<chapter id="help-system-user-manual">
<docinfo>
<date>21/10/2000</date>
<releaseinfo>1.94.00</releaseinfo>
</docinfo>
<title>Uporabniški priročnik za sistem pomoči KDE</title>
<anchor id="help">

<sect1 id="help-introduction">
<title>Sistem pomoči KDE</title>

<para>KDE sistem pomoči je načrtovan tako, da olajša dostop do običajnih
UNIX-ovih sistemov pomoči (<application>man</application> in <application>info</application>)
kot tudi prirojene KDE dokumentacije (<abbrev>HTML</abbrev>). </para>

<para>Vsi osnovni programi KDE so v celoti dokumentirani, za kar gre zahvala
dokumentacijski ekipi. Če želite pomagati pišite koordinatorju
dokumentacijske skupine (Mike McBride), na naslov <email>mpmcbride7@yahoo.com</email>
Izkušnje niso potrebne, le volja in potrpežljivost.
Če želite prevajati dokumentacijo KDE v vaš materin jezik, koordinator
prevajanja je &eacute;ric Bischoff
<email>e.bischoff@noos.fr</email> in bo cenil vašo pomoč.
Več podatkov, vključno s koordinatorji za posamezen jezik lahko najdete na
<ulink url="http://i18n.kde.org">spletni strani posvečeni internacionalizaciji
KDE</ulink> in v razdelku<link linkend="contact">Stiki</link> tega 
dokumenta.</para>

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

<para>&khelpcenter; je del namestitve KDE Base in je nameščen v vsaki kopiji
KDE. Lahko ga najdete v paketu kdebase in je dosegljiv na
<ulink url="ftp://ftp.kde.org/">FTP strani KDE</ulink> ali pa ga lahko najdete
v paketu kdebase vaše distribucije linux-a.</para>

</sect2>
</sect1>

<sect1 id="invoking-help">
<title>Priklic pomoči</title>

<para>&khelpcenter; lahko prikličete na več načinov:</para>

<variablelist>
<varlistentry>
<term>Iz menuja <guimenu>Pomoč</guimenu></term>
<listitem><para>Najpogosteje kličete pomoč iz programa. 
Izberite <menuchoice><guimenu>Pomoč</guimenu>
<guimenuitem>Vsebina</guimenuitem></menuchoice> in odprli boste
pomoč, na strani s kazalom vsebine.</para></listitem>
</varlistentry>

<varlistentry>
<term>Iz menuja <guimenu>K</guimenu></term>
<listitem><para>Izberite velik <guiicon>K</guiicon> na pultu in izberite
<guimenuitem>Pomoč</guimenuitem>, da odprete &khelpcenter;, s pričetkom na privzeti
pozdravni strani.</para></listitem>
</varlistentry>

<varlistentry>
<term>S pulta</term>
<listitem><para>Pult, imenovan <application>Kicker</application> privzeto vebuje ikono
za klic &khelpcenter;. Znova je prikazana pozdravna stran.</para></listitem>
</varlistentry>

<varlistentry>
<term>Iz ukazne vrstice</term>
<listitem><para>&khelpcenter; lahko požete tudi z uporabo <abbrev>URL</abbrev>, da prikaže
datoteko. Dodani so bili <abbrev>URL</abbrev>-ji za <application>Info</application>
in strani <application>man</application>. Uporabite jih lahko 
sledeče:</para>

<variablelist>
<varlistentry>
<term>Pomoč za nek program</term>
<listitem><para><command>khelpcenter
<option>help:/<replaceable>kedit</replaceable></option></command></para>
<para>Odpre datoteko s pomočjo za <application>Kedit</application> in sicer
na kazalu.</para></listitem> 
</varlistentry>

<varlistentry>
<term>Lokalen url</term>
<listitem><para><command>khelpcenter
<option><replaceable>file:/usr/local/src/qt/html/index.html</replaceable></option></command></para></listitem>
</varlistentry>

<varlistentry>
<term>Stran Man</term>
<listitem><para><command>khelpcenter
<option>man:/<replaceable>strcpy</replaceable></option></command></para></listitem>
</varlistentry>

