Move the khelpcenter guides to the directory level in which they are installed.

Signed-off-by: Slávek Banko <slavek.banko@axis.cz>

1 files changed, 243 insertions, 0 deletions

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 &mdash; 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 &amp; drop and the file manager, see the chapter <link linkend="moving-files-with-drag-and-drop">Moving files with drag &amp; 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>