<chapter id="help-system-user-manual">
<chapterinfo><date>03-02-2002</date> <releaseinfo>0.08.00</releaseinfo> </chapterinfo>
<title>Manual d'usuari per al sistema d'ajuda del &kde;</title>
<anchor id="help"/>

<sect1 id="help-introduction">
<title>Sistema d'ajuda del &kde;</title>
	
<para>El sistema d'ajuda del &kde; està dissenyat per accedir de manera senzilla als sistemes d'ajuda comuns de &UNIX; (en format <application>man</application>  i <application>info</application>), així com a la documentació nativa del &kde; (en format &XML;). </para>
	
<para>Totes les aplicacions base del &kde; estan completament documentades, gràcies als esforços de l'equip de documentació. Si desitgeu ajudar-hi, si us plau, escriviu al coordinador de la documentació, en Lauri Watts, a <email>lauri@kde.org</email> per a que us n'informi. No es requereix experiència, simplement entusiasme i paciència. </para>

<para>Si desitgeu ajudar en la traducció de la documentació del &kde; a la vostra llengua nativa, el coordinador de traducció és en Thomas Diehl, <email>thd@kde.org</email>, ell també agrairà el vostre ajut. Es pot trobar més informació, inclogent-hi els noms dels coordinadors per a cada equip de traducció (un per a cadascuna de les diferents llengües) a la <ulink url="http://i18n.kde.org">web d'internacionalització</ulink> i a la secció <link linkend="contact">Contactes</link> d'aquest document. </para>

<sect2 id="installation">
<title>Instal·lació</title>

<para>El &khelpcenter; és una part integral de la instal·lació bàsica del &kde; i s'instal·la amb cada còpia del mateix. Es pot trobar al paquet tdebase i està disponible des de &kde-ftp; o en el paquet tdebase del vostre sistema operatiu. </para>

</sect2>
</sect1>

<sect1 id="invoking-help">
<title>Com invocar a l'ajuda</title>

<para>El &khelpcenter; es pot cridar de diverses maneres: </para>

<variablelist> 
<varlistentry> 
<term>Des del menú <guimenu>Ajuda</guimenu></term> 
<listitem>
<para>El mètode més comú probablement serà des de la mateixa aplicació. Escolliu <menuchoice><guimenu>Ajuda</guimenu> <guimenuitem>Contingut</guimenuitem></menuchoice> per a obrir el fitxer d'ajuda de l'aplicació, a la pàgina de continguts. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>Des del menú <guimenu>K</guimenu></term>
<listitem>
<para>Escolliu la gran <guiicon>K</guiicon> del vostre plafó i seleccioneu <guimenuitem>Ajuda</guimenuitem> per a obrir el &khelpcenter;, començant a la pàgina de benvinguda per omissió. </para>
</listitem> 
</varlistentry>

<varlistentry>
<term>Des del plafó</term>
<listitem>
<para>Per omissió, el plafó &kicker; conté un icona per a cridar al &khelpcenter;. Altra vegada, es mostrarà la pàgina de benvinguda per omissió. </para>
</listitem> 
</varlistentry>

<varlistentry>
<term>Des de la línia de comandaments</term>
<listitem>
<para>El &khelpcenter; pot ser iniciat emprant una &URL; per a mostrar un fitxer. Les &URL; també han estat afegides per a les pàgines de <command>info</command> i <command>man</command>. Les podeu emprar de la següent manera: </para> 

<variablelist>
<varlistentry>
<term>Un fitxer d'ajuda d'una aplicació</term>
<listitem>
<para><command>khelpcenter</command> <option>help:/<replaceable>kedit</replaceable></option> </para>
<para>Obre el fitxer d'ajuda del &kedit;, a la pàgina de continguts. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>Una &URL; local</term>
<listitem><para><command>khelpcenter</command> <option>file:/ <replaceable>usr/local/src/qt/html/index.html</replaceable></option> </para>
</listitem>
</varlistentry>

<varlistentry>
<term>Una pàgina man</term>
<listitem>
<para><command>khelpcenter</command> <option>man:/<replaceable>strcpy</replaceable></option> </para>
</listitem>
</varlistentry>

<varlistentry>
<term>Una pàgina info</term>
<listitem>
<para><command>khelpcenter</command> <option>info:/<replaceable>gcc</replaceable></option> </para>
</listitem>
</varlistentry>
</variablelist>

