diff options
Diffstat (limited to 'doc/quickstart')
| -rw-r--r-- | doc/quickstart/CMakeLists.txt | 12 | ||||
| -rw-r--r-- | doc/quickstart/Makefile.am | 3 | ||||
| -rw-r--r-- | doc/quickstart/index.docbook | 1335 |
3 files changed, 0 insertions, 1350 deletions
diff --git a/doc/quickstart/CMakeLists.txt b/doc/quickstart/CMakeLists.txt deleted file mode 100644 index ba7a81cfd..000000000 --- a/doc/quickstart/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_create_handbook( DESTINATION khelpcenter/quickstart ) diff --git a/doc/quickstart/Makefile.am b/doc/quickstart/Makefile.am deleted file mode 100644 index 7e42282c4..000000000 --- a/doc/quickstart/Makefile.am +++ /dev/null @@ -1,3 +0,0 @@ - -KDE_LANG = en -KDE_DOCS = khelpcenter/quickstart diff --git a/doc/quickstart/index.docbook b/doc/quickstart/index.docbook deleted file mode 100644 index a70ab467c..000000000 --- a/doc/quickstart/index.docbook +++ /dev/null @@ -1,1335 +0,0 @@ -<?xml version="1.0" ?> -<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ - <!ENTITY kappname "Quickstart Guide to &tde;"> - <!ENTITY package "tdebase"> - <!ENTITY % addindex "IGNORE"> - <!ENTITY % English "INCLUDE" > <!-- change language only here --> -]> - -<book lang="&language;"> - -<bookinfo> - -<title>Quickstart Guide to &tde;</title> - -<authorgroup> -<author>&tde-authors;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> - -<date>&tde-release-date;</date> -<releaseinfo>&tde-release-version;</releaseinfo> - -<copyright> -<year>1999-2002</year> -<holder>The &kde; Team</holder> -</copyright> -<copyright> -<year>&tde-copyright-date;</year> -<holder>&tde-team;</holder> -</copyright> - -<legalnotice>&FDLNotice;</legalnotice> - -<abstract> -<para>Quickstart Guide to &tde;</para> -<para>An introduction to the Trinity Desktop Environment</para> -</abstract> - -<keywordset> -<keyword>KDE</keyword> -<keyword>TDE</keyword> -<keyword>quick start</keyword> -<keyword>introduction</keyword> -</keywordset> -</bookinfo> - -<chapter id="introduction"> -<title>Introduction</title> - -<para> -This guide provides a brief introduction to the Trinity Desktop Environment. It -will familiarize you with some of the basic features of &tde;. -</para> - -<para> -This guide does not cover all aspects of the Trinity Desktop or even most -of them. This guide only describes some of the most basic ways to accomplish a few -of the most common tasks. The <ulink url="help:/khelpcenter/userguide">&tde; User's Guide</ulink> -provides detailed coverage of using Trinity. -</para> - -<para> -Use this guide with the presumption of being familiar with at least one graphical -user interface, such as <trademark>CDE</trademark>, -<trademark>Geos</trademark>, <trademark>GEM</trademark>, &NeXTSTEP;, -&Mac;, <trademark>OS/2</trademark> or &Microsoft; &Windows;. Basic concepts, such as -using the mouse or keyboard are not explained in this guide. -</para> - -</chapter> - -<chapter id="an-overview-of-kde"> -<title>An Overview of &tde;</title> - -<para> -This section is for users who prefer to learn by exploring and want -only a brief orientation to get started. Later sections provide a more -thorough introduction to the environment, with helpful hints and -shortcuts. If you are impatient to get started, skim this section, go -play for a bit, then come back and peruse the other sections of this -guide as needed. -</para> - -<note> -<para> -&tde; provides a highly configurable desktop environment. This -overview presumes that you are using the default environment. -</para> -</note> - -<sect1 id="the-kde-desktop"> -<title>The &tde; Desktop</title> - -<para>A typical Trinity desktop consists of several parts:</para> - -<itemizedlist> -<listitem> -<para>A <interface>panel</interface> at the bottom of the screen, used -to start applications and switch between desktops. Among other things, it -contains the &kmenu;, with an &ticon; -that displays a menu of applications to start. -</para> -</listitem> - -<listitem> -<para> -A <interface>taskbar</interface>, by default embedded in the panel, used -to switch between and manage currently running applications. Click on an -application on the taskbar to switch to the application. -</para> -</listitem> - -<listitem> -<para> -The <interface>desktop</interface> itself, on which frequently used -files and folders might be placed. &tde; provides multiple desktops, -each of which has its own windows. Click on the numbered buttons on -the panel to switch between desktops. -</para> -</listitem> -</itemizedlist> - -</sect1> - -<sect1 id="ready-set-go"> -<title>Ready, Set, Go!</title> - -<para>Here are a few quick tips to get you up and running.</para> - -<itemizedlist> -<listitem> -<para> -To start an application, click on the &ticon; button on -the panel (called the <link linkend="starter">&kmenu;</link>) -and choose an item from the menu. -</para> -</listitem> -<listitem> -<para> -Click the icon that looks like a picture of a house on -the panel to access the files in your home folder using -&konqueror;, &tde;'s File Manager utility. -</para> -</listitem> -<listitem> -<para>Choose <menuchoice><guimenu>TDE menu</guimenu> -<guisubmenu>System</guisubmenu> -<guimenuitem>Konsole</guimenuitem></menuchoice> to get a &UNIX; -command prompt, or press <keycombo action="simul">&Alt; -<keycap>F2</keycap></keycombo> to get a mini command prompt window to -execute a single command. -</para> -</listitem> - -<listitem> -<para> -Choose the <menuchoice><guimenuitem>Control Center</guimenuitem> -</menuchoice> item on the &kmenu; to configure &tde;. -</para> -</listitem> - -<listitem> -<para> -Press <keycombo action="simul">&Alt;<keycap>Tab</keycap></keycombo> to -switch between applications and <keycombo -action="simul">&Ctrl;<keycap>Tab</keycap></keycombo> to switch between -desktops using the keyboard. -</para> -</listitem> - -<listitem> -<para> -Use the &RMB; mouse button to access context menus for the panel, -desktop, and most &tde; applications. -</para> -</listitem> -</itemizedlist> - -</sect1> -</chapter> - -<chapter id="launching-applications"> -<title>Launching Applications</title> - -<sect1 id="starter"> -<title>Using the &kmenu; and the Panel</title> - -<para> -At the bottom of the screen you will find the desktop panel, which is called -&kicker;. Use the panel to launch applications. Have a look at the -button on the left with a large &ticon;. -</para> - -<para> -This button is called the &kmenu;. When the mouse pointer hovers over the icon, -a small arrow on the top indicates that it will pop up a menu if you -click on it. The popup offers you easy access to all &tde; -applications installed on your computer system. -</para> - -<sect2> -<title>Customizing &kicker;</title> - -<!-- FIXME: To add a button, use the little arrows on kicker, not the TDE menu -I am not sure I agree - some distributions fade or hide the applet handles by default, but -I haven't found one yet that hides the kmenu. (JLH) --> - -<para>If you use one application or tool very often, then you might want to have fast -access to it. In this case you can add a single application or an entire sub-menu of the -&kmenu; as a special quick-launch button on the panel. If you want to reach an application -directly via a launch button, click with the &RMB; either on a clear space on the panel or on the -&kmenu; icon. Select <menuchoice><guimenu>Panel Menu</guimenu> <guisubmenu>Add Application to Panel... -</guisubmenu></menuchoice> and then navigate to the application or menu you would like to add to -the panel.</para> - - -<para> -You can add an entire menu this way, or one of the &ticon; -button sub-menus. For example, if you have &koffice; installed and -want quick access to all the &koffice; applications, without having to -navigate through the &kmenu;, then instead of choosing an -application, click on the <guimenuitem>Add Menu to Main Panel</guimenuitem> menu -entry. Thereafter you will have instant access to all the &koffice; -applications, without having to put an icon for each on the panel. -</para> - -<note> -<para> -You can move all items of the panel around with the -<guimenuitem>Move</guimenuitem> command of the context menu. Just click -with the <mousebutton>third</mousebutton> mouse button (the -<mousebutton>third</mousebutton> mouse button is normally the -<mousebutton>right</mousebutton> button, but if you have configured your -mouse differently, for example for left-handers, it might also be the -<mousebutton>left</mousebutton> one). A menu will pop up where you can -choose <guimenuitem>Move</guimenuitem>. Now move the mouse and see how -the icon follows while still staying on the panel. When you are done, -simply press the <mousebutton>first</mousebutton> mouse button (by default -the <mousebutton>left</mousebutton> one). As you might have noticed, -there is also a menu entry <guimenuitem>Remove</guimenuitem> in case you -are tired of a certain launch button on your desktop. -</para> -</note> - -</sect2> - -<sect2> -<title>Using Context menus</title> - -<para> -This leads us to another interesting topic: in many places, you can -click the <mousebutton>right</mousebutton> mouse button to display a -<interface>context menu</interface> with choices that are applicable to -the item you clicked. It is therefore always a good idea to try out the -<mousebutton>third</mousebutton> mouse button on something, if you do -not know what to do with it. Even the background of the desktops has -such a menu! -</para> - -</sect2> - -<sect2> -<title>Other Panel features</title> - -<para> -There are other interesting things possible with the panel. One -might be important if you have a low resolution on your monitor: it is -the <quote>hide-and-show</quote> function, activated by clicking on the -small arrowed button, which is at one or both ends of the panel. -</para> - -<para> -Perhaps you just do not like the panel extending the full width of the -screen. That's easily changed! &RMB; on an empty space in the panel, -and choose <menuchoice><guimenuitem>Configure Panel...</guimenuitem></menuchoice>. In the &kcontrolcenter; -dialog that pops up, you can choose <guilabel>Length</guilabel> on -the <guilabel>Appearance</guilabel> tab, and use the slider there to set -the panel to less than 100% width. -</para> - -<para> -If you're following along, and have that dialog open anyway, then feel -free to play with all the options, and use the -<guibutton>Apply</guibutton> to see the effect they have. You can -easily reset everything to the default configuration, by simply pressing -the <guibutton>Use Defaults</guibutton> button. -</para> - -<para> -By the way, if you are not sure what a certain button does in &tde;, -just move the mouse pointer over it and wait for a short while: &tde; -has a built-in mini context help, called <quote>tool tips</quote>, which -explains the functionality of such controls in a few words. -</para> - - -</sect2> -</sect1> - -<sect1 id="want-command-line-back"> -<title>I want access to the command line!</title> - -<para> -There is nothing to fear. &tde; does not remove the -effective command line. You can move -your files with the desktop, but you can also use the &UNIX; commands you are -accustomed to. In fact,&tde; puts command line power at your fingertips, -in perhaps some surprising places. -</para> - -<para> -&tde; provides a very sophisticated command line window called -&konsole;. Choose <menuchoice><guimenu>TDE menu</guimenu> -<guisubmenu>System</guisubmenu> -<guimenuitem>Konsole</guimenuitem></menuchoice> to start it. This might -be something you want on your panel. -</para> - -<para> -Sometimes, you only want to enter one command on the command line. In -these cases, you do not need a full-blown terminal. Just press -<keycombo>&Alt;<keycap>F2</keycap></keycombo> and you get a -small command line where you can enter one command. The command line -window will disappear afterwards, but it remembers your command. -</para> - -<para> -When you pop up this window (that is called -<application>minicli</application>) and press the <keycap>Up -arrow</keycap>, you can browse through all the commands you have -previously entered. Also, you can enter &URL;s in -<application>minicli</application> to open a &konqueror; window with -the specified &URL;. -</para> - -<para> -&konqueror; and the text editor &kate; can both display terminal windows, -which behave just like &konsole;. In &konqueror;, you can turn this -on with the menu choice -<menuchoice><guimenu>Window</guimenu><guimenuitem>Show Terminal -Emulator</guimenuitem></menuchoice>. The embedded terminal will display -at the bottom of your &konqueror; window, and the really clever part -is that it will follow your clicks in the file manager view, changing -folder as you do. In &kate; you can display a terminal with the -menu choice <menuchoice><guimenu>Settings</guimenu><guimenuitem>Show -Console</guimenuitem></menuchoice>. -</para> - -<tip> -<para> -To display a &UNIX; man page, enter -<userinput><command>man:</command><replaceable>command</replaceable></userinput> -in <application>minicli</application>, where <replaceable>command</replaceable> -is the name of a &UNIX; command. -</para> -</tip> - -<tip> -<para> -To search for a word or words on the Google search engine, you can try entering -<userinput><command>gg:</command><replaceable>word or -words</replaceable></userinput>. There are a whole lot more of these -shortcut commands, and you can even add your own! Take a look in -&kcontrolcenter;, in the tab <menuchoice><guilabel>Web Browsing</guilabel> - <guilabel>Enhanced Browsing</guilabel></menuchoice>. -</para> -</tip> - -<para> -Finally, there's a way to have your command line always available, no -matter what you're doing - add one to your &kicker; panel! -</para> - -<para>Simply &RMB; click on an empty space in the panel and choose -<menuchoice><guilabel>Add Applet to Panel...</guilabel></menuchoice>. In the dialog that appears, -scroll down until you see the <guilabel>Run Command</guilabel> list item. Select -it with the &LMB; and click <guilabel>Add to Panel</guilabel>. This will embed a mini-cli -directly into your panel, complete with command history.</para> - -<para> -In conclusion, the command line is never far from view when using &tde;. -</para> - -</sect1> -</chapter> - -<chapter id="working-with-windows"> -<title>Working with Windows</title> - -<para> -If you have not already done so, start an application using the <link -linkend="starter">&kmenu;</link>; for example, <guimenuitem>Find Files</guimenuitem>. -</para> - -<sect1 id="window-what-now"> -<title>A window! What now?</title> - -<para> -Usually people work <emphasis>inside</emphasis> windows, but -sometimes you might want to manipulate windows. Here's a quick overview -of some of the most common window related functions: -</para> - -<variablelist> -<varlistentry> -<term>Move a window</term> -<listitem> -<para> -Drag the window's title bar, or hold the &Alt; key down -and drag anywhere in the window. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>Resize a window:</term> -<listitem> -<para> -Drag the window's border, or hold the &Alt; key down and drag with the -&RMB; anywhere in the window. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>Maximize a window</term> -<listitem> -<para> -Click the maximize button in the titlebar (in the default decoration it -is the button with a square, next to the X, located on the far right side -of the titlebar) to make the window fill the screen. If the window is -already maximized, shrink the window using the same button, although the -image will be a double square. -Clicking with the &MMB; maximizes the window vertically, and with -the &RMB;, horizontally. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>Iconify a window</term> -<listitem> -<para> -Click the <guilabel>Minimize</guilabel> button in the titlebar (next to <guilabel>Maximize</guilabel>) -to hide the window. Restore it by clicking on the window's icon in the -taskbar. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>Switch between windows</term> -<listitem> -<para> -Aside from the usual mouse click to switch to another window, -you can use <keycombo action="simul">&Alt; -<keycap>Tab</keycap></keycombo> to switch windows. See below for more -techniques. -</para> -</listitem> -</varlistentry> -</variablelist> - -<sect2> -<title>Titlebar buttons</title> - -<para> -&tde; windows have some standard buttons on their titlebars that -provide fast access to some common operations. The default button -layout looks like this: -</para> - -<itemizedlist> -<title>On the left side:</title> -<listitem> -<para> -A <guilabel>Menu</guilabel> button. This usually shows a mini icon for the application. Click -on it to get a window operations menu. Shortcut: <keycombo -action="simul">&Alt;<keycap>F3</keycap></keycombo> opens the window -menu. -</para> -</listitem> -<listitem> -<para>A <guilabel>sticky</guilabel> button. This button will look like a tumb tack or pin. -</para> -</listitem> - -</itemizedlist> - -<itemizedlist> -<title>On the right side:</title> -<listitem> -<para> -A <guilabel>Minimize</guilabel> button. -</para> -</listitem> - -<listitem> -<para> -A <guilabel>Maximize</guilabel> button. -</para> -</listitem> - -<listitem> -<para> -A <guilabel>Close</guilabel> button. This closes the window. Shortcut: <keycombo -action="simul">&Alt;<keycap>F4</keycap></keycombo>. -</para> -</listitem> -</itemizedlist> - -</sect2> - -<sect2> -<title>Switching between windows</title> - -<para> -Now that we know how to deal with windows, we encourage you to open -some other windows using the panel, since we will now discuss how to -switch between different windows. Since this is such a common -activity, &tde; offers several ways to do it; pick your favorite! -</para> - -<para> -Many graphical user interface systems require users to click the mouse in a window -to begin using it. This is &tde;'s default behavior, termed -<quote>Click To Focus</quote> focus policy. You can configure -your desktop in a way that moving the mouse pointer on to a window will -activate it. This is called <quote>Focus Follows Mouse</quote>. If you -select this policy using the <link linkend="configure">&tde; Control -Center</link>, the window under the mouse pointer is always the active -one. It does not necessarily come to the front automatically, but you -can still click on to the titlebar or the border of a window or, a -&tde; special, you can use the &Alt; key and click the &MMB; -anywhere on the window to raise it. -</para> - -<para> -Here are some other methods to switch windows: -</para> - -<itemizedlist> -<listitem> -<para> -Pick a window from the <emphasis>window list</emphasis> menu. To open -the menu, click the &MMB; on -an empty area of the desktop, or click the icon with several windows -on the panel, or finally click the up arrow at the left hand end of -the taskbar in the panel. -</para> -</listitem> - -<listitem> -<para> -Hold down the &Alt; key and press <keycap>Tab</keycap> to cycle through -the windows. -</para> -</listitem> - -<listitem> -<para> -Use the taskbar (next section). -</para> -</listitem> -</itemizedlist> - -</sect2> -</sect1> - -<sect1 id="using-taskbar"> -<title>Using the Taskbar</title> - -<para> -The <interface>taskbar</interface> displays a list of small icons, one -for each window on the desktop. In the default &tde; setup the taskbar -is located inside the panel, but can also be located at the top or -the bottom of the screen.</para> - -<para> -The taskbar is powerful. In the default configuration, if you -have more than one window from the same application open, they will be -<quote>grouped</quote>, so that you see one icon per application in -the taskbar.</para> - -<para>A simple &LMB; -click on the taskbar button will pop up a list of the open windows for -that application and you can choose the window you want to -use. Choosing one of these entries with the -<mousebutton>left</mousebutton> will bring you to the selected -window immediately. Click on a taskbar entry with the -<mousebutton>right</mousebutton> and you will see a menu allowing you -to operate on all the windows grouped under that icon, or each window -individually.</para> - -<para> -You can choose to see all the windows on all the desktops in your -taskbar, regardless of which desktop you are currently viewing, or to only -see the icons for the desktop you are viewing. You can choose -to ungroup the icons, so each open window will have its own icon -in the taskbar. There are many more options available simply by -right clicking on the taskbar handle (the small textured bar at the -left hand side) and choosing <guimenuitem>Configure Taskbar...</guimenuitem>. -</para> - -<para> -The icons on the taskbar resize themselves to make room for -applications, so you can fit many more applications than you might -think. Making the panel wider will let the taskbar icons take on a row -and column layout, but they will still resize to fit more icons. -</para> - -</sect1> - -<sect1 id="using-v-desktops"> -<title>Using Virtual Desktops</title> - -<para> -Now, what was that <guilabel>Sticky</guilabel> button? -</para> - -<para> -Perhaps you have more windows open than space on your -desktop. In this case you have three possibilities: -</para> - -<orderedlist> -<listitem> -<para> -Leave all windows open (cluttered desktop) -</para> -</listitem> - -<listitem> -<para> -Iconify those windows that you do not need at present and use -the taskbar or <keycombo action="simul">&Alt; -<keycap>Tab</keycap></keycombo> to switch between them -(still a bit confusing and much work!) -</para> -</listitem> - -<listitem> -<para> -Recommended: Use virtual desktops. -</para> -</listitem> -</orderedlist> - -<para> -The third option is the way to go! &tde; can handle several different desktops, -each with its own set of application windows. The default configuration provides four -desktops. You can switch between the virtual desktops easily with a -click on one of the desktop buttons on the panel. Also <keycombo -action="simul">&Ctrl;<keycap>F1...F4</keycap></keycombo> will send you -to the corresponding desktop immediately, or <keycombo -action="simul">&Ctrl; <keycap>Tab</keycap></keycombo> will cycle through -the desktops. -</para> - -<para> -Virtual desktops are nice. Yet sometimes you want a window to be -present on <emphasis>every</emphasis> desktop. This could be, for example, -a small chat window, an alarm clock or whatever. In this case you can -use the above mentioned <quote>sticky</quote> button that will pin the -window on the background so that it will appear on every virtual -desktop. -</para> - -<para> -The sticky button can also be used to move a window from one virtual -desktop to another one: push the sticky pin on the window, switch to a -different desktop, and release the pin by pushing it again. You can -achieve the same result by using the context popup menu of the -window's entry in the taskbar (menu item <guimenuitem>To Current -Desktop</guimenuitem>) or the <guimenuitem>To Desktop</guimenuitem> -option on the window operations menu. -</para> - -</sect1> -</chapter> - -<chapter id="managing-your-files"> -<title>Managing your files</title> - -<!-- NB Deliberate use of 'directory' rather than 'folder', since we're talking --> -<!-- about folders on disk --> -<para> -A common metaphor of graphical desktops is the use of folders to -represent folders on your hard disk. Folders contain files and -other folders. A &tde; application called &konqueror;, the Trinity File -Manager, uses this metaphor to help you manage your files. -</para> - -<sect1 id="using-konqueror"> -<title>Using &konqueror;</title> - -<para> -The first time you start &konqueror;, a window with lots of icons in it -appears. This is a &konqueror; window displaying the files in your -home folder (the area where your personal files are stored). The -pathname of the folder is displayed under the window's tool bar. If -you do not see such a window now, click the icon on the panel that -looks like a folder with a picture of a house. -</para> - -<para> -To open a file or folder, <quote>double-click</quote> it with the &LMB;. -You can also choose -<menuchoice><guimenu>Window</guimenu><guimenuitem>Show -Navigation Panel</guimenuitem></menuchoice> from the menu to display the folder -hierarchy for more direct navigation. Or you can edit the path -displayed under the toolbar to get to a specific folder quickly. -</para> - -<sect2> -<title>Opening Files</title> - -<para> -&tde; comes with a set of applications to view and edit files of many -common types, and when you select a file containing, say, a document -or image, &konqueror; will start an appropriate application to -display the file. If it does not know what application to start to open -a file you selected, &konqueror; will prompt you for the name of the -application to run, and when you have chosen, &konqueror; will offer -to remember your choice for the next time you open a file of that type. -</para> - -<note> -<para> -&konqueror; uses MIME types to associate -files with applications. -</para> -</note> - -</sect2> - -<sect2> -<title>Dragging and Dropping Icons</title> - -<para> -To copy or move a file, simply drag its icon to the desktop, to -another &konqueror; window, or to a folder icon. When you release the -button, &konqueror; displays a menu to allow you to choose to copy, -move, or create a link to the file. -</para> - -<note> -<para> -Note that if you choose to create a link, &tde; creates a &UNIX; -symbolic link (not a hard link), so if you move or delete the original -file, the link will be broken. -</para> -</note> - -<para> -Most &tde; applications also support drag and drop operations: you can -drag an icon on to a window of a running application, or on to an icon of -an application that is not started, to have the application open the -file. Try it! -</para> - -</sect2> - -<sect2> -<title>Setting File Properties</title> - -<para> -To change file properties, such as its name and permissions, &RMB; -click the icon and choose <guimenuitem>Properties</guimenuitem> from -the menu. -</para> - -</sect2> -</sect1> - -<sect1 id="archives-and-networks"> -<title>Working with Archives and Networks</title> - -<para> -Once upon a time users needed special software to access files on the -Internet. Not any more! -</para> - -<para> -&tde; supports a technology called <quote>Network Transparent -Access</quote> (<acronym>NTA</acronym>), which allows you to work with -files on the other side of the world as easily as those on your local -hard disk.</para> - -<para> -For example, to access files on an &FTP; server, just choose -<menuchoice><guimenu>Location</guimenu><guimenuitem>Open -Location</guimenuitem></menuchoice> from a &konqueror; menu, and enter -the <acronym>URL</acronym> of an &FTP; server. You can drag and drop -files to and from the folders on the server just as if they were on -your local disk. You'll even be able to open files on the &FTP; server -without having to manually copy them to your local disk (&tde; does it for you -when necessary). -</para> - -<note> -<para> -Note that &konqueror; uses anonymous &FTP; access, which might restrict -your access to files on the &FTP; server. If you have an account on -the server, you can supply your user <abbrev>ID</abbrev> as part of -the <acronym>URL</acronym>, like this: -<userinput><command>ftp://</command><parameter>userid</parameter>@<parameter>server</parameter>/<parameter>folder</parameter></userinput> -</para> - -<para> -&konqueror; will prompt you for your password, and if the login -succeeds, you will have full access to your files on the server. -</para> -</note> - -<para> -If you are used to the -<trademark><application>WinZip</application></trademark> utility on -&Microsoft; &Windows;, then you will be happy to know that &tde; can -look into archive files too. It treats such archives just like a -normal folder, and you can browse into the archive, open files, &etc; In -general, accessing files on the Internet and in archives should look -and feel just like accessing files on your local disk, except for -delays imposed by the network and extracting the archive. -</para> -</sect1> - -<sect1 id="using-templates"> -<title>Using Templates to Access Applications and Devices</title> - -<para> -In &tde; it's easy to put icons on the panel or the desktop to access -your applications. It's just as easy to add icons to access other -items of interest. &tde; has templates for shortcuts to: -</para> - -<itemizedlist> -<listitem> -<para> -Applications -</para> -</listitem> -<listitem> -<para> -Printers -</para> -</listitem> -<listitem> -<para> -Mountable Devices (⪚ floppy drives) -</para> -</listitem> -<listitem> -<para> -Internet resources (⪚ <acronym>WWW</acronym> documents, &FTP; -folders) -</para> -</listitem> -<listitem> -<para> -Documents for some of &tde;'s &koffice; applications. -</para> -</listitem> -</itemizedlist> - -<para> -You can add any of these items to the desktop by &RMB; clicking where -you want the icon, and choosing <guisubmenu>Create New</guisubmenu> -and selecting the item you want to link to. -</para> - -<para> -Nearly every item in the &kmenu;, on the desktop, and on -the panel refers to a <literal role="extension">.desktop</literal> -file on disk. The <literal role="extension">.desktop</literal> file -specifies what icon to display, as well as specific information about -what the icon represents (an application, device, or -<acronym>URL</acronym>). You can drag any <literal -role="extension">.desktop</literal> file to the panel to create a -quick-launch button. -</para> - -<!-- -<sect2> -<title>Setting up printers</title> - -<para> -You can create icons for your printers so you can print a file by -dragging it to a printer icon. Here's how: -</para> - -<procedure> -<step><para>Open the Templates folder located on the desktop.</para></step> -<step><para>Drag the Program icon in the folder to the desktop. Choose -<guimenuitem>Copy</guimenuitem> from the menu that appears when you drop the -icon.</para></step> -<step><para><mousebutton>Right</mousebutton> click the new icon, and choose -<guimenuitem>Properties</guimenuitem> from the context menu.</para></step> -<step><para>On the <guilabel>General</guilabel> tab, change the name to -<filename>Printer.kdelnk</filename>.</para></step> -<step><para>On the <guilabel>Execute</guilabel> tab, enter the following in the -first <guilabel>Execute</guilabel> field:</para> -<screen><command>lpr <option>%f</option></command></screen> -<note><para>This example presumes that you print using the <command>lpr</command> -command. If you use a different command, enter the one you -use.</para></note></step> -<step><para>Still in the <guilabel>Execute</guilabel> tab, click the icon that -looks like a <guiicon>cog</guiicon>, and select the <guiicon>Printer</guiicon> icon from the list that appears.</para></step> -</procedure> - -<para>Now you should be able to drag a file to the Printer icon and have it -printed on your default printer.</para> -</sect2> - ---> - -<sect2> -<title>Mounting devices</title> - -<para> -&UNIX; systems provide access to storage devices other than the primary -<hardware>hard disk</hardware> through a process called -<emphasis>mounting</emphasis>. &tde; uses <literal -role="extension">.desktop</literal> files to allow you to easily -mount, unmount, and access files on secondary storage devices such as -<hardware>floppy</hardware> drives and &cdrom; drives. -</para> - -<para> -As an example, here are the steps needed to create an icon to access -files on a floppy disk: -</para> - -<note> -<para> -Many &UNIX; systems require you to be logged in as <systemitem -class="username">root</systemitem> to mount and unmount devices. -</para> -</note> - -<procedure> -<step> -<para><mousebutton>Right</mousebutton> click on the desktop and choose -<menuchoice><guisubmenu>Create -New</guisubmenu><guisubmenu>Device</guisubmenu> -<guimenuitem>Floppy Device...</guimenuitem></menuchoice>. -</para> -</step> -<step> -<para> -On the <guilabel>General</guilabel> tab of the resulting dialog, change -the name to whatever you like, in the text box at the top. -</para> -</step> - -<step> -<para> -On the <guilabel>Device</guilabel> tab, enter <filename -class="devicefile">/dev/fd0</filename> (or the path to the floppy device -as it is named on your system) as the <guilabel>Device</guilabel>. -</para> -</step> -<step> -<para> -You can add a <guilabel>Mount Point</guilabel> here too. This should be -an existing folder, but empty. Common mount points are <filename -class="directory">/mnt/floppy</filename> or <filename -class="directory">/floppy</filename>, but you can just as easily have floppy -disks mounted on <filename class="directory">~/mydisk</filename> if you -want. -</para> -</step> -<step> -<para> -Click the <guilabel>Unmounted Icon</guilabel> and select the picture -of a floppy disk without the green light. -</para> -</step> -<step> -<para> -Once you're happy with your choices, choose <guibutton>OK</guibutton> -and you are finished! -</para> -</step> -</procedure> - -<para> -Now, place a properly formatted floppy in the drive and click the -<guiicon>Floppy</guiicon> icon to have &tde; mount the floppy drive and display -the files on the disk. Before removing the disk from the drive, &RMB; -click the <guiicon>Floppy</guiicon> icon and choose -<guimenuitem>Unmount</guimenuitem> from the menu. -</para> - -</sect2> -</sect1> -</chapter> - -<chapter id="configure"> -<title>Configuring your desktop</title> - -<para> -If you do not like something about the way the desktop looks or -operates, you can probably change it. &tde; is very configurable and you -can change almost every aspect of the appearance and the behavior of -your desktop. Unlike many other &UNIX; desktop environments, you do not -have to edit cryptic configuration files either (but you can if you -really want to!) You use the &kcontrolcenter;, a special program for -configuring your desktop. -</para> - -<sect1 id="using-kde-control"> -<title>Using the <application>&tde; Control Center</application></title> - -<para> -Launch the &kcontrolcenter; from the <link linkend="starter">&kmenu;</link>. -A window with two panes appears, displaying a list of -modules in the left pane. -</para> - -<para> -Open a module by clicking its name; a list of submodules will -appear. Then, click one of the submodule category names to edit its -configuration in the right pane. -</para> - -<para> -Changing the configuration is fairly straightforward. A help button is -available on each configuration panel to explain settings that are not -obvious. Each panel has buttons labeled <guibutton>Help</guibutton>, -<guibutton>Use Defaults</guibutton>, <guibutton>Apply</guibutton>, and -<guibutton>Reset</guibutton>, which work as follows: -</para> - -<variablelist> -<varlistentry> -<term><guibutton>Help</guibutton></term> -<listitem> -<para> -Displays a short help text in the left hand pane, including a link to a -longer manual for the module in question. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><guibutton>Use Defaults</guibutton></term> -<listitem> -<para> -Sets all the options in the current module back to the default at the -time &tde; was installed. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><guibutton>Apply</guibutton></term> -<listitem> -<para> -Applies the current settings in the currently open module. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><guibutton>Reset</guibutton></term> -<listitem> -<para> -Resets the options to the state they were in when you opened the module. -If you have already used the <guibutton>Apply</guibutton> button, then -this button will reset the options to the state they were in when you -pressed <guibutton>Apply</guibutton>. -</para> -</listitem> -</varlistentry> -</variablelist> - -<note> -<para> -If you make changes on one configuration panel and move to a different module -without clicking <guibutton>OK</guibutton> or <guibutton>Apply</guibutton> -first, &kcontrolcenter; will prompt you to ask whether your changes should be applied -first. -</para> -</note> - -</sect1> - -</chapter> - -<chapter id="logging-out"> -<title>Logging out</title> - -<para> -We sincerely hope that using &tde; gives you so much fun and -pleasure that you never want to log out. But if you do, simply choose -<menuchoice><guimenu>TDE menu</guimenu> -<guimenuitem>Logout</guimenuitem></menuchoice>. -</para> - -<para> -There also is an applet logout button that can be added directly to the panel, which looks like a -small power button. Or you can press <keycombo action="simul">&Ctrl; -&Alt; <keycap>Delete</keycap></keycombo> to log out. -</para> - -<sect1 id="session-management"> -<title>Session Management</title> - -<para> -When you log out, &tde; can remember which applications you had open, as -well as where all the windows were located, so that it can open them -for you the next time you log in. This feature is termed -<emphasis>Session Management</emphasis>. &tde;-aware applications will -restore themselves to the state they were in when you logged out. For -example, &kate; remembers which files you were editing.</para> - -<para> -Non-&tde; applications might not memorize their state on logout, and -&tde; will warn you to make sure that you have saved any important -data in them when you start to log out. -</para> - -<para> -To illustrate session management, choose <menuchoice> -<guimenu>TDE menu</guimenu><guisubmenu>Editors</guisubmenu> -<guimenuitem>Kate</guimenuitem> </menuchoice> to start &kate;. Open -a text document to edit. Now log out and back in. You will observe -that &kate; will be restored to the exact same position on the screen, -including the correct virtual desktop, and the document we left open in -&kate; before we logged out is opened again automatically. &kate; -will even remember whether you had unsaved changes to your document -before you logged out and will save them to the file you were working -on if you choose <guimenuitem>Save</guimenuitem> from the -<guimenu>File</guimenu> menu. -</para> - -</sect1> -</chapter> - -<chapter id="kde-an-exciting-journey"> -<title>&tde;, an exciting Journey</title> - -<para> -We hope you enjoyed this brief tour of the Trinity Desktop Environment and -that this unique desktop environment will help you get your work done -faster and more comfortably than ever. -</para> - -<para> -Please remember that the &tde; project is not a commercial venture, -but rather a project run by volunteers from around the world. We -would like to invite you to join the &tde; project and become part of -this unique network of people. If you are a programmer you might -consider helping us write or improve &tde; applications. If you are an artist or -have experience with graphic design, consider creating icons sets, -color schemes, sound schemes and logos for &tde;. If you enjoy -writing we would love for you to join our documentation team. -</para> - -<para> -As you can see there are many ways that you can help. You are -invited to join this world-wide network of people dedicated -to making &tde; the best desktop environment for any computer. Please -visit <ulink url="http://www.trinitydesktop.org">www.trinitydesktop.org</ulink> for more -information. -</para> - -<para> -<emphasis>Welcome aboard on this exciting journey, </emphasis> -</para> -<para> -<literal>Your &tde; Team</literal> -</para> -</chapter> - -<!-- -2004-08-27 -Removed because it probably should not be here, and it will only end up -getting out-of-date if it is (Phil) -<chapter id="advanced-topics"> -<title>Advanced Topics</title> - -<sect1 id="mime"> -<title>&MIME; Types</title> - -<para> -&tde; comes with a number of &MIME; types predefined, but you can add -your own &MIME; types by choosing -<menuchoice><guimenu>Settings</guimenu> -<guisubmenu>Configure Konqueror...</guisubmenu> -</menuchoice> and then <guilabel>File -Associations</guilabel> in a &konqueror; window. -</para> - -<para> -&tde;'s handling of &MIME; types is very powerful, and very -configurable. On the one hand, you can set a default action to be -performed when you click on a file in &konqueror;. Just as usefully, -you can add many more actions, which are then available with a &RMB; -click menu on the file in question. -</para> - - -<procedure> -<title>To link a certain file type with a particular application:</title> -<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>Edit File Type</guimenuitem> from the context menu, or -choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Edit File -Type</guimenuitem></menuchoice> in &konqueror;'s 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 might need to add -variations - <userinput>*.mp3</userinput> might need -<userinput>*.MP3</userinput> added as well, for example. Add as many -extensions 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 labeled <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 might 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 dialog box. This gives you the opportunity to test in the -<application>Konqueror</application> window that your file association -is correct. You can choose <guibutton>OK</guibutton> to save your -changes and close the dialog box, or <guibutton>Cancel</guibutton> if -you have changed your mind and just want to close the dialog 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 might -be used to using file extensions for that purpose, and you might 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 might be -vital - for example, some implementations of <command>gunzip</command> -will not operate on files that are not 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 <token>^</token> character means <quote>starts with...</quote>) and -without any regard to the rest of the filename. -</para> -</note> - -</sect1> - -</chapter> ---> -<chapter id="credits"> -<title>Credits</title> -<sect1 id="authors"> -<title>Authors</title> - -<itemizedlist> -<listitem><para>Matthias Ettrich -<email>[email protected]</email></para></listitem> -<listitem><para>Kalle Dahlheimer <email>[email protected]</email></para></listitem> -<listitem><para>Torben Weiss <email>[email protected]</email></para></listitem> -<listitem><para>Bernd Wuebben <email>[email protected]</email></para></listitem> -<listitem><para>Stephen Schaub <email>[email protected]</email> - -Editor</para></listitem> -<listitem><para>Robert Williams <email>[email protected]</email> - -Editor</para></listitem> -<listitem><para>Lauri Watts <email>[email protected]</email></para></listitem> -</itemizedlist> - -<!-- TRANS:CREDIT_FOR_TRANSLATORS --> - -&underFDL; - -</sect1> -</chapter> -</book> |