<chapter id="help-system-user-manual">
<chapterinfo>
<date
>2002-02-03</date>
<releaseinfo
>0.08.00</releaseinfo>
</chapterinfo>
<title
>&kde; abisüsteemi kasutusjuhend</title>
<anchor id="help"/>

<sect1 id="help-introduction">
<title
>&kde; abisüsteem</title>
	
<para
>&kde; abisüsteemi eesmärk on muuta tavapäraste &UNIX; abisüsteemide (<application
>man</application
> ja <application
>info</application
>) ning &kde; stiilis dokumentatsiooni (&XML;) kasutamine hõlpsaks ja lihtsaks. </para>
	
<para
> Kõik &kde; baasrakendused on tänu dokumentatsioonimeeskonna tööle täielikult dokumenteeritud. Kui soovid abi pakkuda, kirjuta info saamiseks dokumentatsiooni koordinaatorile Lauri Wattsile (<email
>lauri@kde.org</email
>). Selleks ei ole tegelikult vaja isegi kogemust, piisab entusiasmist ja kannatlikkusest. </para>

<para
> Kui soovid kaasa aidata &kde; dokumentatsiooni tõlkimisele oma emakeelde, siis ootab meelsasti sinu abi tõlkekoordinaator Thomas Diehl (<email
>thd@kde.org</email
>). Täpsemat infot, sealhulgas tõlkemeeskondade koordinaatorid, leiad <ulink url="http://i18n.kde.org"
>internatsionaliseerimise veebileheküljelt</ulink
> ning käesoleva dokumendi sektsioonist <link linkend="contact"
>Ühendusevõtmine</link
>. </para>

<sect2 id="installation">
<title
>Paigaldamine</title>

<para
> &khelpcenter; on &kde; baaspaigalduse lahutamatu osa, mis paigaldatakse alati koos &kde;ga. Selle leiab paketist kdebase, samuti võib selle leida ftp-hoidlast &kde-ftp; või siis sinu operatsioonisüsteemi paketist kdebase. </para>

</sect2>
</sect1>

<sect1 id="invoking-help">
<title
>Abiteksti väljakutsumine</title>

<para
> &khelpcenter;it on võimalik välja kutsuda mitmel moel: </para>

<variablelist
> <varlistentry
> <term
>Menüüst <guimenu
>Abi</guimenu
></term
> <listitem
> <para
> See on tõenäoliselt kõige levinum viis mingi rakenduse kasutamise puhul. Antud rakenduse abifaili kasutamiseks kasuta selle menüüd <menuchoice
><guimenu
>Abi</guimenu
> <guimenuitem
>Sisukord</guimenuitem
></menuchoice
>. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guimenu
>K</guimenu
>-menüüst</term
> <listitem
> <para
> Klõpsa paneelil suurel <guiicon
>K</guiicon
>-tähel ja vali sealt &khelpcenter;i kasutamiseks <guimenuitem
>Abi</guimenuitem
>, mis toob sind abikeskuse avaleheküljele. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Paneelilt</term
> <listitem
> <para
> Vaikimisi sisaldab &kicker;i paneel ikooni, millele klõpsamine avab &khelpcenter;i, tuues sind taas avaleheküljele. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Käsurealt</term
> <listitem
> <para
> &khelpcenter;i saab faili näitamiseks käivitada &URL;iga. Vastavad &URL;id on lisatud ka <command
>info</command
> ja <command
>man</command
> kasutamiseks. Vastavad käsud võivad olla järgmised: </para
> <variablelist
> <varlistentry
> <term
>Rakenduse abifail</term
> <listitem
> <para
> <command
>khelpcenter</command
> <option
>help:/<replaceable
>kedit</replaceable
></option
> </para
> <para
> See avab &kedit;i abifaili sisukorra. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Kohalik &URL;</term
> <listitem
><para
> <command
>khelpcenter</command
> <option
>file:/ <replaceable
>usr/local/src/qt/html/index.html</replaceable
></option
> </para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Manuaalilehekülg</term
> <listitem
> <para
> <command
>khelpcenter</command
> <option
>man:/<replaceable
>strcpy</replaceable
></option
> </para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Infolehekülg</term
> <listitem
> <para
> <command
>khelpcenter</command
> <option
>info:/<replaceable
>gcc</replaceable
></option
> </para
> </listitem
> </varlistentry
> </variablelist
> <para
> Käsk <command
>khelpcenter</command
> ilma täpsustuseta avab abikeskuse avalehekülje. </para
> </listitem
> </varlistentry
> </variablelist>
</sect1>