<varlistentry>
<term>Stran Info</term>
<listitem><para><command>khelpcenter
<option>info:<replaceable>gcc</replaceable></option></command></para></listitem>
</varlistentry>
</variablelist>

<para>Ukaz <command>khelpcenter</command> brez prametrov odpre
privzeto pozdravno stran.</para></listitem>
</varlistentry>

</variablelist>
</sect1>

<!-- Interface - Basics, using Konqueror -->
<sect1 id="interface-basics">
<title>Vmesnik &khelpcenter;</title>

<para>Vmesnik za &khelpcenter; sestoji iz dveh področij informacij, ki sta vstavljeni
v okno &konqueror;ja. To olajša premikanje in ga naredi intuitivno z uporabo &konqueror;jevih
lastnih orodnih vrstic, tako kot da bi brskali po spletnih straneh. Poleg tega večina dokumentov
vsebuje lastna navigacijska orodja, ki vam omogočajo gibanje naprej ina nazaj
po dokumentu z uporabo povezav <guilabel>Naprej</guilabel> in <guilabel>Nazaj</guilabel>
ali pa manj urejeno premikanje s pomočjo hiperpovezav. Te vas alhko popeljejo
v druge dele istega dokuemnta ali pa v drug dokument, lahko pa seveda
uporabite ikoni <guiicon>Nazaj</guiicon> (leva puščica) ali
<guiicon>Naprej</guiicon> (desna puščica), ki se nahajata v orodni vrstici,
za premikanje skozi dokumente, ki ste jih pregledali v tej seji.</para>

<para>Področji prikazujeta na levi vsebino sistema pomoči in na desni datoteke 
pomoči same.</para>

<sect2 id="contents-pane">
<title>Področje <guilabel>Vsebina</guilabel></title>

<para>Področje <guilabel>Vsebina</guilabel> &khelpcenter; prikaže na levi strani
okna. Kot bi morda pričakovali lahko črto, ki loči okni premikate in
tako poskrbite za udobno branje enega ali drugega dela okna.</para>

<para><guilabel>Vsebina</guilabel> se deli na dva lista, eden
vsebuje <link linkend="contents-menu">menu</link>, ki prikazuje vso pomoč, ki se
je &khelpcenter; zaveda, drugi pa vam omogoča <link
linkend="search">iskanje</link> določene informacije.</para>

<sect3 id="contents-menu">
<title>Menu <guilabel>Vsebina</guilabel></title>

<para>Menu <guilabel>Vsebina</guilabel> vsebuje naslednje privzete
možnosti:</para>

<variablelist>
<varlistentry>
<term><guilabel>Uvod</guilabel></term>
<listitem><para>Dobrodošli v KDE - uvod v namizno okolje K.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Povabilo v KDE</guilabel></term>
<listitem><para>Hitri tečaj KDE.  Vsebuje turo po  uporabniškem vmesniku KDE
in specifično pomoč in namige kako pametneje in spretneje delati v KDE.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Uporabniški priročnik KDE</guilabel></term>
<listitem><para>Uporabniški priročnik KDE je poglobljena raziskava KDE,
vključno z namestitvijo, nastavitvijo, prilagoditvijo in uporabo
KDE.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Programski priročniki</guilabel></term>
<listitem><para>Naravna dokumentacija KDE. Vsi programi KDE imajo 
dokumentacijo v obliki <abbrev>HTML</abbrev>. Ta razdelek našteje vse programe KDE
s kratkim opisom in povezavo do celotne dokumentacije 
programa.</para>
<para>Programi so prikazani v drevesni strukturi ki odraža privzeto
strukturo menuja <guimenu>K</guimenu>, kar olajša iskanje 
želenega programa.</para></listitem> 
</varlistentry>

<varlistentry>
<term>Strani referenčnega priročnika v UNIX-u</term>
<listitem><para>UNIX-ve strani man so tradicionalen format
za sprotne pomoči z sisteme unix. Večina programov v vašem sistemu ima stran man.
Poleg tega obstajajo še strani za programske funkcije in datotečne 
formate.</para></listitem>
</varlistentry>