<para>Invocant a <command>khelpcenter</command> sense paràmetres s'obre la pàgina de benvinguda per omissió. </para>
</listitem>
</varlistentry>

</variablelist>
</sect1>

<sect1 id="interface-basics">
<title>La interfície del &khelpcenter;</title>

<para>La interfície del &khelpcenter; conté dos plafons d'informació. </para>

<para>La barra d'eines i els menús s'expliquen més endavant a <xref linkend="menu-and-toolbar-ref"/>. </para>

<para>Els documents contenen les seves pròpies eines de navegació, permetent-vos una mobilitat bé seqüencialment a través d'un document, usant els enllaços <guilabel>Següent</guilabel>, <guilabel>Anterior</guilabel>, <guilabel>Amunt</guilabel> i <guilabel>Inici</guilabel> o bé moure's d'un mode menys ordenat, emprant els hiperenllaços. </para>

<para>Els enllaços us poden dur a d'altres parts del mateix document o a un document diferent, i també podeu emprar les icones <guiicon>Endarrere</guiicon> (fletxa a l'esquerra) o <guiicon>Endavant</guiicon> (fletxa a la dreta) a la barra d'eines per a moure'us a través dels documents que hageu estat visualitzant en aquesta sessió. </para> 

<para>Els dos plafons mostren el contingut del sistema d'ajuda i la dels propis fitxers d'ajuda, el primer a l'esquerra i el segon a la dreta respectivament. </para>

<sect2 id="contents-pane">
<title>El plafó de <guilabel>Continguts</guilabel></title>

<para>El plafó de <guilabel>Continguts</guilabel> en el &khelpcenter; es mostra a l'esquerra de la finestra. Com ja haureu suposat, podeu desplaçar la barra divisoria per a poder visualitzar amb comoditat els continguts de cada plafó. </para> 

<para>El plafó de <guilabel>Continguts</guilabel> està subdividit en dues pestanyes, una que conté un <link linkend="contents-menu">menú</link> mostrant un índex amb tota la informació disponible de l'ajuda al &khelpcenter; i l'altre que conté el <link linkend="kde-glossary">Glossari</link> de termes del &kde;. </para>

<sect3 id="contents-menu">
<title>El menú de <guilabel>Continguts</guilabel></title>

<para>Els <guilabel>Continguts</guilabel> inclouen les següents entrades per omissió: </para> 

<variablelist>
<varlistentry>
<term><guilabel>Introducció</guilabel></term>
<listitem><para>Benvingut al &kde; - una introducció a l'entorn d'escriptori KDE.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Introducció al &kde;</guilabel></term>
<listitem>
<para>La guia ràpida d'inici al &kde;. Conté una visita guiada per la interfície del &kde;, ajuda específica i consells sobre com treballar millor amb el &kde;. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Manual de l'usuari del &kde;</guilabel></term>
<listitem>
<para>El manual de l'usuari del &kde; és una exploració en profunditat del &kde;, incloguen la instal·lació, configuració, personalització i ús. </para>
</listitem> 
</varlistentry>

<varlistentry>
<term><guilabel>Manuals de les aplicacions</guilabel></term>
<listitem>
<para>La documentació de les aplicacions natives del &kde;. Totes les aplicacions del &kde; tenen la documentació en format &XML;, el qual és convertit a <acronym>HTML</acronym>. Aquesta secció llista totes les aplicacions del &kde; amb una curta descripció i un enllaç a a la documentació completa de l'aplicació. </para>
<para>Les aplicacions es mostren en una estructura en forma d'arbre que recorda l'estructura del menú <guimenu>K</guimenu>, fent que sigui fàcil el trobar l'aplicació que s'està cercant. </para>
</listitem> 
</varlistentry>

<varlistentry>
<term><guilabel>Pàgines de manual &UNIX;</guilabel></term>
<listitem>
<para>Les pàgines man de &UNIX; estan en el format tradicional de la documentació en línia per a sistemes &UNIX;. La majoria de programes del sistema disposen d'una pàgina man. A més existeixen pàgines man per a funcions de programació i formats dels fitxers. </para>
</listitem> 
</varlistentry>