<sect1 id="interface-basics">
<title
>&khelpcenter;i töökeskkond</title>

<para
> &khelpcenter; koosneb kahest infopaneelist. </para>

<para
> Tööriistaribade ja menüüde kasutamist seletatakse lähemalt <xref linkend="menu-and-toolbar-ref"/>. </para>

<para
> Dokumentidel on omaette navigeerimisvahendid, mis võimaldavad liikuda erinevate dokumentide juurde, kasutates viitu <guilabel
>Järgmine</guilabel
>, <guilabel
>Eelmine</guilabel
> ja <guilabel
>Kodu</guilabel
> või siis hüperlinke kasutades otse vajaliku dokumendi juurde. </para>

<para
> Viidad võivad sind viia sama dokumendi teise osa või hoopis teise dokumendi juurde. Seansi ajal kasutatud dokumentide vahel saab saab liikuda, kui kasutada tööriistaribal ikoone <guiicon
>Tagasi</guiicon
> (vasakule osutav nool) ja <guiicon
>Edasi</guiicon
> (paremale osutav nool). </para
> 

<para
> Kaks paneeli näitavad vasakul abisüsteemi sisukorda ja paremal abifaile. </para>

<sect2 id="contents-pane">
<title
>Paneel <guilabel
>Sisukord</guilabel
></title>

<para
> Paneel <guilabel
>Sisukord</guilabel
> paikneb &khelpcenter;is akna vasakul ääres. Enesestmõistetavalt on kahe paneeli vahel liigutatav piire, mis muudab ükspuha kumba paneeli lugemise väga mugavaks. </para
> 

<para
> Paneeli <guilabel
>Sisukord</guilabel
> jagavad kaheks sakid, millest üks sisaldab <link linkend="contents-menu"
>menüüd</link
>, mis näitab kogu abiinfot, mida &khelpcenter; üldse pakub, ning teine &kde; mõistete <link linkend="kde-glossary"
>sõnaraamatut</link
>. </para>

<sect3 id="contents-menu">
<title
><guilabel
>Sisukorra</guilabel
> menüü</title>

<para
> <guilabel
>Sisukord</guilabel
> sisaldab järgmisi vaikekirjeid: </para
> 

<variablelist
> <varlistentry
> <term
><guilabel
>Sissejuhatus</guilabel
></term
> <listitem
><para
>Tere tulemast &kde;sse - sissejuhatus KDE töölaua keskkonda.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Sissejuhatus &kde;sse</guilabel
></term
> <listitem
> <para
> &kde; kiire sissejuhatus. Sisaldab retke läbi &kde; töökeskkonna ning konkreetseid vihjeid ja nõuandeid, kuidas &kde;s tõhusamalt tööd teha. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>&kde; kasutusjuhend</guilabel
></term
> <listitem
> <para
> &kde; kasutusjuhend on põhjalik ülevaade &kde;st, sisaldades osasid nii paigalduse, seadistamise, kohandamise kui kasutamise kohta. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Rakenduste käsiraamatud</guilabel
></term
> <listitem
> <para
> &kde; omarakenduste dokumentatsioon. Kõigi &kde; rakenduste dokumentatsioon on &XML; vormingus, mis teisendatakse <acronym
>HTML</acronym
> vormingusse, kui te seda vaatate. See sektsioon loetleb kõik &kde; rakendused, annab nende kohta lühikirjelduse ja viitab rakenduse põhjalikule dokumentatsioonile. </para
> <para
> Rakendused on esitatud puuna, mis vastab <guimenu
>K</guimenu
>-menüü vaikestruktuurile, muutes nii lihtsamaks selle rakenduse leidmise, mille kohta sa infot soovisid. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>&UNIX;i man leheküljed</guilabel
></term
> <listitem
> <para
> &UNIX;i man leheküljed on &UNIX;i süsteemide traditsiooniline dokumentatsioonivorming. Süsteemi enamikul rakendustel on olemas oma man lehekülg. Lisaks sellele on man lehekülgi ka mitmesuguste käskude ja failivormingute kohta. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Infoleheküljed</guilabel
></term
> <listitem
> <para
> TeXinfo dokumentatsiooni kasutavad paljud &GNU; rakendused, sealhulgas <command
>gcc</command
> (C/C++ kompilaator), <command
>emacs</command
> ja paljud teised. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Sissejuhatused</guilabel
></term
> <listitem
> <para
> Lühikesed, ülesandekesksed või informatiivsed sissejuhatused. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>&kde; KKK</guilabel
></term
> <listitem
> <para
> Korduma kippuvad küsimused &kde; kohta - ja vastused. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>&kde; veebis</guilabel
></term
> <listitem
> <para
> Viidad &kde;le veebis, nii &kde; ametlikule koduleheküljele kui ka teistele kasulikele lehekülgedele. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Kontaktinfo</guilabel
></term
> <listitem
> <para
> Info, kuidas võtta ühendust &kde; arendajatega ja kuidas liituda &kde; meililistidega. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>&kde; toetamine</guilabel
></term
> <listitem
> <para
> Kuidas pakkuda abi ja kuidas anda oma panus. </para
> </listitem
> </varlistentry
> </variablelist>

