<?xml version="1.0" encoding="utf-8"?>
<!-- -*- indent-tabs-mode: nil -*- -->
<chapter id="tools">
  <title>Tresnak eta utilitateak</title>

  <highlights>
    <para>GNOME mahaigaineko zenbait tresna eta utilitate azaltzen dira atal honetan.</para>
  </highlights>

  <section id="tools-run-app">
    <title>Aplikazioak exekutatzea</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="gospanel-23"/>
    <indexterm>
      <primary>Exekutatu aplikazioa elkarrizketa-koadroa, erabiliz</primary>
    </indexterm>
    <para><guilabel>Exekutatu aplikazioa</guilabel> elkarrizketa-koadroak komando-lerroa irekitzen du. Komando bat exekutatzen baduzu <guilabel>Exekutatu aplikazioa</guilabel> elkarrizketa-koadroan, ezingo duzu komandoaren irteerarik jaso.</para>
    <para>Komando-lerrotik komando bat exekutatzeko, jarraitu urrats hauei:</para>
    <orderedlist>
      <listitem>
        <para>Ireki <guilabel>Exekutatu aplikazioa</guilabel> elkarrizketa-koadroa modu hauetako batean: <variablelist>
          <varlistentry><term>Panel batetik</term>
          <listitem><para><application>Exekutatu aplikazioa</application> botoia gehi diezaiokezu edozein paneli. Ikusi <xref linkend="panels-addobject"/>. <guilabel>Exekutatu aplikazioa</guilabel> elkarrizketa-koadroa irekitzeko, egin klik <guibutton>Exekutatu aplikazioa</guibutton> panel-botoian.</para></listitem></varlistentry>
          <varlistentry><term>Laster-teklak erabiltzea</term>
          <listitem>
            <para>Sakatu <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. <guilabel>Exekutatu aplikazioa</guilabel> elkarrizketa-koadroa bistaratzen duten laster-teklak alda ditzakezu <link linkend="prefs-keyboard-shortcuts"><application>Laster-teklak</application> hobespen-tresnan</link>.</para>
          </listitem>
          </varlistentry>
        </variablelist></para>
      <para><guilabel>Exekutatu aplikazioa</guilabel> elkarrizketa-koadroa bistaratuko da.</para>
    </listitem>
    <listitem>
      <para>Sartu exekutatu nahi duzun komandoa hutsik dagoen eremuan, edo aukeratu aplikazio ezagunen zerrendatik.</para>
      <para>Fitxategi baten kokalekua bakarrik sartzen baduzu, aplikazio bat abiaraziko da fitxategia irekitzeko. Web-orri baten helbidea sartzen baduzu, web-arakatzaile lehenetsia irekiko da orria irekitzeko. Ipini http:// web-orriaren helbidearen aurretik. Adibidez: http://www.gnome.org.</para>
      <para>Bestela, aukeratu aurrez sartu duzun komando bat, egin klik gezia behera begira duen botoian (komando-eremuaren ondoan), eta aukeratu exekutatu beharreko programa.</para>
      <para><guibutton>Exekutatu fitxategiarekin</guibutton> botoia ere erabil dezakezu komando-lerroari fitxategi bat eransteko. Adibidez, <application>emacs</application> sar dezakezu komando gisa, eta editatzeko fitxategi bat aukera dezakezu.</para>
      <para>Hautatu <guilabel>Exekutatu terminalean</guilabel> aukera, aplikazioa edo komandoa terminalaren leihoan exekutatzeko. Hautatu aukera hau exekutatzeko leihoa sortzen ez duten aplikazio edo komandoen kasuan.</para>
    </listitem>
    <listitem>
      <para>Egin klik <guibutton>Exekutatu aplikazioa</guibutton> elkarrizketa-koadroko <guibutton>Exekutatu</guibutton> botoian.</para>
    </listitem>
      </orderedlist>
    </section>