<varlistentry>
<term><guilabel>Navegador de pàgines info</guilabel></term>
<listitem>
<para>La documentació TeXinfo és emprada per la majoria d'aplicacions de &GNU;, incloguen <application>gcc</application> (el compilador C/C++), <application>emacs</application> i moltes altres. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Tutorials</guilabel></term>
<listitem>
<para>Curts, basats en tasques o tutorials informatius. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>La PMF del &kde;</guilabel></term>
<listitem>
<para>Les preguntes més freqüents quant al &kde; i les seves respostes. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>&kde; a la web</guilabel></term>
<listitem>
<para>Enllaços del &kde; a la web, el lloc oficial del &kde; i d'altres llocs d'utilitat. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Informació de contacte</guilabel></term>
<listitem>
<para>Informació de com contactar amb els desenvolupadors del &kde; i de com subscriure's a les llistes de correu del &kde;. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Com col·laborar amb el &kde;</guilabel></term>
<listitem>
<para>Com ajudar i com involucrar-se. </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>Les seccions de les pàgines <application>man</application> i <application>info</application></title>

<para>Les pàgines man són les pàgines del manual estàndard de &UNIX; i s'han emprat durant molts anys en molts sistemes operatius. Són extremadament detallades i conformen la millor font d'informació per a la majoria dels comandaments i aplicacions de &UNIX;. Quan algú diu <quote>RTFM</quote>, el manual al que sovint es refereix és a la pàgina man.</para>

<para>Les pàgines man no són perfectes. Solen ser detallades, però extremadament tècniques i freqüentment escrites per desenvolupadors i per a desenvolupadors. En alguns casos això les converteix en difícils, fins i tot arribant a ser incomprensibles per a molts usuaris. Tot i això, segueixen sent la millor i molt freqüentment la única font d'informació sòlida per a la majoria d'aplicaciones de la línia de comandaments.</para>

<para>Si alguna vegada us heu preguntat quin significat té el que la gent en ocasions escriga coses com man(1), es refereixen a la secció del manual a la que pertany el terme que es cerca. Advertiu que &khelpcenter; empra nombres per a dividir les nombroses pàgines man en seccions, de manera que la recerca d'informació sigui més senzilla, si simplement esteu navegant.</para>

<para>També estan accessibles les pàgines Info, les quals es pretenia que substituissin a les man. Alguns programadors d'aplicacions ja no actualitzen les pàgines man, de manera que si per a dites aplicacions existeix una pàgina man i una altra info, aquesta última probablement serà la més recent. Tot i això la majoria d'aplicacions disposen d'una de les dos. Si esteu cercant ajuda per a una aplicació de &GNU;, el més probable sigui que la trobeu en una pàgina info i no en una pàgina man.</para>

<sect3 id="navigation">
<title>Com navegar per les pàgines <application>Info</application></title>

<para>Els documents info estan organitzats jeràrquicament de manera que cada pàgina anomena un node. Tots els documents info tenen un node <guilabel>Inici</guilabel>, &pex; la pàgina inicial. Sempre podeu tornar a l'<guilabel>Inici</guilabel> d'un document prement a <guilabel>Inici</guilabel>.</para>

<para><guibutton>Anterior</guibutton> i <guibutton>Següent</guibutton> s'usen per a moure's a les pàgines anterior i següents del nivell en el que us trobeu.</para>

<para>El fer clic a l'ítem del menú d'un document serveix per a moure's a un nivell inferior al que us trobeu. Podeu pujar un nivell prement a <guibutton>Amunt</guibutton>.</para>

<para>Les pàgines man es tracten de manera similar a les info, siguen el node superior l'índex de la secció i estant cada pàgina man un nivell per sota. Les entrades man ocupen tota una pàgina.</para>

</sect3>
</sect2>

<sect2 id="kde-glossary">
<title>El glossari del &kde;</title>

<para>El glossari proporciona un lloc de referència ràpida, a on podeu mirar les definicions de paraules que us pugan resultar poc familiars. Aquestes inclouen aplicacions i tecnologies específiques del &kde; o fins i tot termes informàtics de &UNIX;. </para>

<para>Al plafó de l'esquerra veureu una vista en arbre, amb dues possibilitats: <guilabel>Alfabètic</guilabel> o <guilabel>Per tema</guilabel>. Ambdues contenen les mateixes entrades, ordenades de manera diferent, per a permetre que trobeu ràpidament l'ítem d'interés. </para>

<para>Navegueu per les vistes en arbre de l'esquerra i els ítems que seleccioneu es mostraran a la dreta. </para>