</sect3>

<!-- 
<sect3 id="search">
<title
>The <guilabel
>Search</guilabel
> tab</title>

<para>
Searching requires you have the <application
>ht://Dig</application>
application installed.  Information on installing and configuring the
search index is available in the document.  Configuration of the search
index is performed in the &kcontrol;, by choosing
<menuchoice
><guisubmenu
>Help</guisubmenu
><guimenuitem
>Index</guimenuitem
></menuchoice
>,
and detailed help is available from this module.
</para>

<para>
For the purposes of this document, we'll assume you already have this set
up and configured.
</para>

<para>
Searching the help files is fairly intuitive, enter the word(s) you wish
to search for in the text box, choose your options (if any), and press
<guibutton
>Search</guibutton
>.  The results display in the viewer pane
to the right.
</para>

<para
>The options available are:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Method</guilabel
></term>
<listitem>
<para>
Choose how to search for multiple words.  If you choose
<guilabel
>and</guilabel
>, results are returned only if all your search
terms are included in the page. <guilabel
>or</guilabel
> returns results
if <emphasis
>any</emphasis
> of the search terms are found, and
<guilabel
>boolean</guilabel
> lets you search using a combination.
</para
> 
<para>
Boolean syntax lets you use the operators <literal
>AND</literal
>,
<literal
>OR</literal
> and <literal
>NOT</literal
> to create complex
searches. Some examples:</para>
<variablelist>
<varlistentry>
<term
><userinput
>cat and dog</userinput
></term>
<listitem
><para
>Searches for pages which have both the words
<userinput
>cat</userinput
> and <userinput
>dog</userinput
> in them.  Pages with
only one or the other will not be returned.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><userinput
>cat not dog</userinput
></term>
<listitem
><para
>Searches for pages with <userinput
>cat</userinput
> in them, but
only returns the ones that don't have the word <userinput
>dog</userinput
> in
them.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><userinput
>cat or (dog not nose)</userinput
></term>
<listitem
><para
>Searches for pages which contain <userinput
>cat</userinput
>, and
for pages which contain <userinput
>dog</userinput
> but don't contain
<userinput
>nose</userinput
>.  Pages which contain both
<userinput
>cat</userinput
> and <userinput
>nose</userinput
> would be returned,
pages containing all three words would not.</para
></listitem
> 
</varlistentry>
</variablelist>
<para
>If your searches are not returning the results you expect, check
carefully you haven't excluded the wrong search term with an errand
<literal
>NOT</literal
> or a stray brace.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Max. results</guilabel
></term>
<listitem
><para
>Determines the maximum number of results returned from your
search.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Format</guilabel
></term>
<listitem
><para
>Decide if you want just a short link to the page
containing your search terms, or do you want a longer
summary.</para
></listitem
> 
</varlistentry>
<varlistentry>
<term
><guilabel
>Sort</guilabel
></term>
<listitem
><para
>Sort the results in order of <guilabel
>Score</guilabel
> (how
closely your search terms were matched,) alphabetically by
<guilabel
>Title</guilabel
> or by <guilabel
>Date</guilabel
>.  Selecting the
<guilabel
>Reverse order</guilabel
> check box, naturally enough, reverses the
sort order of the results.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Update index</guilabel
></term>
<listitem
><para
>Update the search index, to incorporate new documents,
or if you think your database is incomplete or damaged.  This may take
some time.</para
></listitem>
</varlistentry>
</variablelist>
</sect3>
-->

