From dc7d2fcb9b6d044fd9bc1bdc5d077ed11c0686b1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sl=C3=A1vek=20Banko?= Date: Tue, 17 Nov 2020 23:50:55 +0100 Subject: Move the khelpcenter guides to the directory level in which they are installed. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Slávek Banko --- .../docs/tdebase/khelpcenter/CMakeLists.txt | 2 + .../docs/tdebase/khelpcenter/faq/CMakeLists.txt | 6 + .../docs/tdebase/khelpcenter/faq/Makefile.am | 4 + .../docs/tdebase/khelpcenter/faq/about.docbook | 39 + .../docs/tdebase/khelpcenter/faq/configtde.docbook | 132 ++++ .../docs/tdebase/khelpcenter/faq/contrib.docbook | 100 +++ .../docs/tdebase/khelpcenter/faq/desktop.docbook | 83 +++ .../docs/tdebase/khelpcenter/faq/filemng.docbook | 145 ++++ .../docs/tdebase/khelpcenter/faq/gettde.docbook | 73 ++ .../docs/tdebase/khelpcenter/faq/index.docbook | 102 +++ .../docs/tdebase/khelpcenter/faq/install.docbook | 479 ++++++++++++ .../docs/tdebase/khelpcenter/faq/intro.docbook | 63 ++ .../docs/tdebase/khelpcenter/faq/misc.docbook | 198 +++++ .../docs/tdebase/khelpcenter/faq/moreinfo.docbook | 118 +++ .../tdebase/khelpcenter/faq/nontdeapps.docbook | 32 + .../tdebase/khelpcenter/faq/notrelated.docbook | 165 ++++ .../docs/tdebase/khelpcenter/faq/panel.docbook | 56 ++ .../docs/tdebase/khelpcenter/faq/tdeapps.docbook | 93 +++ .../docs/tdebase/khelpcenter/faq/tips.docbook | 92 +++ .../docs/tdebase/khelpcenter/faq/winmng.docbook | 85 +++ .../tdebase/khelpcenter/glossary/CMakeLists.txt | 6 + .../docs/tdebase/khelpcenter/glossary/Makefile.am | 4 + .../tdebase/khelpcenter/glossary/index.docbook | 183 +++++ .../glossary/tdeprintingglossary.docbook | 458 ++++++++++++ .../tdebase/khelpcenter/quickstart/CMakeLists.txt | 6 + .../tdebase/khelpcenter/quickstart/Makefile.am | 4 + .../tdebase/khelpcenter/quickstart/index.docbook | 828 +++++++++++++++++++++ .../tdebase/khelpcenter/userguide/CMakeLists.txt | 6 + .../docs/tdebase/khelpcenter/userguide/Makefile.am | 4 + .../khelpcenter/userguide/about-desktop.docbook | 243 ++++++ .../userguide/first-impressions.docbook | 186 +++++ .../khelpcenter/userguide/getting-started.docbook | 237 ++++++ .../tdebase/khelpcenter/userguide/history.docbook | 91 +++ .../tdebase/khelpcenter/userguide/index.docbook | 64 ++ .../khelpcenter/userguide/installation.docbook | 240 ++++++ .../tdebase/khelpcenter/userguide/intro.docbook | 14 + .../khelpcenter/userguide/more-help.docbook | 29 + .../userguide/notices-trademarks.docbook | 57 ++ .../khelpcenter/userguide/shortcuts.docbook | 160 ++++ .../tdebase/khelpcenter/userguide/staff.docbook | 65 ++ .../tdebase/khelpcenter/userguide/ug-faq.docbook | 58 ++ .../tdebase/khelpcenter/visualdict/CMakeLists.txt | 6 + .../tdebase/khelpcenter/visualdict/Makefile.am | 4 + .../tdebase/khelpcenter/visualdict/index.docbook | 295 ++++++++ 44 files changed, 5315 insertions(+) create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/CMakeLists.txt create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/Makefile.am create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/about.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/configtde.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/contrib.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/desktop.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/filemng.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/gettde.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/index.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/install.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/intro.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/misc.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/moreinfo.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/nontdeapps.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/notrelated.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/panel.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/tdeapps.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/tips.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/winmng.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/CMakeLists.txt create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/Makefile.am create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/index.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/tdeprintingglossary.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/quickstart/CMakeLists.txt create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/quickstart/Makefile.am create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/quickstart/index.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/CMakeLists.txt create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/Makefile.am create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/about-desktop.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/first-impressions.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/getting-started.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/history.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/index.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/installation.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/intro.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/more-help.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/notices-trademarks.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/shortcuts.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/staff.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/ug-faq.docbook create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/visualdict/CMakeLists.txt create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/visualdict/Makefile.am create mode 100644 tde-i18n-en_GB/docs/tdebase/khelpcenter/visualdict/index.docbook (limited to 'tde-i18n-en_GB/docs/tdebase/khelpcenter') diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/CMakeLists.txt b/tde-i18n-en_GB/docs/tdebase/khelpcenter/CMakeLists.txt index 4649f6a2bb0..14f583d997c 100644 --- a/tde-i18n-en_GB/docs/tdebase/khelpcenter/CMakeLists.txt +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/CMakeLists.txt @@ -4,3 +4,5 @@ tde_create_handbook( DESTINATION khelpcenter LANG en_GB ) + +tde_auto_add_subdirectories() diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/CMakeLists.txt b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/CMakeLists.txt new file mode 100644 index 00000000000..9367a167530 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/CMakeLists.txt @@ -0,0 +1,6 @@ +# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer + +tde_create_handbook( + DESTINATION khelpcenter/faq + LANG en_GB +) diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/Makefile.am b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/Makefile.am new file mode 100644 index 00000000000..15208dfc8a8 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = en_GB +SUBDIRS = $(AUTODIRS) +KDE_DOCS = khelpcenter/faq +KDE_MANS = AUTO diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/about.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/about.docbook new file mode 100644 index 00000000000..e407bc656d0 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/about.docbook @@ -0,0 +1,39 @@ + + + +About this <acronym>FAQ</acronym> + + + + +What can I do to help out with this FAQ? + + + + +First, send us any errors that you may find. Also, any suggestions that you might have, are appreciated. Better yet, send us everything that you think is unclear, and if possible, send us what you think would be a clearer solution. Our email address is kde-doc-english@kde.org. + +Second, send us your solutions of those frequently-asked questions which are still not in this FAQ. We will put them in as soon as possible. + +Last but not least, please make full use of this FAQ. Read this FAQ (and other relevant documentation) well before asking questions on the various &kde; mailing lists or newsgroups. + +You might also want to consider becoming a FAQ maintainer. Please refer to for more details. + + + + + + +How do I become a FAQ maintainer? + + + +Actually, it is very easy to become an FAQ maintainer, and we are always in need of fresh blood. :-) Just send us an email at kde-doc-english@kde.org. + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/configtde.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/configtde.docbook new file mode 100644 index 00000000000..452e2bc04fd --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/configtde.docbook @@ -0,0 +1,132 @@ + + +Configuring &kde; + + + + +How do I set the language used by &kde;? + + + +There are two ways to set the language &kde; uses in the messages it will display: + + +Using the &kde; Control Centre +Fire up the &kde; Control Centre and select Regional & Accessibility followed by Country/Region & Language. You can select your language and location here. If &kde; cannot find a translation in the first language chosen, it will fall back on the default language. This is usually (American) English by default. +Using the &kde; Control Centre is the preferred way of choosing languages in &kde;. + +Using the LANG environment variable +The second method uses the standard locale setting on your system. To change the language, simply set the environment variable LANG accordingly. For example, if your shell is bash, execute export LANG=de to set German as the language used. + + + + + + + +Is there any keyboard switcher for international keyboards for &kde;? + + +Yes, you can configure it using the &kde; Control Centre Regional & Accessibility Keyboard Layout configuration page. + + + + + +How do I replace the standard text login screen with the &kde; login screen? + + +Your distribution/&UNIX; flavour may have its own setup tools to change this (⪚ YaST on &SuSE; &Linux;). This will be the safest way to enable the &kde; login screen. However, if for some reason you do not wish to use these tools, the following instructions may be useful. +First, you need to change to the xdm runlevel (runlevel 5 on &RedHat; and &SuSE; systems) by editing your /etc/inittab file. In the file, you should have a line saying id:3:initdefault:. Change it to id:5:initdefault:. Now, at the end of the file, comment out the following line: x:5:respawn:/usr/bin/X11/xdm -nodaemon and replace it with x:5:respawn:/opt/kde/bin/tdm -nodaemon. The location of &tdm; may differ on your system. +For changes to take effect immediately, type init 5 (for &RedHat; systems) at the shell prompt. It is risky to initiate a graphical login without checking beforehand whether it works. If it fails to work, you would be in for a hard time getting back.... + + +For FreeBSD, you should edit the file /etc/ttys and change one of the lines that look like ttyv8 "/usr/X11R6/bin/xdm -nodaemon" xterm off secure to instead say ttyv8 "/usr/local/bin/tdm -nodaemon" xterm off secure. + + + + + + +I would like to click the &LMB; anywhere on the desktop and have the K menu displayed. + + +Open the &kde; Control Centre and choose Desktop Behaviour. You can now choose the behaviour of mouse clicks on the desktop. To have the K menu open from a single &LMB; click, change the entry labelled Left button to say Application Menu. + + + + + +Where do I find information regarding &kde; themes? + + +Go to http://kde.themes.org/ or http://www.kde-look.org. + + + + + +How do I change &MIME; Types? + + +If you are using &konqueror;, do this instead: first, open a &konqueror; window and choose SettingsConfigure Konqueror, then File Associations. Find the type you want to change (⪚ text/english or image/gif), and set the application preference order to whatever you want. + + + + + +&kde; (&tdm;) does not read my .bash_profile! + + +The login managersxdm and &tdm; do not run a login shell, so .profile, .bash_profile, &etc; are not sourced. When the user logs in, xdm runs Xstartup as root and then Xsession as user. So the normal practice is to add statements in Xsession to source the user profile. Please edit your Xsession and .xsession files. + + + + + +How do I use &TrueType; fonts in &kde;? + + + +You need to install &TrueType; font support into your &X-Window; configuration. Please take a look at x.themes.org for the fonts, and xfsft: &TrueType; Font Support For X11 or X-&TrueType; Server Project Home Page for the font servers. + +If you have a bunch of &TrueType; fonts from &Microsoft; &Windows;, edit the XF86Config file to get the fonts from the font folder. Then just tell &kde; to use these new fonts with the font administrator utility. + + + + + + +Is it possible to enter, show and work with the Euro Symbol in &kde;? + + +Yes and no. For details, look here: http://www.koffice.org/kword/euro.php. + + + + +How do I run a program at &kde; startup? + +There are many ways to do that. If what you want to do is to run some scripts that would set some environment variables (for example, to start gpg-agent, ssh-agent and others), you can put these scripts into $TDEHOME/env/ and make sure their names end in .sh. $TDEHOME is usually a folder named .kde (note the period at the beginning) in your home folder. If you want scripts to be executed for all &kde; users, you can put them under $TDEDIR/env/, where $TDEDIR is the prefix &kde; was installed to (you can find this out using the command tde-config --prefix). +If you wish to start a program after &kde; has started, you may want to use the Autostart folder. To add entries to the Autostart folder: +Open &konqueror;. + +Select GoAutostart from the menubar. + +Right-click in the window view area and select Create NewFileLink to Application + +Click on the Application tab in the window that appears and enter the name of the command to run in the Command text box. + + + + + + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/contrib.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/contrib.docbook new file mode 100644 index 00000000000..82cc85dd1b8 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/contrib.docbook @@ -0,0 +1,100 @@ + + + + +Contributing + + + + +How can I contribute to &kde;? + + +&kde; is a free software project that lives from voluntary contributions. Everybody is encouraged to contribute to &kde;. Not only programmers are welcome. There are many ways in which you can help to improve &kde;: + +Test the software. +Send in bug reports. For more information on this, see How do I submit a bug report?. +Write documentation or help files. You can get some information by visiting the &kde; Editorial Team Home Page. +Translate programs, documentation, and help files. For more information on this, you should visit The &kde; Translators' and Documenters' Web Site. +Draw nice icons or compose sound effects. You can visit the &kde; artists page to find out more. +Write articles and books about &kde;. If you want to help spread the word about &kde;, simply send an email to kde-pr@kde.org. This will get you in touch with the &kde; public relations volunteers. +Program new &kde; applications. Please refer to for more information. +Of course, sponsors are also welcome. :-) + +There are several places to look for more information if you want to get involved in the development. The first step is to subscribe to some of the mailing lists. You will soon see something that can be improved or added. + + + + + +How do I submit a bug report? + + +There is a bug tracking system available at http://bugs.trinitydesktop.org. The system features a wizard to submit new bug reports and a list of all known bugs. +The easiest way to submit a bug is to select HelpReport Bug... from the menu bar of the application with the bug. This will open a small dialogue box with a link to the bug tracking system. Please make sure to follow the instructions of the bug reporting wizard. + + + + + +I want to program for &kde;. What should I do first? + + +Everybody is encouraged to develop software for &kde;. What you should do first depends strongly on your experience, ⪚ whether you have already learned C++ or have experience with the &Qt; toolkit and so on. +To get into &kde; programming, you will need some basic tools: automake, autoconf, and egcs. You should look to http://developer.kde.org/ for more tips. +Another excellent resource for learning &kde; programming is the &Qt; online tutorials. These are installed along with &Qt;. To view them, open $TQTDIR/doc/html/index.html in &konqueror; and bookmark it. The tutorials can be found under "Using Qt". The source code for each lesson can be found in the $TQTDIR/tutorial directory. +There is, however, one thing that everybody interested in programming for &kde; should do: subscribe to the developers mailing list. To subscribe, you have to send an email to kde-devel-request@kde.org with the subject subscribe your_email_address. Please read How to subscribe/unsubscribe to these lists carefully. Everything said there applies to the development list as well. + + + + + +How do I get access to the CVS? + + +The &kde; project uses CVS to develop the core parts of the software. Usually, when you have changed one of the parts (⪚ fixed a bug), and you want to commit this change, the best way is to create a patch against a current snapshot and send this patch to the developer/maintainer of the respective program. +If you are doing this more or less regularly, you can ask Stephan Kulow, coolo@kde.org for direct access to the CVS server. But be aware that more users will slow down CVS access for all developers, so we want to keep the number of people with direct CVS access reasonably small. But feel free to ask! + + + + + +I am just curious. Can I have read-only access to the CVS? + + +Yes. It is possible to get read-only access to the CVS repository with cvsup or cvs utility. You can find more information about how to set up cvsup for the &kde; repository from How to use cvsup to get &kde;. +In addition, anonymous CVS service is also available. To find out more about how to set up and use anonymous CVS, please see here. + + + + + +Are there any cvs mirror sites for &kde;? + + +Yes. The main &kde; server is normally very busy. Please take a look at http://developer.kde.org/source/cvsupmirrors.html and http://developer.kde.org/source/anoncvs.html for the list of available mirrors. +Once you have selected a new cvsup server, simply replace +*default host=cvs.kde.org + with +*default host=cvsup.your.new.host + in your cvsup script. +The instructions to change the anoncvs server can be found on http://developer.kde.org/source/anoncvs.html, too. + + + + + +How do I go about translating &kde; programs into my native language? + + +Look at the The &kde; Translators' and Documenters' Web Site to see whether your program is already translated (most are). Otherwise you will find information there on how to do it yourself. + + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/desktop.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/desktop.docbook new file mode 100644 index 00000000000..a523f222b83 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/desktop.docbook @@ -0,0 +1,83 @@ + + + +The desktop + + + + +How do I add an application to the desktop? + + + +Just choose the desired application from the K menu and drag and drop it to the Desktop. +For applications not listed in the K menu, use the &RMB; on the desktop and choose Create NewFile Link to Application... and fill in the configuration for the application you want to link to. + + + + + + +How do I mount/unmount a device from the desktop? + + + +First, make sure you are allowed to mount/umount the relevant device as a user. +Then you can add any device via &RMB; on the desktop and then choosing Create New. + + + + + + + +Where are the icons kept? + + +The icons can be found only in $TDEDIRS/share/icons or $HOME/.trinity/share/icons or $HOME/.kde2/share/icons. To use icons stored in other locations, you must either copy them into one of the above-mentioned fixed &kde; locations or make symlinks. + + + + + +How do I use the mouse scroll wheel in &kde;? + + +Mouse wheel support comes with &Qt; 2.0 and above, so &kde; based on that will automatically support the use of the mouse scroll wheel. + + + + + +Why can't I get system sound to work, like for opening windows? + + +System sound currently does not work on non-FreeBSD and non-&Linux; systems. This is being worked on. If you use FreeBSD or &Linux;, you have found a bug, so please report it. + + + + + +How do I launch applications in a particular desktop? + + +&kde; comes with a program called &kstart;. To start an xterm on the second desktop and then activate it use: kstart xterm. +Note that the option is important. It takes an argument which is a regular expression matching the title of the window to apply the settings to. +Please read kstart for more magic available with &kstart; (and there is an abundance). + + + + + +Where do I save my files if I want them to appear directly on the desktop? + + +$HOME/Desktop. You might need to refresh your desktop after you have saved your files. + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/filemng.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/filemng.docbook new file mode 100644 index 00000000000..a6b2b4c68cb --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/filemng.docbook @@ -0,0 +1,145 @@ + + + +The File Manager and Web Browser + +The file manager and web browser of &kde; is &konqueror;. The &konqueror; home page is located at http://www.konqueror.org where a &konqueror; specific FAQ can be found. + + + + +How do I use &konqueror; as a web browser with a proxy? + + +&konqueror; can be used with &HTTP; and &FTP; proxies. To set up the proxy server in &konqueror;, just select SettingsConfigure &konqueror;... from the &konqueror; menu and go to the Proxy tab. + + + + + +How can I change the appearance of a folder in &konqueror;? + + +Right-click the folder, select Properties, click on the large icon in the dialogue which appears and choose another icon. +To change the icon displayed for entries in the TDE Menu, use the Menu Editor, located at SettingsMenu Editor. + + + + + +How can I do non-anonymous &FTP; transfers with &konqueror;? + + +Normally, if you enter a &URL; like ftp://ftp.somehost.com, &konqueror; will attempt an anonymous login to the &FTP; server. If you want to login as a particular user, enter a &URL; like ftp://username@ftp.somehost.com instead. &konqueror; will ask for your password and connect to the server. + + + + What are and in the Execute line? +They are used by all &kde; applications (since they are implemented in TDEApplication and all good &kde; programs create a TDEApplication object before they even look at the command line arguments). A standard line for a &kde; application looks like this: foo . Pretty confusing, but it has been designed in that way so that it can integrate legacy, non-&kde; applications as smoothly as possible. &konqueror;, when executing the line above, will extend the command to foo . Both the icon and the mini-icon as well as "The Foo" are properties defined in the .desktop file. If the icons are not defined, they simply default to the executable name foo. + +This way a user can change these things in &kmenuedit; for his or her applications. The option is important, because no user will accept that the menu item Editor starts something called kedit-0.9pl4-build47. Instead, he expects a window called Editor. Furthermore these names are localised, i.e. an American user launches CD-Player and gets a window called CD-Player while a German user launches CD-Spieler and gets a window called CD-Spieler. + + + + + + +How do I specify the startup folder for &konqueror;? + + + +Using the &RMB;, click on the Home icon and choose Properties. Under the Application tab you will probably find something like kfmclient openProfile filemanagement; just append file:/whereever/you/want with the folder you would like &konqueror; to start in. + + + + + + +How do I import &Netscape; bookmarks? + + +There is no need to import anything at all. &Netscape; bookmarks are automatically available under the Bookmarks menu in &konqueror; with no configuration on your part necessary. The Bookmark Editor is able to convert &Netscape; bookmarks to the format used by &konqueror;, if you want this. + + + + + +How do I fool a site into believing &konqueror; is &Netscape; or some other browser? + + +In &konqueror;, select SettingsConfigure Konqueror... and in the configuration dialogue, select Browser Identification. Default and site-specific browser identifications can be set from here. + + + + + +How do I configure &konqueror; to run &Java; applets? + + +Choose SettingsConfigure &konqueror;... from &konqueror;'s menubar and then select Java & Javascript. Set the Path to Java executable correctly. If it doesn't work, please check the Konqueror + Java HOWTO. + + + + + +What is this new Smart policy for JavaScript web popups? + + +This new policy attempts to block intrusive JavaScript popup windows. If the user does not click on a button or submit a form to trigger the popup, then the popup is not permitted. Some sites will open a second new window from within the first and in that case, the second window will not show. + + + + + +Why doesn't my banking site work with &konqueror;? It pops up a new window with the login screen in other browsers, but not in &konqueror;. + + +Make sure you have Javascript enabled, and the default JavaScript web popups policy set to Ask or Allow. The Smart policy is not always sufficient for some banks. Many banks also require &Java; support. You can find more help on enabling this at http://www.konqueror.org/. + + + + + +Why can't &konqueror; render &GIF; images? + + +It is because you did not enable &GIF; support in &Qt;. Please see for more details. + + + + + +How do I rename files? + + +Simply right click on the file and select Rename or click once on an already selected file. The default keyboard shortcut to rename a file is F2. + + + + +When I try to open a web page with &konqueror;, I get the message: There appears to be a configuration error. You have associated Konqueror with text/html, but it cannot handle this file type. + + +You need to make sure that the embedding settings for the text/html MIME type are correct: +In &konqueror;, go to SettingsConfigure Konqueror and then to the File Associations page. +Open text->html in the tree view. +Click on the Embedding tab. Make sure that Left Click Action is set to Show file in embedded viewer, and that TDEHTML (tdehtml) is at the top of Services Preference Order. + + +Try opening a website in Konqueror. It should now work. + + + + +How do I configure the programs that &konqueror; uses to open different types of files? + +In order to configure file associations, you should go to the &kcontrolcenter; and choose the item File Associations under the category TDE Components. +Suppose the default PDF viewer is now &kghostview; and you would prefer to use KPDF as a viewer. You would simply type pdf in the search box at the top of the dialogue, choose pdf in the application group and move KPDF up. In the Embedding tab you can also choose which component other applications will use to display files (for example, when viewing files in &konqueror; or using &ark;'s embedded viewer). + + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/gettde.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/gettde.docbook new file mode 100644 index 00000000000..6f250409f90 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/gettde.docbook @@ -0,0 +1,73 @@ + + + +Getting &kde; + + + + +Where do I get &kde;? + + + +The main distribution site for &kde; is ftp.kde.org. However, this site is often under heavy load, so you might prefer to use download.kde.org which automatically redirects you to the mirror nearest to you. You can also have a look at the list of &kde; mirror sites. + + + + + +Are there &Linux; distributions that include &kde;? + + +Yes, major &Linux; distributions already ship &kde;. As building a distribution takes some time, they might not always contain the latest version, but for a start or to avoid downloading from the Internet, they do provide a good starting point. +You can find an up-to-date list of distributions that ship with &kde; here. + + + + + + +What is the current version? + + + +Currently, the latest stable version is 3.2 + +The &kde; 3.2 Info Page contains a lot of information specific to this release. + + + + + +Where do I find &kde; snapshots? + + +You can get the latest snapshots from ftp://ftp.kde.org/pub/kde/unstable/snapshots. You might also want to consider setting up your own CVS client in order to maintain the latest snapshot at all times. Please refer to Anonymous CVS and &kde; for further information. + + + + + + +Where do I get &Qt;? + + +&Qt; is a product of the Norwegian company Trolltech. You can always get the latest &Qt; version from their &FTP; server. +And with most up-to-date &Linux; distributions, &Qt; is already included. Please see for the version of &Qt; you need. + + + + + +What is &Qt;, by the way? + + +&Qt; is a C++-based class library to build user interfaces. It also includes many utility classes like string classes and classes to handle input and output. It provides most of the widgets you will see in a &kde; application: menus, buttons, sliders, &etc;. &Qt; is a cross-platform library that allows you to write code that will compile on &UNIX; systems as well as &Windows; and embedded devices. You can learn more about &Qt; at http://www.trolltech.com. + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/index.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/index.docbook new file mode 100644 index 00000000000..8638010c0b9 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/index.docbook @@ -0,0 +1,102 @@ + + + + + + + + + + + + + + + + + + + + + + + +]> + + + + +&kde; Frequently Asked Questions + + + +The &kde; Team + +MalcolmHunter
malcolm.hunter@gmx.co.uk
Conversion to British English + + + + +1997 +1998 +1999 +2000 +2001 +2003 +2004 +The &kde; Team + + +&FDLNotice; + +2004-09-07 +3.3 + + +This is a compilation of the most frequently asked questions about the K Desktop Environment. Please report any bugs, inconsistencies, or omissions you find in this &FAQ; to kde-doc-english@kde.org. Please do not mail your questions to this list. Post them to the &kde; mailing lists and newsgroups instead. They are monitored for this &FAQ;. + + +KDE +FAQ +question +answer + + + +&faq-about; +&faq-intro; +&faq-gettde; +&faq-install; +&faq-panel; +&faq-desktop; +&faq-winmng; +&faq-filemng; +&faq-configtde; +&faq-tdeapps; +&faq-nontdeapps; +&faq-tips; +&faq-misc; +&faq-moreinfo; +&faq-contrib; + + +Credits and Licence + +The current &FAQ; maintainers are: + + +Rainer Endres endres@kde.org + + +Many of the answers in this &FAQ; are taken from the various &kde; mailing lists and newsgroups. Here is a big thank you to all of you who have contributed answers that eventually appear in this &FAQ;. + +Special thanks go to the former &FAQ; maintainer, who has written most of the stuff in here, and did a tremendous job: Mr. Lee Wee Tiong + + +Conversion to British English: Malcolm Hunter malcolm.hunter@gmx.co.uk +&underFDL; + +&documentation.index; + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/install.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/install.docbook new file mode 100644 index 00000000000..3b0d78aa90d --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/install.docbook @@ -0,0 +1,479 @@ + + + + +Installation instructions + +These are the generic installation instructions for the K Desktop Environment. Please complement your reading with the READMEs and INSTALLs that come along with the package. Please read them carefully and try to help yourself out if anything goes wrong. If you need further assistance, consider joining the &kde; mailing lists (see our web site instructions for joining the &kde; mailing lists) or newsgroups. + + + + + + + +To the would-be converts + + + +So you have heard the rumours. Or you have seen the screenshots. And you are dying to get hold of &kde;. But you know next to nothing about this whole alternative OS business. Don't worry! You only need to do some (well, maybe not some) reading, that's all! + +&kde; does not run on any version of &Microsoft; &Windows; or OS/2 (yet). To run &kde;, you need to have a &UNIX; system. Please refer to for more details. + +Decide on a platform and set it up for your system. This FAQ can not help you with this, since &kde; runs on many &UNIX; platforms. + + + +Finally, you are ready to commence the &kde; installation. Please start reading from the next section. To get &kde;, please refer to . Last but not least, if you encounter any problems while installing &kde;, please do not hesitate to make use of the &kde; mailing lists and newsgroups. But do bear this in mind: no question is too silly to ask, but some are too silly to answer, especially when they are already answered in this FAQ. +Good luck and have fun! + + + + + + +Available package formats + + + + +You can find several kinds of binary and source packages for different distributions and operating systems on the &kde-ftp;. The binary packages are not made by the &kde; Team, but by the distributors themselves, or some dedicated individuals. Please refer to &kde; Package Policy Explained for information about the &kde; Package Policy. The only official release is the source tar.bz2 packages. Please refer to the READMEs and INSTALLs in the several binaries folders. For a list of the available packages for a release, refer to the relevant info page. For the latest release this is the &kde; 3.2 Info Page. + + + + + + +Prerequisites + + + + + +For &kde; 3.2, you need the &Qt; library version 3.2 or greater. Please make sure you download the correct &Qt;. You will also need the header files, if you want to compile &kde; yourself. They are all available, at no cost, from http://www.trolltech.com/download. In addition, there are optional libraries that might improve &kde; if installed on your system. An example is OpenSSL which will enable &konqueror; to browse web pages securely and is needed in a version >=0.9.6. These should be provided by your distributor; if not, ask for an update. + + + + + + +Description of the base packages + + +The base distribution currently consists of eleven packages. Some are required, while others are optional. Each package is available in each of the aforementioned package formats. + + +tdelibs + +Required +This package contains shared libraries that are needed by all &kde; applications. + + + +tdebase + +Required +This package contains the base applications that form the core of the K Desktop Environment like the window manager, the terminal emulator, the control centre, the file manager, and the panel. + + + +&arts; + +Required +The &arts; sound server. A powerful, network transparent sound server. + + + +tdeaddons + +Optional +Various plugins for &kate;, &kicker;, &knewsticker;, &konqueror; and &noatun; + + + +tdeartwork + +Optional +Additional wallpapers, themes, styles, sounds ... + + + +tdebindings + +Optional +Various bindings for other languages, including &Java;, Perl, Python, ... + + + +tdegames + +Optional +Various games like &kmahjongg;, &ksnake;, &kasteroids;, and &kpatience;. + + + +tdegraphics + +Optional +Various graphics-related programs like &PostScript; previewer, &DVI; previewer, and a drawing program. + + + +tdeutils + +Optional +Various desktop tools like a calculator, an editor and other nifty stuff. + + + +tdemultimedia + +Optional +Multimedia applications like a &CD; player and a mixer. + + + +tdenetwork + +Optional +Network applications. Currently contains the mail program &kmail;, the news reader &knode;, and several other network-related programs. + + + +tdeadmin + +Optional +System administration programs. + + + +tdeedu + +Educational and entertaining applications for &kde;'s younger users. + + + +tdetoys + +Optional +Toys! + + + +tdevelop + +Optional +A complete Integrated Development Environment for &kde; and Qt + + + + +&arts; and then tdelibs should be installed before everything else, and tdeaddons last. The other packages can be installed in any arbitrary order. + +Most package management tools will let you put all these packages in one folder and install them all at once, figuring out the dependencies as they go. + + + + + + +Installation instructions for the different package formats + + + +Please do not forget to read the README and INSTALL files if they are available. + + + +Installation of the Debian packages + +The Debian packages install in accordance with the upcoming FHS (File Hierarchy Standard). + +become superuser +run dpkg for every package you want to install. + + + + +Installation of the RPM packages + + +To install binary <acronym>RPM</acronym>s +become superuser +execute rpm + + + + +Installation of the source .tar.bz2 files + +Since there are always changes and updates to the way &kde; is compiled, please refer to Download and Install from Source for the most up to date installation instructions for the source packages. +The general approach should work in most cases though. +The source .tar.bz2 package installs into /usr/local/kde by default. You can override this setting by using the option of the configure script. + +unpack the packages with tar +change folder to the package folder: cd packagename +configure the package: ./configure Some packages (notably tdebase) have special configuration options that might be applicable to your installation. Type ./configure to see the available options. +build the package: make +install the package: su (if you aren't already root). If you already are, just type make . + + + + + + + + + +Post-installation procedures + + +First of all, please make sure that you have added &kde;'s binary installation folder (⪚ /usr/local/kde/bin) to your PATH and &kde;'s library installation folder to your LD_LIBRARY_PATH (only necessary on systems that do not support rpath; on &Linux; &ELF;, it should work without). This environment variable may be called differently on some systems, ⪚ it is called SHLIB_PATH on &IRIX;. Then set the environment variable TDEDIR to the base of your &kde; tree, ⪚ /usr/local/kde. Please bear in mind that it is unwise to set LD_LIBRARY_PATH blindly. In the vast majority of cases it is unnecessary and can do more harm than good. There is a web page written by Dave Barr explaining the evils of LD_LIBRARY_PATH and it can be found at http://www.cis.ohio-state.edu/~barr/ldpath.html. + + +Even though you can use most of the &kde; applications simply by calling them, you can only benefit fully from &kde;'s advanced features if you use the &kde; window manager and its helper programs. +In order to make it easy for you, we have provided a simple script called starttde which gets installed in $TDEDIR/bin and is therefore in your path. +Edit the file .xinitrc in your home folder (make a backup copy first!), remove everything that looks like calling a window manager, and insert starttde instead. Restart the &X-Server;. If you use &tdm;/xdm, you will have to edit the file .xsession instead of .xinitrc. And if there is no .xinitrc or .xsession in your home folder, simply create a new one with just one line containing starttde. Some systems (notably &RedHat; &Linux;) use .Xclients instead. + +This should present you with a new shining &kde; desktop. You can now start to explore the wonderful world of &kde;. In case you want to read some documentation first, there is a highly recommended Quick Start guide available. Furthermore, every application has an online help that is available via the help menu. + + + + + + +Should I remove old version xyz before installing a new one? + + +In principle, this is not necessary. RPM and Debian packages should take care of all dependencies. +If you compile the source code yourself, you should take more care. Instructions for running two different versions of &kde; on the same system are given at http://developer.kde.org/build/kde2-and-kde3.html. However, please note that running two different versions of &kde; from source can lead to problems if you are not careful. + + + + + +How do I start &kde;? + + +The most comfortable method to start &kde; is to use the starttde script. Simply put the line starttde at the end of your .xsession file (or your .xinitrc or .Xclients file if you are not using &tdm; or xdm). Please also remove the lines that start your previous window manager. If there is no .xsession, .xinitrc, or .Xclients in your home folder, simply create a new one that contains just one line: starttde. + + + + + +Is it possible to install &kde; in a user folder? + + +Yes, you can install &kde; in any folder you want. What you have to do depends on the kind of packages you want to install: +Source packages +Configure and install the package using configure ; make; make install to install into /users/myhome/kde. +Add the following to your init files. Please note that if it is not necessary for you to set LD_LIBRARY_PATH, it is better to leave it out. + +For csh or tcsh: +setenv TDEDIR /users/myhome/kde + +if ( $?LD_LIBRARY_PATH ) then + setenv LD_LIBRARY_PATH $TDEDIR/lib:$LD_LIBRARY_PATH +else + setenv LD_LIBRARY_PATH $TDEDIR/lib +endif + +if ( ! $?LIBRARY_PATH ) then + setenv LIBRARY_PATH $LD_LIBRARY_PATH +endif + +For bash: +TDEDIR=/users/myhome/kde +PATH=$TDEDIR/bin:$PATH +LD_LIBRARY_PATH=$TDEDIR/lib:$LD_LIBRARY_PATH +LIBRARY_PATH=$LD_LIBRARY_PATH +export TDEDIR PATH LD_LIBRARY_PATH LIBRARY_PATH + + +<acronym>RPM</acronym> packages +rpm allows you to use the option to select the folder you want to install to. For example, executing rpm will install the package to /users/myhome/kde. + + +Although &kde; will run from a user folder, there are some problems with programs that require suid root, ⪚ the programs in the tdeadmin package. But since they are not meant to be run by users in the first place, this is nothing to worry about. +However, on systems using shadow passwords, the screensavers have to be suid root to enable password access for unlocking the screen, so this option will not work. + + + + + + +starttde fails with can not connect to X server. What is wrong? + + +You probably tried to start the X server with starttde. The X server is started with startx. starttde is the script that should be run from your .xinitrc, .xsession, or .Xclients to activate the window manager and the necessary server daemons for &kde;. See also . + + + + + +&kde; on &AIX;? + + +IBM now officially support &kde; on &AIX;. You can find details at http://www.ibm.com/servers/aix/products/aixos/linux/index.html. There is also some older information at http://space.twc.de/~stefan/kde/aix.html. + + + + + +&kde; on a laptop? + + +If you can get &X-Window; to run on your laptop, you should not have any problem getting &kde; to run on it. In addition, you might find the following links helpful: + + +http://www.linux-laptop.net/ + + +http://www.sanpei.org/Laptop-X/note-list.html + + + + + + + +I have a neomagic chipset in my laptop. Is there anything special I should do to run &kde;? + + +On some laptops using the 2160 chipset (MagicGraph 128XD) the following options in XF86Config are needed to avoid a lock-up of the graphic engine: +Option "XaaNoScanlineImageWriteRect" + Option "XaaNoScanlineCPUToScreenColorExpandFill" + +If you have experienced desktop hangs while using &kde; please try this option. + + + + + +I do not like the default &kde; folder after installation. How do I move it without breaking anything? + + +Assuming the default is /opt/kde and you want to move it to /usr/local/kde, here's what you have to do: + +change to superuser if you aren't already +mv /opt/kde /usr/local/kde +ln -s /usr/local/kde /opt/kde + +This will put all your &kde; files in /usr/local/kde but everything is still accessible from /opt/kde. + + + + + +What files can I delete from my &kde; install folder? Can all the *.h, *.c and *.o files be safely removed? + + +There should not be any need to keep the .c and .o files, but you might want to keep the .h files, as they are used by includes if you ever want to compile your own &kde; programs. But if you wish to add patches to the source programs as they become available (rather than downloading everything again), then they should stay. + + + + + +Will I lose my current settings when I upgrade &kde;? + + + +No. In most cases &kde; will be able to transport your settings intact. You may need to reenter passwords in some applications (such as &kmail; or &knode;) but most other settings will be safe. + +There were mixed reports of results between some previous versions of &kde;. To be safe, you may like to back up your entire &kde; configuration. + +Settings are kept in the $HOME/.trinity or $HOME/.kde2 subfolder in your home folder. Copy your old .kde/.kde2 folder to a backup location, install &kde; 3.2, and then copy back any necessary mail and news settings. That said, most people can make a direct upgrade, without removing the old .kde folder, without a hitch. +You can override the use of $HOME/.trinity by setting the $TDEHOME variable. + + + + + +I upgraded &kde; and it seemed to go fine, but when I start it, I get a blank grey screen, and nothing happens. There are errors in the console about DCOPserver. What's going on? + + + +&kde; uses several temporary files during its operation. These are usually to be found in the following locations: + +~/.DCOPserver-* (there are usually two of these; one is a symlink to the other) +~/.trinity/socket-hostname +~/.trinity/tmp-hostname which is normally a symlink to the next file: +/tmp/tmp-kde-USER +~/.trinity/socket-hostname which is also normally a symlink to: +/tmp/tdesocket-USER + + +If the symlinks get broken, usually because a cron or shutdown script is emptying out the /tmp folder, then strange things will happen. These files, and the symlinks, will all be created automatically at the start of &kde; so you can safely remove them while &kde; is not running. + +If you are only getting a grey screen when you start &kde;, or if you get an error message telling you to Check your installation, then shut down X and delete all the files listed above, then try to restart X. + +Normally (&ie; when not upgrading between &kde; versions) it's quite safe to leave these files intact, and you may shave a few seconds off your &kde; startup time by doing so. + + + + + +Compiling tdebase gives me a bin/sh: msgfmt: command not found error! + + +You need the &GNU; msgfmt which is part of the &GNU; i18n package gettext. You should be able to download it from any &GNU; mirror. + + + + + +How do I uninstall &kde; applications compiled from source? + + +You can uninstall your programs by typing make uninstall in the folder where you did make install. If you have already deleted that folder, then there is only one way, and it is not good: go to $TDEDIR/bin and start deleting files one by one. +If you expect to find yourself in this situation, you might want to consider a program such as &GNU; stow, found at http://www.gnu.org/software/stow/stow.html. + + + + + +What is up with &GIF; support? + + +This has to do with issues with Unisys' &LZW; patent. &GIF; support is turned off from &Qt; 1.44 onwards by default. When you want to use &GIF;s and have the relevant license, recompile &Qt; with &GIF; support. ./configure . + + + + + +How do I install &kde; themes? + + +Theme support in &kde; has been discontinued with this version. However, there are many opportunities to personalise and add eye candy to &kde; Look at, for example, Appearance & Themes in &kcontrol;. + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/intro.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/intro.docbook new file mode 100644 index 00000000000..6b31d8982e0 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/intro.docbook @@ -0,0 +1,63 @@ + + + +Introduction + + + + +What is &kde;? + + +&kde; is the K Desktop Environment. It is a project initiated by Matthias Ettrich in 1996. The aim of the &kde; project is to connect the power of the &UNIX; operating systems with the comfort of a modern user interface. +In short, &kde; will bring &UNIX; to the desktop! +If you want further information about &kde;, have a look at What is &kde;? + + + + + +On which platforms can I expect &kde; to work? + + +&kde; is a Desktop Environment for all flavours of &UNIX;. While it is true that most &kde; developers use &Linux;, &kde; runs smoothly on a wide range of systems. You may, however, need to tweak the source code a bit to get &kde; to compile on a not-so-popular variant of &UNIX;, or if you are not using the &GNU; development tools, in particular the &gcc; compiler. +For an almost complete list of systems &kde; is running on, please refer to this list of systems for KDE + + + + + +Is &kde; a window manager? + + +No, &kde; is not a window manager. While &kde; includes a very sophisticated window manager (&twin;), &kde; is much more than that. It is a full-blown Integrated Desktop Environment. +&kde; provides a complete desktop environment, including a web browser, a file manager, a window manager, a help system, a configuration system, uncountable tools and utilities, and an ever increasing number of applications, including but not limited to mail and news clients, drawing programs, a &PostScript; and a &DVI; viewer and so forth. + + + + + +Is &kde; a CDE, &Windows; 95 or &Mac; OS clone? + + +No, &kde; is not a clone. Specifically &kde; is not a CDE or &Windows; clone. While the &kde; developers have and will continue to glean the best features from all existing desktop environments, &kde; is a truly unique environment that has and will continue to go its own way. + + + + + +Is &kde; free software? + + +Yes, &kde; is free software according to the &GNU; General Public Licence. All &kde; libraries are available under the LGPL making commercial software development for the &kde; desktop possible, but all &kde; applications are licensed under the GPL. +&kde; uses the &Qt; C++ crossplatform toolkit, which is also released (since version 2.2) under the GPL. +It is absolutely legal to make &kde; and &Qt; available on &CD-ROM; free of charge. No runtime fees of any kind are incurred. + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/misc.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/misc.docbook new file mode 100644 index 00000000000..d0047f27cad --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/misc.docbook @@ -0,0 +1,198 @@ + + + +Miscellaneous questions + + + + +Why does &kde; use &Qt;? + + +&Qt; is a very sophisticated toolkit that provides everything that is needed to build a modern user interface. &Qt; is written in C++, thus allowing object-oriented development which ensures efficiency and code reuse in a project the size and scope of &kde;. In our opinion there is no better toolkit available for &UNIX; systems and that it would have been a grave mistake to try to build &kde; on anything but the best. + + + + + +Why does &kde; not use gtk, xforms, xlib, whatever? + + +There are a number of toolkits available. To provide a consistent user interface and to keep used resources such as memory to a minimum, &kde; can use only one of them. &Qt; was selected for the reasons mentioned above. + + + + + +But &Qt; isn't free, is it? + + +It is! As of September 4, 2000, version 2.2 of the &Qt; libraries were licensed under the GPL, thereby fulfiling all aspects of free software. + + + + + +Does &kde; have terminal emulators with transparent background? + + +Yes and no. &konsole; has the ability to simulate transparency by redrawing the background of the window inside the &konsole; window. This gives the illusion of transparency, but if you place &konsole; on top of another window, the transparency is lost. Eterm should work fine under &kde; if you desire more complete transparency. + + + + + +How do I create icons for non-&kde; applications that I can put in the K menu? Where do these icons go? + + +Create them using your favourite image manipulator, for example, GIMP, or the &kde; Icon Editor and put them in $TDEDIR/share/icons(/mini) or $HOME/.trinity/share/icons(/mini). + + + + + +What about &kde; programs that do not have icons? How do I get them into the menu? + + +Use &kmenuedit;. To access it use the &RMB; on the K button and select Menu Editor. + + + + + +Does &kde; have a graphical &FTP; client? + + +Yes, and it is none other than your favourite file manager, &konqueror;. You can drag and drop remote files into local folders. + + + + + +How do I exit &kde;? + + +Simply click on the K button and select Logout. In addition, if you right click on an empty area of the desktop, you will be presented with a menu containing logout as one of the options. Depending on your configuration of the &X-Window;, &Ctrl;&Alt;&Backspace; might also do the trick by killing the X server, but its use prevents session management and cannot be recommended. + + + + + +Is there a program that checks for new mails at my ISP if and only if I am online? + + +&korn; will do the job. If you are not connected, it will just sit there (idling). + + + + + +Is it really necessary to upgrade to the latest version? + + +We recommend to always use the latest stable release. If you don't, it will probably be difficult to get answers to your questions. If you have a problem with an old version, the answer will probably be Please upgrade and try again. Note that new versions also sometimes fix security problems. + + + + + +How do I copy and paste in &kde;? + + +The simplest method is to use your mouse: + +Highlight the text you want to copy by holding down the &LMB; and dragging across the text. +Go to the destination area; depending on your configuration, you might need to click it using the &LMB; to give it focus. +Click the &MMB; to paste. If you have a two button mouse and are emulating a three button mouse, push both buttons simultaneously. + + + + + + +How do I convert the default &RedHat; menus into a menu in the K menu? + + +Click on the K button and select SystemAppfinder. + + + + + +What is CVS? + + +It stands for Concurrent Versions System. It is a version control system and is based on RCS (Revision Control System), but offers more functionality. It is used to maintain source code under development. It will keep multiple versions of things (handy if you broke something and have to back up and get a clean old version), and allows people remote access over the Net to pick up the latest source code and even to check in new files if they have permission. It is also open source (you pay for support if you want it), and since it is free it is the system of choice for people writing more free products, such as &kde;. + + + + + +Does &kde; support dual screen (Xinerama)? + + +Yes, you need to have a multi-headed X server (⪚ MetroX or XFree86 4.0 and above) and a &kde; >= 2.2.1 + + + + + +Why does Drag and Drop not work with Xinerama? + + +You should upgrade to XFree86 4.2.0 for this to work properly. + + + + + + +How do I check which version of &kde; I am using? + + +Fire up your &kde; Control Centre. It comes up with an Info Screen including the version of &kde; The &kde; version is also included in the application's About dialogue. + + + + + +Can I write commercial software for &kde;? + + +You can use the &kde; libraries to write commercial and closed source as well as commercial and open source software. If you write open source software you can use the &Qt; free edition. But if you write closed source software you may not use the &Qt; free edition; you need to obtain the &Qt; professional edition from Troll Tech. If you want more information, please contact Troll Tech directly. + + + + + +How do I go about creating themes and icons? + + +Go see http://artist.kde.org. + + + + + +Is KLyX dead? + + +Yes. But future versions of LyX will be &GUI; independent. Check the progress of the various &GUI; frontends here. + + + + + +How can I get to know about development updates? + + +You might want to subscribe to the various &kde; mailing lists available, especially kde-cvs, which lists all commits done to the &kde; CVS repository. Check http://lists.kde.org if you want to read without subscribing. + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/moreinfo.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/moreinfo.docbook new file mode 100644 index 00000000000..a5fe88c3f7a --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/moreinfo.docbook @@ -0,0 +1,118 @@ + + + +Getting more information + + + + +Where is the &kde; homepage? + + +The &kde; homepage is located at http://www.kde.org. If you prefer a local mirror, there are several to choose from. For a current list of web site mirrors sorted by location, please visit http://www.kde.org/mirrors/web.php. + + + + + +Is there a &kde; mailing list? + + +There are several &kde; mailing lists. Each focuses on a different aspect of &kde;. Some are for developers, so they are not discussed in detail. Some of the more important lists that users might be interested in are: + +kde +This is the main &kde; mailing list for general discussions. + +kde-announce +This list is used to announce new versions of &kde; as well as new tools and applications. + +kde-look +This is the list that deals with questions about look and feel, and general user interface considerations. + + +For the complete list of mailing lists available, please refer to http://www.kde.org/mailinglists/. +Please note that it is not a good idea to ask questions which are already answered in this &FAQ;. + + + + + +How do I subscribe/unsubscribe to these lists? + + +To subscribe, send an email to list-request, that is: + +kde-request@kde.org +kde-announce-request@kde.org +kde-user-request@kde.org +kde-look-request@kde.org + +The email must contain subscribe your_email_address in the subject. +To unsubscribe, send an email to list-request, that is: + +kde-request@kde.org +kde-announce-request@kde.org +kde-user-request@kde.org +kde-look-request@kde.org + +The email must contain unsubscribe your_email_address in the subject. Never send subscribe/unsubscribe request to the mailing lists directly! Use the list-request instead. +There is also a complete list of all &kde;-related mailing lists, and a web interface for subscribing and unsubscribing located at http://master.kde.org/mailman/listinfo. + + + + + +Is there a mailing list archive? + + + +Yes, there is a searchable mailing list archive hosted by Progressive Computer Concepts. The &URL; is http://lists.kde.org. There you will see a folder listing of the mailing lists. Note that you can only do a subject/author search at this level. You probably will not find what you want doing this kind of search. + +To do a body search, you have to enter one of the mailing lists. Just click on the folder you want to search (⪚ kde or kde-user) and then the pull-down menu by the search box will default to Body searches. To be thorough, you should probably search the kde, kde-user, and kde-devel folders. + + + + + + +Is there a newsgroup about &kde;? + + +Yes, there is! It is at comp.windows.x.kde. In addition, there is also a German newsgroup at de.alt.comp.kde. Please note that it is not a good idea to ask questions which are already answered in this &FAQ;. + + + + + +Are there any other &kde;-related &FAQ;s? + + +Yes. Here is a list of them: + +&kde; &FAQ; +&konqueror; &FAQ; +aRts sound server documentation + + + + + + + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/nontdeapps.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/nontdeapps.docbook new file mode 100644 index 00000000000..44b0272aee4 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/nontdeapps.docbook @@ -0,0 +1,32 @@ + + + +&kde; with non-&kde; applications + + + + + + +My non-&kde; applications like &Emacs; and kterm are running amok with strange colours! + + +Start the &kde; Control Centre and in Appearance & ThemesColours uncheck the Apply colours to non-TDE applications checkbox and click Apply. + + + + +How can I set my default web browser to be something other than &konqueror;? + +If you are using &kde; 3.3 or later, open up the &kcontrolcenter; and navigate to the TDE ComponentsComponent Chooser panel. Select Web Browser from the list on the left, then select Open http and https URLs in the following browser: and type in the name of the browser (⪚ mozilla, firefox, opera, &etc;) in the textbox. + + + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/notrelated.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/notrelated.docbook new file mode 100644 index 00000000000..c1b5011ed6c --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/notrelated.docbook @@ -0,0 +1,165 @@ + + + +Not really &kde;-related, but frequently asked nevertheless. + + + + +How do I change the screen resolution? + + +Use &Ctrl;&Alt;+ and &Ctrl;&Alt;- to cycle through the resolutions you have defined in XF86Config (maybe under /etc/X11; poke around first). If you prefer to get your hands dirty, you can always edit the file directly. By placing your favourite resolution at the beginning (or making it the only one listed), &X-Window; will always start up with that resolution. Always make a backup copy of your XF86Config file before you start editing it. Errors in this file can render &X-Window; unusable. +These instructions are only valid if you are running version 3.3.x of the XFree86 server. If you are running XFree86 4.x, you must consult with the XFree86(TM): Home Page. + + + + + +How do I change the colour depth? + + +There is no way you can do this on the fly. You can either start &X-Window; using startx where number can be 8, 16, 24 or 32, depending on the depth you want. Alternatively, if you are using xdm/&tdm;, you need to edit /etc/X11/xdm/Xservers (may vary) and enter :0 local /usr/X11R6/bin/X -bpp 16 for 16 bit colour depth. +You can also edit the XF86Config file and add a line like DefaultColorDepth number to Section "Screen". The next time you start X, it will run with the newly-configured colour depth. + + + + + +What can I do if I am using a 2-button mouse? + + +Go buy a 3-button one, or use third button emulation. The third button is emulated by pressing both the &LMB; and the &RMB; together. You would need to enable in your XF86Config file. + + + + + +What is a "sticky" window? + + +In a virtual desktop environment with multiple virtual desktops, a "sticky" window will stay put on the screen when you switch between desktops, as if sticking to the glass of the screen. Xclock is a typical candidate for sticking, as you need to run only one instance of it, and it always stays with you. + + + + + +How do I replace the "X" mouse pointer with an arrow? + + +The various types of cursor available in X are defined in X11/cursorfont.h. You can change it using xsetroot -cursor_name name_of_cursor. For example, I have the following in my .Xclients: +xsetroot -cursor_name left_ptr + +This will create the common left-angled pointer. To see other alternatives, type xfd -fn cursor. And of course, do not forget that man xsetroot is your friend. + + + + + +How do I extract/install diff files? + + +To generate a context-diff suitable for patching, use diff -u old-file new-file > patchfile. To apply the diff to a file (i.e. "patch the file"), execute patch < patchfile. + + + + + +How do I get &Linux; to mount the floppy device for use with both DOS and ext2 formatted floppies? + + +Just specify the filesystem type as auto in /etc/fstab. Auto detection works fine for DOS and ext2. + + + + + +How do I start &kde; with the Num Lock on? + + +Have you tried man setleds? In addition, you might want to edit your $HOME/.Xmodmap and put the following lines in: +! redefines numeric keypad to be used without NumLock +keycode 79 = 7 +keycode 80 = 8 +keycode 81 = 9 + +keycode 83 = 4 +keycode 84 = 5 +keycode 85 = 6 + +keycode 87 = 1 +keycode 88 = 2 +keycode 89 = 3 + +keycode 90 = 0 +keycode 91 = comma +keycode 86 = plus + +! deactivates NumLock key +keycode 77 = + +Other possible alternatives: + +xkeycaps: right clicking should allow edits. You may have to do this as root. +man XF86Config and look under section Keyboard. +Install NumLockX, which is available from http://dforce.sh.cvut.cz/~seli/en/numlockx. + + + + + + +How do I take window or desktop screenshots? + + +Use &ksnapshot;. + + + + + +Is there a tool to make webpages? + + +Yes, and there are a lot of them out there, including StarOffice, &Netscape; Composer, and XEmacs. There are also many &kde; applications. To find the most current list, go to kde-apps.org: The Latest in &kde; Applications and search for web development. Try as many as possible and choose the one most suitable to your needs. + + + + + +What do all those acronyms like AFAIK mean? + + +AAMOF: as a matter of fact +AFAIK: as far as I know +AISE: as I see it +BFN: bye for now +BION: believe it or not +BRB: be right back +BTW: by the way +CMIIW: correct me if I am wrong +FUD: fear, uncertainty, and doubt +FWIW: for what it's worth +FYI: for your information +HTH: hope this helps +IIRC: if I recall correctly +IMHO: in my humble opinion +LOL: laughing out loud +MYOB: mind your own business +PITA: pain in the ass +ROTFL: rolling on the floor laughing +RTFM: read the fine manual +SOP: standard operating procedure +TIA: thanks in advance +YMMV: your mileage may vary + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/panel.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/panel.docbook new file mode 100644 index 00000000000..60718985eb0 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/panel.docbook @@ -0,0 +1,56 @@ + + + +The panel + + + + +How do I add applications to the &kde; panel (&kicker;)? + + +There are several ways to add an application to the panel, of which the easiest is to right-click on the panel, and from the context menu which appears, select Panel MenuAddApplication Button and then the application for which you want to add a link. +For more ways of adding buttons to the panel, refer to the &kicker; Handbook. + + + + + + + + +My desktop panel has disappeared. How can I get it back? + + + + +The panel disappearing is usually due to it crashing. This is most often caused by loading an applet that has a fatal bug or due to a bad installation of &kde; and/or the panel. + +The easiest way to get the panel back is to launch the Run Command window by pressing &Alt;F2 and entering kicker and then pressing the OK button. + +If the panel continues to disappear, you may wish to either remove or edit by hand your $TDEHOME/share/config/kickerrc file, where $TDEHOME is usually ~/.trinity. If you choose to edit it by hand, start by removing the applet entry groups. + + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/tdeapps.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/tdeapps.docbook new file mode 100644 index 00000000000..d894f7d4c6f --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/tdeapps.docbook @@ -0,0 +1,93 @@ + + + +&kde; applications + + + + +&kppp; + + + +Many &kde; users report problems using &kppp;. But before you complain about &kppp;, make sure you have already checked the following: + + +Can you dialup to your ISP without using &kppp;? If you cannot, then perhaps &kppp; is not the culprit after all. +Have you gone through the &kppp; documentation at least three times and followed its instructions and trouble-shooting suggestions? + +The &kppp; documentation can be accessed through the &kde; Help Centre. Last, but not least, the &kppp; homepage is at http://ktown.kde.org/~kppp/. +Now, if you still encounter problems, here's what might help you solve them: + +How do I change the &MTU; setting in &kppp;? +Open up the &kppp; dialogue box and select Setup. Choose an existing account and click Edit, or New to create a new dialup account. Select the Dial tab and click Arguments. Type what you want to change in the Argument textbox (⪚ mtu 296) and click Add. When you are satisfied, click Close. +To check whether the options took, do one of the following: + + +In a terminal window, run /sbin/ifconfig ppp0 and look at the reported &MTU; in the output. It should match your request. + +Add and (each on a separate line) to your /etc/ppp/options file and restart your &PPP; session. You will find debugging messages in /var/log/messages, including &MRU; and &MTU; settings. + +If you want, the &MRU; and &MTU; settings can be added to the options file, one complete setting per line, no quotes or dashes. + + +&kppp; connects at a slower speed than normal. +The following might do the trick: + +Try executing setserial spd_hi. +The default &MTU; value is 1500, which maybe too large for a dialup connection. Try changing it to a smaller value like 296 or 576. +Check in your $HOME/.trinity/share/config for the kppprc. Ensure the correct modem speed is actually defined there. + + + + + + + + +&konsole; + + + + + +How do I page-up or page-down? +Use ShiftPage Up and ShiftPg Dn. + + + +How do I perform a simple copy from &konsole; to anything else? +When I do a ls, first I select with the mouse the desired text, press &Ctrl;C, then I make the target application active, point the mouse to the relevant part and press &Ctrl;V. Alternatively, highlight the text by dragging with the &LMB; down and paste by clicking with the &MMB; (or both buttons if you are using a 2 button mouse with 3 button emulation). + + + +Why can't &konsole; find the 9x15 and the 2 console bitmap fonts installed with &kde;? + + +FontConfig must find the three fonts installed in: $TDEDIR/share/fonts. If the &kde; install does not install these fonts in a directory that already exists (⪚ /usr/share/fonts) then you must add this directory to the configuration file /etc/fonts/local.conf. This should be the first line after <fontconfig>. For example: +<fontconfig> +<dir>/usr/kde3/share/fonts</dir> +</fontconfig> + After adding the directory, run (as root): fc-cache -v and check that it found the directory. + + + + + + + + + +&kmail; + + +&kmail; has its own home page at http://kmail.kde.org where an FAQ is available. + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/tips.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/tips.docbook new file mode 100644 index 00000000000..af3d0ad2b57 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/tips.docbook @@ -0,0 +1,92 @@ + + + +Useful tips + + + + +Reading documentation in &kde; + + +Pop up the Run Command window (&Alt;F2 by default) and type: + +man:command for man pages. It even unpacks on the fly if the man pages are gzipped. + + + +info:command for info pages. + + + +help:kdeappname for &kde; application help pages. + + + + + +You can also enter any of these in the Location text box in &konqueror;. +Or you can use the &kde; Help Centre if you are using &kde; 2. Simply start the &kde; Help Centre by clicking on the icon (the blue book with the yellow key) on the toolbar. Once the &kde; Help Centre has loaded, the window on the left will contain an entry called Unix manual pages. Click once on this entry, and you can browse through all the installed manual pages on your system. + + + + + +Move or resize windows quickly + + +To move a window, use &Alt;left mouse button. &Alt;right mouse button will resize the window. Last but not least, &Alt;middle mouse button raises/lowers the window. The &kde; Control Centre allows you to change these mouse bindings. + + + + + +Killing windows in &kde; + + +There is a standard keybinding (&Ctrl;&Alt;&Esc;) that gives you a skull & crossbones cursor. Click that cursor on a window to kill it. The keybindings are viewable/changeable from the &kde; Control Centre. Using this option kills the program forcibly. Data may be lost, and some processes related to the program may remain active. Use only as a last resort. + + + + + + +What if something is so wrong that I ca not even get the skull & crossbones cursor? How do I get out of a total lockup? + + +These kind of locks tend to occur when an application locks up while it has a so called mouse/keyboard grab. When that happens you can try to select a virtual text console with &Ctrl;&Alt;F1 and login. With the following command you will get a list of all running processes: + + ps | more + +By killing the process that has the mousegrab, your desktop will come to life again. Unfortunately you ca not see which process that is, so you will have to find out through trial and error. To kill a process use: + + kill pid + +Here pid is the process id of the process, which is the first number on each line reported by ps . + +You can switch back to the desktop with &Ctrl;&Alt;F7 (or F8 through F9 depending on your operating system) to see if things work again. When you press &Alt;Tab you should get a response from the window manager. If not, you need to get back to the text console and try to kill another process. + +Good candidates to kill are: the application you were working with, &kicker;, &klipper; and &kdesktop;. + + + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/winmng.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/winmng.docbook new file mode 100644 index 00000000000..f548851aaa1 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/faq/winmng.docbook @@ -0,0 +1,85 @@ + + + + + +The window manager + +The default window manager provided by &kde; is the K Window Manager (&twin;). Please read The K Window Manager Handbook (which should be accessible from the &kde; Help Centre) for usage information. + + + + +Are there keyboard shortcuts for &twin; operations? + + +Yes. Please refer to "The K Window Manager Handbook" for the list of shortcuts available. + + + + + +Can I define my own set of keyboard shortcuts? + + +Yes. Launch the &kde; Control Centre and select Regional & AccessibilityKeyboard Shortcuts to configure window manager bindings like maximising windows, &etc;. + + + + + +When I "iconify" a window, it disappears. Where does it go? + + +With many &X-Window; &GUI;s, the minimise button (a little dot) will erase the window that the program is running in and create, instead, an icon on the desktop. &kde; does not do this. Instead, when a window is iconified it is simply hidden (but the program is still running). +There are a few ways to access disappeared windows: + + +If you are running the taskbar part of &kicker;, you can choose to have a list of tasks displayed on your desktop. Iconified tasks will have their names displayed in grey. + + +If you click the &MMB; on the root window (&ie;, the background of the desktop), &twin; will give you a list of all available tasks. + + + + + + + +How do I maximise windows only vertically or horizontally? + + +Provided your window is not already maximised, clicking on the maximise button with the &LMB;/&MMB;/&RMB; will maximise fully/vertically/horizontally respectively. + + + + + +What is shading a window? + + +By shading a window we mean rolling up the window leaving just the title bar visible. You can do this by double clicking on the window title bar. + + + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/CMakeLists.txt b/tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/CMakeLists.txt new file mode 100644 index 00000000000..052340c91f0 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/CMakeLists.txt @@ -0,0 +1,6 @@ +# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer + +tde_create_handbook( + DESTINATION khelpcenter/glossary + LANG en_GB +) diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/Makefile.am b/tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/Makefile.am new file mode 100644 index 00000000000..ff629e8b913 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = en_GB +SUBDIRS = $(AUTODIRS) +KDE_DOCS = khelpcenter/glossary +KDE_MANS = AUTO diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/index.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/index.docbook new file mode 100644 index 00000000000..9b7db6216bd --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/index.docbook @@ -0,0 +1,183 @@ + + + + + + +]> + + +&glossary-tdeprinting; + Technologies + + IO Slave + IO Slaves enable &kde; applications to access remote resources as easily as local resources (making them network transparent). Remote resources (⪚ files) might be stored on SMB shares or similar. +SMB &kde; + + + TDEIO + The &kde; Input/Output system which makes use of so-called IO Slaves. +IO Slave &kde; + + + KParts + KParts is an embedding technology which allows &kde; applications to embed other &kde; applications. For example, the text view used by &konqueror; is a KPart. + &konqueror; + + + + KSycoca + KSycoca (&kde; System Configuration Cache) is a configuration cache which, for example, guarantees fast access to the menu entries. + KBuildSycoca + + + + + + XFree86 + + Antialiasing + If mentioned in context with &kde;, antialiasing often means the smoothing of the fonts visible on the screen. &Qt; version 2.3.0 or higher used together with XFree86 4.x makes this possible under &kde; as well. +&kde; &Qt; + + + &X-Server; + The &X-Server; represents a basic layer upon which the various &GUI;s like &kde; are built. It manages the basic mouse and keyboard input (from the local host as well as from remote hosts) and provides elementary graphic routines to draw rectangles and other primitives. +&kde; &GUI; + + + + + Applications + + KBuildSycoca + KBuildSycoca is a command line program and regenerates the so-called KSycoca. This is useful, for example, if some or all modules in &kcontrol; are missing. +KSycoca &kcontrol; + + + &kcontrol; + This is the project and filename of the &kde; control centre. &kcontrol; allows you to customise virtually every configuration option of &kde;. + &kde; + + + + &kicker; + &kicker; is the nickname as well as project name of the &kde; panel. +&kde; Panel + + + &konqueror; + &konqueror; is a filemanager, web browser, picture viewer and more, and a core part of the &kde; project. You can find more information about &konqueror; at www.konqueror.org. + &kde; + + + + &ksirc; + &ksirc; is the default IRC client, which is shipped with &kde;. You can use &ksirc; to chat with anyone on an IRC network. + IRC + + + + + + Desktop Terminology + + Drag and Drop + This concept tries to replace many actions like copying files from one place to another by a certain mouse movement, ⪚ clicking on an icon in a &konqueror; window, moving the mouse to another window while keeping the mouse button pressed, and releasing the mouse button (dropping the object) copies files. + &konqueror; + + + + &GUI; + Abbreviation for Graphical User Interface. Every desktop environment (like &kde;) is a &GUI;. Most &GUI;s feature mouse support and/or windows to manage the programs. + &kde; + + + + &kde; + Abbreviation for K Desktop Environment, a leading &GUI; for &UNIX;-based systems. You can find more detailled information at www.kde.org. + &GUI; + + + + GNOME + + GNU Network Object Model Environment, one of the leading &UNIX; &GUI;s. + &GUI; + + + + Panel + Refers to the panel (also known as &kicker;) which often resides at the bottom of the screen. +&kde; &kicker; + + + ripping + The process of reading audio data from a &cdrom; and storing it on the hard disk. + + + + + + &kde; Development + + &Qt; + The &GUI; of &kde; is built on top of the &Qt; toolkit, which provides many graphical elements (so-called Widgets) which are used to construct the desktop. You can find more information about &Qt; at www.trolltech.com. +&kde; &GUI; Widget + + + i18n + Abbreviation for internationalisation. &kde; supports many different languages, and several i18n techniques make it easy to translate the &GUI; as well as the accompanying documents of &kde; into all these languages. More information about the i18n process is available at i18n.kde.org. +&kde; &GUI; + + + l10n + Abbreviation for localisation, the process of adapting a program to the local environment. This includes ⪚ the currency used for monetary values or the time format. + i18n + + + + Widget + Graphical elements like scrollbars, buttons or input fields which are used by &kde; to construct the &GUI;. +&kde; &GUI; + + + CVS + + Concurrent Version System. The CVS is a very elegant way of managing file versions that allow more than one developer to easily work on the same project. You can find a description of how to get the latest (developer) version of the &kde; sources via anonymous CVS on http://www.kde.org/anoncvs.html. More about CVS is available at www.cvshome.org. + + + + + + Miscellaneous + + RFC + Request For Comment. A common way to publish new protocol ideas or procedures for evaluation of the Internet community. Though RFCs are not mandatory, many applications try to adhere to them, once they have been approved by the community. More information about RFCs can be found at the RFC Homepage. + + + + + + Various protocols + + SMB + Server Message Block. A network protocol used in &Microsoft; &Windows; networks to access the filesystems of other computers. + IO Slave + + + + IRC + Internet Relay Chat. A protocol defined in RFC 1459, which handles the specification to enable real time text chat. + RFC + + + + host + This can either be a name from your /etc/hosts file (mycomputer), an Internet name (www.kde.org) or an IP-Address (192.168.0.10). + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/tdeprintingglossary.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/tdeprintingglossary.docbook new file mode 100644 index 00000000000..9e3ffae8b92 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/glossary/tdeprintingglossary.docbook @@ -0,0 +1,458 @@ + + + + Printing + + + + ACLs + Abbreviation for Access Control Lists; ACLs are used to check for the access by a given (authenticated) user. A first rough support for ACLs for printing is available from &CUPS;; this will be refined in future versions. + Authentication + + + + + AppSocket Protocol + AppSocket is a protocol for the transfer of print data, also frequently called "Direct TCP/IP Printing". &Hewlett-Packard; have taken AppSocket, added a few minor extensions around it and been very successful in renaming and marketing it under the brand "&HP; JetDirect"... +&HP; JetDirect Protocol Direct TCP/IP Printing + + + + APSfilter + APSfilter is used mainly in the context of "classical" &UNIX; printing (BSD-style LPD). It is a sophisticated shell script, disguised as an "all-in-one" filtering program. In reality, APSfilter calls "real filters" to do the jobs needed. It sends printjobs automatically through these other filters, based on an initial file-type analysis of the printfile. It is written and maintained by Andreas Klemm. It is similar to Magicfilter and mostly uses Ghostscript for file conversions. Some Linux Distributions (like &SuSE;) use APSfilter, others Magicfilter (like &RedHat;), some have both for preference selection (like *BSD). &CUPS; has no need for APSfilter, as it runs its own file type recognition (based on &MIME; types) and applies its own filtering logic. +Ghostscript Magicfilter &MIME;-Types printcap + + + + Authentication + Proving the identity of a certain person (maybe via username/password or by means of a certificate) is often called authentication. Once you are authenticated, you may or may not get access to a requested ressource, possibly based on ACLs. + ACLs + + + + + Bi-directional communication + In the context of printing, a server or a host may receive additional information sent back from the printer (status messages &etc;), either upon a query or unrequested. AppSocket ( = &HP; JetDirect), &CUPS; and IPP support bi-directional communication, LPR/LPD and BSD-style printing do not... +AppSocket Protocol &CUPS; Direct TCP/IP Printing &HP; JetDirect IPP LPR/LPD + + + + BSD-style Printing + Generic term for different variants of the traditional &UNIX; printing method. Its first version appeared in the early 70s on BSD &UNIX; and was formally described in RFC 1179 only as late as 1990. At the time when BSD "remote" printing was first designed, printers were serially or otherwise directly connected devices to a host (with the Internet hardly consisting of more than 100 nodes!); printers used hole-punched, continuous paper, fed through by a tractor mechanism, with simple rows of ASCII text mechanically hammered on to the medium, drawn from a cardboard box beneath the table. It came out like a zig-zag folded paper "snake". Remote printing consisted of a neighbouring host in the next room sending a file asking for printout. How technology has changed! Printers generally use cut-sheet media, they have built-in intelligence to compute the raster images of pages after pages that are sent to them using one of the powerful page description languages (PDL). Many are network nodes in their own right, with CPU, RAM, a hard disk and their own Operation System, and are hooked to a net with potentially millions of users... It is a vast proof of the flexible &UNIX; concept for doing things, that it made "Line Printing" reliably work even under these modern conditions. But time has finally come now to go for something new -- the IPP. It is strong proof of the flexibility of &UNIX;; that "Line Printing" works reliably, even under these modern conditions. But time has finally come now to go for something new -- the IPP. +IPP &CUPS; LPR/LPD printing + + + + &CUPS; + Abbreviation for Common UNIX Printing System; &CUPS; is the most modern &UNIX; and Linux printing system, also providing cross-platform print services to &Microsoft; &Windows; and Apple &MacOS; clients. Based on IPP, it does away with all the pitfalls of old-style BSD printing, providing authentication, encryption and ACLs, plus many more features. At the same time it is backward-compatible enough to serve all legacy clients that are not yet up to IPP, via LPR/LPD (BSD-style). &CUPS; is able to control any &PostScript; printer by utilizing the vendor-supplied PPD (PostScript Printer Description file), targeted originally for &Microsoft; Windows NT printing only. &kde; Printing is most powerful if based on &CUPS;. +ACLs Authentication BSD-style printing IPP TDEPrint LPR/LPD PPD + + + + + &CUPS;-FAQ + Currently only available in German (translation is on the way), the &CUPS;-FAQ is a valuable resource to answer many questions that anyone new to &CUPS; printing might have at first. + TDEPrint Handbook + + + + + + &CUPS;-O-Matic + &CUPS;-O-Matic was the first "Third Party" plugin for the &CUPS; printing software. It is available on the Linuxprinting.org website to provide an online PPD-generating service. Together with the companion cupsomatic Perl-Script, that needs to be installed as an additional &CUPS; backend, it redirects output from the native pstops filter into a chain of suitable Ghostscript filters. Upon completion, it passes the resulting data back to a &CUPS; "backend" for sending to the printer. In this way, &CUPS;-O-Matic enables support for any printer known to have worked previously in a "classical" Ghostscript environment. If no native &CUPS; support for that printer is in sight... &CUPS;-O-Matic is now replaced by the more capable PPD-O-Matic. +cupsomatic PPD-O-Matic Foomatic + + + + + cupsomatic + The Perl script cupsomatic (plus a working Perl installation on your system) is needed to make any &CUPS;-O-Matic (or PPD-O-Matic) generated PPD work with &CUPS;. It was written by Grant Taylor, author of the Linux Printing HOWTO and Maintainer of the printer database at the Linuxprinting.org website. +&CUPS;-O-Matic Foomatic cupsomatic + + + + Daemon + Abbreviation for Disk and execution monitor; Daemons are present on all &UNIX; systems to perform tasks independent of user intervention. Readers more familiar with &Microsoft; &Windows; might want to compare daemons and the tasks they are responsible with "services". One example of a daemon present on most legacy &UNIX; systems is the LPD (Line Printer Daemon); &CUPS; is widely seen as the successor to LPD in the &UNIX; world and it also operates through a daemon. + SPOOLing + + + + + Database, Linuxprinting.org + Already years ago, when Linux printing was still really difficult (only command line printing was known to most Linux users, no device specific print options were available for doing the jobs), Grant Taylor, author of the "Linux Printing HOWTO", collected most of the available information about printers, drivers and filters in his database. With the emerging &CUPS; concept, extending the use of PPDs even to non-PostScript printers, he realised the potential of this database: if one puts the different datablobs (with content that could be described along the lines "Which device prints with which Ghostscript or other filter?", "How well?", and "What command line switches are available?") into PPD-compatible files, he could have all the power of &CUPS; on top of the traditional printer "drivers". This has now developed into a broader concept, known as "Foomatic". Foomatic extends the capabilities of spoolers other than &CUPS; (LPR/LPD, LPRng, PDQ, PPR) to a certain degree ("stealing" some concepts from &CUPS;). The Linuxprinting Database is not a Linux-only stop -- people running other &UNIX; based OSes (like *BSD or &MacOS; X) will also find valuable information and software there. +Foomatic Linuxprinting database + + + + Direct TCP/IP Printing + This is a method that often uses TCP/IP port 9100 to connect to the printer. It works with many modern network printers and has a few advantages over LPR/LPD, as it is faster and provides some "backchannel feedback data" from the printer to the host sending the job. +AppSocket Protocol &HP; JetDirect Protocol + + + + + Drivers, Printer Drivers + The term "printer drivers", used in the same sense as on the &Microsoft; &Windows; platform, is not entirely applicable to a Linux or &UNIX; platform. A "driver" functionality is supplied on &UNIX; by different modular components working together. At the core of the printer drivers are "filters". Filters convert print files from a given input format to another format that is acceptable to the target printer. In many cases filters may be connected to a whole filter "chain", where only the result of the last conversion is sent to the printer. The actual transfer of the print data to the device is performed by a "backend". +Filter PPDs + + + + Easy Software Products + Mike Sweet's company, which has contributed a few substantial software products towards the Free Software community; amongst them the initial version of Gimp-Print, the EPM software packaging tool and HTMLDOC (used by the "Linux Documentation Project" to build the PDF versions of the HOWTOs) -- but most importantly: &CUPS; (the 'Common &UNIX; Printing System'). ESP finance themselves by selling a commercial version of &CUPS;, called ESP PrintPro, that includes some professional enhancements. +&CUPS; ESP PrintPro ESP Gimp-Print + + + + Encryption + Encryption of confidential data is an all-important issue if you transfer it over the Internet or even within intranets. Printing via traditional protocols is not encrypted at all -- it is very easy to tap and eavesdrop ⪚ into &PostScript; or PCL data transfered over the wire. Therefore, in the design of IPP, provision was made for the easy plugin of encryption mechanisms (which can be provided by the same means as the encryption standards for HTTP traffic: SSL and TLS). +Authentication &CUPS; IPP SSL TLS + + + + + Epson + Epson inkjets are among the best supported models by Free software drivers, as the company was not necessarily as secretive about their devices and handed technical specification documents to developers. The excellent print quality achieved by Gimp-Print on the Stylus series of printers can be attributed to this openness. They have also contracted Easy Software Products to maintain an enhanced version of Ghostscript ("ESP GhostScript") for improved support of their printer portfolio. + ESP Ghostscript + + + + + + Escape Sequences + The first ever printers printed ASCII data only. To initiate a new line, or eject a page, they included special command sequences, often carrying a leading [ESC]-character. &HP; evolved this concept through its series of PCL language editions until today, having now developed a full-blown Page Description Language (PDL) from these humble beginnings. +PCL PDL + + + + ESC/P + Abbreviation for Epson Standard Codes for Printers. Besides &PostScript; and PCL, Epson's ESC/P printer language is one of the best known. +PCL &PostScript; hpgl + + + + ESP + Abbreviation for Easy Software Products; the company that developed &CUPS; (the "Common &UNIX; Printing System"). +Easy Software Products &CUPS; ESP PrintPro + + + + + ESP Ghostscript + A Ghostscript version that is maintained by Easy Software Products. It includes pre-compiled Gimp-Print drivers for many inkjets (plus some other goodies). ESP Ghostscript will produce photographic quality prints in many cases, especially with the Epson Stylus model series. ESP Ghostscript is GPL-software. +Easy Software Products &CUPS; ESP PrintPro + + + + ESP PrintPro + This professional enhancement to &CUPS; (the "Common &UNIX; Printing System") is sold by the developers of &CUPS; complete with more than 2,300 printer drivers for several commercial &UNIX; platforms. ESP PrintPro is supposed to work "out of the box" with little or no configuration for users or admins. ESP also sell support contracts for &CUPS; and PrintPro. These sales help to feed the programmers who develop the Free version of &CUPS;. + &CUPS; + + + + + Filter + Filters, in general, are programs that take some input data, work on it and pass it on as their output data. Filters may or may not change the data. Filters in the context of printing, are programs that convert a given file (destined for printing, but not suitable in the format it is presently) into a printable format. Sometimes whole "filter chains" have to be constructed to achieve the goal, piping the output of one filter as the input to the next. +Ghostscript RIP + + + + Foomatic + Foomatic started out as the wrapper name for a set of different tools available from Linuxprinting.org These tools aimed to make the usage of traditional Ghostscript and other print filters easier for users and extend the filters' capabilities by adding more command line switches or explain the driver's execution data. Foomatic's different incarnations are &CUPS;-O-Matic, PPD-O-Matic, PDQ-O-Matic, LPD-O-Matic, PPR-O-Matic, MF-O-Matic and Direct-O-Matic. All of these allow the generation of appropriate printer configuration files online, by simply selection the suitable model and suggested (or alternate) driver for that machine. More recently, Foomatic gravitated towards becoming a "meta-spooling" system, that allows configuration of the underlying print subsystem through a unified set of commands (however, this is much more complicated than TDEPrint's &GUI; interface, which performs a similar task with regards to different print subsystems). +&CUPS;-O-Matic PPD-O-Matic cupsomatic + + + + Ghostscript + Ghostscript is a &PostScript; Raster Image Processor (RIP) in software, originally developed by L. Peter Deutsch. There is always a GPL version of Ghostscript available for free usage and distribution (mostly 1 year old) while the current version is commercially sold under another licence. Ghostscript is widely used inside the Linux and &UNIX; world for transforming &PostScript; into raster data suitable for sending to non-&PostScript; devices. +&PostScript; RIP + + + + Gimp-Print + Contrary to its name, Gimp-Print is no longer just the plugin to be used for printing from the popular Gimp program -- its codebase can also serve to be compiled into... *...a set of PPDs and associated filters that integrate seamlessly into &CUPS;, supporting around 130 different printer models, providing photographic output quality in many cases; *...a Ghostscript filter that can be used with any other program that needs a software-RIP; *...a library that can be used by other software applications in need of rasterising functions. +Lexmark Drivers RIP Ghostscript + + + + &HP; + Abbreviation for Hewlett-Packard; one of the first companies to distribute their own Linux printer drivers. -- More recently, the Company has released their "HPIJS" package of drivers, including source code and a Free licence. This is the first printer manufacturer to do so. HPIJS supports most current models of HP Ink- and DeskJets. + + + + + + &HP;/GL + Abbreviation for &HP; Graphical Language; a &HP; printer language mainly used for plotters; many CAD (Computer Aided Design) software programs output &HP;/GL files for printing. +ESC/P PCL &PostScript; + + + + &HP; JetDirect Protocol + A term branded by &HP; to describe their implementation of print data transfer to the printer via an otherwise "AppSocket" or "Direct TCP/IP Printing" named protocol. +AppSocket Protocol Direct TCP/IP Printing + + + + IETF + Abbreviation for Internet Engineering Task Force; an assembly of Internet, software and hardware experts that discuss new networking technologies and very often arrive at conclusions that are regarded by many as standards. "TCP/IP" is the most famous example. IETF standards, as well as drafts, discussions, ideas and useful tutorials, are put in writing in the famous series of "RFCs", which are available to the public and included in most Linux and BSD distributions. +IPP PWG RFC + + + + IPP + Abbreviation for Internet Printing Protocol; defined in a series of RFCs accepted by the IETF with status "proposed standard"; was designed by the PWG. -- IPP is a completely new design for network printing, but it utilises a very well-known and proven method for the actual data transfer: HTTP 1.1! By not "re-inventing the wheel", and basing itself on an existing and robust Internet standard, IPP is able to relatively easily bolt other HTTP-compatible standard mechanisms into its framework: * Basic, Digest or Certificate authentication mechanisms; * SSL or TLS for encryption of transferred data; * LDAP for directory services (to publish data on printers, device-options, drivers, costs or also to the network; or to check for passwords while performing authentication). +&CUPS; PWG IETF RFC TLS + + + + TDEPrint + The new printing functionality of &kde; since version 2.2 consists of several modules that translate the features and settings of different available print subsystems (&CUPS;, BSD-style LPR/LPD, RLPR...) into nice &kde; desktop &GUI; windows and dialogues to ease their usage. Most important for day-to-day usage is "kprinter", the new &GUI; print command. -- Note: TDEPrint does not implement its own spooling mechanism or its own &PostScript; processing; for this it relies on the selected print subsystem -- however it does add some functionality of its own on top of this foundation... +BSD-style printing &CUPS; kprinter TDEPrint Handbook + + + + + TDEPrint Handbook... + ...is the name of the reference document that describes TDEPrint functions to users and administrators. You can load it into Konqueror by typing "help:/tdeprint" into the address field. It is authored and maintained by Kurt Pfeifle. + &CUPS;-FAQ + + + + + kprinter + kprinter is the new powerful print utility that is natively used by all &kde; applications. Contrary to some common misconceptions, kprinter is not a &CUPS;-only tool, but supports different print subsystems. You can even switch to a different print subsystem "on the fly", in between two jobs, without re-configuration. Of course, due to the powerful features of &CUPS;, kprinter is best suited for use with a &CUPS; frontend. kprinter is the successor to "qtcups", which is no longer being actively maintained. It has inherited all the best features of qtcups and added several new ones. MOST IMPORTANT: you can use kprinter with all its features in all non-&kde; applications that allow a customized print command, like gv, Acrobat Reader, Netscape, Mozilla, Galeon, StarOffice, OpenOffice and all GNOME programs. kprinter can act as a "standalone" utility, started from an X-Terminal or a "Mini-CLI" to print many different files, from different folders, with different formats, in one job and simultaneously, without the need to first open the files in the applications! (File formats supported this way are &PostScript;, PDF, International and ASCII Text, as well as many different popular graphic formats, such as PNG, TIFF, JPEG, PNM, Sun RASTER, &etc;) + QtCUPS + + + + + Lexmark + was one of the first companies to distribute their own Linux printer drivers for some of their models. However, those drivers are binary only (no source code available), and therefore cannot be used to integrate into other Free printing software projects. + + + + + Linuxprinting.org + Linuxprinting.org = not just for Linux; all &UNIX;-like OS-es, like *BSD and commercial Unices may find useful printing information on this site. This web site is the home for the interesting Foomatic project, that strives to develop the "Meta Print Spool and Driver Configuration Toolset" (being able to configure, through one common interface, different print subsystems and their required drivers) with the ability to transfer all queues, printers and configuration files seamlessly to another spooler without new configuration effort. -- Also, they maintain the Printing Database; a collection of driver and device information that enables everybody to find the most current information about printer models, and also generate online the configuration files for any spooler/driver/device combo known to work with one of the common Linux or &UNIX; print subsystems. + Linuxprinting database + + + + + + Linuxprinting.org Database + ....Database containing printers and drivers that are suitable for them... ...a lot of information and documentation to be found... ...it is now also providing some tools and utilities for easing the integration of those drivers into a given system... ...the "Foomatic" family of utilities; being the toolset to make use of the database for most of the commonly used print subsystems, for generating "on the fly" working configurations for your printer model. + Foomatic + + + + + LPR/LPD printing + LPR == some people translate Line Printing Request, others: Line Printer Remote. + BSD-style printing + + + + + Magicfilter + Similarly to the APSfilter program, Magicfilter provides automatic file type recognition functions and, base on that, automatic file conversion to a printable format, depending on the target printer. + APSfilter + + + + + &MIME;-Types + Abbreviation for Multipurpose (or Multimedia) Internet Mail Extensions; &MIME;-Types were first used to allow the transport of binary data (like mail attachments containing graphics) over mail connections that were normally only transmitting ASCII characters: the data had to be encoded into an ASCII representation. Later this concept was extended to describe a data format in a platform independent, but at the same time non-ambiguous, way. From &Windows; everybody knows the .doc extensions for &Microsoft; Word files. This is handled ambiguously on the &Windows; platform: .doc extensions are also used for simple text files or for Adobe Framemaker files. And if a real Word file is renamed with a different extension, it can no longer be opened by the program. &MIME; typed files carry a recognition string with them, describing their file format based on main_category/sub_category. Inside IPP, print files are also described using the &MIME; type scheme. &MIME; types are registered with the IANA (Internet Assigning Numbers Association) to keep them unambiguous. &CUPS; has some &MIME; types of its own registered, like application/vnd.cups-raster (for the &CUPS;-internal raster image format). +&CUPS; Easy Software Products ESP PrintPro Gimp-Print + + + + PCL + Abbreviation for Printer Control Language; developed by &HP;. PCL started off in version 1 as a simple command set for ASCII printing; now, in its versions PCL6 and PCL-X, it is capable of printing graphics and colour -- but outside the &Microsoft; &Windows; realm and &HP-UX; (&HP;'s own brand of &UNIX;), it is not commonly used... +ESC/P &HP;/GL PDL &PostScript; + + + + PDL + Abbreviation for Page Description Language; PDLs describe, in an abstract way, the graphical representation of a page. - Before it is actually transferred into toner or ink laid down on to paper, a PDL needs to be "interpreted" first. In &UNIX;, the most important PDL is &PostScript;. +ESC/P &HP;/GL PCL &PostScript; + + + + Pixel + Abbreviation for Picture Element; this term describes the smallest part of a raster picture (either as printed on paper or as displayed on a monitor by cathode rays or LCD elements). As any graphical or image representation on those types of output devices is composed of pixels, the values of "ppi" (pixel per inch) and &dpi; (dots per inch) are one important parameter for the overall quality and resolution of an image. +Filter Ghostscript &PostScript; Raster + + + + PJL + Abbreviation for Print Job Language; developed by &HP; to control and influence default and per-job settings of a printer. It may not only be used for &HP;'s own (PCL-)printers; also many &PostScript; and other printers understand PJL commands sent to them inside a print job, or in a separate signal. + PCL + + + + + &PostScript; + &PostScript; (often shortened to "PS") is the de-facto standard in the &UNIX; world for printing files. It was developed by Adobe and licensed to printer manufacturers and software companies. As the &PostScript; specifications were published by Adobe, there are also "Third Party" implementations of &PostScript; generating and &PostScript; interpreting software available (one of the best-known in the Free software world being Ghostscript, a powerful PS-interpreter). +ESC/P &HP;/GL PCL PPD + + + + PPD + Abbreviation for PostScript Printer Description; PPDs are ASCII files storing all information about the special capabilities of a printer, plus definitions of the (PostScript- or PJL-) commands to call on a certain capability (like print duplexing). As the explanation of the acronym reveals, PPDs were originally only used for &PostScript; printers. &CUPS; has extended the PPD concept to all types of printers. PPDs for &PostScript; printers are provided by the printer vendors. They can be used with &CUPS; and TDEPrint to have access to the full features of any &PostScript; printer. The TDEPrint Team recommends using a PPD originally intended for use with &Microsoft; Windows NT. PPDs for non-PostScript printers need a companion "filter" to process the &PostScript; print files into a format digestible for the non-PostScript target device. Those PPD/filter combos are not (yet) available from the vendors. After the initiative by the &CUPS; developers to utilise PPDs, the Free Software community was creative enough to quickly come up with support for most of the currently used printer models, through PPDs and classical Ghostscript filters. But note: the printout quality varies from "hi-quality photographic output" (using Gimp-Print with most Epson inkjets) to "hardly readable" (using Foomatic-enabled Ghostscript filters for models rated as "paperweight" in the Linuxprinting.org database). +&CUPS; Linuxprinting.org &PostScript; + + + + PPD-O-Matic + PPD-O-Matic is a set of Perl scripts that run on the Linuxprinting.org web server and can be used online to generate PPDs for any printer that is known to print with Ghostscript. These PPDs can be hooked up to &CUPS;/TDEPrint, as well as used inside PPD-aware applications like StarOffice to determine all different parameters of your printjobs. It is now recommended, in most cases, to use "PPD-O-Matic" instead of the older &CUPS;-O-Matic. To generate a PPD, go to the printer database, select your printer model, follow the link to show the available Ghostscript filters for that printer, select one, click "generate" and finally save the file to your local system. Be sure to read the instructions. Make sure that your local system does indeed have Ghostscript and the filter, which you chose before generating the PPD, installed. +&PostScript; &CUPS;-O-Matic Linuxprinting.org Foomatic + + + + printcap + In BSD-style print systems, the "printcap" file holds the configuration information; the printing daemon reads this file to determine which printers are available, what filters are to be user for each, where the spooling folder is located, if there are banner pages to be used, and so on... Some applications also depend on read access to the printcap file, to obtain the names of available printers. + BSD-style printing + + + + + + Printer-MIB + Abbreviation for Printer-Management Information Base; the Printer-MIB defines a set of parameters that are to be stored inside the printer for access through the network. This is useful if many (in some cases, literally thousands) network printers are managed centrally with the help of SNMP (Simple Network Management Protocol). +PWG SNMP + + + + PWG + Abbreviation for Printer Working Group; the PWG is a loose grouping of representatives of the printer industry that has, in the past years, developed different standards in relation to network printing. These were later accepted by the IETF as RFC standards, like the "Printer-MIB" and the IPP. +&PostScript; IPP Printer-MIB SNMP + + + + print:/ TDEIO Slave + You can use a syntax of "print:/..." to get quick access to TDEPrint resources. Typing "print:/manager" as a Konqueror URL address gives administrative access to TDEPrint. Konqueror uses &kde;'s famous "KParts" technology to achieve that. +IO Slave KParts + + + + + Printer Database + . + Linuxprinting Database + + + + + Qt&CUPS; + Qt&CUPS; and KUPS were the predecessors of TDEPrint; they are now deprecated and no longer maintained. What was good in qtcups is all inherited by "kprinter", the new TDE print dialogue (which is much improved over qtcups); what you liked about kups is now all in the TDEPrint Manager (accessible via the KDE Control Centre or via the URL "print:/manager" from Konqueror) -- with more functionality and less bugs... Its former developer, Michael Goffioul, is now the developer of TDEPrint -- a very nice and productive guy and quick bug fixer... + kprinter + + + + + Raster Image + Every picture on a physical medium is composed of a pattern of discrete dots in different colours and (maybe) sizes. This is called a "raster image". This is as opposed to a "vector image" where the graphic is described in terms of continuous curves, shades, forms and filled areas, represented by mathematical formula. Vector images normally have a smaller file size and may be scaled in size without any loss of information and quality --- but they cannot be output directly, but always have to be "rendered" or "rasterised" first to the given resolution that the output device is capable of... The rasterisation is done by a Raster Image Processor (RIP, often the Ghostscript software) or some other filtering instance. +Pixel Ghostscript &PostScript; Filter RIP + + + + RIP + Abbreviation for Raster Image Process(or); if used in the context of printing, "RIP" means a hardware or software instance that converts &PostScript; (or other print formats that are represented in one of the non-Raster PDLs) into a raster image format in such a way that it is acceptable for the "marking engine" of the printer. &PostScript; printers contain their own PostScript-RIPs. A RIP may or may not be located inside a printer. For many &UNIX; systems, Ghostscript is the package that provides a "RIP in software", running on the host computer, and pre-digesting the &PostScript; or other data to become ready to be sent to the printing device (hence you may perceive a "grain of truth" in the slogan "Ghostscript turns your printer into a &PostScript; machine", which of course is not correct in the true sense of the meaning). +Filter Ghostscript &PostScript; PDL Raster + + + + + RLPR (Remote LPR) + Abbreviation for Remote Line Printing Request; this is a BSD-style printing system, that needs no root privileges to be installed, and no "printcap" to work: all parameters may be specified on the command line. RLPR comes in handy for many laptop users who are working in frequently changing environments. This is because it may be installed concurrently with every other printing sub system, and allows a very flexible and quick way to install a printer for direct access via LPR/LPD. TDEPrint has an "Add Printer Wizard" to make RLPR usage even easier. The kprinter command allows switching to RLPR "on the fly" at any time. +TDEPrint kprinter printcap + + + + + SNMP + Abbreviation for Simple Network Management Protocol; SNMP is widely used to control all types of network node (Hosts, Routers, Switches, Gateways, Printers...) remotely. +PWG Printer-MIB + + + + SSL(3) encryption + Abbreviation for Secure Socket Layer; SSL is a proprietary encryption method for data transfer over HTTP that was developed by Netscape. It is now being replaced by an IETF standard named TLS. + TLS + + + + + + SPOOLing + Abbreviation for Synchronous Peripheral Operations OnLine; SPOOLing enables printing applications (and users) to continue their work as the job is being taken care of by a system daemon, which stores the file at a temporary location until the printer is ready to print. + Daemon + + + + + + TLS encryption + Abbreviation for Transport Layer Security; TLS is an encryption standard for data transfered over HTTP 1.1; it is defined in RFC 2246; although based on the former SSL development (from Netscape) it is not fully compatible with it. + SSL(3) + + + + + + System V-style printing + This is the second flavour of traditional &UNIX; printing (as opposed to BSD-style printing). It uses a different command set (lp, lpadmin,...) to BSD, but is not fundamentally different from it. However, the gap between the two is big enough to make the two incompatible, so that a BSD-client cannot simply print to a System V style print server without additional tweaking... IPP is supposed to resolve this weakness and more. +BSD-style printing IPP + + + + TurboPrint + Shareware software providing photo quality printing for many inkjet printers. It is useful if you are unable to find a driver for your printer and may be hooked into either a traditional Ghostscript system or a modern &CUPS; system. + Gimp-Print + + + + + XPP + Abbreviation for X Printing Panel; XPP was the first Free graphical print command for &CUPS;, written by Till Kamppeter, and in some ways a model for the "kprinter" utility in &kde;. + + + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/quickstart/CMakeLists.txt b/tde-i18n-en_GB/docs/tdebase/khelpcenter/quickstart/CMakeLists.txt new file mode 100644 index 00000000000..c52ce1fc0e9 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/quickstart/CMakeLists.txt @@ -0,0 +1,6 @@ +# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer + +tde_create_handbook( + DESTINATION khelpcenter/quickstart + LANG en_GB +) diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/quickstart/Makefile.am b/tde-i18n-en_GB/docs/tdebase/khelpcenter/quickstart/Makefile.am new file mode 100644 index 00000000000..2102aa47e4f --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/quickstart/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = en_GB +SUBDIRS = $(AUTODIRS) +KDE_DOCS = khelpcenter/quickstart +KDE_MANS = AUTO diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/quickstart/index.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/quickstart/index.docbook new file mode 100644 index 00000000000..620dd16dae9 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/quickstart/index.docbook @@ -0,0 +1,828 @@ + + + + + +]> + + + + +An Introduction to &kde; + + + + +The KDE Team + +MalcolmHunter
malcolm.hunter@gmx.co.uk
Conversion to British English + + +2004-08-28 +3.00.00 + + +1999200020012002 +The KDE Team + + +&FDLNotice; + + +An introduction to the K Desktop Environment +Quick Start Guide to &kde; + + +KDE +quick start +introduction + + + + +Introduction + +This document is a brief introduction to the K Desktop Environment. It will familiarise you with some of the basic features of &kde;. + +This guide is far from covering all aspects of the K Desktop or even most of them. It will only describe some of the most basic ways to accomplish a few of the most common tasks. + +We assume that you are already familiar with at least one graphical user interface, for example CDE, Geos, GEM, &NeXTSTEP;, &Mac;, OS/2 or &Microsoft; &Windows;. So we will not explain the usage of the mouse or the keyboard but concentrate on hopefully more interesting things. + + + + +An Overview of &kde; + +This section is for users who prefer to learn by exploring and want only a brief orientation to get started. Later sections provide a more thorough introduction to the environment, with helpful hints and shortcuts. If you are impatient to get started, skim this section, go play for a bit, then come back and peruse the other sections of this guide as needed. + + +&kde; provides a highly configurable desktop environment. This overview assumes that you are using the default environment. + + + +The &kde; Desktop + +A typical &kde; desktop consists of several parts: + + + +A panel at the bottom of the screen, used to start applications and switch between desktops. Among other things, it contains the &kmenu;, a large &ticon; which displays a menu of applications to start when clicked. + + + +A taskbar, by default embedded in the panel, used to switch between and manage currently running applications. Click on an application on the taskbar to switch to the application. + + + +The desktop itself, on which frequently used files and folders may be placed. &kde; provides multiple desktops, each of which has its own windows. Click on the numbered buttons on the panel to switch between desktops. + + + + + + +Ready, Set, Go! + +Here are a few quick tips to get you up and running. + + + +To start an application, click on the &ticon; button on the panel (called the &kmenu;) and choose an item from the menu. + + +Click the icon that looks like a folder with a picture of a house on the panel to access the files in your home folder using &konqueror;, &kde;'s File Manager utility. + + +Choose TDE menu System Konsole to get a &UNIX; command prompt, or press &Alt; F2 to get a mini command prompt window to execute a single command. + + + +Choose the SettingsControl Centre item on the &kmenu; to configure &kde;. + + + +Press &Alt;Tab to switch between applications and &Ctrl;Tab to switch between desktops using the keyboard. + + + +Use the &RMB; mouse button to access context menus for the panel, desktop, and most &kde; applications. + + + + + + + +Launching Applications + + +Using the &kmenu; and the Panel + +At the bottom of the screen you will find the desktop panel, which is called &kicker;. You use the panel to launch applications. Have a look at the button on the left with a large &ticon;. + +This button is called the &kmenu;. It has a small arrow on the top to indicate that it will pop up a menu if you click on it. Just do it! The pop-up offers you easy access to all &kde; applications installed on your computer system. + + +Customising &kicker; + + +If you use one application or tool very often, then you may want to have even faster access to it, of course. In this case, you can add a single application, or an entire sub-menu of the &kmenu;, as a special quick-launch button, on to the panel. If you want to reach the &kfind; application directly via a launch button, simply choose TDE menu Panel Menu Add Button Find Files (By this we mean that you should first click the &kmenu;, then select Panel Menu, where the small arrow to the right indicates that another menu will pop up. In this menu, choose Add, then Button, and in the next sub-menu, Find Files). + +You can add an entire menu this way, or one of the &ticon; button sub-menus. For example, if you have &koffice; installed and want quick access to all the &koffice; applications, without having to navigate through the &kmenu;, then instead of choosing an application, click on the Add this menu menu entry. Now you will have instant access to all the &koffice; applications, without having to put an icon for each on the panel. + + +You can move all items of the panel around with the Move command of the context menu. Just click with the third mouse button (the third mouse button is normally the right button, but if you have configured your mouse differently, for example for left-handers, it might also be the left one). A menu will pop up where you can choose Move. Now move the mouse and see how the icon follows while still staying on the panel. When you are done, simply hit the first mouse button (by default the left one). As you may have noticed, there is also a menu entry Remove in case you are tired of a certain launch button on your desktop. + + + + + +Using Context menus + +This leads us to another interesting topic: in many places, you can click the right mouse button to display a context menu with choices that are applicable to the item you clicked. It is therefore always a good idea to try out the third mouse button on something, if you do not know what to do with it. Even the background of the desktops has such a menu! + + + + +Other Panel features + +There are other interesting things possible with the panel. One may be important if you have a low resolution on your monitor: it is the hide-and-show function, activated by clicking on the small arrowed button, which is at one or both ends of the panel. + +Perhaps you just don't like the panel extending the full width of the screen. That's easily changed! &RMB; on an empty space in the panel, and choose Configure Panel.... In the &kcontrol; dialogue that pops up, you can choose Length on the Appearance tab, and use the slider there to set the panel to less than 100% width. + +If you're following along, and have that dialogue open anyway, then feel free to play with all the options, and use the Apply to see the effect they have. You can easily reset everything to the default configuration, by simply pressing the Use Defaults button. + +By the way, if you are not sure what a certain button does in &kde;, just move the mouse pointer over it and wait for a short while: &kde; has a built-in mini context help, called tool tips, which explains the functionality of such controls in a few words. + + + + + + +But I want my command line back! + +Just calm down, there is nothing to fear. &kde; does not want to take your beloved (and sometimes very effective) command line away from you. You can move your files with the desktop, but you can also use the &UNIX; commands you are accustomed to. In fact,&kde; puts command line power at your fingertips, in perhaps some surprising places. + +&kde; provides a very sophisticated command line window called &konsole;. Choose TDE menu System Konsole to start it. This may be something you want on your panel: luckily it is already there in the default configuration! + +Sometimes, you only want to enter one command on the command line. In these cases, you do not need a full-blown terminal. Just hit &Alt;F2 and you get a small command line where you can enter one command. The command line window will disappear afterwards, but it remembers your command. + +When you pop up this window (which we call minicli by the way) and hit the Up arrow, you can browse through all the commands you have previously entered. Also, you can enter &URL;s in minicli to open a &konqueror; window with the specified &URL;. + +&konqueror; and the editor &kate; can both display terminal windows, which behave just like &konsole;. In &konqueror;, you can turn this on with the menu choice WindowShow Terminal Emulator. The embedded terminal will display at the bottom of your &konqueror; window, and the really clever thing is that it will follow your clicks in the file manager view, changing folder as you do. In &kate; you can display a terminal with the menu choice SettingsShow Console. + + +To display a &UNIX; man page, enter man:command in minicli, where command is the name of a &UNIX; command. + + + +To search for a word or words on the Google search engine, you can try entering gg:word or words. There are a whole lot more of these shortcut commands, and you can even add your own! Take a look in &kcontrol;, in the tab Web Browsing Enhanced Browsing. + + +Finally, there's a way to have your command line always available, no matter what you're doing - add one to your &kicker; panel! + +Simply &RMB; click on an empty space in the panel, and choose Panel Add Applet Application Launcher. This will embed a mini-cli directly into your panel, complete with command history. + +So, in conclusion, the command line is never far from view when you're using &kde;. + + + + + +Working with Windows + +If you have not already done so, start an application using the &kmenu;; say, Find Files. + + +A window! What now? + +Well, usually people work inside windows, but sometimes you may want to manipulate windows. Here's a quick overview of some of the most common window related functions: + + + +Move a window + +Drag the window's title bar, or hold the &Alt; key down and drag anywhere in the window. + + + + +Resize a window: + +Drag the window's border, or hold the &Alt; key down and drag with the &RMB; anywhere in the window. + + + + +Maximise a window + +Click the maximise button in the title bar (in the default decoration it is the square, next to the X) to make the window fill the screen, or if the window is already maximised, to shrink it back to its original size. Clicking with the &MMB; maximises the window vertically, and with the &RMB;, horizontally. + + + + +Iconify a window + +Click the iconify button in the title bar (next to Maximise) to hide the window. Restore it by clicking on the window's icon in the taskbar. + + + + +Switch between windows + +Aside from the usual mouse click to switch to another window, you can use &Alt; Tab to switch windows. See below for more techniques. + + + + + +Title bar buttons + +&kde; windows have some pretty standard buttons on their title bars which give you fast access to some common operations. The default button layout looks like this: + + +On the left side: + +A menu button. This usually shows a mini icon for the application. Click on it to get a window operations menu. Shortcut: &Alt;F3 opens the window menu. + + + +A sticky button, with a picture of a tack. What the heck is this? Stay tuned! + + + + +On the right side: + +An iconify button. + + + +A maximise button. + + + +A close button. This closes the window. Shortcut: &Alt;F4. + + + + + + +Switching between windows + +Now that we know how to deal with windows, we encourage you to open some other windows using the panel, since we will now discuss how to switch between different windows. Since this is such a common activity, &kde; offers several ways to do it; pick your favourite! + +Many window systems require you to click the mouse in another window to begin using it. This is &kde;'s default behaviour, termed Click To Focus focus policy. But you can also configure your desktop in a way that moving the mouse pointer on to a window will activate it. This is called Focus Follows Mouse. If you select this policy using the &kde; Control Centre, the window under the mouse pointer is always the active one. It doesn't necessarily come to the front automatically, but you can still click on to the title bar or the border of a window or, a &kde; special, you can use the &Alt; key and click the &MMB; anywhere on the window to raise it. + +Here are some other methods to switch windows: + + + +Pick a window from the window list menu. To open the menu, click the &MMB; on an empty area of the desktop, or click the icon with several windows on the panel, or finally click the up arrow at the left hand end of the taskbar in the panel. + + + +Hold down the &Alt; key and press Tab to cycle through the windows. + + + +Use the taskbar (see below). + + + + + + + +Using the Taskbar + +The taskbar displays a list of small icons, one for each window on the desktop. In the default &kde; setup the taskbar is located inside the panel, but it can also be located at the top or the bottom of the screen. + +The taskbar is very powerful. In the default configuration, if you have more than one window from the same application open, they will be grouped, so that you see one icon per application in the taskbar. + +A simple &LMB; click on the taskbar button will pop up a list of the open windows for that application and you can choose the window you want to use. Choosing one of these entries with the left will bring you to the selected window immediately. Click on a taskbar entry with the right and you will see a menu allowing you to operate on all the windows grouped under that icon, or each window individually. + +You can choose to see all the windows on all the desktops in your taskbar, no matter which desktop you are currently viewing, or to only see the icons for the desktop you are looking at. You can also choose to ungroup the icons, so that each open window will have its own icon in the taskbar. These and many more options are available simply by right clicking on the taskbar handle (the small textured bar at the left hand side) and choosing Configure Taskbar.... + +The icons on the taskbar resize themselves to make room for applications, so you can fit many more applications than you might think. Making the panel wider will let the taskbar icons take on a row and column layout, but they will still resize to fit more icons. + + + + +Using Virtual Desktops + +Now, what was that sticky thing? + +It may happen that you have more windows open than space on your desktop. In this case you have three possibilities: + + + +Leave all windows open (cluttered desktop) + + + +Iconify those windows which you do not need at present and use the taskbar or &Alt; Tab to switch between them (still a bit confusing and much work!) + + + +Recommended: Do what a real operating system does if there is not enough physical memory: Use virtual memory, in this case virtual desktops. + + + +The third option is the way to go! &kde; can handle several different desktops, each with its own windows. The default configuration provides four desktops. You can switch between the virtual desktops easily with a click on one of the desktop buttons on the panel. Also &Ctrl;F1...F4 will send you to the corresponding desktop immediately, or &Ctrl; Tab will cycle through the desktops. + +Virtual desktops are very nice. But sometimes you want a window to be present on every desktop. This could be, for example, a small chat window, an alarm clock or whatever. In this case you can use the above mentioned sticky button which will pin the window on the background so that it will appear on every virtual desktop. + +The sticky button can also be used to move a window from one virtual desktop to another one: push the sticky pin on the window, switch to a different desktop, and release the pin by pushing it again. You can achieve the same result by using the context pop-up menu of the window's entry in the taskbar (menu item To Current Desktop) or the To Desktop option on the window operations menu. + + + + + +Managing your files + + + +A common metaphor of graphical desktops is the use of folders to represent directories on your hard disk. Folders contain files and other folders. A &kde; application called &konqueror;, the K File Manager, uses this metaphor to help you manage your files. + + +Using &konqueror; + +The first time you start &kde;, a window with lots of icons in it appears. This is a &konqueror; window displaying the files in your home folder (the area where your personal files are stored). The pathname of the folder is displayed under the window's tool bar. If you do not see such a window now, click the icon on the panel that looks like a folder with a picture of a house. + +To open a file or folder, simply click it once with the &LMB;. You can also choose WindowShow Navigation Panel from the menu to display the folder hierarchy for more direct navigation. Or you can edit the path displayed under the toolbar to get to a specific folder quickly. + + +Opening Files + +&kde; comes with a set of applications to view and edit files of many common types, and when you click a file containing, say, a document or image, &konqueror; will start the appropriate application to display the file. If it doesn't know what application to start to open a file you clicked, &konqueror; will prompt you for the name of the application to run, and when you have chosen, &konqueror; will offer to remember your choice for the next time you open a file of that type. + + +&konqueror; uses MIME types to associate files with applications. + + + + + +Dragging and Dropping Icons + +To copy or move a file, simply drag its icon to the desktop, to another &konqueror; window, or to a folder icon. When you release the button, &konqueror; displays a menu to allow you to choose to copy, move, or create a link to the file. + + +Note that if you choose to create a link, &kde; creates a &UNIX; symbolic link (not a hard link), so if you move or delete the original file, the link will be broken. + + +Most &kde; applications also support drag and drop operations: you can drag an icon on to a window of a running application, or on to an icon of an application that is not started, to have the application open the file. Try it! + + + + +Setting File Properties + +To change file properties, such as its name and permissions, &RMB; click the icon and choose Properties from the menu. + + + + + +Working with Archives and Networks + +In the recent past, you needed special software to access files on the Internet. Not any more! + +&kde; supports a technology called Network Transparent Access (NTA) which allows you to work with files on the other side of the world as easily as those on your local hard disk. + +For example, to access files on an &FTP; server, just choose LocationOpen Location from a &konqueror; menu, and enter the URL of an &FTP; server. You can drag and drop files to and from the folders on the server just as if they were on your local disk. You'll even be able to open files on the &FTP; server without having to manually copy them to your local disk (&kde; does it for you when necessary). + + +Note that &konqueror; uses anonymous &FTP; access, which may restrict your access to files on the &FTP; server. If you have an account on the server, you can supply your user ID as part of the URL, like this: ftp://userid@server/folder + +&konqueror; will prompt you for your password, and if the login succeeds, you will have full access to your files on the server. + + +If you are used to the WinZip utility on &Microsoft; &Windows;, then you will be happy to hear that &kde; can look into tar archives, too. It treats such archives just like a normal folder, and you can browse into the archive, open files, &etc; In general, accessing files on the Internet and in archives should look and feel just like accessing files on your local disk, except for delays imposed by the network and extracting the archive. + + + +Using Templates to access Applications and Devices + +In &kde; it's easy to put icons on the panel or the desktop to access your applications. It's just as easy to add icons to access other items of interest. &kde; has templates for shortcuts to: + + + +Applications + + +Printers + + +Mountable Devices (⪚ floppy drives) + + +Internet resources (⪚ WWW documents, &FTP; folders) + + +Documents for some of &kde;'s &koffice; applications. + + + +You can add any of these items to the desktop by &RMB; clicking where you want the icon, and choosing Create New and selecting the item you want to link to. + +Nearly every item in the &kmenu;, on the desktop, and on the panel refers to a .desktop file on disk. The .desktop file specifies what icon to display, as well as specific information about what the icon represents (an application, device, or URL). You can drag any .desktop file to the panel to create a quick-launch button. + + + + +Mounting devices + +&UNIX; provides access to storage devices other than the primary hard disk through a process called mounting. &kde; uses .desktop files to allow you to easily mount, unmount, and access files on secondary storage devices such as floppy drives and &cdrom; drives. + +As an example, here are the steps needed to create an icon to access files on a floppy disk: + + +Many systems require you to be logged in as root to mount and unmount devices. + + + + +Right click on the desktop and choose Create New Floppy Device.... + + +On the General tab of the resulting dialogue, change the name to whatever you like, in the text box at the top. + + + +On the Device tab, enter /dev/fd0 (or the path to the floppy device as it is named on your system) as the Device. + + +You can add a Mount Point here too. This should be an existing folder, but empty. Common mount points are /mnt/floppy or /floppy, but you can just as easily have floppy disks mounted on ~/mydisk if you want. + + +Click the Unmounted Icon and select the picture of a floppy disk without the green light. + + +Once you're happy with your choices, choose OK and you are finished! + + + +Now, place a properly formatted floppy in the drive and click the Floppy icon to have &kde; mount the floppy drive and display the files on the disk. Before removing the disk from the drive, &RMB; click the Floppy icon and choose Unmount from the menu. + + + + + + +Configuring your desktop + +If you do not like something about the way the desktop looks or operates, you can probably change it. &kde; is very configurable and you can change almost every aspect of the appearance and the behaviour of your desktop. Unlike many other &UNIX; desktop environments, you do not have to edit cryptic configuration files either (but you can if you really want to!) You use the &kcontrol;, a special program for configuring your desktop. + + +Using the <application>&kde; Control Centre</application> + +Launch the &kcontrol; from the &kmenu;. A window with two panes appears, displaying a list of modules in the left pane. + +Open a module by clicking its name; a list of submodules will appear. Then, click one of the submodule category names to edit its configuration in the right pane. + +Changing the configuration is fairly straightforward. A help button is available on each configuration panel to explain settings that are not obvious. Each panel has buttons labelled Help, Use Defaults, Apply, and Reset, which work as follows: + + + +Help + +Displays a short help text in the left hand pane, including a link to a longer manual for the module in question. + + + + +Use Defaults + +Sets all the options in the current module back to the default at the time &kde; was installed. + + + + +Apply + +Applies the current settings in the currently open module. + + + + +Reset + +Resets the options to the state they were in when you opened the module. If you have already used the Apply button, then this button will reset the options to the state they were in when you pressed Apply. + + + + + +If you make changes on one configuration panel and move to a different module without clicking OK or Apply first, &kcontrol; will prompt you to ask whether your changes should be applied first. + + + + + +Configuration Modules + +Here is a brief overview of the major configuration modules categories: + + + +File Browsing + +Contains options that relate to how you view the contents of your local system. + + + + +Information + +Contains modules that you normally can't use to change anything. They display useful information about your computer instead. + + + + +Appearance & Themes + +Here you find the modules that have the most visible effect on your environment: Colours, styles, window decorations. Nearly everything you see can be customised to suit your tastes, and the few things that can't be, soon will. + + + + +Network + +The place to configure how your computer sees the world outside, as well as how the world sees you. Among other things, you can set up central email identities that many &kde; applications can use, to save you having to enter the same information over and over, you can set up SOCKS firewall support, and you can configure &Windows; (SMB) shares... and much more. + + + + +Peripherals + +Contains settings for your keyboard and mouse, and for printers. + + + + +Personalisation + +Here you can set up things that make your life easier, from accessibility features to localisation, so that &kde; applications know how you like to see numbers and dates formatted, for example. + + + + +Power Control + +If your computer supports APM power saving features, or you are using a laptop, this is the place to configure them. + + + + +Sound + +Configure the sound daemon (&artsd;) and other audio behaviour. + + + + +System + +Here you can set the remaining system features - how the &konsole; and &tdm; applications behave, set up printing, and set your system date. You might not be able to set some of these options unless you are logged in as root, but &kcontrol; will let you know if this is the case. + + + + +Web Browsing + +With the Internet, and especially the web, being such an integral part of today's computer world, there are many options to be set to enhance your experience. You'll find them all here, from setting up custom style sheets, to proxies and caching. + + + + +Go ahead! Explore the configuration possibilities and discover the flexibility of &kde;. + + + + + +Logging out + +We sincerely hope that using &kde; gives you so much fun and pleasure that you never want to log out. But if you do, simply choose TDE menu Logout. + +There is also a logout button directly on the panel, which looks like a small power button. Or you can press &Ctrl; &Alt; Delete to log out. + + +Session Management + +When you log out, &kde; can remember which applications you had open, as well as where all the windows were located, so that it can open them for you the next time you log in. This feature is termed Session Management. &kde;-aware applications will restore themselves to the state they were in when you logged out. For example, &kate; remembers which files you were editing. + +Non-&kde; applications do not memorise their state on logout, and &kde; will warn you to make sure that you have saved any important data in them when you start to log out. + +To illustrate session management, choose TDE menuEditors Kate to start &kate;. Open a text document to edit. Now log out and back in. You will observe that &kate; will be restored to the exact same position on the screen, including the right virtual desktop, and the document we left open in &kate; before we logged out is opened again automatically. &kate; will even remember whether you had unsaved changes to your document before you logged out and will save them to the file you were working on if you choose Save from the File menu. + + + + + +&kde;, an exciting Journey + +We hope you enjoyed this brief tour of the K Desktop environment and that this unique desktop environment will help you get your work done faster and more comfortably than ever. + +Please remember that the &kde; project is not a commercial venture, but rather a project run by volunteers from all over the world. We would like to invite you to join the &kde; project and become part of this unique network of people. If you are a programmer you might consider helping us write &kde; applications. If you are an artist or have experience with graphic design, consider creating icons sets, colour schemes, sound schemes and logos for &kde;. If you enjoy writing we would love for you to join our documentation project. + +As you can see there are many ways in which you can help. You are cordially invited to join this world-wide network of people dedicated to making &kde; the best desktop environment for any computer. Please visit www.kde.org for more information. + + +Welcome aboard on this exciting journey, + + +Your &kde; Team + + + + + +Credits + +Authors + + +Matthias Ettrich ettrich@kde.org +Kalle Dahlheimer kalle@kde.org +Torben Weiss weis@kde.org +Bernd Wuebben wuebben@kde.org +Stephen Schaub sschaub@bju.edu - Editor +Robert Williams rwilliams@kde.org - Editor +Lauri Watts lauri@kde.org + + +Conversion to British English: Malcolm Hunter malcolm.hunter@gmx.co.uk +&underFDL; + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/CMakeLists.txt b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/CMakeLists.txt new file mode 100644 index 00000000000..1ea81676fe6 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/CMakeLists.txt @@ -0,0 +1,6 @@ +# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer + +tde_create_handbook( + DESTINATION khelpcenter/userguide + LANG en_GB +) diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/Makefile.am b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/Makefile.am new file mode 100644 index 00000000000..8161986a832 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = en_GB +SUBDIRS = $(AUTODIRS) +KDE_DOCS = khelpcenter/userguide +KDE_MANS = AUTO diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/about-desktop.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/about-desktop.docbook new file mode 100644 index 00000000000..f5f7670e015 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/about-desktop.docbook @@ -0,0 +1,243 @@ + +All About Your Desktop + + +Little Red Riding Hood +Grandma, what big eyes you have! + + + +The Wolf +The better to see you! + + +The more you see, the more efficiently you can use your desktop. &kde; gives you the opportunity to make the desktop look and work the way you prefer, enabling you to work faster and more productively. It even gives you the opportunity to be warned if a wolf is trying to eat you, or (if you happen to be a granny) alert you when Little Red Riding Hood is on her way to bring you the goodies. Now that's service. + + +Autostarting Applications + +Native &kde; programs and many third party applications left open at the end of a session will save their state and reappear when you login again, but there are some programs (like some versions of &Netscape;) that will not. You can use the Autostart folder for these programs. + +To launch programs when &kde; is started, do the following: + + + +Open the Autostart folder. By default this folder is at $HOME/.trinity/Autostart + + +Open a &konqueror; window and browse to the program you want to add. If you do not know how to do this, it was covered in . + + +Drag and drop the desired program from the &konqueror; window on to the Autostart folder. When asked, choose Link to create a symbolic link rather than a full copy, as this saves a great deal of disk space. + + +Repeat the above steps for every program you want started when &kde; is launched. Remember, you do not need to add native &kde; applications, just leave them open when you log out, and they will open up again as if nothing had happened the next time you log in to &kde;. + + +Restart &kde; if you want to see the autostart function in action. + + + +Your programs should have launched automatically when &kde; restarted. + +Do not forget though that you will only need the Autostart folder for a few applications. Many applications, including almost all native &kde; applications, now understand session management, and you can simply leave them open when you log out in order for them to be restarted exactly as you left them. You can leave a &konqueror; window open with your favourite website, &kmail; looking at your inbox, and &kate; with a half dozen files open, log out, log back in, and find your desktop exactly as you left it. + + + + +Adding Programs and Shortcut Icons to Your &kmenu; and Panel + +The &kde; &kmenu; and &kicker; are not limited to the setup you find right after installing &kde;. The &kde; panel is designed to be extended, and there are two main ways of doing that: Adding new programs, and adding shortcut icons. + + +Adding menu entries + +&kde; comes with a great many applications already in the menu. Depending on your operating system and distribution, this could include many non-&kde; applications. &kde; also includes an application that will search your hard drive for more applications, and add them to the menu for you. Try pressing &Alt;F2 and entering kappfinder to see it in action — operation is very straightforward. + +&kappfinder; is clever enough, but it doesn't know about every application there is. Or perhaps you simply don't want to have all those applications in the menu, and just want to add a single extra program. + +To add your favourite programs to the &kde; menu, you can use the KDE Menu Editor. To start it, use the &kmenu; and choose SettingsMenu Editor. + +A window will open showing the existing &kmenu; on the left, and an empty menu entry dialogue on the right + +For this example, we will be adding an entry for the Gimp under the Graphics submenu. If you already have a Gimp entry there and don't want a new one, you can still follow through this example, but just don't click the Apply when you are done. + + +Navigate down the left hand tree to the Graphics entry. + +Click on it once with the left mouse button to expand the entry. + + +Click the icon labelled New Item in the toolbar, or choose FileNew Item in the menu bar. + + +In the dialogue box that pops up, enter the name you want your new menu entry to have. For this example, enter Gimp.Then press OK in the dialogue. + + +Click on the new Gimp menu entry that was created for you under the Graphics submenu. The menu entry dialogue to the right will now change to be mostly empty, except for the name you already gave. + + +Fill in an optional Comment. You might like to put An image editor for the example. Text entered here will be shown as a tool-tip in the &kmenu;. + + +Enter in the box labelled Command, the command you would type on the command line to open your application. For this example, this is gimp. You may also enter any optional command line parameters if you wish. You can use this to make a menu entry that always opens a particular document or image, for example. Check the application's documentation to find out more about command line parameters. + + +If you want the application to operate from a particular folder (for example, for Gimp to begin its Load Image dialogue in a particular place) enter this path in the box labelled Work Path. This is optional. + + +If you wish to change the icon from the default unknown, click on the icon to the right of the dialogue, to open a standard &kde; icon chooser. + + +Some applications must be run in a terminal window (for example Pine). If this is the case, check the appropriate check box. + + +If you want to run your application as a different user, check the box labelled Run as a different user and enter the appropriate user name in the text box. + + +If you're happy with your menu entry, press Apply. If you would like to start over, press Reset. + + + +And that's all. You now have a new menu entry. + + + + +Shortcut Icons + +Although &kde; is much more comfortable than the average &UNIX; window manager, everyone wants a solution for a one-click way to start a program. Later, you will learn how to create links and files on your desktop, but this also has some disadvantages: sometimes all your desktops are filled up with windows, and you cannot reach your icons without minimising all the windows that cover them. For commonly used programs, you can minimise this problem and speed access by creating shortcut icons on the &kde; panel. + +To create a shortcut on the &kicker; panel, you have some choices: Drag-and-drop, or via a menu. + + +Adding a shortcut icon with the menu +Click on the &ticon; and choose Panel MenuAddApplication . +You will see the top level of the &kmenu; again. Go through the menus to find the entry for which you want to create the shortcut, such as Home folder or &konqueror;. Click on the program you want. + + + +A new icon will appear on the panel. Click on it, and the program will start. + +Adding a shortcut icon with drag-and-drop is even simpler - just drag any icon from your desktop, or a &konqueror; window, to an empty space on the panel. + +What happens when you drag an item to your panel depends on what kind of item it is: + + + +If you drag a folder... A menu will pop up giving you a choice of Add as a File Manager URL or Add as a QuickBrowser. Choosing the first will create an icon that opens a &konqueror; window, starting at this folder, while choosing the latter will open that folder as a menu from the Panel. + + + +If you drag a shortcut from your desktop... +It will be copied to the panel. + + + +If you drag a document... +A link will be made on the panel, leaving the original in place. Clicking on the resulting icon will open that document in the default application. + + + +In any case, if you want to move the icon, click on it using the &RMB; and choose Move Name of Button Move the icon to the position you want and press the &LMB;. If you wish to remove the icon, click on it using the &RMB; and choose Remove Name of Button. + + + + + +Creating New Files On Your Desktop + +Your desktop can be an efficient place to work. Every time you start &kde;, you can see the complete files, folders and &URL;s which you often use. + +There are two ways to create and edit files on your desktop. In any application, you can say that you want to save your work in the Desktop subfolder of your home folder. For example, my home folder is /home/stupiddog, so my Desktop folder is /home/stupiddog/Desktop. Everything you save there will be put on your desktop. + +If you want to move existing files to your Desktop, the best way to achieve this is to use &konqueror;. Open a file manager window and drag the files you need to your desktop. You can choose to copy them if you want to keep all your common stuff on the desktop now, or you can create symbolic links to the real files. Everything you change in the link files will be automatically updated in the originals. For more information on how to use drag & drop and the file manager, see the chapter Moving files with drag & drop. + + + + +Placing Links on Your Desktop + +Placing files on your desktop may shorten the paths you need to enter. However, sometimes it would be nice if you could start &kedit; with a commonly edited file already opened in it. And how often do you find yourself frustrated after browsing through endless lists of bookmarks to find a site you visit often? Wouldn't it be nice if everything necessary to deliver you to that site was done automatically after clicking a single icon? + + + +Using &MIME; Types and File Associations + +&MIME; Types are very powerful. Employing them, you can easily customise your system such that clicking on a file of a specific type starts the application with which that file type has been associated. For example, all .mod files could be set to start &noatun;, .html files could open a &konqueror; window showing the file, and a core file can be viewed with the &khexedit; by simply clicking on the core file. + + +Although &MIME; types are very powerful, they are not without dangers. Playing around with &MIME; types as the system administrator (root) can damage a &kde; system so severely that it cannot be restarted! In this example, you will create your personal &MIME; style, which is only relevant for you. It will only affect other users if you copy or move it to $TDEDIR/share/mimelnk. + + +To link a certain file type with a particular application: + + + +Make sure the application you want to start this file type has an entry in the &kmenu;. + +In &konqueror; find or make a file with the extension you wish to link. + +Right click on the file, and choose Properties from the context menu and then press the tiny button with an icon next to the Type resulting properties dialogue. Or, choose EditEdit File Type... in the &konqueror; menu bar. + +Add file masks for the application by clicking the Add button, and entering the file pattern you want. Remember that &UNIX; is case sensitive, so you may need to add variations - *.mp3 may need *.MP3 added as well, for example. Add as many masks as you like in this way. + +Add a description if you like. This is optional. + +In the section labelled Application Preference Order, press the Add button. A miniature copy of the &kmenu; will open, where you can choose the application you want files of this type to be opened with. + +Sometimes, you may want to use a different application to open this file type. For example, you might like to use &kate; to open text files you wish to edit, and &kedit; for text files that you just want to take a quick peek into. You can add more applications in the same way as you did in the last step, and you can change the preferred order using the Move Up and Move Down buttons. + +If you're satisfied with your choices, you can click the Apply button to save your changes without closing the dialogue box. This gives you the opportunity to test in the &konqueror; window that your file association is correct. You can choose OK to save your changes and close the dialogue box, or Cancel if you have changed your mind and just want to close the dialogue box. + + +Be sure to try your new association by opening a folder containing a file of the type you just selected. Click on the file, and the program needed to edit it should start. + + +&MIME; types are a way of describing the contents of files. You may be used to using file extensions for that purpose, and you may know that on &UNIX; systems the file extension often bears little or no relation to the contents of the file. On the other hand, it may be vital - for example, some implementations of gunzip won't operate on files that aren't named .gz. + +&MIME; types naturally make use of filename patterns, but not necessarily the extensions - you can set up any filename pattern you like. For example, if you always want to open any files relating to a particular client with &kate;, and you make a habit of naming the files with the client's name at the beginning so that they naturally group in the &konqueror; window, then you can set up a filename pattern that matches ^clientname*. Then any files that have clientname at the beginning (the ^ character means starts with...) will be opened with the application you choose. + + + + + + +Using the Trash Can + +Under normal circumstances, deleting a file under &UNIX; is something which cannot be undone. However, with &kde;, you can choose Move to Trash instead of Delete. This will move the file into the Trash Folder, which, by default, is accessible as an icon on your desktop. In the Trash Folder, you can always recover deleted files. Remember to empty the trashcan now and then by clicking on it using the right mouse button, then choosing Empty trashcan, otherwise you might run out of disk space because the files still need space. Note, however, that once you empty the Trash Folder, the files contained therein are lost forever. + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/first-impressions.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/first-impressions.docbook new file mode 100644 index 00000000000..bc4fbce0294 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/first-impressions.docbook @@ -0,0 +1,186 @@ + +First Impressions + + +Origin unknown +You see to sea to see all that you can see is sea + + +First impressions are so important -- this is not only true for Agatha Christie's famous thriller The Mousetrap -- but also for &kde;. As we mentioned before, &kde; is supposed to be the most intuitive, easy to learn user interface available. In fact, we will have reached our goal when users no longer need this book in order to work with &kde;, causing the authors to lose their (unpaid and voluntary) jobs as documenters. + + +Starting &kde; + +When you boot a &UNIX; system, one of three things should happen (that is, if the system works correctly; everything else is an undocumented fourth case). Either you stay in text mode and get a login prompt, you are logged into your &GUI; of choice automatically, or you are presented with a graphical login window. In the first case, you must log into your system and type: + +startx + + +If the installation was successful, the &kde; desktop should appear after a few seconds of initialisation. + +If a graphical login window is presented, then all that should be required is your login name and password. Assuming the &kde; installation was successful, &kde; should start without further intervention. + +If you have not done so already, we recommend changing your X display manager from xdm to &tdm;, which includes the same functionality, but with the advanced features of the K Desktop Environment. + +If your system is configured to automatically log you into a &GUI; you will need to consult your operating system manuals or support forums for instructions how to have &kde; be that &GUI;. + + + + +Desktop Components + +After everything has come up, take some time to explore the new environment. If you have already worked with &Windows;, OS/2 or &MacOS;, many things should look familiar to you. The main visible parts of &kde; that you will see are the desktop itself, and the panel. + + + +Panel + +When you start &kde; for the first time, the panel is situated at the bottom of the screen. From here, you will start your programs and switch between the virtual screens. + + + +&ticon; button +The &ticon; button is one of the most important places on your &kde; desktop. From here, you can start all &kde; applications installed. Later, when you learn how to use the TDE Menu Editor, you can also add other programs here as well. To start a program, just click on the button. You will see a list of different categories, plus some special entries. Whenever you move your mouse over an entry that has an arrow to the right, a new menu will appear. When you find the program you want to start, just click on it with the left mouse button. + + + +Virtual Desktop buttons +When you start &kde; for the first time, note the four buttons labelled, appropriately enough, 1, 2, 3 and 4. These represent your four desktops. Just click one of them. Don't worry; though they have disappeared, any open windows are still active (just take a look at the task list!). Using multiple desktops is one of the most powerful features of &kde; and the &X-Window;. Instead of placing one window over another, as you would when using &Windows; or OS/2, you can say Well, on the first desktop, I will write the &kde; User Guide. On the second desktop I'll run the meinproc documentation compiler and see my results while compiling my &Linux; kernel on the third desktop, and reading my email on the fourth. + + +Icon bar + +Some people are so lazy that they consider even the two or three motions through the application's menu to be too much (me included). For them, additional buttons can be placed next to the desktop buttons; for example, shortcuts to your home folder, to your trashcan, to the Konsole terminal emulator and to the documents you use often. For information on how to add icons to the taskbar, read Adding icons to your taskbar. +&kde; by default installs several commonly used buttons, including links to &khelpcenter;, &kwrite; and &kcontrol;. + + +Time and date +At the far right end of the &kde; panel, you can always see the time and date. + + +The task list + +In another section of the panel, find a button for each open window. Just click on the button corresponding to the windows you want to open. Another click will minimise the window. A right mouse button click will give you a menu allowing you to move the window to another desktop, manipulate it's size, or close the application. + + + + + +Using Windows + + + +Window menu + +Right mouse button clicking in the title bar of the window (where you see the application's name), you can see a window manipulation icon. This is the same menu you see if you right click on an application's icon in the panel taskbar. When you click on it, a context menu containing commands to manipulate the window is presented. The available commands are as follows: + + + +Move +Lets you move the window with your mouse. Click on the left mouse button when you have the window where you want it to be. + + +Resize +Enables you to make the window smaller or larger. Move your mouse around and click when you are satisfied with the new size. + + +Minimise +Hides the window, leaving only an icon in the taskbar. Notice that the window title in this icon is now shown in (parentheses). To bring the window to the desktop again, click the icon. + + +Maximise +This will expand the window to the largest size possible. Note that &kde; will take the size of your virtual desktop, which means that the window could be bigger than your screen. + + +Shade +Roll up the window, leaving only the titlebar visible. You can achieve the same effect by double clicking in the titlebar. To display the entire window again, select Shade again, or double click in the titlebar. + + +Advanced +Here you can find menu options that allow you to manipulate how windows may cover each other up, and more: + + + +Keep Above Others +Selecting this will keep this window on top of all other applications, even when it does not have the focus. + + +Keep Below Others +Selecting this will keep this window below all others, even when it does have the focus. + + +Fullscreen +Selecting this makes the window take up the entire screen, similar to maximising, however, there are no window decorations showing. To switch to other applications, you may need to use the keybindings. For instance &Alt; to switch to another window or &Ctrl; to switch to another virtual desktop. +To revert from fullscreen mode, you can use the &Alt;F3 shortcut to show the window operations menu and deselect AdvancedFullscreen . + + + +No Border + +Remove the window decoration and border from this window. This is useful for monitor type applications, such as &kpager; which you keep on screen all the time and will never need the window decorations for. Many people also like to use this for xterm and &konsole; windows. +To revert from no border mode, you can use the &Alt;F3 shortcut to show the window operations menu and deselect AdvancedNo Border . + + + + +Store Window Settings +Stored the current settings for this window (position, size, whether it should always stay on top of all other windows &etc;.). This configuration will then be loaded the next time the window gets opened. + + + + + + +To Desktop +Enables you to send a window to another desktop. Choose the desktop where you want the window to be. The window will disappear at once. To see your window again, select the appropriate Desktop Button on the &kde; Panel. Selecting All Desktops will make the window sticky - it will display on all desktops at once, so you can alway see this window. + + +Configure Window Behaviour... +Allows you to change the look and feel, of all the windows in &kde;. This changes the window decoration widgets, including the titlebar buttons, but also including things such as checkboxes and buttons within dialogues, scrollbars, and the titlebar itself. The default is Keramik. +You can further customise nearly everything about the window manager itself, including how windows behave when moved, what different mouse button clicks will do in different parts of the window, and how to decide which windows have focus. + + + +Close +This will close the window. Sometimes the application will allow you to save your work, but in some cases (⪚, old X11 applications) this does not work. It is best to close an application with its own commands, using this menu item only as a last resort. +If the application itself is experiencing a problem that doesn't allow you to close it normally, using this menu item, or the window decoration close button will offer you the chance to kill it as gracefully as possible. Note that this may still leave the application open in the background but not showing any windows. Allowing the application to be killed in this manner will most likely allow you back into the desktop however, so you can check in a terminal window and clean up any remaining processes. + + + + + + + + +Window Decoration Buttons + +Sticky button +This button looks like a plus symbol in the default window decoration (Keramik) and may look like a thumb tack in others. It performs the same operation as selecting To DesktopAll Desktops in the Window Menu, but requires fewer steps to invoke. + + +Title bar +The title bar containing the name of the window can be double-clicked in order to shade it. Use the right mouse button: The Window menu will reappear, allowing you to (un)maximise, iconify, move, resize, (un)sticky the window, to move it to another desktop (this works faster than the method with the sticky button). When a program does not react anymore, you can close (which will sometimes give you the opportunity to save your work) it. + + +Minimise, Maximise and Close Buttons +To the right of the title bar, there are two buttons that can also be used to iconify or maximise the window (this is faster than using the window manipulation menu). Iconified windows can be brought back with a click on the taskbar. +At the far left of the titlebar (with the default window decoration) is a button to close the window. + + + +To move a window, place the cursor on the title bar and hold down the &LMB;. Without releasing the mouse button, move the window to the location of your choice, then release the mouse button. If you want to resize a window, move the mouse cursor to the window border you wish to change. Once you have reached the correct spot, the cursor will change from an arrow to a bracket and an arrow. Hold down the &LMB; and drag the side in question to the location you wish, then release the button. Note that you may drag sides or corners (which will adjust the size in two dimensions at once.) + +Using the menu bar of each &kde; window is easy. Just click on what you want to do, and it will be done. + +Below the menu bar, there is a set of tool symbols you can use to execute commands. Whenever you move over them, an active picture will be marked. But the menu bar can do even more for you. Notice the textured stripe on the left of the menu and icon bars? Depress your right mouse button and a context menu will appear, allowing you to put the menu bar on the top, left, right, or bottom of the window. You can also hide the menubar by selecting Flat + + + + +Getting Help + +Help is available basically everywhere: On the desktop, just use the right mouse button and choose HelpKDesktop Handbook. On the &kde; panel, open the application menu and choose Help. Every &kde; program has a help menu. + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/getting-started.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/getting-started.docbook new file mode 100644 index 00000000000..0d79313468f --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/getting-started.docbook @@ -0,0 +1,237 @@ + +Getting Started + + +Help for one of the toughest riddles in The 7th Guest +Using only what you see, can you get from A to B? + + +So far, you may be thinking that &kde; is little more than another window manager. Relax, and read this chapter, and we'll introduce you to some features that will assure you that &kde; is very much more than a window manager — it's a full fledged environment. + + +Editing Files + +Since you do not only have &kde; applications installed on your system, you probably know the mess of editing ASCII style configuration files. But in fact, there are a lot of other file types that need to be edited this way. For example, the raw &XML; source for this guide was written ASCII style, as was the source code for the &kde; programs themselves. We will now show you how you can use the &kwrite; facility in &kde; to edit ASCII files of your own. + + +Opening a Window Containing Your Home Folder + +Click on the &ticon; button and choose Home (Personal Files). A window showing the contents of your home folder will pop up. To see a more detailed listing of files in your home folder, select Show Hidden Files from the View menu. + +On the left hand of the window, a tree view of your file system structure should appear, while on the right hand side, you can see icons for each file in your Home folder, including any hidden files — files or folders beginning with a period. + + + + +The File Manager Screen + +We tried to make the File Manager as easy as possible to use, and if you know other window managers (including those built into other Operating Systems) with integrated file management, many of the following concepts should be familiar to you. + +On the top, there is a Location menu which contains functions to open and close file manager windows. You can also print the current contents. + +Want to visit the Internet? There are several paths you can take. You could choose LocationOpen Location (or press &Ctrl;O) and enter a &URL;. + +The simplest way however, is to simply type in the address you want to go to in the location bar itself. + +For example, if you want to visit the &kde; homepage, enter http://www.kde.org. You can also quickly transfer files over &FTP; using this method. &kde; is Internet ready, which means that you can load and save files not only on your local hard disk, but also on remote &FTP; and other remote servers that you have write access to. While other operating systems and desktops make a distinction between local and remote file systems, &kde; does not. + + +The Edit menu offers functions to select, copy and move files. We will use them later. Already having used the View menu, you have probably seen that you can view the content in many different ways. Just play around a bit and see what happens. + +You will undoubtedly find the Bookmarks to be extremely useful: Now you can remember virtually any link, be it on the local machine or somewhere on the Internet. &kde;'s network transparency works both ways, allowing you to treat files and folders on your hard drive as if they were Internet bookmarks. + +The Tools menu helps you find the notorious file-that-I-put-somewhere-I-do-not-remember-anymore. + + + + +Navigating Through Folders + +We will now pick one of your configuration files and edit it. First, we must change the folder in the File Manager. + +&konqueror; started with your home folder as the top of the tree. For most day-to-day purposes, this is where you are likely to be working, so it is a practical default. Sometimes you need to see the broader picture though, so the rest of your file system is not far away. + +You can quickly display the / or root folder several ways: click the small folder icon beside the navigation pane to switch to a full filesystem tree, use the Up arrow on the toolbar above to go to the top of your filesystem in the right hand pane, or type in / in the location bar. + +For the purpose of following this guide, press the small blue folder icon beside the navigation pane, so that the navigation pane switches to a full filesystem view. Notice that part of the tree is expanded, and your home folder is still selected. Now you can see how your home folder fits into the whole hierarchy, and your home folder files are still visible in the right hand pane. + +Scroll down the navigation pane on the left side of the window until you find the folder /etc. Double-click on etc. You will see a long list of files in the right window. + + + + +Opening A File + +Some of the files you see here are at the heart of your operating system, so making permanent changes to them require you to be the root or superuser. We are going to practice on a file that will not hurt anything if a mistake is made, called motd. + +Scroll down until you find the file motd and click on it with the right mouse button. In the context menu, select Open With. A new menu will pop up. Choose &kwrite;. Voila! + +There are many ways to open a file, and this is just one of them. &kwrite; is an editor with a simple and probably familiar interface. You could also have navigated down the small tree in the popup dialogue to the Editors section, and chosen another editor, or simply double click the file to open it in the default editor. + +In the meantime, you have the file /etc/motd open in &kwrite; and we're ready to do some editing. + + + + +The Editor Screen + +The more you work with &kde;, the more you will notice that most screens and applications look and feel the same. The &kwrite; File menu is a great example of this. Almost every other &kde; program has the same menu, allowing you to create new files, open existing files from your local file system or (coming soon) even the web, save them (soon even on the web, too!), print it or mail it to somebody else. + +The Edit menu can also be found in most &kde; applications, allowing you to cut and paste information between programs. You can also search and replace text. Using the Settings Menu, you can customise the editor in many different ways. For example, you can increase the font size to suit your monitor resolution — and your eyes. Of course, as in any other &kde; application, you find a Help Menu, offering you on-line help whenever you need it. + + + + +Using the Editor + +Most motd files contain useless stuff like Do not forget to back up your data or Do not annoy the system manager. Boring. Let's change the text so that users logging in get the really important information. You can navigate through the text using the arrow keys, and mark sections of text with &Shift;Arrows or by using the mouse with the left button pressed. Use the Edit Menu to cut and paste text. Enter whatever you want, or use the following (great) example: + +Welcome! + +This machine now has KDE installed, providing you with a great, +easy-to-use interface and a consistent Look-and-Feel for all your +applications. For more information on how to get KDE running on your +account, please email the administrator. + + + + +Saving Your Work + +Now that you have changed the motd file, it is time to save the file, putting the changes into effect. To do this, you can use either the File Menu, or you can use the Save Icon on the toolbar. + +At this point, reality hits us. You need to have root permission to save the changes to this file. &kde; handles this by asking you for the root password. + +You probably don't really want to save this file, so you can press Cancel in the password dialogue and Cancel again in the save dialogue. + +Finally, finish your work by closing the editor and file manager window. You can do this by clicking the X button on the top left of the window, by using the window menu of the title bar, or by choosing File Quit. Simple and elegant, isn't it? + + + + +Creating New Files + +As with everything in &kde;, there are several ways to create a new file. You could open up the file manager, right click on an empty space in a folder you own, and choose Create NewFileText File.... A new empty file will appear, which you can open just like any other. You can even do this right on the desktop itself. + +More often you are already in an application and want to start a new file. Most &kde; applications offer a FileNew menu item, and an icon on the toolbar to complement it. A new empty document will appear that you can immediately begin working in. + +Both these approaches have advantages, so use the one that is most practical at the time. + + + + + + +Moving Files With Drag and Drop + +As you have seen in the previous section, working with files is as easy as 1-2-3. However, when you want to copy and move files, the whole copy-and-paste business can get annoying. Don't worry — a procedure called drag and drop allows you to copy and move files more quickly and easily. + + +Opening Two File Manager Windows + +Before you can start, you will need to open two file manager windows. The simplest way to open a new window is to press the gear wheel button on the right of the icon bar. If you do not see the tree view in the new window, activate it (WindowNavigation Panel or press F9). + + + + +Dragging a File From One Window To Another + +In the first window, open the /etc folder and scroll until you see the motd file we modified in the previous section. + +In the second window, open your home folder. + +Click on the motd file. Hold your left mouse button and drag your file into your home folder. Release the left mouse button (this is called dropping the file). You will be presented up to four options: Copy Here, Move Here, Link Here and Cancel. In this example, since you are not root, you cannot move the file, so this option is not presented. Link Here will create a symbolic link to the file, while Copy Here and Move Here do exactly what they say. Select Copy Here. You should now have a copy of the motd file in your home folder. + + + + + +Using Command Line And Terminals + +So far, you have only worked with the tools and programs &kde; provides. Undoubtedly, you will want to use other &UNIX; programs as well. There are two ways of running them: The quick command line and the terminal. + + +Quick Command Line + +Pressing &Alt; F2 pops up a small window where you can enter a command to run. Please note that you will not see any text output generated from a program started in this manner! This method is only recommended for starting &X-Window; based programs or for running tools where you do not need to see or type anything. For other programs, you will still need to use the terminal. + + + + +The &UNIX; Terminal Emulator + +From the application menu, choose SystemTerminal . A terminal window will open. Here you can use regular &UNIX; shell commands: ls, cat, less, and so forth. Using the Settings menu, you can customise the terminal emulator to suit your needs. + + + + + +Finding Your Lost Files + +Everyone has undoubtedly encountered the following problem: You start ftp, log into a great site like ftp.kde.org and start downloading files. It is late in the evening and you shut down your machine after completing the transfer. The next morning, you are at the keyboard again, and you start wondering into which folder you placed the recently transferred files. Using &kde;'s &kfind; utility makes finding those lost files a snap. + + +Starting &kfind; + +Starting &kfind; is simple: Choose Find Files in the &kmenu;. &kfind; uses an interface part you probably have not yet met in &kde;: tabs. When &kfind; starts, you see that Name/Location is selected. When you click on Date Range, the tab content changes. Since you have never run a search before, most of the icons on the toolbar and most of the menu entries are disabled. We will change this now. + + + + +Finding a File by Knowing Parts of Its Name + +As long as you know a bit of the file name, searching is easy. Select the Name/Location tab, and enter the file name in the Named field. Wildcards may be used as needed. As a test, type *.tar.gz. By default, the search begins in your home folder, but you can select any starting folder you wish by clicking on the Look in or Browse.... To start searching, press the Find button. After a moment, a list of files will appear in the search results window. If they do not appear, you started the search in the wrong folder, made a spelling mistake in the Named field, or no files ending with a .tar.gz extension are located on your machine. + + + + +Finding a File by More Complex Criteria + +There are many categories you can use to make your search more precise. The more you know about the file, the better are your chances of finding it. + + + +Date Range + +Here, you can specify that you only want to see files which were last touched in a given period of time. You can also specify that you only want to see files that were touched since a specified number of months or days ago. + + + +File Type in the Contents tab. +If you know that the file was of a special type (⪚, a tar/gzip archive or a jpeg picture), you can tell &kfind; to find only this type of file. + + +Containing text in the Advanced tab + +You can specify text that the file must contain. + + + +File size is, in the Properties tab +If you know the file size, you can limit your search in this regard, as well. + + + +&kfind; has many more options to refine searches, explore them all! + + + + + +Using Multiple Desktops + +Using multiple desktops helps you organise your work. You can place your programs on different desktops, and name the desktops so you know what you do there. This increases and optimises your workspace. It also helps you when you are surfing the net instead of doing your work and your boss comes in. But, of course, this is rare — at least in the office where I work. + +You can switch between desktops by clicking the desktop buttons on the &kicker; panel. If you want to rename them, you can do so by double-clicking on them. + +You can use windows on multiple desktops. If you want to have a window present everywhere, just click the sticky button on the top-left of the window. To send a window to another desktop, click on the title bar with the right mouse button, choose To Desktop, and select the desktop where you would like the window moved. + + + + +Quitting &kde; + +To quit working with &kde;, you can use the Logout entry in the &kmenu;. You will be asked if you really want to quit &kde;. Quitting will close all windows and return you to your console or display manager. For information on how programs can save your work during logout, please read the notes for logging out. + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/history.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/history.docbook new file mode 100644 index 00000000000..ab2b9f729f9 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/history.docbook @@ -0,0 +1,91 @@ + +A Short Guided Tour of &kde;'s History + + +The CEO of a big software company, at the beginning of the 80s...(apocryphal) +640KB ought to be enough for everybody + + + +Before &kde; + +Since the beginning of &UNIX; development, there has been one great problem: There were stable kernels, and good, powerful software. Unfortunately, only a few people could use &UNIX;, because it was written mainly for those students and professionals who had studied the system for a long time. For example, the standard method for reading USENET news was: + +find /var/spool/news -name '[0-9]*' -exec cat {} \; | more + + +Although fast and relatively efficient, this couldn't be called user friendly. Today, there are many good front ends available, such as tin and &knode;, which provide easy-to-use, intuitive graphical user interfaces (&GUI;s). Unfortunately, the &GUI;s lack a common look-and-feel. Commercial libraries for programmers like &Motif; promised a solution to this, but these libraries remained, until recently, far too expensive and far too slow. + +The configuration of programs is also often difficult. While compiling is usually done with a command line such as ./configure && make && make only a very few programs can be configured with menus or scripts. In most cases, you must edit text configuration files yourself. It often happens that a misplaced period ruins the whole file, forcing you to restart the configuration process. Whenever you need to change your settings or reconfigure a program, the whole mess comes up again. + +All this contributes to the fact that &Linux; and other &UNIX;'s fail to reach a wider audience. At the same time, many people are not satisfied with their current operating system, often because of the lack of stability and performance found in those operating systems. Other people hate to buy a new computer each time a new version of the program they cannot live without comes out, because it needs more RAM and more disk space. Often the new version provides functions few people really need. + +&kde; is different. Although we do not try to replace the standard &UNIX; shell, we are working on a tool that will make using &UNIX; easier. We also want to attract more users to the &UNIX; environment. Simple things will be made easy, yet complex things will still be just as possible. A single interface will be provided, instead of the dozens currently required. + + + + + +What &kde; Can Do For You + +&kde; is designed for everyone. + +Those new to &UNIX;, or those who simply have no interest in learning to use new technologies and commands not found in their previous operating systems don't need to face the intricacies of the command line unless they want to. Yet there is much &kde; offers that is of value to experienced &UNIX; users, with &GUI; tools to make simple what were previously complex tasks, and the command line just a mouse click away if you want it. + +No matter what your level of experience with &UNIX; or any other operating system, &kde; brings you: + + + +A good looking, easy to use desktop environment. + + +A powerful, easy to use file manager + + +An equally powerful and easy to use web browser + + +A simple, centralised configuration + + +A comprehensive list of applications, so you can be productive within minutes of your first &kde; login. + + +Online help to support you in every situation. + + +Consistency of interface. Menus are in the same place across applications, keybindings behave the same way, toolbar icons, once learned, always work the same. + + + + + + +The Background Of &kde; + +In October 1996, German LyX developer Matthias Ettrich initiated the development of &kde; with a USENET posting. Soon after, a couple of interested developers began planning and programming parts of the new project. One year later, the window and file managers, the terminal emulator, the help system and the display configuration tool were released for Alpha and Beta testing and proved to be relatively stable. + +In July 1998, &kde; 1.0 was released. It was the stable version for the next six months, while developers continued work on improving &kde; without stability constraints. In January 1999, their improvements were consolidated and integrated to produce &kde; 1.1, the new standard, stable version. + +Development continued from there with &kde; 2.0, an almost complete rewrite of the desktop, being released on October 23rd 2000. The &kde; 2.x version evolved through six minor releases over the period of a year, each bringing an already impressive desktop further features and stability. + +At the time of writing, &kde; 3.2 is in preparation for release, introducing a broad range of improvements over the 2.0 series. Although the &GUI; didn't change as dramatically as it did during the move from &kde; 1 to &kde; 2, many refinements like a completely new printing system, vastly improved SSL support (for secure Internet transactions) or full support for languages which are written right-to-left (like Arabic or Hebrew) found their way into the desktop. You can find more information about this exciting development at &kde-http;. + +The developers and users communicate primarily via several mailing lists, as described in the Mailing Lists section. If you would like to help, please do, &kde; is driven by volunteer contribution, and you are always welcome to take part. + + + + +How To Get New Components + +The main web site for &kde; is &kde-http;. Here you can find all important information regarding &kde;, including announcements, bugfixes, developer information and much more. + +For software upgrades, please visit our &FTP; site, &kde-ftp;, or use a mirror if one exists near you. You can find an up to date list of mirrors at http://www.kde.org/ftpmirrors.html. + +On the &FTP; servers, the folder unstable always contains brand new software, but it is often untested and may not even compile. If you are looking for more reliable components, please take a look in the stable folder, where we put Beta and release versions. + +If you are interested in developing &kde; applications of your own, you should visit http://developer.kde.org/" where you will find a wealth of information, including tutorials, API guides to the &kde; libraries, and much more. You should also visit Troll Tech's server (http://www.trolltech.com) which features a great deal of information concerning the &Qt; library used by &kde;. You will probably find it valuable to join the &kde; developer mailing list. + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/index.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/index.docbook new file mode 100644 index 00000000000..53872f918b1 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/index.docbook @@ -0,0 +1,64 @@ + + + + + + + + + + + + + + + +]> + + + +K Desktop Environment + + +The KDE Team + +MalcolmHunter
malcolm.hunter@gmx.co.uk
Conversion to British English + + +2003-10-19 +3.2 + + +2000200120022003 +The KDE Team + + +&GPLNotice; + + + +This is the &kde; User's Guide, a complete documentation of the K Desktop Environment from the user perspective. The K Desktop Environment is a collection of tools that will make your &UNIX; life easier and more enjoyable. + + +KDE +user +guide + + + +&introduction; +&history; + +&first-impressions; +&getstarted; +&about-desktop; +&shortcuts; +&ug-faq; +&more-help; +&staff; +¬ices-and-trademarks; + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/installation.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/installation.docbook new file mode 100644 index 00000000000..d11a12bda42 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/installation.docbook @@ -0,0 +1,240 @@ + +Installation + + +Linus Torvalds, after finding one of his file systems smashed by a new Beta kernel +Core dumping fsck's tend to make me nervous + + +Don't worry! Although the use of some Beta software can cause considerable grief, it is unlikely that the installation of KDE will trash your hard disk. In fact, this chapter is designed to guide you through the installation process, so that you can take a look at your new desktop as quickly (and with as little grief) as possible. As with all new Window Manager installs, it is recommended that you back up all your X11-specific configuration files before you begin the install. If you do not know the exact location of them, try all the hidden (.*) files in your home folder and the folder /usr/X11/lib/X11/xdm. + + +Requirements + +Before installing KDE, ascertain that your system fulfills the following requirements: + + + +A running POSIX compatible UNIX system. UNIX's that are known to work with KDE include: Linux, FreeBSD, Solaris, HP-UX, and MkLinux. We are working to make KDE available for more platforms soon. + +Some free hard disk space on the partition where /opt/kde will be created. We recommend that you reserve about 50MB if your system supports shared libraries, and considerably more if it does not. If you need or want to build KDE from the source tree, please remember to reserve about 100MB in /usr/src. + +A running X11 system with or without xdm. If you have not installed the X Window System yet, first check your UNIX installation media for an installable version. If you cannot find any version working, visit the XFree86 web site for more information on how to get and install the X Window System, or contact your UNIX vendor support. + +The &Qt; libraries, version 3.2 or higher. You can obtain these at Troll Tech's FTP Server in tgz format. + + + +A warning before you start: Before upgrading from a previous version of &kde;, we recommend that you do the following: + +cd /opt/kde +tar + + + + + + +Linux: Installing RPMs for RedHat, Caldera and SuSE. + +Using RPMs is the easiest method to get KDE up and running. Just visit your favourite KDE mirror and visit the folder /pub/kde/stable/distribution/rpm. There, you can see folders for different operating systems. Currently, the i386, alpha and sparc architectures are supported. The RPM packages can also be found on the Red Hat contrib sites like sunsite.unc.edu or ftp.redhat.com. + +The basic system consists of the files kde-component.architecture.rpm You need at least tdesupport, tdelibs and tdebase. After getting the base distribution, feel free to download any other RPMs that you think may come in handy. + +Next, start installing with the base package. If you are installing KDE for the first time, use + +rpm tdesupport.arch.rpm +rpm tdelibs.arch.rpm +rpm tdebase.arch.rpm + + +It is important that these components are installed in the order listed, and that they are installed before any other KDE component. + +If you are upgrading from a previous release, try rpm kde-component.arch.rpm + + + +Once again, the order given above should be preserved, and the given components should be installed before any other KDE components. + +This will unpack the base distribution and install it by default in /opt/kde. + +If the installation of the base packages has been successful, you can install the remaining packages (use instead of once again to update an existing version) the same way. + + + + +Linux: Installing <acronym>DEB</acronym>s for debian + +The installation for a Debian system is also rather straightforward. You will only find KDE 2.0 packages for Debian 2.2 (Potato) and 3.0 (Woody). We describe here how to install packages for Debian 2.2, the stable version, since Debian 3.0 is still in development. However, the installation for both versions, is almost identical. The main difference is that KDE is officially included in Debian 3.0 and you do not need to specify any special location to find the deb packages for KDE. + +The first step is to tell your system where it can find the deb packages for KDE. A list of locations for the Debian packages is kept on your hard disk in /etc/apt/sources.list. You should add to that file the following line: http://kde.tdyc.com/ stable kde2 + + +Then you have to update your local package database so that your system knows that there are new packages available. Type the following command: + +apt-get + + +Finally you should install the KDE base components. This is accomplished by typing: + +apt-get + + +If you want to install other components you should try some, or all of these options: + +apt-get +apt-get +apt-get +apt-get +apt-get +apt-get +apt-get +apt-get +apt-get +apt-get +apt-get + + +You may also be interested in installing your language. + +apt-get + +where xx has to be substituted by the country code. + +The control files for some TDE applications will be placed at /etc/kde2, the executables will go in /usr/bin and most of the auxiliary files in /usr/share under different folders. + +If you are upgrading from a previous version of KDE you should perform the following steps. First, update file /etc/apt/sources.list by changing the line with the location of KDE packages with line: http://kde.tdyc.com/ stable kde2. Second update your package database: + +apt-get + + +Finally install the KDE base system: + +apt-get +apt-get + + +If you want to install more KDE components try some, or all of these options. + +apt-get +apt-get +apt-get +apt-get +apt-get +apt-get +apt-get +apt-get +apt-get +apt-get +apt-get + + + + + +Using Source Compilation to Install on Top of Other Systems + +If your Linux distribution did not come with an RPM or DEB archive format, or you are not using Linux at all, you must compile KDE on your own. In the future, we are planning to provide a binary distribution which includes its own installation program. + +In order to compile and install KDE properly, you need to have the following items installed on your hard disk: + + +An ANSI-C compiler, e.g. the GNU C compiler. +An ANSI-C++ compiler, e.g. GNU C++. +The make utility. +Qt development version 2.2 or higher. +X11 development version (include files are often missing) + + +Once you have all the needed helper applications, go to your favourite KDE mirror and retrieve the following files from the folder /pub/kde/stable/newest version: + + +tdesupport-version.tar.gz +tdelibs-version.tar.gz + +tdebase-version.tar.gz +any other packages you wish to install. We advise you to get at least tdeutils. + + +In all cases above, version stands for the current version number. Once you have downloaded all you need, extract these files to /usr/src. This process should yield the following folder structure: + + +/usr/src/tdesupport +/usr/src/tdelibs +/usr/src/tdebase +/usr/src/... (any other packages) + + +Make sure you have write permissions to /opt/kde. + +Next you must compile and install the packages using the following: + + +cd into the folder of the package, you want to install (see above) +./configure (with the options you want to apply) +make +make install + + +Apply the above steps to every package you want to install. + +These instructions can be used for almost every source package available, not just KDE packages. + +Every configure script has several options available. Some are common between the packages while others are specific to an individual package. The following is a small part of the result of configure in tdelibs: + + + Installation directories: + --prefix=PREFIX install architecture-independent files in PREFIX + [/usr/local/kde-cvs] +... +Optional Features: + --disable-FEATURE do not include FEATURE (same as --enable-FEATURE=no) + --enable-FEATURE[=ARG] include FEATURE [ARG=yes] + --disable-fast-perl disable fast Makefile generation (needs perl) + --enable-debug=ARG enables debug symbols (yes|no|full) default=no + --disable-debug disables debug output and debug symbols default=no + --enable-strict compiles with strict compiler options (may not work!) + --disable-warnings disables compilation with -Wall and similar +... + + + +Several options are not required and are only useful as workarounds for known problems (⪚ ). Since some are important options, for instance --with-shadow, you should always check the available options. + +An important option is . This option specifies the path where configure should install (for tdesupport and tdelibs) or where to look for libraries (for the other packages). By default, configure will look in /usr/local/kde . If you want to install &kde; into /opt/kde, you have to use configure . + +If you have installed the &Qt; libraries in an uncommon place, for instance in $HOME/src/qt, you must use configure . By default configure looks in the most common places for &Qt; before it gives up. + +If you have problems that you are not able to solve, send a copy of the config.log file to the address given in the offending package's README file. + +You must install KDE in the following order: arts, tdelibs, then the application packages (for example tdebase). All the application packages should only depend on tdelibs, so you can compile them at the same time (if you have a powerful machine). + +If you want to take advantage of multiprocessor systems, try make instead of make. + + +Platform Specific Building Notes + + +Linux + +For &Linux;, most of the utilities needed to build &kde; can be found either at ftp://sunsite.unc.edu/pub/Linux/GCC or ftp://sunsite.unc.edu/pub/GNU. The Qt libraries can be found at ftp://ftp.troll.no/pub/qt/source, available as source code. Detailed instructions on how to install them are provided. Include files for X11 programs should be available at ftp://ftp.xfree86.org in the xdevel section. + + + + + + +Required Changes To Your Configuration Files +After you have placed the KDE binaries into their destination folder, there are a few adjustments you must make to your startup scripts. +The following procedure was tested on SuSE Linux 5.0, and should be compatible with the other popular UNIX's as well. Always make backups of configuration files before changing them! Add the following to the end of your /etc/profile: + +export PATH=$PATH:/opt/kde/bin +export TDEDIR=/opt/kde + + +Next, edit the .xinitrc file in your home folder. Look for the line that calls your window manager and replace it with starttde. +Now that everything needed to run KDE has been installed, you can go on to chapter 4 where you will start KDE for the first time. If something goes wrong, you may need to compile KDE on your own. Read Using Source Compilation to Install on Top of Other Systems for more information. +We have made the installation as bulletproof as possible, so you should not encounter any serious problems unless your configuration is exotic. If you do experience difficulties feel free to use the KDE mailing lists + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/intro.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/intro.docbook new file mode 100644 index 00000000000..b9f94c572c1 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/intro.docbook @@ -0,0 +1,14 @@ + +Introduction + +Welcome to the K Desktop Environment User Guide. + +This book is intended to be an introduction to the K Desktop Environment as a whole, with a broad description of the user interface, some practical examples on how to use &kde; for daily work, and some hints on how to customise the &kde; desktop. + +Included is a table of shortcuts, and some tips and tricks intended to help you find your way around quickly and efficiently. + +This book is not a guide to the use of the individual applications, as they each have their own User Manual. However, &kde; is an integrated environment — what you learn in this manual and in your own exploration of &kde;'s interface is consistent and readily transferable between &kde; applications. + +This book also explores some of the philosophy behind &kde; and some of its history, and rounds out with how to find more information, should you need it. + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/more-help.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/more-help.docbook new file mode 100644 index 00000000000..006fb573728 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/more-help.docbook @@ -0,0 +1,29 @@ + +Further Help + + +Other Sources for Help + +Take a look at the &kde-http; for the most up-to-date information available about &kde; on the web. You may also want to subscribe to our mailing lists. + +You can subscribe at the web pages listed below: + + + +&kde; announcements - http://mail.kde.org/mailman/listinfo/kde-announce + +&kde; users' mailing list - http://mail.kde.org/mailman/listinfo/kde + +KDE developers' mailing list - http://mail.kde.org/mailman/listinfo/kde-devel + +KDE look and feel discussions - http://mail.kde.org/mailman/listinfo/kde-look + +KDE licensing questions - http://mail.kde.org/mailman/listinfo/kde-licensing + +KDE Documenters' list - http://mail.kde.org/mailman/listinfo/kde-doc-english + + +Many &kde; applications and sub-projects maintain more specific lists for themselves. You can find a complete list of archives at http://lists.kde.org/. + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/notices-trademarks.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/notices-trademarks.docbook new file mode 100644 index 00000000000..bf9ed76bd65 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/notices-trademarks.docbook @@ -0,0 +1,57 @@ + +Legal Notices + +Licence + +&kde; is open source software, and all of &kde; is released under free licenses such as the GPL. + + + + +Trademarks + + + +All trademarks mentioned on this web server or in &kde; documentation are recognised as belonging to their respective owners, including but not limited to: + + +&AIX; is a registered trademark of IBM Corporation +&CSS;, &XHTML;, &XSL; and &XML; are common law trademarks of the Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, or Keio University on behalf of the World Wide Web Consortium. +&Handspring; and &Visor; are trademarks of Handspring, Inc. and may be registered in certain jurisdictions. +&Hewlett-Packard;, &HP; &LaserJet;,&HP-UX; PCL, PCL 5 and PCL 6 are U.S. registered trademarks of Hewlett Packard Company. +&IRIX; is a registered trademark and &SGI; is a trademark of Silicon Graphics, Inc. +&Java; and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. +&Jini; and all Jini-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. +&Linux; is a registered trademark of Linus Torvalds +&LinuxPPC; is a trademark of LinuxPPC Inc. +&Mac; is a trademark of Apple Computer Inc., registered in the United States and other countries. +&Mandrake; and &Linux-Mandrake; are trademarks of MandrakeSoft. +&Netscape; is a registered trademark of Netscape Communications Corporation in the United States and other countries. +&NeXTSTEP; is a trademark of NeXT Software, Inc., registered in the U.S. and other countries. +&PalmOS;, &HotSync; and &PalmPilot; are registered trademarks of Palm, Inc. +&PostScript; is a registered trademark of Adobe Systems Incorporated. +&Qt; is a trademark of Trolltech AS +&RedHat; and all Red Hat-based trademarks and logos are trademarks or registered trademarks of Red Hat, Inc. in the United States and other countries. +&Sendmail; is a registered trademark of Sendmail Inc. +&Solaris;, Sun and SunOS are trademarks of Sun Microsystems Inc. +&SuSE; is a registered trademark of SuSE AG +&ThreeCom; is a registered trademark of 3com corporation in the United States and other countries. +&Motif;, &UNIX; and the X device are registered trademark of The Open Group in the United States and other countries +&Microsoft; and &Windows; are registered trademarks of the Microsoft Corporation +XFree86 is pending trademark registration by The XFree86 Project, Inc. + + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/shortcuts.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/shortcuts.docbook new file mode 100644 index 00000000000..e073b4eedac --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/shortcuts.docbook @@ -0,0 +1,160 @@ + +Tips & Tricks for Your Daily Work + + +Fortune Cookies +Everyone can make an omelette with eggs. The trick is to make one with none. + + +Nearly everyone can use &kde;; this is why the developers made it. There are no cryptic switches with which to cope, and few configuration files you need edit in ASCII style. However, there are some ways you can do your work more elegantly, saving you time for the truly important things, like &ksirtet;. + + +Shortcut Table + + + + +&Alt;Tab or &Alt;&Shift;Tab +Cycle through the windows + + + +&Ctrl;Tab or &Ctrl;&Shift;Tab +Cycle through your desktops + + + +&Alt;F2 +Mini Command line + + + +&Alt;F3 +Window Menu + + + +&Alt;F4 +Close the current window + + + +&Ctrl;F{1..8} +Switch to a specific desktop + + + +&Ctrl;&Alt;Esc +Window destroyer (every window you click on will be destroyed). Press this key combination again to cancel the killer cursor. + + + +&Ctrl;&Alt;Backspace +This exits &kde; (without saving!) Use this as a last resort + + +&Ctrl;&Alt;Numpad + +Cycles to the next screen resolution. You need to configure this in your &X-Server; configuration for it to work. + + + +&Ctrl;&Alt;Numpad - +Cycles to the previous screen resolution. You need to configure this in your &X-Server; configuration for it to work. + + + + + + +Mouse Techniques + +Note these are defaults only, and you can customise them to your liking. + + + + +Clicking on the border or the titlebar + + + + +Left +Activates and raises the window. + + + +Middle +Lowers the window + + + +Right +Shows the Window menu if the window is active, otherwise activates the window. + + + + + + +Doubleclick on the window title +Shades the window (rolls it up so only the titlebar is visible). + + + +Drag on the titlebar +Moves the window around. + + + +Drag on corners or edges +Resizes the window. + + + +&Alt;Left Button +Moves the window around. + + + +&Alt;Middle Button +Raises the window. + + + +&Alt;Right Button +Resizes the window in the direction you drag the mouse. + + + +Click on the Icon on the top left +Close the application + + +Click on the Sticky Button +toggles sticky + + + +Clicking on Maximise + + + +Left +Maximises the window + + +Middle +Maximises only vertically + + +Right +Maximises horizontally + + + + + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/staff.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/staff.docbook new file mode 100644 index 00000000000..de90b43f7db --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/staff.docbook @@ -0,0 +1,65 @@ + +Epilogue + + +The end of Evita +She had her moments, she had some style, the best show in town was the crowd, outside the Casa Rosada crying 'Eva Peron'; but that's all gone now... + +We hope that you found this documentation useful, informative and perhaps even entertaining. The following things are not necessary to understand the Trinity Desktop Environment, but you still may want to read it. + + +The K Documentation Staff + +This User Guide has been updated for 3.0, and is currently maintained by Lauri Watts lauri@kde.org + +Others who have contributed to this guide. + +Pablo de Vicente vicente@oan.es, who updated the section regarding installing on Debian for KDE 2.0 +Andreas Buschka andi@circe.tops.net +Robert D. Williams rwilliam@kde.org +Poul Gerhard +John Waalkes +Vernon Wells +Kay Lutz +Stephan Kulow + + + + +We still need people! + +KDE is a huge project, and every KDE supporter has already realised that. All of us are trying very hard to create a user interface that is easy to use and maybe also has the potential to make UNIX ready for the desktop PC. You have the chance to participate in this project too, and we would be thankful if you did. Developers and interested users communicate via several mailing lists described in . If you would like to help, please do so! We are still looking for helpers in the following departments: + + +Development (Libraries and Applications) +Documentation +Graphics +Beta-Testing +and everywhere else, too :-) + + + + + +Legal notices + +This document contains copyrighted material from Andreas Buschka, Gerhard Poul and Robert David Williams. All trademarks and branded names mentioned are properties of their legal owners. + + + + +Sources of information used during the creation of this book + +During the creation of this documentation, the authors used the following sources for information: + + +The KDE Mailing lists +Various README and HTML help files that came with the KDE components + + + + + +Licence +&underGPL; + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/ug-faq.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/ug-faq.docbook new file mode 100644 index 00000000000..75ccff2aec1 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide/ug-faq.docbook @@ -0,0 +1,58 @@ + +Frequently Asked Questions About &kde; + + +Batman Animated Series +What are you? +I'm your worst nightmare... + + +There are some questions that are always raised on the &kde; mailing lists. To keep the traffic as low as possible (making the lists more readable), we have included them in this section. So please be kind and do not ask them in the mailing lists anymore - think of the quote above! + + + + + +What does &kde; stand for? +Originally the K stood for Kool, nowadays the K has no meaning and &kde; simply stands for the K Desktop Environment. &kde; is intended to be a collection of small tools, a window manager, a file manager and tools that bring all this together. It is created to make your life with &UNIX; easier. + + + +I cannot compile package xxx + + +Always be sure that you have the newest version of the &kde; libraries installed. The software is in constant development, so the dependencies can change from one day to another if you are using CVS. For most users, using a released version is much more practical. + +Another problem could be that you are using a program written for a very old version of &kde;, which depends on outdated include files. Check in the source archive's README to see if it explains which version of &kde; the application is looking for. If that file doesn't exist, check the file dates. They should be more recent than your current &kde; version. + + + + + +What version of &kde; should I use for a stable desktop? +One can, in general, obtain &kde; in many ways. Obtaining pre-compiled binaries in a package format (rpm,deb,tgz) labeled with a particular version (⪚ 3.2) is the best way to encourage stability on your &kde; desktop. + + + + + +But I heard that my problem/wishlist item is already in CVS. I want to get my hands on the new features, why shouldn't I try CVS? + + +The price of stability is that one must wait for each release to get new features. Conversely the price of being the first to see new features, is that you risk stability. &kde; has a fairly frequent release schedule, and stability of released versions is a particular focus. For the majority of &kde; users, unless you are planning to help develop &kde;, there is little advantage to running development versions of &kde;. + +However, there is always a place for experienced users who know what they are letting themselves in for, and are willing to report bugs found. If this is you, then there is no reason not to try the CVS versions. Be prepared for things to break occasionally, CVS gives you a snapshot of source code that is currently being worked on. + +These are daily snapshots of whatever the developers are working on, and some things are guaranteed to be broken. + + +Do not rely on CVS snapshots to maintain operational desktops. You will get burned eventually! + + + + + + + + diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/visualdict/CMakeLists.txt b/tde-i18n-en_GB/docs/tdebase/khelpcenter/visualdict/CMakeLists.txt new file mode 100644 index 00000000000..e31b81cada8 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/visualdict/CMakeLists.txt @@ -0,0 +1,6 @@ +# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer + +tde_create_handbook( + DESTINATION khelpcenter/visualdict + LANG en_GB +) diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/visualdict/Makefile.am b/tde-i18n-en_GB/docs/tdebase/khelpcenter/visualdict/Makefile.am new file mode 100644 index 00000000000..f2bfec833e0 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/visualdict/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = en_GB +SUBDIRS = $(AUTODIRS) +KDE_DOCS = khelpcenter/visualdict +KDE_MANS = AUTO diff --git a/tde-i18n-en_GB/docs/tdebase/khelpcenter/visualdict/index.docbook b/tde-i18n-en_GB/docs/tdebase/khelpcenter/visualdict/index.docbook new file mode 100644 index 00000000000..a6b7bd0174f --- /dev/null +++ b/tde-i18n-en_GB/docs/tdebase/khelpcenter/visualdict/index.docbook @@ -0,0 +1,295 @@ + + + + + + +]> + + + + +The &kde; Visual Guide + +The KDE Team +MalcolmHunter
malcolm.hunter@gmx.co.uk
Conversion to British English + + +2000-10-04 +2.00.00 + + +2000 +The KDE Team + + +&FDLNotice; + +A visual guide to &kde;'s interface. This is a very early version of the document. Eventually, this will be a graphical tour of &kde;. + + +KDE +Visual +Dictionary +Guide + + + + + + + + + + +&kde; Visual Dictionary of terms + +This project was started to help unify the vocabulary used in &kde; documentation. + +We provide this for you here as an aid to learning your way around the &kde; Graphical User Interface. These names have been standardised within &kde; documentation, so that you will always find interface items referred to in the same way. + +The term Widget refers to the basic building block of a computer program's interface. +Each widget operates in a similar manner each time it is used, but the effect that the widget has depends on its place within the program. + + + +Listing of Common &kde; Widgets +Currently, this guide consists of a table of the names of the graphical elements often found in &kde; documentation, and an example of each one. +Our hope, eventually, is to make this a much more complete document, which will take you on a visual tour of &kde;. + + + + + + +Button + + + + + + + + + + +Check Boxes + + + + + + + + + + +Colour Selector + + + + + + + + + + +Combo Box + + + + + + + + + + +Dialogue Box + + + + + + + + + + +Drop Down Box + + + + + + + + + + +Icon List + + + + + + + + + + +List Box + + + + + + + + + + +Menubar + + + + + + + + + + +Progress Bar + + + + + + + + + + +Radio Buttons + + + + + + + + + + +Scroll Bar + + + + + + + + + + +Slider + + + + + + + + + + +Spin Box + + + + + + + + + + +Status Bar + + + + + + + + + + +Text Box + + + + + + + + + + + +Toolbar + + + + + + + + + + +Tree View + + + + + + + + + + + +Window Titlebar + + + + + + + + + + + + + + + +Credits and Licences +&kappname; + +Documentation by the KDE Documentation Team. +&underFDL; + + + -- cgit v1.2.1