</sect2>

<sect2 id="menu-and-toolbar-ref">
<title>Els menús i la barra d'eines</title>

<para>El &khelpcenter; té una interfície mínima, permetent que us concentreu en obtenir ajuda i no a tenir que aprendre com usar el navegador de l'ajuda. </para>

<para>Les icones disponibles a la barra d'eines són les següents: </para>

<variablelist>
<title>Icones de la barra d'eines</title>

<varlistentry>

<term><guiicon>Endarrere</guiicon></term>
<listitem>
<para>Anirà a la pàgina anterior que esteu visualitzant.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guiicon>Endavant</guiicon></term>
<listitem>
<para>Avançarà una pàgina. Aquesta icona tan sols s'activa si ja heu emprat la icona <guiicon>Endarrere</guiicon>.</para></listitem>
</varlistentry>

<varlistentry>
<term><guiicon>Imprimeix</guiicon></term>
<listitem>
<para>Imprimeix els continguts de la pàgina actualment visualitzada. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guiicon>Cerca</guiicon></term>
<listitem>
<para>Cerca una paraula o paraules dintre de la pàgina actualment visualitzada. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guiicon>Augmenta la font</guiicon></term>
<listitem>
<para>Augmenta la mida del text al plafó de visualització. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guiicon>Disminueix la font</guiicon></term>
<listitem>
<para>Disminueix la mida del text al plafó de visualització. Aquesta icona tan sols s'activa si previament heu emprat l'augment del text. </para>
</listitem>
</varlistentry>

</variablelist>

<para>Els menús contenen les següents entrades: </para>

<variablelist>
<varlistentry>
<term><guimenu>Arxiva</guimenu></term>
<listitem>

<variablelist>
<varlistentry>
<term>
<menuchoice><guimenu>Arxiva</guimenu> <guimenuitem>Imprimeix...</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Imprimeix els continguts de la pàgina actualment visualitzada. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu>Arxiva</guimenu> <guimenuitem>Surt</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Tanca i surt del &khelpcenter; </para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenu>Edita</guimenu></term>
<listitem>

<variablelist>
<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut> <guimenu>Edita</guimenu> <guimenuitem>Selecciona-ho tot</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Selecciona tot el text de la pàgina actual. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut> <guimenu>Edita</guimenu> <guimenuitem>Cerca...</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Cerca una paraula o paraules a la pàgina actualment visualitzada. </para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenu>Visualitza</guimenu></term>
<listitem>
<variablelist>
<varlistentry>
<term><menuchoice><guimenu>Visualitza</guimenu> <guimenuitem>Vista font del document</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Us permet veure la font <acronym>HTML</acronym> de la pàgina actualment visualitzada. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Visualitza</guimenu> <guisubmenu>Estableix la codificació</guisubmenu> </menuchoice>
</term>
<listitem>
<para>Canvia la codificació de la pàgina actual. Normalment, l'opció per omissió <guimenuitem>Auto</guimenuitem> tindria que ser suficient, però si teniu problemes visualitzant pàgines escrites en d'altres llengües que l'anglès, potser necessitareu escollir una codificació específica en aquest menú. </para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Vés</guimenu> <guimenuitem>Endarrere</guimenuitem></menuchoice></term>
<listitem>
<para>Per anar a la pàgina anterior a la que esteu visualitzant.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Vés</guimenu> <guimenuitem>Endavant</guimenuitem> </menuchoice></term>
<listitem>
<para>Si ja us heu mogut prèviament endavant amb la icona o l'entrada del menú, podeu tornar novament cap endavant amb aquesta entrada del menú.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Vés</guimenu> <guimenuitem>...</guimenuitem> </menuchoice></term>
<listitem>
<para>A la part inferior del menú <guimenu>Vés</guimenu>, trobareu una llista històrica de les últimes pàgines que heu visualitzat. Seleccionant-ne una podreu tornar-hi.</para>
</listitem></varlistentry></variablelist>

</sect2>

</sect1>

<sect1 id="credits">
<title>Crèdits i llicències</title>

<para>&khelpcenter;</para>

<para>Originalment desenvolupat per en &Matthias.Elter; &Matthias.Elter.mail;</para>
<para>L'actual mantenidor és en &Cornelius.Schumacher; &Cornelius.Schumacher.mail;</para>
&underFDL; &underGPL; </sect1>
</chapter>