</sect2>

<sect2 id="man-and-info">
<title
><application
>Man</application
> ja <application
>Info</application
> sektsioonid</title>

<para
>Man leheküljed on standardsed &UNIX;i manuaalileheküljed, mida on juba aastaid kasutatud paljudel operatsioonidesüsteemidel. Need on väga põhjalikud ja seetõttu parim koht, kust hankida infot &UNIX;i käskude ja rakenduste kohta. Kui öeldakse <quote
>RTFM</quote
>, peetakse manuaali all enamasti silmas just man lehekülge.</para>

<para
>Man leheküljed ei ole küll ideaalsed. Nad on enamasti põhjalikud, aga samas väga tehnilised, sest neid on tihtipeale kirjutajad arendajad - teistele arendajatele. Mõnikord muudab see nad väga raskesti mõistetavaks või isegi täiesti mõistetamatuks nii-öelda tavalisele kasutajale. Siiski on see parim koht,. kust hankida infot enamiku käsurearakenduste kohta, ja väga tihti ka ainus.</para>

<para
>Kui sa oled kunagi hämmastunult mõelnud, mida küll tähendab see, kui kirjas seisab näiteks man(1), siis see tähendab seda, millises manuaali sektsioonis viidatu paikneb. Ka &khelpcenter; kasutab numbreid, et jagada man lehekülgede hiigelhulk teatud sektsioonideks, mis võimaldab lihtsamaks leida just seda infot, mida sul vaja läheb.</para>

<para
>Kasutada saab ka infolehekülgi, mis olid mõeldud asendama man lehekülgi. Mõnegi rakenduse hooldaja ei värskenda enam man lehekülgi, nii et kui saadaval on nii man kui infolehekülg, siis in infolehekülg tõenäoliselt uuem. Paljudel rakendustel on olemas mõlemad abivahendid. Kui rakendus, mille kohta sa abi otsid, on &GNU; utiliit, siis on tõenäolisem leida abi infoleheküljelt, mitte man lehekülgedelt.</para>

<sect3 id="navigation">
<title
>Liikumine <application
>info</application
>lehekülgedel</title>

<para
>Infodokumendid on korrastatud hierarhiliselt, lehekülgi kutsutakse siin sõlmedeks. Kõigil infolehekülgedel on sõlm <guilabel
>Top</guilabel
>, <abbrev
>st</abbrev
> avalehekülg. Infolehekülje "tippu" pääseb klõpsuga viidal <guilabel
>Top</guilabel
>.</para>

<para
>Hierarhia samal tasemel eelmisele ja järgmisele leheküljele liikumiseks saab kasutada viitu <guibutton
>Prev</guibutton
> &amp; <guibutton
>Next</guibutton
>.</para>

<para
>Klõps menüüelemendil dokumendi sees viib hierarhia järgmisele astmele. Tagasi ülespoole pääseb viidaga <guibutton
>Up</guibutton
>.</para>

<para
>Man lehekülgede kasutamine on sarnane infolehekülgede kasutamisega, ka seal on sektsiooni indeks "Top" ja iga man lehekülg asub taseme võrra allpool. Man kirjed on ühe lehekülje pikkused.</para>

</sect3>
</sect2>

<sect2 id="kde-glossary">
<title
>&kde; sõnaraamat</title>

<para
> Sõnaraamat on mõeldud kiireks viitematerjaliks, kus võib leida seletuse sõna kohta, mida sa varem ei teadnud. Mõisted ulatuvad &kde; spetsiifilistest rakendustest ja tehnoloogiatest &UNIX;i üldiste terminiteni. </para>

<para
> Vasakul paneelil on puuvaade kahe valikuga: <guilabel
>Tähestiku järjekorras</guilabel
> ja <guilabel
>Teemade järgi</guilabel
>. Mõlemad sisaldavad ühesuguseid mõisteid, mis on erinevalt korraldatud, võimaldamaks kiiresti leida huvipakkuva termini. </para>

<para
> Liikudes vasakul esitatud puus vajaliku kohani, avaneb paremal otsitava mõiste seletus. </para>

</sect2>

<sect2 id="menu-and-toolbar-ref">
<title
>Menüüd ja tööriistariba</title>

<para
> &khelpcenter;i töökeskkond on väga lihtne, mis võimaldab abikeskuse talituspõhimõtete tundmaõppimise asemel keskenduda abi saamisele. </para>