<section id="tools-screenshot">
  <title>Pantaila-argazkiak egitea</title>
  <!-- preserve id for backwards compatibility: 2.12 -->
  <anchor id="goseditmainmenu-53"/>   
  <indexterm>
    <primary>pantaila-argazkiak egitea</primary>
  </indexterm>
  <para>Pantaila-argazkiak honela egin ditzakezu:</para>
  <itemizedlist>
    <listitem>
      <para>Panel batetik</para>
      <para><guibutton>Egin pantaila-argazkia</guibutton> botoia gehi diezaiokezu edozein paneli. Jarraibide gehiago nahi izanez gero, ikusi <xref linkend="panels-addobject"/>. Pantaila osoaren argazkia egiteko, egin klik <guibutton>Egin pantaila-argazkia</guibutton> botoian.</para>
    </listitem>
    <listitem>
      <para>Erabili laster-teklak</para>
      <para>Pantaila-argazkia egiteko, erabili laster-tekla hauek:</para>
      <informaltable frame="topbot">
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="35.67*"/>
          <colspec colname="colspec1" colwidth="64.33*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Laster-tekla lehenetsiak</para>
              </entry>
              <entry>
                <para>Funtzioa</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <keycap>Inpr pant</keycap>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Pantaila osoaren argazkia egiten du.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para><keycombo><keycap>Alt</keycap><keycap>Inpr pant</keycap></keycombo></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Takes a screenshot of the window which is active.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para><link linkend="prefs-keyboard-shortcuts"><application>Laster-teklak</application> hobespen-tresna</link> erabil dezakezu laster-tekla lehenetsiak aldatzeko.</para>
    </listitem>
    <listitem>
      <para>Menu-barratik</para>
      <para>Hautatu <menuchoice><guimenu>Aplikazioak</guimenu><guimenuitem>Gehigarriak</guimenuitem><guimenuitem>Egin pantaila-argazkia</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para>Terminaletik</para>
      <para><command>gnome-screenshot</command> komandoa erabil dezakezu pantaila-argazkia egiteko. <command>gnome-screenshot</command> komandoak pantaila osoaren argazkia egiten du, eta <guilabel>Gorde pantaila-argazkia</guilabel> elkarrizketa-koadroa erakusten du. Pantaila-argazkia gordetzeko, erabili <guilabel>Gorde pantaila-argazkia</guilabel> elkarrizketa-koadroa.</para>
      <para><command>gnome-screenshot</command> komandoko aukerak ere erabil ditzakezu:</para>
      <informaltable frame="topbot">
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="35.67*"/>
          <colspec colname="colspec1" colwidth="64.33*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Aukera</para>
              </entry>
              <entry>
                <para>Funtzioa</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--window</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Fokua duen leihoaren pantaila-argazkia egiten du.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--delay=<replaceable>segundo</replaceable></command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Zehaztutako segundo kopurua igarotakoan pantaila-argazkia egiten du, eta <guilabel>Gorde pantaila-argazkia</guilabel> elkarrizketa-koadroa bistaratzen du. Erabili <guilabel>Gorde pantaila-argazkia</guilabel> elkarrizketa-koadroa pantaila-argazkia gordetzeko.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--include-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Takes a screenshot including the border of the window.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--remove-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Takes a screenshot without the border of the window.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--border-effect=shadow</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Takes a screenshot and adds a shadow bevel effect around it.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--border-effect=border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Takes a screenshot and adds a border effect around it.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--interactive</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Opens a window that lets you set options before taking the screenshot.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <command>--help</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Komandoaren aukerak bistaratzen ditu.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </listitem>
  </itemizedlist>

  <para>
  When you take a screenshot, the <guilabel>Save Screenshot</guilabel> dialog 
  opens. To save the screenshot as an image file, enter the filename for the 
  screenshot, choose a location from the drop-down list and click the <guilabel>Save</guilabel> button. You can also use the <guilabel>Copy to Clipboard</guilabel> button to copy the image to the clipboard or transfer it to another application by drag-and-drop.
  </para>
  
</section>