<varlistentry>
<term>Sistemski imenik Info</term>
<listitem><para>TeXinfo dokumentacijo uporabljajo mnogi programi GNU,
kot so <application>gcc</application> (C/C++ prevajalnik),
<application>emacs</application> in mnogi drugi.</para></listitem>
</varlistentry>

<varlistentry>
<term>Pogosto postavljena vprašanja o KDE (FAQ)</term>
<listitem><para>Pogosto zastavljana vprašanja o KDE in
odgovori nanje.</para></listitem>
</varlistentry>

<varlistentry>
<term>KDE v spletu</term>
<listitem><para>Povezave na KDE v spletu, tako uradne spletne strani KDE kot
tudi druge uporabne strani.</para></listitem>
</varlistentry>

<varlistentry>
<term>Kontaktne informacije</term>
<listitem><para>Informacije o tem, kako kontaktirati razvijalce KDE in kako se pridružiti
poštnim listam.</para></listitem>
</varlistentry>

<varlistentry>
<term>Podpora KDE</term>
<listitem><para>Kako lahko pomagate in kako se lahko priključite.</para></listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="search">
<title>Vez <guilabel>Poišči</guilabel></title>

<para>Če želite iskati po pomoči, morate imeti nameščen program <application>ht://Dig</application>
Podatke o tem, kako namestiti in nastaviti indeks iskanja
so dosegljivi v dokumentaciji. Nastavitev indeksa iskanja je
izvedena v <application>nadzornem središču KDE</application> z izbiro
<menuchoice><guisubmenu>Pomoč</guisubmenu><guimenuitem>Indeks</guimenuitem></menuchoice>,
podrobnejša pomoč pa je dosegljiva v okviru tega modula.</para>

<para>V tem dokumentu bomo predpostavili, da ste vse to že
opravili.</para>

<para>Iskanje po datoteka pomoči je zelo preprosto, vnesite besedo(e) ki
jo (jih) želite poiskati v besedilno polje, izberite možnost (če sploh) in
pritisnite <guibutton>Poišči</guibutton>.  Rezultati se prikažejo v desnem
polju.</para>

<para>Izbire, ki so na razpolago:</para>

<variablelist>
<varlistentry>
<term><guilabel>Metoda</guilabel></term>
<listitem><para>Izberite način, kako iskati s pomočjo več besed naenkrat. Če izberete
<guilabel>in</guilabel>, bo iskanje dalo rezultate le, če so na neki strani vse
besede. <guilabel>ali</guilabel> vrne rezultate če je najden
<emphasis>vsaj ena</emphasis> izmed besed, 
<guilabel>boolean</guilabel> pa vam omogoča iskanje s pomočjo kombinacij.</para>
<para>Booleanova sintaksa vam omogoča uporabo operatorjev <literal>AND</literal>,
<literal>OR</literal> in <literal>NOT</literal> pri zapletenih iskanjih.
Nekaj primerov:</para>
<variablelist>
<varlistentry>
<term><userinput>mačka and pes</userinput></term>
<listitem><para>Išče strani, ki vsebujejo obe besedi,
<userinput>mačka</userinput> in <userinput>pes</userinput>. Strani z le eno besedo
ne bodo prikazane.</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>mačka not pes</userinput></term>
<listitem><para>Išče strani z besedo <userinput>mačka</userinput>, vrne pa le
tiste, ki hkrati ne vsebujejo besede <userinput>pes</userinput>.
</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>mačka or (per not nos)</userinput></term>
<listitem><para>Išče strani, ki vsebujejo <userinput>mačka</userinput> in tiste,
ki vsebujejo <userinput>pes</userinput>, nimajo pa besede
<userinput>nos</userinput>.  Strani, ki vsebujejo 
<userinput>mačka</userinput> in <userinput>nos</userinput> bodo izpisane, tiste,
ki vsebujejo vse tri besede pa ne.</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>Maks. število rezultatov</guilabel></term>
<listitem><para>Določi največje število rezultatov, ki vam jih vrne
iskanje.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Oblikuj</guilabel></term>
<listitem><para>Odločite se, ali želite le kratko povezavo na stran, ki vsebuje
iskane besede ali pa želite dalji povzetek.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Uredi</guilabel></term>
<listitem><para>Uredi rezultate glede na <guilabel>Rezultat</guilabel> (kako
natančno so se ujemali z iskanimi pojmi), abecedno glede na
<guilabel>Naslov</guilabel> ali pa <guilabel>Datum</guilabel>.  Označitev potrditvenega
polja <guilabel>V obratnem vrstnem redu</guilabel> v skladu z imenom obrne vrstni
red rezultatov.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Osveži indeks</guilabel></term>
<listitem><para>Osveži indeks iskanja da vključi nove dokumente ali pa če je po vašem
mnenju baza podatkov nepopolna oziroma poškodovali. To utegne
trajati kar nekaj časa.</para></listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>

