Signed-off-by: Michele Calgaro <michele.calgaro@yahoo.it>pull/6/head r14.1.0
parent
3567c9ed9c
commit
4c52a894e7
GPG Key ID:
2A75B7CA8ADED5CF
@ -1,3 +0,0 @@
|
||||
[submodule "admin"]
|
||||
path = admin
|
||||
url = https://system@scm.trinitydesktop.org/scm/git/tde-common-admin
|
||||
@ -0,0 +1,17 @@
|
||||
Basic Installation
|
||||
==================
|
||||
|
||||
kgtk-qt3 relies on cmake to build.
|
||||
|
||||
Here are suggested default options:
|
||||
|
||||
-DCMAKE_EXPORT_COMPILE_COMMANDS="ON" \
|
||||
-DCMAKE_INSTALL_PREFIX="/opt/trinity" \
|
||||
-DCONFIG_INSTALL_DIR="/etc/trinity" \
|
||||
-DSYSCONF_INSTALL_DIR="/etc/trinity" \
|
||||
-DXDG_MENU_INSTALL_DIR="/etc/xdg/menus" \
|
||||
-DCMAKE_BUILD_TYPE=RelWithDebInfo \
|
||||
-DCMAKE_VERBOSE_MAKEFILE="ON" \
|
||||
-DCMAKE_SKIP_RPATH="OFF" \
|
||||
-DBUILD_ALL="ON" \
|
||||
-DWITH_ALL_OPTIONS="ON"
|
||||
@ -1,124 +0,0 @@
|
||||
Introduction
|
||||
------------
|
||||
|
||||
KGtk is a quick-n-dirty hack to allow some Gtk2, Qt3, and Qt4
|
||||
applications to use KDE3 or KDE4 file dialogs.
|
||||
|
||||
KGtk is composed of the following pieces:
|
||||
|
||||
1. An application called kdialogd. In this archive there are
|
||||
two varieties of this - a KDE3 version, and a KDE4 version.
|
||||
2. LD_PRELOAD libraries that are used to override the Gtk2, Qt3,
|
||||
and Qt4 file dialogs.
|
||||
|
||||
If you start an application using the following command:
|
||||
kgtk-wrapper gimp
|
||||
|
||||
...the the following occurs:
|
||||
|
||||
1. kgtk-wrapper determines whether the application is a Gtk2, Qt3,
|
||||
or Qt4 application. It then sets the LD_PRELOAD environment
|
||||
variable to point to the approriate KGtk library.
|
||||
2. When the application now starts, it checks for the
|
||||
TDE_SESSION_VERSION environment variable. If this is not set,
|
||||
or is less than 4, then the KDE3 version of kdialogd is started,
|
||||
else the KDE4 version is started.
|
||||
3. When 'gimp' now tries to open a file dialog, the KGtk library
|
||||
intercepts this, and asks kdialogd to open a file dialog instead.
|
||||
|
||||
There will only ever be one instance of kdialogd, and all apps communicate with the same
|
||||
instance - and it termiantes itself 30 seconds after the last Gtk/Qt app has
|
||||
disconnected. This timeout can be changed by editing kdialogdrc and setting/changing
|
||||
|
||||
[General]
|
||||
Timeout=10
|
||||
|
||||
|
||||
Installation
|
||||
------------
|
||||
As of v0.9.1, kgtk uses CMake in place of autotools.
|
||||
|
||||
Because KGtk includes code for Qt3/KDE3 and Qt4/KDE4, you need
|
||||
to specify when building which variants you would like to build.
|
||||
This is accomplished as follows:
|
||||
|
||||
1. mkdir build
|
||||
2. cd build
|
||||
3. cmake .. -DCMAKE_INSTALL_PREFIX=/usr
|
||||
4. make
|
||||
5. sudo make install
|
||||
|
||||
* -DKGTK_KDE3=true instructs CMake to create makefiles for the KDE3
|
||||
version of KDialogD. Defaults to "true", use -DKGTK_KDE3=false
|
||||
to turn off. Turning this on, sets -DKGTK_KDE4=false and
|
||||
-DKGTK_QT4=false
|
||||
|
||||
* -DKGTK_KDE4=true would instruct CMake to create makefiles for
|
||||
the KDE4 version of KDialogD. Defaults to "false".
|
||||
|
||||
* -DKGTK_GTK2=true instructs CMake to create makefiles for the Gtk2
|
||||
version of the LD_PRELOAD library. Defaults to "true", use
|
||||
-DKGTK_GTK2=false to turn off.
|
||||
|
||||
* -DKGTK_QT3=true instructs CMake to create makefiles for the Qt3
|
||||
version of the LD_PRELOAD library. Defaults to "true", use
|
||||
-DKGTK_QT3=false to turn off. Turning this on, sets
|
||||
-DKGTK_KDE4=false and -DKGTK_QT4=false
|
||||
|
||||
* -DKGTK_QT4=true instructs CMake to create makefiles for the Qt4
|
||||
version of the LD_PRELOAD library. Defaults to "false".
|
||||
|
||||
* For 64 bit systems, also append -DLIB_SUFFIX=64
|
||||
|
||||
Mixing '-DKGTK_KDE3=true' and '-DKGTK_KDE4=true' wont work, so compile the Qt3/KDE3,
|
||||
and Qt4/KDE4 variants separately. Also, the 'build' folder *must* be cleaned before
|
||||
switching to/from Qt3/KDE3 from/to Qt4/KDE4
|
||||
|
||||
|
||||
So, to compile everything I suggest the following:
|
||||
|
||||
1. mkdir build3
|
||||
2. cd build3
|
||||
3. cmake .. -DCMAKE_INSTALL_PREFIX=/usr
|
||||
[ This will build KDialogD for KDE3, and create the LD_PRELOAD libraries for
|
||||
Qt3 and Gtk2 ]
|
||||
4. make
|
||||
5. sudo make install
|
||||
|
||||
6. set up Qt4/KDE4 env variables
|
||||
7. clean build folder
|
||||
|
||||
8. mkdir build4
|
||||
9. cd build4
|
||||
10. cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DKGTK_KDE4=true -DKGTK_QT4=true -DKGTK_GTK2=false
|
||||
11. make
|
||||
12. sudo make install
|
||||
|
||||
NOTE: If you have both KDE3 and KDE4 installed, when calling cmake for KDE3, set TDEDIR to be empty.
|
||||
e.g.
|
||||
TDEDIR= cmake -DCMAKE_INSTALL_PREFIX=/usr -DKGTK_KDE4=false -DKGTK_QT4=false
|
||||
|
||||
Notes
|
||||
-----
|
||||
|
||||
The library has been tested with the following applications:
|
||||
|
||||
Reported to work:
|
||||
|
||||
1. Firefox (1.5.x only, not 1.0.x)
|
||||
2. Inkscape
|
||||
3. GIMP
|
||||
4. Kino
|
||||
5. Eclipse
|
||||
6. Azureus
|
||||
7. Galde-2
|
||||
8. Streamtuner
|
||||
9. Avidemux2
|
||||
10. Scribus
|
||||
11. QComcBook
|
||||
12. Planner 0.14: works, but asks twice for open file
|
||||
|
||||
Reported *not* working:
|
||||
|
||||
1. AbiWord
|
||||
|
||||
@ -0,0 +1,49 @@
|
||||
|
||||
ktgk-qt3 - allows to use TDE dialogs in Gtk apps
|
||||
|
||||
This is an LD_PRELOAD hack that allows most GTK
|
||||
applications to use Trinity's file dialogs when run under TDE.
|
||||
|
||||
It overrides the gtk file chooser functions to communicate
|
||||
with this TDE module/application.
|
||||
|
||||
kgtk-qt3 is composed of the following pieces:
|
||||
|
||||
1. An application called kdialogd.
|
||||
2. LD_PRELOAD libraries that are used to override the Gtk2 and TQt3 file dialogs.
|
||||
|
||||
Start an application using the following command to use the functionality:
|
||||
|
||||
kgtk-wrapper <application>
|
||||
|
||||
kgtk-wrapper determines whether it is a Gtk2 or TQt3 application and then sets
|
||||
the LD_PRELOAD environment variable to point to the approriate kgtk library.
|
||||
When the application tries to open a file dialog, the kgtk library intercepts
|
||||
this and asks kdialogd to open a file dialog instead.
|
||||
There will only ever be one instance of kdialogd, and all apps communicate with the same
|
||||
instance - and it terminates itself 30 seconds after the last Gtk/TQt app has
|
||||
disconnected. This timeout can be changed by editing kdialogdrc and setting/changing
|
||||
|
||||
[General]
|
||||
Timeout=10
|
||||
|
||||
.
|
||||
|
||||
Contributing
|
||||
--------------
|
||||
|
||||
If you wish to contribute to kgtk-qt3, you might do so:
|
||||
|
||||
- TDE Gitea Workspace (TGW) collaboration tool.
|
||||
https://mirror.git.trinitydesktop.org/gitea
|
||||
|
||||
- TDE Weblate Translation Workspace (TWTW) collaboration tool.
|
||||
https://mirror.git.trinitydesktop.org/weblate
|
||||
|
||||
|
||||
Translations status
|
||||
---------------------
|
||||
|
||||
### messages
|
||||
[](https://mirror.git.trinitydesktop.org/weblate/projects/applications/kgtk-qt3/)
|
||||
@ -1 +0,0 @@
|
||||
Subproject commit a7f75ac0ff587d5b8694a1b78557597161f8104c
|
||||
Loading…
Reference in new issue