<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>&abikeskus; on &kde; baaspaigalduse lahutamatu osa, mis paigaldatakse alati koos &kde;ga. Selle leiab paketist tdebase, samuti võib selle leida ftp-hoidlast &kde-ftp; või siis sinu operatsioonisüsteemi paketist tdebase. </para> </sect2> </sect1> <sect1 id="invoking-help"> <title>Abiteksti väljakutsumine</title> <para>&abikeskus; 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 &abikeskus;e 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 &abikeskus;e, tuues sind taas avaleheküljele. </para> </listitem> </varlistentry> <varlistentry> <term>Käsurealt</term> <listitem> <para>&abikeskus;e 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>&abikeskus;e töökeskkond</title> <para>&abikeskus; koosneb kahest infopaneelist. </para> <para>Tööriistaribade ja menüüde kasutamist seletab 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 &abikeskus;es 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> jaguneb kaheks kaardiks, millest üks sisaldab <link linkend="contents-menu">menüüd</link>, mis näitab kogu abiinfot, mida &abikeskus; ü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; kasutaja käsiraamat</guilabel></term> <listitem> <para>&kde; kasutaja käsiraamat 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 toob ära 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 manuaalilehekü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 tavakasutajale. 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 &abikeskus; 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 on 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>, &ie; 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> & <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. Manuaalikirjed 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>&abikeskus;e 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 &abikeskus;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>Autorid ja litsentsid</title> <para>&abikeskus;</para> <para>Originaali arendaja: &Matthias.Elter; &Matthias.Elter.mail;</para> <para>Praegune hooldaja: &Cornelius.Schumacher; &Cornelius.Schumacher.mail;</para> &underFDL; &underGPL; </sect1> </chapter>