Signed-off-by: Michele Calgaro <michele.calgaro@yahoo.it>pull/6/head r14.1.0
parent
3567c9ed9c
commit
4c52a894e7
@ -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
|
||||||
|
[![Translations status](https://mirror.git.trinitydesktop.org/weblate/widgets/applications/-/kgtk-qt3/multi-auto.svg
|
||||||
|
"Engage in translating")](https://mirror.git.trinitydesktop.org/weblate/projects/applications/kgtk-qt3/)
|
@ -1 +0,0 @@
|
|||||||
Subproject commit a7f75ac0ff587d5b8694a1b78557597161f8104c
|
|
Loading…
Reference in new issue