<!-- ============= Yelp ============================= -->
<section id="yelp">
  <title>Yelp laguntza-arakatzailea</title>
  <indexterm>
    <primary>Yelp</primary>
  </indexterm>
  <!-- ============= Introduction ============================== -->

  <section id="yelp-introduction">
    <title>Sarrera</title>

    <para><application>Yelp laguntza-arakatzailea</application> aplikazioak aukera ematen dizu GNOMErekin eta beste osagai batzuekin lotutako informazioa ikusteko, hainbat formatu bidez. Formatu horiek dira, besteak beste, docbook fitxategiak, HTML laguntza-orriak, eskuliburuko orriak eta informazio-orriak (eskuliburuko eta informazio-orrien laguntza konpilatuta egon liteke). Hainbat formatu onartu arren, Yelp ahalik eta gehiena saiatzen da itxura bateratua eskaintzen, dokumentuaren jatorrizko formatua gorabehera.</para>

    <para><application>Yelp laguntza-arakatzailea</application> nazioartekoa da, hau da, hainbat hizkuntzatako dokumentuak ikusteko gai da. Dokumentuak lokalizatuta edo itzulita egon behar dute hizkuntza bakoitzean, eta ondo instalatuta, Yelp laguntza-arakatzaileak ikusi ahal izateko.</para>
  </section>

  <!-- ============= Getting Started  ================================ -->

  <section id="yelp-getting-started">
    <title>Yelp abiaraztea</title>

    <section>
      <title><application>Yelp laguntza-arakatzailea</application> abiarazteko</title>

      <para>Aukera hauek dituzu <application>Yelp laguntza-arakatzailea</application> abiarazteko:</para>

      <para><variablelist>
          <varlistentry>
            <term><guimenu>Sistema</guimenu> menua</term>

            <listitem>
              <para>Hautatu <application>Laguntza</application></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>Komando-lerroa</term>

            <listitem>
              <para>Exekutatu komando hau: <command>yelp</command></para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section>
      <title>Interfazea</title>

      <para><application>Yelp laguntza-arakatzailea</application> abiaraztean, ondoko leihoa azalduko da.</para>

      <para><figure id="fig-yelp-window">
          <title><application>Yelp laguntza-arakatzailearen</application> leihoa</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_window.png"/>
            </imageobject>
          </mediaobject>
        </figure><application>Yelp laguntza-arakatzaileak</application> ondoko elementuak ditu hemen: <xref linkend="fig-yelp-window"/></para>

      <variablelist>
        <varlistentry>
          <term><interface>Menu-barra</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><guimenu>Fitxategia</guimenu></term>

                  <listitem>
                    <para>Erabili menu hau Leiho berria irekitzeko, 'Dokumentu honi buruz' orria ikusteko, Uneko dokumentua inprimatzeko, edo Leihoa ixteko.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Editatu</guimenu></term>

                  <listitem>
                    <para>Erabili menu hau Kopiatzeko, Denak hautatzeko, Bilatzeko... edo zure Hobespenak ezartzeko.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Joan</guimenu></term>

                  <listitem>
                    <para>Erabili menu hau Atzera edo Aurrera joateko, Laguntza-gaien orrira joateko... DocBook dokumentu bat ikusten ari zarenean, erabili menu hau Hurrengo edo Aurreko atalera joateko, Edukira joateko...</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Laster-markak</guimenu></term>

                  <listitem>
                    <para>Erabili menu hau Laster-markak gehitzeko edo Laster-markak editatzeko.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guimenu>Laguntza</guimenu></term>

                  <listitem>
                    <para>Ikusi Yelp laguntza-arakatzaileari eta proiektuaren laguntzaileei buruzko informazioa <guimenuitem>Honi buruz</guimenuitem> menu-elementuaren bidez. Ireki dokumentu hau <guimenuitem>Edukia</guimenuitem> menu-elementuarekin, edo <keycap>F1</keycap> sakatuz.</para>
                  </listitem>
                </varlistentry>
              </variablelist></para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term><interface>Tresna-barra</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><guibutton>Atzera</guibutton></term>

                  <listitem>
                    <para>Erabili botoi hau zure dokumentu-historian atzera joateko.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guibutton>Aurrera</guibutton></term>

                  <listitem>
                    <para>Erabili botoi hau zure dokumentu-historian aurrera joateko.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term><guibutton>Laguntza-gaiak</guibutton></term>

                  <listitem>
                    <para>Erabili botoi hau eduki-taula nagusira itzultzeko (<xref linkend="fig-yelp-window"/>).</para>
                  </listitem>
                </varlistentry>
              </variablelist></para>
          </listitem>
        </varlistentry>

        <varlistentry id="yelp-browser-pane" xreflabel="Yelp Browser Pane">
          <term><interface>Arakatzailearen panela</interface></term>

          <listitem>
            <para>Arakatzailearen panelean eduki-taula edo dokumentazioa aurkeztuko zaizu. Erabili eduki-taula behar duzun dokumentaziora nabigatzeko.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </section>
  </section>

  <!--===================== Usage ========================-->

  <section id="yelp-usage">
    <title>Yelp erabiltzea</title>

    <section>
      <title>Ireki dokumentua</title>

      <para>To open a document in <application>Yelp Help Browser</application>:
	  
	  <itemizedlist>
		<listitem>
			<para>In an application, click <menuchoice>
                <guimenu>Help</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice>
			  </para>
		</listitem>	  
		<listitem>
			<para>Use the Table of Contents to navigate to the desired document.</para>
		</listitem>
		<listitem>
			<para>You can drag a Docbook XML file from Nautilus to the Yelp window or launcher.</para>
		</listitem>
		<listitem>
			<para>Press the <keycap>F1</keycap> key.</para>
		</listitem>		
	  
	  </itemizedlist></para>
	  
      <para>Bestela, dokumentu jakin bat ikusteko komando-lerrotik nahiz Yelp-era fitxategiak arrastatuz dei dezakezu Yelp laguntza-arakatzailea. Ikusi <xref linkend="yelp-open-specific"/> honi buruzko informazio gehiago lortzeko.</para>
    </section>

    <section>
      <title>Ireki Leiho berria</title>

      <para>Leiho berri bat irekitzeko:</para>
	  
      <para><itemizedlist>
          <listitem>
            <para>Hautatu <menuchoice><guimenu>Fitxategia</guimenu><guimenuitem>Leiho berria</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Erabili <keycombo><keycap>Ktrl</keycap><keycap>N</keycap></keycombo> tekla-konbinazioa.</para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Dokumentu honi buruz</title>

      <para>Une horretan irekita dagoen dokumentuari buruzko informazioa ikusteko:</para>

      <para><itemizedlist>
          <listitem>
            <para>Hautatu <menuchoice><guimenu>Fitxategia</guimenu><guimenuitem>Dokumentu honi buruz</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Aukera hau DocBook dokumentaziorako bakarrik dago erabilgarri. Legezko abisuak eta dokumentazio-laguntzaileak atal honetan azaltzen dira zerrendatuta normalean.</para>
        </note></para>
    </section>

    <section>
      <title>Inprimatu orri bat</title>

      <para><application>Yelp laguntza-arakatzailean</application> ikus daitekeen edozein orri inprimatzeko:</para>

      <para><itemizedlist>
          <listitem>
            <para>Hautatu <menuchoice><guimenu>Fitxategia</guimenu><guimenuitem>Inprimatu orri hau</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Inprimatu dokumentu bat</title>

      <para>Dokumentu oso bat inprimatzeko:</para>

      <para><itemizedlist>
          <listitem>
            <para>Hautatu <menuchoice><guimenu>Fitxategia</guimenu><guimenuitem>Inprimatu dokumentu hau</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Aukera hau DocBook dokumentaziorako bakarrik dago erabilgarri.</para>
        </note></para>
    </section>

    <section>
      <title>Itxi leihoa</title>

      <para><application>Yelp laguntza-arakatzaileko</application> leiho bat ixteko, egin ondokoa:</para>

      <para><itemizedlist>
          <listitem>
            <para>Hautatu <menuchoice><guimenu>Fitxategia</guimenu><guimenuitem>Itxi leihoa</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Erabili <keycombo><keycap>Ktrl</keycap><keycap>W</keycap></keycombo> tekla-konbinazioa.</para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Ezarri hobespenak</title>

      <para><application>Yelp laguntza-arakatzailearen</application> hobespenak ezartzeko:</para>

      <para><itemizedlist>
          <listitem>
            <para>Hautatu <menuchoice><guimenu>Editatu</guimenu><guimenuitem>Hobespenak</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist>Honelako leiho bat azalduko da <xref linkend="yelp-preferences"/>:</para>

      <para><figure id="yelp-preferences">
          <title><application>Yelp laguntza-arakatzailearen</application> Hobespenen leihoa</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_preferences.png"/>
            </imageobject>
          </mediaobject>
        </figure>Elkarrizketa honetako aukera erabilgarriek ondoko funtzioak dituzte:</para>

      <para><variablelist>
          <varlistentry>
            <term><guilabel>Erabili sistemako letra-tipoak</guilabel></term>

            <listitem>
              <para>Hautatu kontrol-lauki hau dokumentazioa GNOME mahaigainak erabilitako letra-tipoekin bistara dadin.</para>

              <para>Dokumentazioa bistaratzeko beste letra-tipo batzuk aukeratzeko, garbitu aukera hau eta egin klik <guilabel>Zabalera aldakorra</guilabel> edo <guilabel>Zabalera finkoa</guilabel> aukeren ondoko botoietan.</para>

              <para><variablelist>
                  <varlistentry>
                    <term><guilabel>Zabalera aldakorra</guilabel></term>

                    <listitem>
                      <para>Normalean zabalera estatiko edo finko bat behar ez denean erabiltzen da letra-tipo hau. Testu gehienak horrelako letra-tipoarekin egongo dira idatzita.</para>
                    </listitem>
                  </varlistentry>

                  <varlistentry>
                    <term><guilabel>Zabalera finkoa</guilabel></term>

                    <listitem>
                      <para>Karaktere guztiek tamaina berekoak izan behar dutenean erabiltzen da letra-tipo hau. Normalean komandoak, programa-blokeak edo halako kategorietako testuak adierazteko erabiltzen da.</para>
                    </listitem>
                  </varlistentry>
                </variablelist></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guilabel>Arakatu kurtsore bidez</guilabel></term>

            <listitem>
              <para>Egin klik aukera honetan kurtsorea ikusteko hemen: <xref linkend="yelp-browser-pane"/>. Horrek aukera emango dizu dokumentua errazago arakatzeko, dokumentuan kurtsorea non dagoen erakutsiz.</para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section>
      <title>Joan atzera Dokumentuaren historian.</title>

      <para>Dokumentuaren historian atzera joateko:</para>

      <para><itemizedlist>
          <listitem>
            <para>Hautatu <menuchoice><guimenu>Joan</guimenu><guimenuitem>Atzera</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Erabili <keycombo><keycap>Alt</keycap><keycap>Ezkerrera gezia</keycap></keycombo> tekla-konbinazioa.</para>
          </listitem>

          <listitem>
            <para>Egin klik <interface>Tresna-barrako</interface> <guibutton>Atzera</guibutton> botoian.</para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Joan aurrera Dokumentuaren historian</title>

      <para>Dokumentuaren historian aurrera joateko:</para>

      <para><itemizedlist>
          <listitem>
            <para>Hautatu <menuchoice><guimenu>Joan</guimenu><guimenuitem>Aurrera</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Erabili <keycombo><keycap>Alt</keycap><keycap>Eskuinera gezia</keycap></keycombo> tekla-konbinazioa.</para>
          </listitem>

          <listitem>
            <para>Egin klik <interface>Tresna-barrako</interface> <guibutton>Aurrera</guibutton> botoian.</para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Joan Laguntza-gaietara</title>

      <para>Laguntza-gaietara joateko:</para>

      <para><itemizedlist>
          <listitem>
            <para>Hautatu <menuchoice><guimenu>Joan</guimenu><guimenuitem>Laguntza-gaiak</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Erabili <keycombo><keycap>Alt</keycap><keycap>Hasi</keycap></keycombo> tekla-konbinazioa.</para>
          </listitem>

          <listitem>
            <para>Egin klik <interface>Tresna-barrako</interface> <guibutton>Laguntza-gaiak</guibutton> botoian.</para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Joan Aurreko atalera</title>

      <para>Aurreko atalera joateko:</para>

      <para><itemizedlist>
          <listitem>
            <para>Hautatu <menuchoice><guimenu>Joan</guimenu><guimenuitem>Aurreko atala</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Erabili <keycombo><keycap>Alt</keycap><keycap>Gora gezia</keycap></keycombo> tekla-konbinazioa.</para>
          </listitem>
        </itemizedlist><note>
          <para>Aukera hau DocBook formatudun dokumentuetarako bakarrik dago erabilgarri.</para>
        </note></para>
    </section>

    <section>
      <title>Joan Hurrengo atalera</title>

      <para>Hurrengo atalera joateko:</para>

      <para><itemizedlist>
          <listitem>
            <para>Hautatu <menuchoice><guimenu>Joan</guimenu><guimenuitem>Hurrengo atala</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Erabili <keycombo><keycap>Alt</keycap><keycap>Behera gezia</keycap></keycombo> tekla-konbinazioa.</para>
          </listitem>
        </itemizedlist><note>
          <para>Aukera hau DocBook formatudun dokumentuetarako bakarrik dago erabilgarri.</para>
        </note></para>
    </section>

    <section>
      <title>Joan Edukira</title>

      <para>Dokumentu bateko edukira joateko:</para>

      <para><itemizedlist>
          <listitem>
            <para>Hautatu <menuchoice><guimenu>Joan</guimenu><guimenuitem>Edukia</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Aukera hau DocBook formatudun dokumentuetarako bakarrik dago erabilgarri.</para>
        </note></para>
    </section>

    <section>
      <title>Gehitu laster-marka bat</title>

      <para>Dokumentu jakin baten laster-marka gehitzeko:</para>

      <para><itemizedlist>
          <listitem>
            <para>Hautatu <menuchoice><guimenu>Laster-markak</guimenu><guimenuitem>Gehitu laster-marka</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Erabili <keycombo><keycap>Ktrl</keycap><keycap>D</keycap></keycombo> tekla-konbinazioa.</para>
          </listitem>
        </itemizedlist>Honelako leiho bat azalduko da <xref linkend="yelp-add-bookmark"/>:</para>

      <para><figure id="yelp-add-bookmark">
          <title>Laster-marka gehitzeko leihoa</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_add_bookmark.png"/>
            </imageobject>
          </mediaobject>
        </figure>Sartu zure laster-markaren titulua <guilabel>Titulua</guilabel> testua sartzeko eremuan. Hautatu <guibutton>Gehitu</guibutton> laster-marka gehitzeko, edo <guibutton>Utzi</guibutton> eskaera bertan behera uzteko.</para>
    </section>

    <section>
      <title>Editatu laster-markak</title>

      <para>Zure laster-marken bilduma editatzeko:</para>

      <para><itemizedlist>
          <listitem>
            <para>Hautatu <menuchoice><guimenu>Laster-markak</guimenu><guimenuitem>Editatu laster-markak...</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Erabili <keycombo><keycap>Ktrl</keycap><keycap>B</keycap></keycombo> tekla-konbinazioa.</para>
          </listitem>
        </itemizedlist>Honelako leiho bat azalduko da <xref linkend="yelp-edit-bookmarks"/>:</para>

      <para><figure id="yelp-edit-bookmarks">
          <title>Laster-markak editatzeko leihoa</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_edit_bookmarks.png"/>
            </imageobject>
          </mediaobject>
        </figure>Laster-markak kudeatzeko, honela erabil dezakezu leiho hau:</para>

      <para><variablelist>
          <varlistentry>
            <term><guibutton>Ireki</guibutton></term>

            <listitem>
              <para>Erabili botoi hau hautatutako laster-marka leiho berri batean irekitzeko.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Izena aldatu</guibutton></term>

            <listitem>
              <para>Erabili botoi hau laster-markaren tituluaren izena aldatzeko.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Kendu</guibutton></term>

            <listitem>
              <para>Erabili botoi hau laster-marka zure bildumatik ezabatzeko.</para>
            </listitem>
          </varlistentry>
        </variablelist>Behin zure laster-markak kudeatzen amaituta, egin klik <guibutton>Itxi</guibutton> botoian, <interface>Laster-markak editatzeko leihotik</interface> irteteko.</para>
    </section>

    <section>
      <title>Lortu laguntza</title>

      <para><application>Yelp laguntza-arakatzailea</application> erabiltzeko (eta dokumentu hau ikusteko) laguntza lortzeko:</para>

      <para><itemizedlist>
          <listitem>
            <para>Hautatu <menuchoice><guimenu>Laguntza</guimenu><guimenuitem>Edukia</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>
  </section>

  <!--=============== Advanced Features ====================-->

  <section id="yelp-advanced">
    <title>Eginbide aurreratuak</title>

   <section id="yelp-open-specific" xreflabel="Opening Specific Documents">
    <title>Dokumentu zehatzak irekitzea</title>

    <section id="yelp-open-drag">
      <title>Dokumentuak Fitxategi-kudeatzailearekin irekitzea</title>
        <para>Dokumentu bat (XML fitxategi bat, esate baterako) fitxategi-kudeatzailetik irekitzeko, ireki dokumentua <application>Nautilus</application> fitxategi-kudeatzailearekin, edo arrastatu ikonoa <application>Nautilus</application>-etik <application>Yelp</application> dokumentu-panelera edo abiarazlera.</para>
    </section>

    <section id="yelp-advanced-cmdline" xreflabel="Using the Command Line to Open Documents">
      <title>Dokumentuak komando-errotik irekitzea</title>

      <para>Yelp laguntza-arakatzaileak komando-lerrotik ireki ditzake dokumentuak. Hainbat URI (Uniform Resource Identifiers) erabil daitezke horretarako. Besteak beste, hauek:</para>

      <variablelist>
          <varlistentry>
            <term><option>file:</option></term>

            <listitem>
              <para>Erabili URI hau fitxategi batean yelp-ekin sartu nahi duzunean, esate baterako:</para>

              <screen><userinput>yelp file:///usr/share/gnome/help/gcalctool/C/gcalctool.xml</userinput></screen>

            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>ghelp:</option> edo <option>gnome-help:</option></term>

            <listitem>
              <para>Erabili URI hau GNOMEren laguntza-dokumentuetan sartu nahi duzunean, normalean DocBook formatuan.</para>

              <screen><userinput>yelp ghelp:gcalctool</userinput></screen>

              <para>Laguntza-dokumentua atal jakin batean ireki nahi baduzu, gehitu galdera-marka bat URIaren amaieran, atalaren id-aren aurretik.</para>
              
              <screen><userinput>yelp ghelp:user-guide?yelp-advanced-cmdline</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>man:</option></term>

            <listitem>
              <para>Erabili URI hau man orri jakin batean sartzeko. Ikusi nahi duzun man orriaren atala gehi dezakezu, izen bereko man orri bat baino gehiago egonez gero. Atalaren zenbakiak parentesi artean joan beharko luke, eta argumentua saihestu behar da, shell-ak parentesia kontuan har ez dezan.</para>

              <screen><userinput>yelp man:gcalctool</userinput></screen>
              
              <para>edo</para>

              <screen><userinput>yelp 'man:intro(1)'</userinput>
