diff options
Diffstat (limited to 'tde-i18n-sl/docs/tdebase/userguide/getting-started.docbook')
| -rw-r--r-- | tde-i18n-sl/docs/tdebase/userguide/getting-started.docbook | 459 |
1 files changed, 459 insertions, 0 deletions
diff --git a/tde-i18n-sl/docs/tdebase/userguide/getting-started.docbook b/tde-i18n-sl/docs/tdebase/userguide/getting-started.docbook new file mode 100644 index 00000000000..84306dac8d0 --- /dev/null +++ b/tde-i18n-sl/docs/tdebase/userguide/getting-started.docbook @@ -0,0 +1,459 @@ +<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 Directory </title> + +<para>Click on the <guiicon>K</guiicon> icon button and +choose <guimenuitem>Home Directory</guimenuitem>. A window showing +the contents of your home directory will pop up. To see a more +detailed listing of files in your home directory, 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 directory, including any +<quote>hidden files</quote> — files or directories 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><keycap>Ctrl</keycap><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 +directories 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 Directories </title> + +<para>We will now pick one of your configuration files and edit +it. First, we must change the directory in the File Manager.</para> + +<para>&konqueror; started with your home directory 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's 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> directory +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 directory is still selected. Now you can see +how your home directory fits into the whole hierarchy, and your home +directory 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 directory <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're going to practise on a file that won't 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 dialog 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 customize 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><keycap>Shift</keycap><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 dialog and +<guibutton>Cancel</guibutton> again in the save dialog.</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 +directory you own, and choose <menuchoice><guisubmenu>Create +New</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>).</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 directory.</para> + +<para>Click on the <filename>motd</filename> file. Hold your +<mousebutton>left</mousebutton> mouse button and drag your file into +your home directory. Release the <mousebutton>left</mousebutton> mouse +button (this is called <emphasis>dropping</emphasis> the file). You +will be presented three options: <guimenuitem>copy</guimenuitem>, +<guimenuitem>move</guimenuitem> and +<guimenuitem>link</guimenuitem>. <guimenuitem>Link</guimenuitem> will +create a symbolic link to the file, while +<guimenuitem>copy</guimenuitem> and <guimenuitem>move</guimenuitem> do +exactly what they say. Select <guimenuitem>copy</guimenuitem>. You +should now have a copy of the <filename>motd</filename> file in your +home directory. </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"><keycap>Alt</keycap> +<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>Options</guimenu> menu, you can customize 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 +directory 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 <guimenu>K</guimenu> menu. &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 directory, but you can select +any starting directory 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 directory, 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>Of type</guilabel> in the +<guilabel>Advanced</guilabel> tab.</term> +<listitem><para>If you know that the file was of a special type +(e.g., 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>Size is</guilabel>, also in the +<guilabel>Advanced</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 organize your work. You can +place your programs on different desktops, and name the desktops so +you know what you do there. This increases and optimizes 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 <guimenu>K</guimenu> menu. 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> |