<para
> Tööriistaribal kasutatakse järgmisi ikoone: </para>

<variablelist
> <title
>Tööriistaribaikoonid</title
> <varlistentry
> <term
><guiicon
>Tagasi</guiicon
></term
> <listitem
> <para
>Liigub eelmisele vaadatud leheküljele.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Edasi</guiicon
></term
> <listitem
> <para
>Liigub ühe lehekülje võrra edasi. Seda saab kasutada ainult siis, kui varem on kasutatud ikooni <guiicon
>Tagasi</guiicon
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Trüki</guiicon
></term
> <listitem
> <para
> Trükib parajasti vaadatava lehekülje sisu. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Otsi</guiicon
></term
> <listitem
> <para
> Otsib sõna või sõnu parajasti vaadataval leheküljel. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Suurenda fonti</guiicon
></term
> <listitem
> <para
> Suurendab tekstisuurust vaateleheküljel. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Vähenda fonti</guiicon
></term
> <listitem
> <para
> Vähendab tekstisuurust vaateleheküljel. See toimib ainult siis, kui varem on teksti suurendatud. </para
> </listitem
> </varlistentry
> </variablelist>

<para
> Menüüdes esinevad järgmised kirjed: </para>

<variablelist
> <varlistentry
> <term
><guimenu
>Fail</guimenu
></term
> <listitem
> <variablelist
> <varlistentry
> <term
> <menuchoice
> <guimenu
>Fail</guimenu
> <guimenuitem
>Trüki...</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> Trükib parajasti vaadatava lehekülje sisu. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Välju</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> Sulgeb lehekülje ja väljub &khelpcenter;ist. </para
> </listitem
> </varlistentry
> </variablelist
> </listitem
> </varlistentry
> <varlistentry
> <term
><guimenu
>Redigeerimine</guimenu
></term
> <listitem
> <variablelist
> <varlistentry
> <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>A</keycap
></keycombo
></shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Vali kõik</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> Valib kogu teksti aktiivsel leheküljel. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>F</keycap
></keycombo
></shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Otsi...</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> Otsib sõna või sõnu parajasti nähtaval leheküljel. </para
> </listitem
> </varlistentry
> </variablelist
> </listitem
> </varlistentry
> <varlistentry
> <term
><guimenu
>Vaade</guimenu
></term
> <listitem
> <variablelist
> <varlistentry
> <term
><menuchoice
> <guimenu
>Vaade</guimenu
> <guimenuitem
>Vaata dokumendi lähteteksti</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> Esitab parajasti vaadatava lehekülje <acronym
>HTML</acronym
>-lähteteksti. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenu
>Vaade</guimenu
> <guisubmenu
>Määra kodeering</guisubmenu
> </menuchoice
> </term
> <listitem
> <para
> Muudab aktiivse lehekülje kodeeringut. Normaalselt peaks kõik vajadused rahuldama vaikeseadistus <guimenuitem
>Automaatne</guimenuitem
>, aga kui tekib probleeme lehekülgedega, mis ei ole kirjutatud inglise keeles, võib tekkida vajadus määrata selle menüü abil sobilik kodeering. </para
> </listitem
> </varlistentry
> </variablelist
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenu
>Liikumine</guimenu
> <guimenuitem
>Tagasi</guimenuitem
></menuchoice
></term
> <listitem
> <para
>Liigub eelmisele vaadatud leheküljele.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenu
>Liikumine</guimenu
> <guimenuitem
>Edasi</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Kui oled varem liikunud tagasi vastava ikooni või menüükäsu abil, siis selle käsuga saad taas edasi liikuda.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenu
>Liikumine</guimenu
> <guimenuitem
>...</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Menüü <guimenu
>Liikumine</guimenu
> allosas leiad ajalooloendi mõne viimase vaadatud leheküljega. Neist ühe valimine viib sind otse sellele leheküljele.</para
> </listitem
></varlistentry
></variablelist>

</sect2>

</sect1>

<sect1 id="credits">
<title
>Tänusõnad ja litsentsid</title>

<para
>&khelpcenter;</para>

<para
>Originaali arendaja: Matthias Elter <email
>me@kde.org</email
></para>
<para
>Praegune hooldaja: Matthias Hoelzer-Kluepfel <email
>mhk@kde.org</email
></para>

&underFDL;
&underGPL;

</sect1>
</chapter>


