diff options
author | Slávek Banko <slavek.banko@axis.cz> | 2020-11-17 23:50:55 +0100 |
---|---|---|
committer | Slávek Banko <slavek.banko@axis.cz> | 2020-11-17 23:50:55 +0100 |
commit | dc7d2fcb9b6d044fd9bc1bdc5d077ed11c0686b1 (patch) | |
tree | eb6b216344555e136ff38747f5f3462377c2eacf /tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide | |
parent | fff371d8d9ed1ea3b1c771fbc07f95a12658e723 (diff) | |
download | tde-i18n-dc7d2fcb9b6d044fd9bc1bdc5d077ed11c0686b1.tar.gz tde-i18n-dc7d2fcb9b6d044fd9bc1bdc5d077ed11c0686b1.zip |
Move the khelpcenter guides to the directory level in which they are installed.
Signed-off-by: Slávek Banko <slavek.banko@axis.cz>
Diffstat (limited to 'tde-i18n-en_GB/docs/tdebase/khelpcenter/userguide')
14 files changed, 1454 insertions, 0 deletions
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 @@ +<chapter id="all-about-your-desktop"> +<title>All About Your Desktop</title> + +<epigraph> +<attribution>Little Red Riding Hood</attribution> +<para>Grandma, what big eyes you have!</para> +</epigraph> + +<epigraph> +<attribution>The Wolf</attribution> +<para>The better to see you!</para> +</epigraph> + +<para>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. </para> + +<sect1 id="the-autostart-folder"> +<title>Autostarting Applications</title> + +<para>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 <filename>Autostart</filename> folder for these programs.</para> + +<para>To launch programs when &kde; is started, do the following:</para> + +<procedure> +<step> +<para>Open the <filename>Autostart</filename> folder. By default this folder is at <filename class="directory">$<envar>HOME</envar>/.trinity/Autostart</filename></para> +</step> +<step> +<para>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 <xref linkend="the-filemanager-screen"/>.</para> +</step> +<step> +<para>Drag and drop the desired program from the &konqueror; window on to the <filename class="directory">Autostart</filename> folder. When asked, choose <guimenuitem>Link</guimenuitem> to create a symbolic link rather than a full copy, as this saves a great deal of disk space.</para> +</step> +<step> +<para>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;.</para> +</step> +<step> +<para>Restart &kde; if you want to see the autostart function in action.</para> +</step> +</procedure> + +<para>Your programs should have launched automatically when &kde; restarted.</para> + +<para>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.</para> + +</sect1> + +<sect1 id="adding-programs"> +<title>Adding Programs and Shortcut Icons to Your &kmenu; and Panel</title> + +<para>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.</para> + +<sect2 id="menu-items-add"> +<title>Adding menu entries</title> + +<para>&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 <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> and entering <userinput>kappfinder</userinput> to see it in action — operation is very straightforward.</para> + +<para>&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.</para> + +<para>To add your favourite programs to the &kde; menu, you can use the <application>KDE Menu Editor</application>. To start it, use the &kmenu; and choose <menuchoice><guimenuitem>Settings</guimenuitem><guimenuitem>Menu Editor</guimenuitem></menuchoice>.</para> + +<para>A window will open showing the existing &kmenu; on the left, and an empty menu entry dialogue on the right</para> + +<para>For this example, we will be adding an entry for the <application>Gimp</application> under the <guisubmenu>Graphics</guisubmenu> submenu. If you already have a <guimenuitem>Gimp</guimenuitem> entry there and don't want a new one, you can still follow through this example, but just don't click the <guibutton>Apply</guibutton> when you are done.</para> + +<procedure> +<step><para>Navigate down the left hand tree to the <guisubmenu>Graphics</guisubmenu> entry.</para></step> +<step> +<para>Click on it once with the <mousebutton>left</mousebutton> mouse button to expand the entry.</para> +</step> +<step> +<para>Click the icon labelled <guiicon>New Item</guiicon> in the toolbar, or choose <menuchoice><guimenu>File</guimenu><guimenuitem>New Item</guimenuitem></menuchoice> in the menu bar.</para> +</step> +<step> +<para>In the dialogue box that pops up, enter the name you want your new menu entry to have. For this example, enter <userinput>Gimp</userinput>.</para><para>Then press <guibutton>OK</guibutton> in the dialogue.</para> +</step> +<step> +<para>Click on the new <guimenuitem>Gimp</guimenuitem> menu entry that was created for you under the <guisubmenu>Graphics</guisubmenu> submenu. The menu entry dialogue to the right will now change to be mostly empty, except for the name you already gave.</para> +</step> +<step> +<para>Fill in an optional <guilabel>Comment</guilabel>. You might like to put <userinput>An image editor</userinput> for the example. Text entered here will be shown as a tool-tip in the &kmenu;.</para> +</step> +<step> +<para>Enter in the box labelled <guilabel>Command</guilabel>, the command you would type on the command line to open your application. For this example, this is <command>gimp</command>. 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.</para> +</step> +<step> +<para>If you want the application to operate from a particular folder (for example, for <application>Gimp</application> to begin its <guilabel>Load Image</guilabel> dialogue in a particular place) enter this path in the box labelled <guilabel>Work Path</guilabel>. This is optional.</para> +</step> +<step> +<para>If you wish to change the icon from the default <quote>unknown</quote>, click on the <guiicon>icon</guiicon> to the right of the dialogue, to open a standard &kde; icon chooser.</para> +</step> +<step> +<para>Some applications must be <guilabel>run in a terminal</guilabel> window (for example <application>Pine</application>). If this is the case, check the appropriate check box.</para> +</step> +<step> +<para>If you want to run your application as a different user, check the box labelled <guilabel>Run as a different user</guilabel> and enter the appropriate user name in the text box.</para> +</step> +<step> +<para>If you're happy with your menu entry, press <guibutton>Apply</guibutton>. If you would like to start over, press <guibutton>Reset</guibutton>.</para> +</step> +</procedure> + +<para>And that's all. You now have a new menu entry.</para> + +</sect2> + +<sect2 id="icons-add"> +<title>Shortcut Icons</title> + +<para>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.</para> + +<para>To create a shortcut on the &kicker; panel, you have some choices: Drag-and-drop, or via a menu. </para> + +<procedure> +<title>Adding a shortcut icon with the menu</title> +<step><para>Click on the &ticon; and choose <menuchoice><guisubmenu>Panel Menu</guisubmenu><guisubmenu>Add</guisubmenu><guimenuitem>Application</guimenuitem> </menuchoice>.</para></step> +<step><para>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 <guimenuitem>Home folder</guimenuitem> or &konqueror;. Click on the program you want.</para> +</step> +</procedure> + +<para>A new icon will appear on the panel. Click on it, and the program will start.</para> + +<para>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.</para> + +<para>What happens when you drag an item to your panel depends on what kind of item it is:</para> + +<variablelist> +<varlistentry> +<term>If you drag a folder...</term> <listitem><para>A menu will pop up giving you a choice of <guimenuitem>Add as a File Manager URL</guimenuitem> or <guimenuitem>Add as a QuickBrowser</guimenuitem>. 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.</para></listitem> +</varlistentry> + +<varlistentry> +<term>If you drag a shortcut from your desktop...</term> +<listitem><para>It will be copied to the panel.</para></listitem> +</varlistentry> + +<varlistentry> +<term>If you drag a document...</term> +<listitem><para>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.</para></listitem> +</varlistentry> +</variablelist> + +<para>In any case, if you want to move the icon, click on it using the &RMB; and choose <guimenuitem>Move <replaceable>Name of Button</replaceable></guimenuitem> 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 <guimenuitem>Remove <replaceable>Name of Button</replaceable></guimenuitem>.</para> + +</sect2> +</sect1> + +<sect1 id="creating-new-files-on-your-desktop"> +<title>Creating New Files On Your Desktop</title> + +<para>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.</para> + +<para>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 <filename class="directory">/home/stupiddog</filename>, so my Desktop folder is <filename class="directory">/home/stupiddog/Desktop</filename>. Everything you save there will be put on your desktop.</para> + +<para>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 <link linkend="moving-files-with-drag-and-drop">Moving files with drag & drop.</link></para> + +</sect1> + +<sect1 id="desktop-links"> +<title>Placing Links on Your Desktop</title> + +<para>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?</para> +<!-- +<sect2 id="using-mimetype"> +<title>Using Templates</title> + +<para>Templates provide a convenient mechanism for performing tasks +such as those outlined above. Templates can also be used to associate +particular file extensions with a specific application. When a file +ending in a known extension is double-clicked, the application +associated with that extension is automatically started. In short, +<emphasis>templates</emphasis> help you get the most out of +&kde;.</para> + +<para>Example: You want to put an icon for visiting the &kde; web site +on your desktop.</para> + +<procedure> +<step><para><mousebutton>Right</mousebutton> click on an empty space +in the desktop.</para></step> <step><para>Choose +<menuchoice><guisubmenu>Create +New</guisubmenu><guisubmenu>File</guisubmenu><guimenuitem>Link to +Location (URL)</guimenuitem></menuchoice> from the context +menu.</para></step> <step><para>A dialog box will open where you can +type in the address you are making a shortcut to.</para></step> +<step><para>A new icon will be created on your desktop.</para></step> +</procedure> + +<para>Your new Internet shortcut can be customized like any other +shortcut icon. <mousebutton>Right</mousebutton> click on the icon and +choose <guimenuitem>Properties</guimenuitem>, and you can change the +icon, or the name of the shortcut as you wish.</para> + +</sect2> +--> + +<sect2> +<title>Using &MIME; Types and File Associations</title> + +<para>&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 <literal role="extension">.mod</literal> files could be set to start &noatun;, <literal role="extension">.html</literal> files could open a &konqueror; window showing the file, and a <filename>core</filename> file can be viewed with the &khexedit; by simply clicking on the <filename>core</filename> file.</para> + +<warning> +<para>Although &MIME; types are very powerful, they are not without dangers. Playing around with &MIME; types as the system administrator (<systemitem class="username">root</systemitem>) can damage a &kde; system so severely that it cannot be restarted! In this example, you will create your <emphasis>personal</emphasis> &MIME; style, which is only relevant for you. It will only affect other users if you copy or move it to <filename class="directory">$<envar>TDEDIR</envar>/share/mimelnk</filename>.</para> +</warning> + +<para>To link a certain file type with a particular application:</para> + +<procedure> + +<step><para>Make sure the application you want to start this file type has an entry in the &kmenu;.</para></step> + +<step><para>In &konqueror; find or make a file with the extension you wish to link.</para></step> + +<step><para><mousebutton>Right</mousebutton> click on the file, and choose <guimenuitem>Properties</guimenuitem> from the context menu and then press the tiny button with an icon next to the <guilabel>Type</guilabel> resulting properties dialogue. Or, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Edit File Type...</guimenuitem></menuchoice> in the &konqueror; menu bar.</para></step> + +<step><para>Add file masks for the application by clicking the <guibutton>Add</guibutton> button, and entering the file pattern you want. Remember that &UNIX; is case sensitive, so you may need to add variations - <userinput>*.mp3</userinput> may need <userinput>*.MP3</userinput> added as well, for example. Add as many masks as you like in this way.</para></step> + +<step><para>Add a description if you like. This is optional.</para></step> + +<step><para>In the section labelled <guilabel>Application Preference Order</guilabel>, press the <guibutton>Add</guibutton> 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.</para></step> + +<step><para>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 <guibutton>Move Up</guibutton> and <guibutton>Move Down</guibutton> buttons.</para></step> + +<step><para>If you're satisfied with your choices, you can click the <guibutton>Apply</guibutton> 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 <guibutton>OK</guibutton> to save your changes and close the dialogue box, or <guibutton>Cancel</guibutton> if you have changed your mind and just want to close the dialogue box.</para></step> +</procedure> + +<para>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.</para> + +<note> +<para>&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 <command>gunzip</command> won't operate on files that aren't named <literal role="extension">.gz</literal>. </para> + +<para>&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 <literal>^<replaceable>clientname</replaceable>*</literal>. Then any files that have <replaceable>clientname</replaceable> at the beginning (the <literal>^</literal> character means <quote>starts with...</quote>) will be opened with the application you choose. </para> +</note> +</sect2> + +</sect1> + +<sect1 id="using-the-trashcan"> +<title>Using the Trash Can</title> + +<para>Under normal circumstances, deleting a file under &UNIX; is something which cannot be undone. However, with &kde;, you can choose <guimenuitem>Move to Trash</guimenuitem> instead of <guimenuitem>Delete</guimenuitem>. This will move the file into the <filename class="directory">Trash</filename> Folder, which, by default, is accessible as an icon on your desktop. In the <filename class="directory">Trash</filename> 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 <guimenuitem>Empty trashcan</guimenuitem>, otherwise you might run out of disk space because the files still need space. Note, however, that once you empty the <filename>Trash</filename> Folder, the files contained therein are lost forever.</para> + +</sect1> +</chapter> 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 @@ +<chapter id="first-impressions"> +<title>First Impressions </title> + +<epigraph> +<attribution>Origin unknown</attribution> +<para>You see to sea to see all that you can see is sea</para> +</epigraph> + +<para>First impressions are so important -- this is not only true for Agatha Christie's famous thriller <quote>The Mousetrap</quote> -- 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. </para> + +<sect1 id="starting-kde"> +<title>Starting &kde; </title> + +<para>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: </para> + +<screen><command>startx</command> +</screen> + +<para>If the installation was successful, the &kde; desktop should appear after a few seconds of initialisation. </para> + +<para>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. </para> + +<para>If you have not done so already, we recommend changing your X display manager from <application>xdm</application> to &tdm;, which includes the same functionality, but with the advanced features of the K Desktop Environment. </para> + +<para>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;.</para> + +</sect1> + +<sect1 id="desktop-components"> +<title>Desktop Components </title> + +<para>After everything has come up, take some time to explore the new environment. If you have already worked with <emphasis>&Windows;</emphasis>, <emphasis>OS/2</emphasis> or <emphasis>&MacOS;</emphasis>, many things should look familiar to you. The main visible parts of &kde; that you will see are the desktop itself, and the panel.</para> + + +<sect2 id="kde-logout"> +<title>Panel </title> + +<para>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. </para> + +<variablelist> +<varlistentry> +<term>&ticon; button</term> +<listitem><para>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 <link linkend="adding-programs">the TDE Menu Editor</link>, 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 <mousebutton>left</mousebutton> mouse button.</para></listitem> +</varlistentry> + +<varlistentry> +<term>Virtual Desktop buttons</term> +<listitem><para>When you start &kde; for the first time, note the four buttons labelled, appropriately enough, <guilabel>1</guilabel>, <guilabel>2</guilabel>, <guilabel>3</guilabel> and <guilabel>4</guilabel>. These represent your four <emphasis>desktops</emphasis>. Just click one of them. Don't worry; though they have <quote>disappeared</quote>, 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 <quote>Well, on the first desktop, I will write the &kde; User Guide. On the second desktop I'll run the <command>meinproc</command> documentation compiler and see my results while compiling my &Linux; kernel on the third desktop, and reading my email on the fourth.</quote> </para></listitem> +</varlistentry> +<varlistentry> +<term>Icon bar</term> +<listitem> +<para>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 <application>Konsole</application> terminal emulator and to the documents you use often. For information on how to add icons to the taskbar, read <link linkend="icons-add">Adding icons to your taskbar</link>. </para> +<para>&kde; by default installs several commonly used buttons, including links to &khelpcenter;, &kwrite; and &kcontrol;.</para></listitem> +</varlistentry> +<varlistentry> +<term>Time and date</term> +<listitem><para>At the far right end of the &kde; panel, you can always see the time and date.</para></listitem> +</varlistentry> +<varlistentry> +<term>The task list</term> +<listitem> +<para>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 <mousebutton>right</mousebutton> 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.</para></listitem> +</varlistentry> +</variablelist> + +</sect2> +<sect2> +<title>Using Windows </title> + +<variablelist> +<varlistentry> +<term>Window menu</term> +<listitem> +<para><mousebutton>Right</mousebutton> 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 <mousebutton>right</mousebutton> 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:</para> + +<variablelist> +<varlistentry> +<term><guimenuitem>Move</guimenuitem></term> +<listitem><para>Lets you move the window with your mouse. Click on the <mousebutton>left</mousebutton> mouse button when you have the window where you want it to be.</para></listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>Resize</guimenuitem></term> +<listitem><para>Enables you to make the window smaller or larger. Move your mouse around and click when you are satisfied with the new size.</para></listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>Minimise</guimenuitem></term> +<listitem><para>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.</para></listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>Maximise</guimenuitem></term> +<listitem><para>This will expand the window to the largest size possible. Note that &kde; will take the size of your <emphasis>virtual desktop</emphasis>, which means that the window could be bigger than your screen. </para></listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>Shade</guimenuitem></term> +<listitem><para><quote>Roll</quote> 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 <guimenuitem>Shade</guimenuitem> again, or double click in the titlebar.</para></listitem> +</varlistentry> +<varlistentry> +<term><guisubmenu>Advanced</guisubmenu></term> +<listitem><para>Here you can find menu options that allow you to manipulate how windows may cover each other up, and more:</para> + +<variablelist> +<varlistentry> +<term><guimenuitem>Keep Above Others</guimenuitem></term> +<listitem><para>Selecting this will keep this window on top of all other applications, even when it does not have the focus.</para></listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>Keep Below Others</guimenuitem></term> +<listitem><para>Selecting this will keep this window below all others, even when it does have the focus.</para></listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>Fullscreen</guimenuitem></term> +<listitem><para>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 <keycombo action="simul">&Alt;	</keycombo> to switch to another window or <keycombo action="simul">&Ctrl;	</keycombo> to switch to another virtual desktop.</para> +<para>To revert from fullscreen mode, you can use the <keycombo action="simul">&Alt;<keycap>F3</keycap></keycombo> shortcut to show the window operations menu and deselect <menuchoice><guisubmenu>Advanced</guisubmenu><guimenuitem>Fullscreen</guimenuitem> </menuchoice>.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>No Border</guimenuitem></term> +<listitem> +<para>Remove the window decoration and border from this window. This is useful for <quote>monitor</quote> 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 <application>xterm</application> and &konsole; windows.</para> +<para>To revert from no border mode, you can use the <keycombo action="simul">&Alt;<keycap>F3</keycap></keycombo> shortcut to show the window operations menu and deselect <menuchoice><guisubmenu>Advanced</guisubmenu><guimenuitem>No Border</guimenuitem> </menuchoice>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guimenuitem>Store Window Settings</guimenuitem></term> +<listitem><para>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.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>To Desktop</guimenuitem></term> +<listitem><para>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 <guiicon>Desktop Button</guiicon> on the &kde; <application>Panel</application>. Selecting <guimenuitem>All Desktops</guimenuitem> will make the window <quote>sticky</quote> - it will display on all desktops at once, so you can alway see this window.</para></listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>Configure Window Behaviour...</guimenuitem></term> +<listitem><para>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 <guilabel>Keramik</guilabel>.</para> +<para>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.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guimenuitem>Close</guimenuitem></term> +<listitem><para>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.</para> +<para>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 <quote>kill</quote> 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.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +<variablelist> +<title>Window Decoration Buttons</title> +<varlistentry> +<term>Sticky button</term> +<listitem><para>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 <menuchoice><guimenu>To Desktop</guimenu><guimenuitem>All Desktops</guimenuitem> </menuchoice> in the <guimenu>Window Menu</guimenu>, but requires fewer steps to invoke.</para></listitem> +</varlistentry> +<varlistentry> +<term>Title bar</term> +<listitem><para>The title bar containing the name of the window can be double-clicked in order to shade it. Use the <mousebutton>right</mousebutton> mouse button: The <guimenu>Window menu</guimenu> 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. </para></listitem> +</varlistentry> +<varlistentry> +<term><guibutton>Minimise</guibutton>, <guibutton>Maximise</guibutton> and <guibutton>Close</guibutton> Buttons</term> +<listitem><para>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. </para> +<para>At the far left of the titlebar (with the default window decoration) is a button to close the window.</para></listitem> +</varlistentry> +</variablelist> + +<para>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.)</para> + +<para>Using the menu bar of each &kde; window is easy. Just click on what you want to do, and it will be done.</para> + +<para>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 <mousebutton>right</mousebutton> mouse button and a context menu will appear, allowing you to put the menu bar on the <guimenuitem>top</guimenuitem>, <guimenuitem>left</guimenuitem>, <guimenuitem>right</guimenuitem>, or <guimenuitem>bottom</guimenuitem> of the window. You can also hide the menubar by selecting <guimenuitem>Flat</guimenuitem></para> + +</sect2> + +<sect2> +<title>Getting Help </title> + +<para>Help is available basically everywhere: On the desktop, just use the <mousebutton>right</mousebutton> mouse button and choose <menuchoice><guisubmenu>Help</guisubmenu><guimenuitem>KDesktop Handbook</guimenuitem></menuchoice>. On the &kde; panel, open the application menu and choose <guimenu>Help</guimenu>. Every &kde; program has a help menu.</para> + +</sect2> +</sect1> +</chapter> 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 @@ +<chapter id="getting-started"> +<title>Getting Started </title> + +<epigraph> +<attribution>Help for one of the toughest riddles in <quote>The 7th Guest</quote></attribution> +<para>Using only what you see, can you get from A to B?</para> +</epigraph> + +<para>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.</para> + +<sect1 id="editing-files"> +<title>Editing Files </title> + +<para>Since you do not only have &kde; applications installed on your system, you probably know the mess of editing <abbrev>ASCII</abbrev> 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 <abbrev>ASCII</abbrev> 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 <abbrev>ASCII</abbrev> files of your own. </para> + +<sect2 id="the-filemanager-screen"> +<title>Opening a Window Containing Your Home Folder </title> + +<para>Click on the &ticon; button and choose <guimenuitem>Home (Personal Files)</guimenuitem>. 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 <guimenuitem>Show Hidden Files</guimenuitem> from the <guimenu>View</guimenu> menu.</para> + +<para>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 <quote>hidden files</quote> — files or folders beginning with a period. </para> + +</sect2> + +<sect2> +<title>The File Manager Screen </title> + +<para>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.</para> + +<para>On the top, there is a <guimenu>Location</guimenu> menu which contains functions to open and close file manager windows. You can also print the current contents.</para> + +<note><para>Want to visit the Internet? There are several paths you can take. You could choose <menuchoice><guimenu>Location</guimenu><guimenuitem>Open Location</guimenuitem></menuchoice> (or press <keycombo>&Ctrl;<keycap>O</keycap></keycombo>) and enter a &URL;.</para> + +<para>The simplest way however, is to simply type in the address you want to go to in the location bar itself.</para> + +<para>For example, if you want to visit the &kde; homepage, enter <userinput>http://www.kde.org</userinput>. You can also quickly transfer files over &FTP; using this method. &kde; is <quote>Internet ready</quote>, 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.</para> +</note> + +<para>The <guimenu>Edit</guimenu> menu offers functions to select, copy and move files. We will use them later. Already having used the <guimenu>View</guimenu> menu, you have probably seen that you can view the content in many different ways. Just play around a bit and see what happens.</para> + +<para>You will undoubtedly find the <guimenu>Bookmarks</guimenu> 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.</para> + +<para>The <guimenu>Tools</guimenu> menu helps you find the notorious file-that-I-put-somewhere-I-do-not-remember-anymore.</para> + +</sect2> + +<sect2> +<title>Navigating Through Folders </title> + +<para>We will now pick one of your configuration files and edit it. First, we must change the folder in the File Manager.</para> + +<para>&konqueror; started with your home folder as the top of the <quote>tree</quote>. 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.</para> + +<para>You can quickly display the <filename class="directory">/</filename> or <quote>root</quote> folder several ways: click the small <guiicon>folder</guiicon> icon beside the navigation pane to switch to a full filesystem tree, use the <guiicon>Up</guiicon> arrow on the toolbar above to go to the top of your filesystem in the right hand pane, or type in <userinput>/</userinput> in the location bar.</para> + +<para>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.</para> + +<para>Scroll down the navigation pane on the left side of the window until you find the folder <filename>/etc</filename>. Double-click on <filename>etc</filename>. You will see a long list of files in the right window.</para> + +</sect2> + +<sect2 id="opening-a-file"> +<title>Opening A File </title> + +<para>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 <systemitem class="username">root</systemitem> or superuser. We are going to practice on a file that will not hurt anything if a mistake is made, called <filename>motd</filename>.</para> + +<para>Scroll down until you find the file <filename>motd</filename> and click on it with the <mousebutton>right</mousebutton> mouse button. In the <guimenu>context menu</guimenu>, select <guimenuitem>Open With</guimenuitem>. A new menu will pop up. Choose <guimenuitem>&kwrite;</guimenuitem>. Voila!</para> + +<para>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 <guilabel>Editors</guilabel> section, and chosen another editor, or simply double click the file to open it in the default editor.</para> + +<para>In the meantime, you have the file <filename>/etc/motd</filename> open in &kwrite; and we're ready to do some editing.</para> + +</sect2> + +<sect2> +<title>The Editor Screen </title> + +<para>The more you work with &kde;, the more you will notice that most screens and applications look and feel the same. The &kwrite; <guimenu>File</guimenu> 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.</para> + +<para>The <guimenu>Edit</guimenu> 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 <guimenu>Settings</guimenu> 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 <guimenu>Help</guimenu> Menu, offering you on-line help whenever you need it. </para> + +</sect2> + +<sect2> +<title>Using the Editor </title> + +<para>Most <filename>motd</filename> files contain useless stuff like <quote>Do not forget to back up your data</quote> or <quote>Do not annoy the system manager</quote>. 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 <keycombo>&Shift;<keycap>Arrows</keycap> </keycombo>or by using the mouse with the <mousebutton>left</mousebutton> button pressed. Use the <guimenu>Edit</guimenu> Menu to cut and paste text. Enter whatever you want, or use the following (great) example: </para> + +<screen><userinput>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. </userinput></screen> + +</sect2> + +<sect2 id="saving-files"> +<title>Saving Your Work </title> + +<para>Now that you have changed the <filename>motd</filename> file, it is time to save the file, putting the changes into effect. To do this, you can use either the <guimenu>File</guimenu> Menu, or you can use the <guiicon>Save</guiicon> Icon on the toolbar.</para> + +<para>At this point, reality hits us. You need to have <systemitem class="username">root</systemitem> permission to save the changes to this file. &kde; handles this by asking you for the <systemitem class="username">root</systemitem> password.</para> + +<para>You probably don't really want to save this file, so you can press <guibutton>Cancel</guibutton> in the password dialogue and <guibutton>Cancel</guibutton> again in the save dialogue.</para> + +<para>Finally, finish your work by closing the editor and file manager window. You can do this by clicking the <guibutton>X</guibutton> button on the top left of the window, by using the window menu of the title bar, or by choosing <menuchoice><guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem></menuchoice>. Simple and elegant, isn't it? </para> + +</sect2> + +<sect2 id="creating-new-files"> +<title>Creating New Files</title> + +<para>As with everything in &kde;, there are several ways to create a new file. You could open up the file manager, <mousebutton>right</mousebutton> click on an empty space in a folder you own, and choose <menuchoice><guisubmenu>Create New</guisubmenu><guisubmenu>File</guisubmenu><guimenuitem>Text File...</guimenuitem></menuchoice>. A new empty file will appear, which you can open just like any other. You can even do this right on the desktop itself.</para> + +<para>More often you are already in an application and want to start a new file. Most &kde; applications offer a <menuchoice><guimenu>File</guimenu><guimenuitem>New</guimenuitem></menuchoice> menu item, and an icon on the toolbar to complement it. A new empty document will appear that you can immediately begin working in.</para> + +<para>Both these approaches have advantages, so use the one that is most practical at the time.</para> + +</sect2> + +</sect1> + +<sect1 id="moving-files-with-drag-and-drop"> +<title>Moving Files With Drag and Drop </title> + +<para>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 <quote>drag and drop</quote> allows you to copy and move files more quickly and easily. </para> + +<sect2> +<title>Opening Two File Manager Windows </title> + +<para>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 (<menuchoice><guimenu>Window</guimenu><guimenuitem>Navigation Panel</guimenuitem> </menuchoice> or press <keycap>F9</keycap>).</para> + +</sect2> + +<sect2> +<title>Dragging a File From One Window To Another </title> + +<para>In the first window, open the <filename>/etc</filename> folder and scroll until you see the <filename>motd</filename> file we modified in the previous section.</para> + +<para>In the second window, open your home folder.</para> + +<para>Click on the <filename>motd</filename> file. Hold your <mousebutton>left</mousebutton> mouse button and drag your file into your home folder. Release the <mousebutton>left</mousebutton> mouse button (this is called <emphasis>dropping</emphasis> the file). You will be presented up to four options: <guimenuitem>Copy Here</guimenuitem>, <guimenuitem>Move Here</guimenuitem>, <guimenuitem>Link Here</guimenuitem> and <guimenuitem>Cancel</guimenuitem>. In this example, since you are not <systemitem class="username">root</systemitem>, you cannot move the file, so this option is not presented. <guimenuitem>Link Here</guimenuitem> will create a symbolic link to the file, while <guimenuitem>Copy Here</guimenuitem> and <guimenuitem>Move Here</guimenuitem> do exactly what they say. Select <guimenuitem>Copy Here</guimenuitem>. You should now have a copy of the <filename>motd</filename> file in your home folder. </para> + +</sect2> +</sect1> + +<sect1 id="using-command-line-and-terminals"> +<title>Using Command Line And Terminals </title> + +<para>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.</para> + +<sect2> +<title>Quick Command Line </title> + +<para>Pressing <keycombo action="simul">&Alt; <keycap>F2</keycap></keycombo> 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.</para> + +</sect2> + +<sect2> +<title>The &UNIX; Terminal Emulator </title> + +<para>From the application menu, choose <menuchoice><guisubmenu>System</guisubmenu><guimenuitem>Terminal</guimenuitem> </menuchoice>. A terminal window will open. Here you can use regular &UNIX; shell commands: <command>ls</command>, <command>cat</command>, <command>less</command>, and so forth. Using the <guimenu>Settings</guimenu> menu, you can customise the terminal emulator to suit your needs. </para> + +</sect2> +</sect1> + +<sect1 id="finding-your-lost-files"> +<title>Finding Your Lost Files </title> + +<para>Everyone has undoubtedly encountered the following problem: You start <command>ftp</command>, 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.</para> + +<sect2> +<title>Starting &kfind;</title> + +<para>Starting &kfind; is simple: Choose <guimenuitem>Find Files</guimenuitem> in the &kmenu;. &kfind; uses an interface part you probably have not yet met in &kde;: tabs. When &kfind; starts, you see that <guilabel>Name/Location</guilabel> is selected. When you click on <guilabel>Date Range</guilabel>, 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.</para> + +</sect2> + +<sect2> +<title>Finding a File by Knowing Parts of Its Name </title> + +<para>As long as you know a bit of the file name, searching is easy. Select the <guilabel>Name/Location</guilabel> tab, and enter the file name in the <guilabel>Named</guilabel> field. Wildcards may be used as needed. As a test, type <userinput>*.tar.gz</userinput>. By default, the search begins in your home folder, but you can select any starting folder you wish by clicking on the <guilabel>Look in</guilabel> or <guibutton>Browse...</guibutton>. To start searching, press the <guibutton>Find</guibutton> 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 <guilabel>Named</guilabel> field, or no files ending with a <filename>.tar.gz</filename> extension are located on your machine.</para> + +</sect2> + +<sect2 id="finding-with-complex-criteria"> +<title>Finding a File by More Complex Criteria </title> + +<para>There are many categories you can use to make your search more precise. <emphasis>The more you know about the file, the better are your chances of finding it</emphasis>.</para> + +<variablelist> +<varlistentry> +<term><guilabel>Date Range</guilabel></term> +<listitem> +<para>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.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>File Type</guilabel> in the <guilabel>Contents</guilabel> tab.</term> +<listitem><para>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.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Containing text</guilabel> in the <guilabel>Advanced</guilabel> tab</term> +<listitem> +<para>You can specify text that the file must contain. </para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>File size is</guilabel>, in the <guilabel>Properties</guilabel> tab</term> +<listitem><para>If you know the file size, you can limit your search in this regard, as well. </para></listitem> +</varlistentry> +</variablelist> + +<para>&kfind; has many more options to refine searches, explore them all!</para> + +</sect2> +</sect1> + +<sect1 id="using-multiple-desktops"> +<title>Using Multiple Desktops </title> + +<para>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. </para> + +<para>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. </para> + +<para>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 <mousebutton>right</mousebutton> mouse button, choose <guimenuitem>To Desktop</guimenuitem>, and select the desktop where you would like the window moved. </para> + +</sect1> + +<sect1 id="quitting-kde"> +<title>Quitting &kde;</title> + +<para>To quit working with &kde;, you can use the <guimenuitem>Logout</guimenuitem> 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 <link linkend="kde-logout">the notes for logging out.</link> </para> + +</sect1> +</chapter> 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 @@ +<chapter id="history"> +<title>A Short Guided Tour of &kde;'s History</title> + +<epigraph> +<attribution>The <abbrev>CEO</abbrev> of a big software company, at the beginning of the 80s...(apocryphal)</attribution> +<para>640KB ought to be enough for everybody </para> +</epigraph> + +<sect1 id="before-kde"> +<title>Before &kde;</title> + +<para>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:</para> + +<screen><userinput><command>find</command> <filename>/var/spool/news</filename> <parameter>-name '[0-9]*' -exec cat {} \;</parameter> | <command>more</command></userinput> +</screen> + +<para>Although fast and relatively efficient, this couldn't be called user friendly. Today, there are many good front ends available, such as <application>tin</application> 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. </para> + +<para>The configuration of programs is also often difficult. While compiling is usually done with a command line such as <userinput><command>./configure</command> && <command>make</command> && <command>make <option>install</option></command></userinput> 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.</para> + +<para>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 <acronym>RAM</acronym> and more disk space. Often the new version provides functions few people really need. </para> + +<para><emphasis>&kde; is different.</emphasis> 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. </para> + +</sect1> + + +<sect1 id="what-kde-can-do-for-you"> +<title>What &kde; Can Do For You</title> + +<para>&kde; is designed for everyone.</para> + +<para>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.</para> + +<para>No matter what your level of experience with &UNIX; or any other operating system, &kde; brings you:</para> + +<itemizedlist> +<listitem> +<para>A good looking, easy to use desktop environment.</para> +</listitem> +<listitem> +<para>A powerful, easy to use file manager</para> +</listitem> +<listitem> +<para>An equally powerful and easy to use web browser</para> +</listitem> +<listitem> +<para>A simple, centralised configuration</para> +</listitem> +<listitem> +<para>A comprehensive list of applications, so you can be productive within minutes of your first &kde; login.</para> +</listitem> +<listitem> +<para>Online help to support you in every situation.</para> +</listitem> +<listitem> +<para>Consistency of interface. Menus are in the same place across applications, keybindings behave the same way, toolbar icons, once learned, always work the same.</para> +</listitem> +</itemizedlist> + +</sect1> + +<sect1 id="background-of-kde"> +<title>The Background Of &kde;</title> + +<para>In October 1996, German <application>LyX</application> 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. </para> + +<para>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. </para> + +<para>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.</para> + +<para>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 <acronym>SSL</acronym> 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;. </para> + +<para>The developers and users communicate primarily via several mailing lists, as described in the <link linkend="mailing-lists">Mailing Lists</link> section. If you would like to help, please do, &kde; is driven by volunteer contribution, and you are always welcome to take part.</para> + +</sect1> + +<sect1 id="getting-kde"> +<title>How To Get New Components</title> + +<para>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.</para> + +<para>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 <ulink url="http://www.kde.org/ftpmirrors.html">http://www.kde.org/ftpmirrors.html</ulink>.</para> + +<para>On the &FTP; servers, the folder <filename>unstable</filename> 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 <filename>stable</filename> folder, where we put Beta and release versions. </para> + +<para>If you are interested in developing &kde; applications of your own, you should visit <ulink url="http://developer.kde.org/">http://developer.kde.org/"</ulink> where you will find a wealth of information, including tutorials, <acronym>API</acronym> guides to the &kde; libraries, and much more. You should also visit Troll Tech's server (<ulink url="http://www.trolltech.com/">http://www.trolltech.com</ulink>) which features a great deal of information concerning the &Qt; library used by &kde;. You will probably find it valuable to join <link linkend="mailing-lists">the &kde; developer mailing list</link>.</para> + +</sect1> + +</chapter> 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 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" +"dtd/kdex.dtd" [ + <!ENTITY kappname "&kde; User's Guide"> + <!ENTITY introduction SYSTEM "intro.docbook"> + <!ENTITY history SYSTEM "history.docbook"> + <!ENTITY installation SYSTEM "installation.docbook"> + <!ENTITY first-impressions SYSTEM "first-impressions.docbook"> + <!ENTITY getstarted SYSTEM "getting-started.docbook"> + <!ENTITY about-desktop SYSTEM "about-desktop.docbook"> + <!ENTITY shortcuts SYSTEM "shortcuts.docbook"> + <!ENTITY ug-faq SYSTEM "ug-faq.docbook"> + <!ENTITY more-help SYSTEM "more-help.docbook"> + <!ENTITY staff SYSTEM "staff.docbook"> + <!ENTITY notices-and-trademarks SYSTEM "notices-trademarks.docbook"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % British-English "INCLUDE"> <!-- change language only here --> +]> + +<book lang="&language;"> +<bookinfo> +<title>K Desktop Environment</title> +<authorgroup> +<author> +<surname>The KDE Team</surname> +</author> +<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> +</authorgroup> + +<date>2003-10-19</date> +<releaseinfo>3.2</releaseinfo> + +<copyright> +<year>2000</year><year>2001</year><year>2002</year><year>2003</year> +<holder>The KDE Team</holder> +</copyright> + +<legalnotice>&GPLNotice;</legalnotice> + +<!-- Please note: This is NOT the final KDE Users Guide, which is not complete. +This is a quick rewrite of the KDE 1.1x user guide, because it was badly out of +date, and so that KDE wasn't released without a users guide entirely. --> + +<abstract><para>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. </para></abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>user</keyword> +<keyword>guide</keyword> +</keywordset> +</bookinfo> + +&introduction; +&history; +<!-- &installation; --> +&first-impressions; +&getstarted; +&about-desktop; +&shortcuts; +&ug-faq; +&more-help; +&staff; +¬ices-and-trademarks; +</book> 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 @@ +<chapter id="installation"> +<title>Installation </title> + +<epigraph> +<attribution>Linus Torvalds, after finding one of his file systems smashed by a new Beta kernel</attribution> +<para>Core dumping fsck's tend to make me nervous</para> +</epigraph> + +<para>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 (<filename>.*</filename>) files in your home folder and the folder <filename>/usr/X11/lib/X11/xdm</filename>. </para> + +<sect1 id="requirements"> +<title>Requirements </title> + +<para>Before installing KDE, ascertain that your system fulfills the following requirements: </para> + +<itemizedlist> + +<listitem><para>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. </para></listitem> + +<listitem><para>Some free hard disk space on the partition where <filename>/opt/kde</filename> 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 <filename>/usr/src</filename>.</para></listitem> + +<listitem><para>A running X11 system with or without <application>xdm</application>. 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 <ulink url="http://www.xfree86.org">the XFree86 web site</ulink> for more information on how to get and install the X Window System, or contact your UNIX vendor support. </para></listitem> + +<listitem><para>The &Qt; libraries, version 3.2 or higher. You can obtain these at <ulink url="ftp://ftp.trolltech.com/qt">Troll Tech's FTP Server</ulink> in tgz format. </para> +</listitem> +</itemizedlist> + +<warning><para>A warning before you start: Before upgrading from a previous version of &kde;, we recommend that you do the following:</para> + +<screen><command>cd <filename>/opt/kde</filename></command> +<command>tar <option>cfvz <replaceable>~/KDE-old-version-backup.tar.gz</replaceable> * </option></command> +</screen> +</warning> + +</sect1> + +<sect1 id="linux-installing-rpms"> +<title>Linux: Installing RPMs for RedHat, Caldera and SuSE.</title> + +<para>Using RPMs is the easiest method to get KDE up and running. Just visit your favourite KDE mirror and visit the folder <filename>/pub/kde/stable/distribution/rpm</filename>. 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. </para> + +<para>The basic system consists of the files <filename>kde-<replaceable>component</replaceable>.<replaceable>architecture</replaceable>.rpm</filename> 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. </para> + +<para>Next, start installing with the base package. If you are installing KDE for the first time, use </para> + +<screen><userinput><command>rpm</command> <option>-i</option> <filename>tdesupport.arch.rpm</filename></userinput> +<userinput><command>rpm</command> <option>-i</option> <filename>tdelibs.arch.rpm</filename></userinput> +<userinput><command>rpm</command> <option>-i</option> <filename>tdebase.arch.rpm</filename></userinput> +</screen> + +<important><para>It is important that these components are installed in the order listed, and that they are installed before any other KDE component.</para></important> + +<para>If you are upgrading from a previous release, try <screen><userinput><command>rpm</command> <option>-Uvh</option> <filename>kde-<replaceable>component</replaceable>.<replaceable>arch</replaceable>.rpm</filename></userinput> +</screen> +</para> + +<para>Once again, the order given above should be preserved, and the given components should be installed before any other KDE components.</para> + +<para>This will unpack the base distribution and install it by default in <filename>/opt/kde</filename>.</para> + +<para>If the installation of the base packages has been successful, you can install the remaining packages (use <option>-Uvh</option> instead of <option>-i</option> once again to update an existing version) the same way. </para> + +</sect1> + +<sect1 id="installing-debian"> +<title>Linux: Installing <acronym>DEB</acronym>s for debian</title> + +<para>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.</para> + +<para>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 <filename>/etc/apt/sources.list</filename>. You should add to that file the following line: <userinput>http://kde.tdyc.com/ stable kde2</userinput></para> + + +<para>Then you have to update your local package database so that your system knows that there are new packages available. Type the following command:</para> + +<screen><userinput><command>apt-get</command> <option>update</option></userinput> +</screen> + +<para>Finally you should install the KDE base components. This is accomplished by typing:</para> + +<screen><userinput><command>apt-get</command> <option>install tdebase</option></userinput> +</screen> + +<para>If you want to install other components you should try some, or all of these options:</para> + +<screen><userinput><command>apt-get</command> <option>install task-tdenetwork</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdeadmin</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdetoys</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdeutils</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdemultimedia</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdegraphics</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdepim</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdegames</option></userinput> +<userinput><command>apt-get</command> <option>install task-koffice</option></userinput> +<userinput><command>apt-get</command> <option>install tdebase-docs</option></userinput> +<userinput><command>apt-get</command> <option>install tdm</option></userinput> +</screen> + +<para>You may also be interested in installing your language.</para> + +<screen><userinput><command>apt-get</command> <option>install +tde-i18n-<replaceable>xx</replaceable></option></userinput> + </screen> +<para>where <replaceable>xx</replaceable> has to be substituted by the country code.</para> + +<para>The control files for some TDE applications will be placed at <filename class="directory">/etc/kde2</filename>, the executables will go in <filename class="directory">/usr/bin</filename> and most of the auxiliary files in <filename class="directory">/usr/share</filename> under different folders. </para> + +<para>If you are upgrading from a previous version of KDE you should perform the following steps. First, update file <filename>/etc/apt/sources.list</filename> by changing the line with the location of KDE packages with line: <userinput>http://kde.tdyc.com/ stable kde2</userinput>. Second update your package database:</para> + +<screen><userinput><command>apt-get</command> <option>update</option></userinput> +</screen> + +<para>Finally install the KDE base system:</para> + +<screen><userinput><command>apt-get</command> <option>install tdebase</option></userinput> +<userinput><command>apt-get</command> <option>dist-upgrade</option></userinput> +</screen> + +<para>If you want to install more KDE components try some, or all of these options.</para> + +<screen><userinput><command>apt-get</command> <option>install task-tdenetwork</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdeadmin</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdetoys</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdeutils</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdemultimedia</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdegraphics</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdepim</option></userinput> +<userinput><command>apt-get</command> <option>install task-tdegames</option></userinput> +<userinput><command>apt-get</command> <option>install task-koffice</option></userinput> +<userinput><command>apt-get</command> <option>install tdebase-docs</option></userinput> +<userinput><command>apt-get</command> <option>install tdm</option></userinput> +</screen> + +</sect1> + +<sect1 id="source-distribution"> +<title>Using Source Compilation to Install on Top of Other Systems </title> + +<para>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. </para> + +<para>In order to compile and install KDE properly, you need to have the following items installed on your hard disk: </para> + +<itemizedlist> +<listitem><para>An ANSI-C compiler, <abbrev>e.g.</abbrev> the <abbrev>GNU</abbrev> C compiler. </para></listitem> +<listitem><para>An ANSI-C++ compiler, <abbrev>e.g.</abbrev> <abbrev>GNU</abbrev> C++. </para></listitem> +<listitem><para>The <application>make</application> utility. </para></listitem> +<listitem><para>Qt development version 2.2 or higher.</para></listitem> +<listitem><para>X11 development version (include files are often missing) </para></listitem> +</itemizedlist> + +<para>Once you have all the needed helper applications, go to your favourite KDE mirror and retrieve the following files from the folder <filename>/pub/kde/stable/<replaceable>newest version</replaceable></filename>:</para> + +<itemizedlist> +<listitem><para><filename>tdesupport-<replaceable>version</replaceable>.tar.gz</filename></para></listitem> +<listitem><para><filename>tdelibs-<replaceable>version</replaceable>.tar.gz</filename> +</para></listitem> +<listitem><para><filename>tdebase-<replaceable>version</replaceable>.tar.gz</filename></para></listitem> +<listitem><para>any other packages you wish to install. We advise you to get at least tdeutils. </para></listitem> +</itemizedlist> + +<para>In all cases above, <replaceable>version</replaceable> stands for the current version number. Once you have downloaded all you need, extract these files to <filename>/usr/src</filename>. This process should yield the following folder structure:</para> + +<itemizedlist> +<listitem><para><filename>/usr/src/tdesupport</filename></para></listitem> +<listitem><para><filename>/usr/src/tdelibs</filename></para></listitem> +<listitem><para><filename>/usr/src/tdebase</filename></para></listitem> +<listitem><para><filename>/usr/src/...</filename> (any other packages)</para></listitem> +</itemizedlist> + +<para>Make sure you have write permissions to <filename>/opt/kde</filename>.</para> + +<para>Next you must compile and install the packages using the following: </para> + +<procedure> +<step><para><command>cd</command> into the folder of the package, you want to install (see above)</para></step> +<step><para><command>./configure</command> (with the options you want to apply)</para></step> +<step><para><command>make</command></para></step> +<step><para><command>make install</command></para></step> +</procedure> + +<para>Apply the above steps to every package you want to install.</para> + +<note><para>These instructions can be used for almost every source package available, not just KDE packages. </para></note> + +<para>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 <command>configure <option>--help</option></command> in tdelibs:</para> + +<screen><computeroutput> + 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 +... +</computeroutput> +</screen> + +<para>Several options are not required and are only useful as workarounds for known problems (⪚ <option>--disable-FEATURE</option>). Since some are important options, for instance <emphasis>--with-shadow</emphasis>, you should always check the available options.</para> + +<para>An important option is <option>--prefix</option>. 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 <filename>/usr/local/kde</filename> . If you want to install &kde; into <filename>/opt/kde</filename>, you have to use <command>configure <option>--prefix /opt/kde</option></command>.</para> + +<para>If you have installed the &Qt; libraries in an uncommon place, for instance in <filename>$HOME/src/qt</filename>, you must use <command>configure <option>--with-qt-dir=$HOME/src/qt</option></command>. By default configure looks in the most common places for &Qt; before it gives up.</para> + +<para>If you have problems that you are not able to solve, send a copy of the <filename>config.log</filename> file to the address given in the offending package's <filename>README</filename> file.</para> + +<para>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).</para> + +<para>If you want to take advantage of multiprocessor systems, try <command>make <option> -j <replaceable>Number of processors</replaceable></option></command> instead of <command>make</command>. </para> + +<sect2> +<title>Platform Specific Building Notes </title> + +<sect3> +<title>Linux </title> + +<para>For &Linux;, most of the utilities needed to build &kde; can be found either at <ulink url="ftp://sunsite.unc.edu/pub/Linux/GCC">ftp://sunsite.unc.edu/pub/Linux/GCC</ulink> or <ulink url="ftp://sunsite.unc.edu/pub/GNU">ftp://sunsite.unc.edu/pub/GNU</ulink>. The Qt libraries can be found at <ulink url="ftp://ftp.troll.no/pub/qt/source">ftp://ftp.troll.no/pub/qt/source</ulink>, available as source code. Detailed instructions on how to install them are provided. Include files for X11 programs should be available at <ulink url="ftp://ftp.xfree86.org">ftp://ftp.xfree86.org</ulink> in the xdevel section. </para> + +</sect3> +</sect2> +</sect1> + +<sect1 id="suse-install"> +<title>Required Changes To Your Configuration Files </title> +<para>After you have placed the KDE binaries into their destination folder, there are a few adjustments you must make to your startup scripts. </para> +<para>The following procedure was tested on SuSE Linux 5.0, and should be compatible with the other popular UNIX's as well. <emphasis>Always make backups of configuration files before changing them!</emphasis> Add the following to the end of your /etc/profile: </para> +<para> +<screen>export PATH=$PATH:/opt/kde/bin +export TDEDIR=/opt/kde +</screen> + </para> +<para>Next, edit the .xinitrc file in your home folder. Look for the line that calls your window manager and replace it with <literal>starttde</literal>.</para> +<para>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<emphasis> <link linkend="source-distribution">Using Source Compilation to Install on Top of Other Systems</link> </emphasis>for more information. </para> +<para>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 <link linkend="mailing-lists">the KDE mailing lists</link> </para> +</sect1> +</chapter> 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 @@ +<chapter id="introduction"> +<title>Introduction</title> + +<para>Welcome to the K Desktop Environment User Guide.</para> + +<para>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.</para> + +<para>Included is a table of shortcuts, and some tips and tricks intended to help you find your way around quickly and efficiently.</para> + +<para>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.</para> + +<para>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.</para> + +</chapter> 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 @@ +<chapter id="more-help"> +<title>Further Help</title> + +<sect1 id="mailing-lists"> +<title>Other Sources for Help </title> + +<para>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. </para> + +<para>You can subscribe at the web pages listed below:</para> + +<simplelist> + +<member>&kde; announcements - <ulink url="http://mail.kde.org/mailman/listinfo/kde-announce"> http://mail.kde.org/mailman/listinfo/kde-announce</ulink></member> + +<member>&kde; users' mailing list - <ulink url="http://mail.kde.org/mailman/listinfo/kde"> http://mail.kde.org/mailman/listinfo/kde</ulink></member> + +<member>KDE developers' mailing list - <ulink url="http://mail.kde.org/mailman/listinfo/kde-devel"> http://mail.kde.org/mailman/listinfo/kde-devel</ulink></member> + +<member>KDE look and feel discussions - <ulink url="http://mail.kde.org/mailman/listinfo/kde-look"> http://mail.kde.org/mailman/listinfo/kde-look </ulink></member> + +<member>KDE licensing questions - <ulink url="http://mail.kde.org/mailman/listinfo/kde-licensing"> http://mail.kde.org/mailman/listinfo/kde-licensing </ulink></member> + +<member>KDE Documenters' list - <ulink url="http://mail.kde.org/mailman/listinfo/kde-doc-english"> http://mail.kde.org/mailman/listinfo/kde-doc-english </ulink></member> +</simplelist> + +<para>Many &kde; applications and sub-projects maintain more specific lists for themselves. You can find a complete list of archives at <ulink url="http://lists.kde.org/">http://lists.kde.org/</ulink>.</para> + +</sect1> +</chapter> 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 @@ +<appendix id="legal-notices-and-trademarks"> +<title>Legal Notices</title> +<sect1 id="legal-status"> +<title>Licence</title> + +<para>&kde; is open source software, and all of &kde; is released under free licenses such as the GPL.</para> + +</sect1> + +<sect1 id="trademarks-list"> +<title>Trademarks</title> + +<!-- <para>&kde; and <quote>K Desktop Environment</quote> are registered +trademarks of KDE e.V.</para> --> + +<para>All trademarks mentioned on this web server or in &kde; documentation are recognised as belonging to their respective owners, including but not limited to:</para> + +<simplelist> +<member>&AIX; is a registered trademark of IBM Corporation</member> +<member>&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.</member> +<member>&Handspring; and &Visor; are trademarks of Handspring, Inc. and may be registered in certain jurisdictions.</member> +<member>&Hewlett-Packard;, &HP; &LaserJet;,&HP-UX; PCL, PCL 5 and PCL 6 are U.S. registered trademarks of Hewlett Packard Company.</member> +<member>&IRIX; is a registered trademark and &SGI; is a trademark of Silicon Graphics, Inc.</member> +<member>&Java; and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.</member> +<member>&Jini; and all Jini-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.</member> +<member>&Linux; is a registered trademark of Linus Torvalds</member> +<member>&LinuxPPC; is a trademark of LinuxPPC Inc.</member> +<member>&Mac; is a trademark of Apple Computer Inc., registered in the United States and other countries.</member> +<member>&Mandrake; and &Linux-Mandrake; are trademarks of MandrakeSoft.</member> +<member>&Netscape; is a registered trademark of Netscape Communications Corporation in the United States and other countries.</member> +<member>&NeXTSTEP; is a trademark of NeXT Software, Inc., registered in the U.S. and other countries. </member> +<member>&PalmOS;, &HotSync; and &PalmPilot; are registered trademarks of Palm, Inc.</member> +<member>&PostScript; is a registered trademark of Adobe Systems Incorporated.</member> +<member>&Qt; is a trademark of Trolltech AS</member> +<member>&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. </member> +<member>&Sendmail; is a registered trademark of Sendmail Inc.</member> +<member>&Solaris;, <trademark>Sun</trademark> and <trademark>SunOS</trademark> are trademarks of Sun Microsystems Inc.</member> +<member>&SuSE; is a registered trademark of SuSE AG</member> +<member>&ThreeCom; is a registered trademark of 3com corporation in the United States and other countries.</member> +<member>&Motif;, &UNIX; and the <quote>X</quote> device are registered trademark of The Open Group in the United States and other countries</member> +<member>&Microsoft; and &Windows; are registered trademarks of the Microsoft Corporation</member> +<member>XFree86 is pending trademark registration by The XFree86 Project, Inc.</member> +</simplelist> + +<!-- Others that needs to be covered above: + +&MacOS; +&Netscape; +&PMX; +&TrueType; +&X-Window; +Xing, +Yamaha +--> + +</sect1> +</appendix> 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 @@ +<chapter id="shortcuts"> +<title>Tips & Tricks for Your Daily Work </title> + +<epigraph> +<attribution>Fortune Cookies</attribution> +<para>Everyone can make an omelette with eggs. The trick is to make one with none.</para> +</epigraph> + +<para>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 <acronym>ASCII</acronym> style. However, there are some ways you can do your work more elegantly, saving you time for the truly important things, like &ksirtet;.</para> + +<sect1 id="shortcut-table"> +<title>Shortcut Table </title> + +<variablelist> + +<varlistentry> +<term><keycombo>&Alt;<keycap>Tab</keycap> </keycombo> or <keycombo>&Alt;&Shift;<keycap>Tab</keycap></keycombo></term> +<listitem><para>Cycle through the windows </para></listitem> +</varlistentry> + +<varlistentry> +<term><keycombo>&Ctrl;<keycap>Tab</keycap></keycombo> or <keycombo>&Ctrl;&Shift;<keycap>Tab</keycap> </keycombo></term> +<listitem><para>Cycle through your desktops </para></listitem> +</varlistentry> + +<varlistentry> +<term><keycombo>&Alt;<keycap>F2</keycap> </keycombo></term> +<listitem><para>Mini Command line</para></listitem> +</varlistentry> + +<varlistentry> +<term><keycombo>&Alt;<keycap>F3</keycap></keycombo></term> +<listitem><para>Window Menu </para></listitem> +</varlistentry> + +<varlistentry> +<term><keycombo>&Alt;<keycap>F4</keycap> </keycombo></term> +<listitem><para>Close the current window </para></listitem> +</varlistentry> + +<varlistentry> +<term><keycombo>&Ctrl;<keycap>F{1..8}</keycap></keycombo></term> +<listitem><para>Switch to a specific desktop </para></listitem> +</varlistentry> + +<varlistentry> +<term><keycombo>&Ctrl;&Alt;<keycap>Esc</keycap> </keycombo></term> +<listitem><para>Window destroyer (every window you click on will be destroyed). Press this key combination again to cancel the killer cursor. </para></listitem> +</varlistentry> + +<varlistentry> +<term><keycombo>&Ctrl;&Alt;<keycap>Backspace</keycap> </keycombo></term> +<listitem><para>This exits &kde; (without saving!) Use this as a last resort </para></listitem> +</varlistentry> +<varlistentry> +<term><keycombo>&Ctrl;&Alt;<keycap>Numpad +</keycap></keycombo></term> +<listitem><para>Cycles to the next screen resolution. You need to configure this in your &X-Server; configuration for it to work. </para></listitem> +</varlistentry> + +<varlistentry> +<term><keycombo>&Ctrl;&Alt;<keycap>Numpad -</keycap> </keycombo></term> +<listitem><para>Cycles to the previous screen resolution. You need to configure this in your &X-Server; configuration for it to work.</para></listitem> +</varlistentry> +</variablelist> + +</sect1> + +<sect1 id="mouse-techniques"> +<title>Mouse Techniques </title> + +<para>Note these are defaults only, and you can customise them to your liking.</para> + +<variablelist> + +<varlistentry> +<term>Clicking on the border or the titlebar</term> +<listitem> +<variablelist> + +<varlistentry> +<term><mousebutton>Left</mousebutton></term> +<listitem><para>Activates and raises the window.</para></listitem> +</varlistentry> + +<varlistentry> +<term><mousebutton>Middle</mousebutton></term> +<listitem><para>Lowers the window</para></listitem> +</varlistentry> + +<varlistentry> +<term><mousebutton>Right</mousebutton></term> +<listitem><para>Shows the <guimenu>Window menu</guimenu> if the window is active, otherwise activates the window.</para></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term>Doubleclick on the window title</term> +<listitem><para>Shades the window (<quote>rolls it up</quote> so only the titlebar is visible).</para></listitem> +</varlistentry> + +<varlistentry> +<term>Drag on the titlebar</term> +<listitem><para>Moves the window around.</para></listitem> +</varlistentry> + +<varlistentry> +<term>Drag on corners or edges</term> +<listitem><para>Resizes the window.</para></listitem> +</varlistentry> + +<varlistentry> +<term><keycombo>&Alt;<mousebutton>Left</mousebutton></keycombo> Button</term> +<listitem><para>Moves the window around.</para></listitem> +</varlistentry> + +<varlistentry> +<term><keycombo>&Alt;<mousebutton>Middle</mousebutton> </keycombo> Button</term> +<listitem><para>Raises the window.</para></listitem> +</varlistentry> + +<varlistentry> +<term><keycombo>&Alt;<mousebutton>Right</mousebutton> </keycombo> Button</term> +<listitem><para>Resizes the window in the direction you drag the mouse.</para></listitem> +</varlistentry> + +<varlistentry> +<term>Click on the Icon on the top left</term> +<listitem><para>Close the application</para></listitem> +</varlistentry> +<varlistentry> +<term>Click on the Sticky Button</term> +<listitem><para>toggles sticky </para></listitem> +</varlistentry> + +<varlistentry> +<term>Clicking on Maximise</term> +<listitem> +<variablelist> +<varlistentry> +<term><mousebutton>Left</mousebutton></term> +<listitem><para>Maximises the window</para></listitem> +</varlistentry> +<varlistentry> +<term><mousebutton>Middle</mousebutton></term> +<listitem><para>Maximises only vertically</para></listitem> +</varlistentry> +<varlistentry> +<term><mousebutton>Right</mousebutton></term> +<listitem><para>Maximises horizontally</para></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +</sect1> + +</chapter> 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 @@ +<chapter id="docu-staff"> +<title>Epilogue </title> + +<epigraph> +<attribution>The end of Evita</attribution> +<para>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...</para></epigraph> + +<para>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. </para> + +<sect1 id="the-k-documentation-staff"> +<title>The K Documentation Staff </title> + +<para>This User Guide has been updated for 3.0, and is currently maintained by Lauri Watts <email>lauri@kde.org</email></para> + +<para>Others who have contributed to this guide.</para> +<itemizedlist> +<listitem><para>Pablo de Vicente <email>vicente@oan.es</email>, who updated the section regarding installing on Debian for KDE 2.0</para></listitem> +<listitem><para>Andreas Buschka <email>andi@circe.tops.net</email></para></listitem> +<listitem><para>Robert D. Williams <email>rwilliam@kde.org</email></para></listitem> +<listitem><para>Poul Gerhard</para></listitem> +<listitem><para>John Waalkes</para></listitem> +<listitem><para>Vernon Wells</para></listitem> +<listitem><para>Kay Lutz</para></listitem> +<listitem><para>Stephan Kulow</para></listitem> +</itemizedlist> +</sect1> + +<sect1 id="we-still-need-people"> +<title>We still need people! </title> + +<para>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 <xref linkend="mailing-lists"/>. If you would like to help, please do so! We are still looking for helpers in the following departments: </para> + +<itemizedlist> +<listitem><para>Development (Libraries and Applications)</para></listitem> +<listitem><para>Documentation</para></listitem> +<listitem><para>Graphics</para></listitem> +<listitem><para>Beta-Testing</para></listitem> +<listitem><para>and everywhere else, too :-) </para></listitem> +</itemizedlist> + +</sect1> + +<sect1 id="legal-notices"> +<title>Legal notices </title> + +<para>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. </para> + +</sect1> + +<sect1 id="sources-of-information-used-during-the-creat"> +<title>Sources of information used during the creation of this book </title> + +<para>During the creation of this documentation, the authors used the following sources for information: </para> + +<itemizedlist> +<listitem><para>The KDE Mailing lists </para></listitem> +<listitem><para>Various <filename>README</filename> and <abbrev>HTML</abbrev> help files that came with the KDE components </para></listitem> +</itemizedlist> + +</sect1> + +<sect1 id="license"> +<title>Licence</title> +&underGPL; </sect1> +</chapter> 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 @@ +<chapter id="frequently-asked-questions"> +<title>Frequently Asked Questions About &kde; </title> + +<epigraph> +<attribution>Batman Animated Series</attribution> +<para>What are you?</para> +<para>I'm your worst nightmare...</para> +</epigraph> + +<para>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! </para> + +<!-- pretty short list.. going to watch mailing lists a little, and +see if there aren't any more questions that ought to be here --> + +<qandaset id="faq"> +<qandaentry> +<question><para>What does <quote>&kde;</quote> stand for?</para></question> +<answer><para>Originally the <emphasis>K</emphasis> stood for <emphasis>Kool</emphasis>, nowadays the K has no meaning and &kde; simply stands for the <emphasis>K Desktop Environment</emphasis>. &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. </para></answer> +</qandaentry> + +<qandaentry> +<question><para>I cannot compile package xxx</para></question> +<answer> + +<para>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 <acronym>CVS</acronym>. For most users, using a released version is much more practical.</para> + +<para>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 <filename>README</filename> 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.</para> +</answer> +</qandaentry> + +<qandaentry> + +<question><para>What version of &kde; should I use for a stable desktop?</para></question> +<answer><para>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.</para> + +</answer> +</qandaentry> + +<qandaentry> +<question><para>But I heard that my problem/wishlist item is <quote>already in <acronym>CVS</acronym></quote>. I want to get my hands on the new features, why shouldn't I try <acronym>CVS</acronym>?</para></question> + +<answer> +<para>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;.</para> + +<para>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 <acronym>CVS</acronym> versions. Be prepared for things to break occasionally, <acronym>CVS</acronym> gives you a snapshot of source code that is currently being worked on.</para> + +<para>These are daily snapshots of whatever the developers are working on, and some things are guaranteed to be broken.</para> + +<warning> +<para><emphasis>Do not rely on <acronym>CVS</acronym> snapshots to maintain operational desktops</emphasis>. You will get burned eventually!</para> +</warning> + +</answer> + +</qandaentry> +</qandaset> + +</chapter> |