<sect2 id="man-and-info">
<title>Razdelka <application>Man</application> in <application>Info</application>
</title>

<para>Strani man ("manual"- priročnik) so standardni priročniki v svetu unix-a in so bile v uporabi 
dolga leta na mnogih operacijskih sistemih. So zelo zgoščene in najboljši
način za pridobivanje podatkov o večini lunix-ovih ukazih in programih.
Kadar ljudje rečejo <quote>RTFM</quote>, je priročnik, na katerega se sklicujejo
zelo pogosto stran man.</para>

<para>Žal pa niso popolne. Prepogosto so pregloboke in pretirano 
tehnične, pogosto spisane s strani razvijalcev za razvijalce. V nekaterih primerih so
zaradi tega neprijazne če ne celo nerazumljive večini uporabnikov.
Vendar pa so najbolj preverjen vir podatkov za večino
programov  v ukazni vrstici in zelo pogosto tudi edini vir.</para>

<para>Če ste se kdaj čudili, kaj pomeni številka, ki jo ljudje pišejo
v primerih kot je man(1) - to je razdelek priročnika, v katerem se element (stran) nahaja.
Kot boste videli uporablja &khelpcenter; te številke za to, da razdeli mnoge strani v svoje
razdelkem kar vam precej olajša iskanje informacij če le brskate
po priročniku.</para>

<para>Prav tako so na voljo strani Info, mišljene kot zamenjava za 
strani man. Vzdržeavlci nekaterih programov ne vzdržujejo več strani man,
tako da je v primeru da sta dosgeljiva tako info kot stran man, info verjetno
novejša. Večina programov pa ima tako eno kot drugo. Če je program,
za katerega iščete pomoč del projekta <abbrev>GNU</abbrev>,
potem bo najverjetne imel stran info in ne man.</para>

<sect3 id="navigation">
<title>Navigacija znotraj strani <application>Info</application></title>

<para>Info dokumenti so organizirani hierarhično s vsako stranjo poimenovano
vozlišče. Vsi dokumenti imajo vrhnje vozlišče (<guilabel>Top</guilabel> node),
<abbrev>to je</abbrev> otvoritveno stran.  Na vrh dokumenta 
(<guilabel>Top</guilabel>) se lahko vrnete s pritiskom na
<guilabel>Top</guilabel>.</para>

<para>Gumba <guibutton>Prev</guibutton> & <guibutton>Next</guibutton> 
se uporabljata za gibanje na prejšnjo/naslednjo stran na trenutni stopnji hirarhije.</para>

<para>Klik na izbiro v menuju znotraj dokumenta vas pomakne stopnjo nižje v 
hirarhiji. Navzgor se premikate s pritiskom na gumb
<guibutton>Up</guibutton>.</para>

<para>Man se obravnava podobno kot info, z razdelkom index kot vrhnjim vozliščem 
in vsako man stranjo na ravni nižje. Vnosi man so dolhi eno stran.</para>

</sect3>
</sect2>
</sect1>

<sect1 id="credits">
<title>Zasluge in licence</title>

<para>&khelpcenter;</para>

<para>Prvotno ga je razvil Matthias Elter <email>me@kde.org</email></para>
<para>Trenutni vzdrževalec: Matthias Hoelzer-Kluepfel
<email>mhk@kde.org</email></para>

&underFDL;
&underGPL;

</sect1>
</chapter>