<userinput>yelp 'man:intro(2)'</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>info:</option></term>

            <listitem>
              <para>Erabili URI hau GNU informazio-orri jakin batean sartzeko.</para>

              <screen><userinput>yelp info:make</userinput></screen>
            </listitem>
          </varlistentry>
        </variablelist>
    </section>

   </section>

    <section>
      <title>Eskatu ahala Edukia freskatzea</title>

      <para><application>Yelp laguntza-arakatzaileak</application> <keycombo><keycap>Ktrl</keycap><keycap>R</keycap></keycombo> tekla-konbinazioa onartzen du, irekita dagoen DocBook dokumentua berriro kargatzeko. Horrek aukera ematen die garatzaileei aldaketak egin ahala dokumentuetan ikusi ahal izateko.</para>
    </section>
  </section>

  <section id="yelp-moreinfo">
    <title>Informazio gehiago</title>

    <para><application>Yelp laguntza-arakatzaileak</application> erabiltzen dituen laguntza-aplikazio batzuei buruzko xehetasunak ematen ditu atal honek, eta baliabideak eskaintzen ditu <application>Yelp laguntza-arakatzaileari</application> buruzko informazio gehiago lortzeko.</para>

    <section>
      <title>Scrollkeeper</title>

      <para><application>Yelp laguntza-arakatzaileak</application> scrollkeeper erabiltzen du DocBook eta HTML dokumentaziorako eduki-taula sortzeko, eta dokumentu bakoitzaren itzulpenen jarraipena egiteko.</para>
    </section>

    <section>
      <title>GNOME dokumentazioaren utilitateak</title>

      <para>GNOMErekin banatutako dokumentazioak utilitate multzo hau darabil hainbat gauza egiteko:</para>

      <para><itemizedlist>
          <listitem>
            <para>Dokumentuak hainbat hizkuntzatara itzultzea erraztea.</para>
          </listitem>

          <listitem>
            <para>Dokumentazioa kokaleku egokian paketatzen eta instalatzen laguntzeko eta dokumentazioa scrollkeeper-ekin erregistratzeko tresna multzo bat hornitzen du.</para>
          </listitem>

          <listitem>
            <para>DocBook formatua bistaratzeko egokia den formatu batera bihurtzen du.</para>
          </listitem>
        </itemizedlist><application>Yelp laguntza-arakatzailea</application> <ulink url="ghelp:gnome-doc-xslt">GNOME XSLT estilo-orrietan</ulink> oinarritzen da DocBook formatutik HTML formatura bihurtzeko. <ulink url="ghelp:gnome-doc-make">GNOME Dokumentazioa prestatzeko utilitateak</ulink> aplikazio-egileen araberakoak dira, laguntza-sistemako dokumentazioa instalatzeko eta erregistratzeko.</para>
    </section>

    <section>
      <title>Orri nagusia eta Posta-zerrenda</title>

      <para><application>Yelp laguntza-arakatzaileari</application> buruz gehiago jakiteko, bisitatu Dokumentazio-proiektuaren orri nagusia, <ulink url="http://live.gnome.org/Yelp">http://live.gnome.org/Yelp</ulink>, edo harpidetu posta-zerrendan, <ulink type="http" url="http://mail.gnome.org/mailman/listinfo/gnome-doc-devel-list">gnome-doc-devel-list@gnome.org</ulink>.</para>
    </section>
  </section>

  <section id="yelp-joininggdp">
    <title>Parte hartu GNOMEren dokumentazio-proiektuan</title>

    <para>Interesatzen bazaizu GNOME proiektuari buruzko dokumentazioa sortzen eta eguneratzen laguntzea, bisitatu Dokumentazio-proiektuaren orri nagusia: <ulink url="http://live.gnome.org/DocumentationProject">http://live.gnome.org/DocumentationProject</ulink></para>
  </section>

</section>

</chapter>
