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

  <highlights>
    <para>MATE 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>Run Application dialog, using</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>Open the <guilabel>Run Application</guilabel> dialog in any of the
        following ways:
        <variablelist>
          <varlistentry><term>From a panel</term>
          <listitem><para>You can add the <application>Run Application</application> button to any 
          panel. See <xref linkend="panels-addobject"/>. Click on the <guibutton>Run Application</guibutton> 
          panel button to open the <guilabel>Run Application</guilabel> dialog.</para></listitem></varlistentry>
          <varlistentry><term>Using shortcut keys</term>
          <listitem>
            <para>
              Press <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. You can change 
              the shortcut keys that display the <guilabel>Run Application</guilabel> dialog
              in the <link linkend="prefs-keyboard-shortcuts"><application>Keyboard Shortcuts</application> 
            preference tool</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>screenshots, taking</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>Print Screen</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>Print Screen</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>Choose <menuchoice><guimenu>Applications</guimenu><guimenuitem>Accessories</guimenuitem>
      <guimenuitem>Take Screenshot</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para>Terminaletik</para>
      <para><command>mate-screenshot</command> komandoa erabil dezakezu pantaila-argazkia egiteko. <command>mate-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>mate-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>seconds</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 MATErekin 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 Help Browser</application> Window</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_window.png"/>
            </imageobject>
          </mediaobject>
        </figure><application>Yelp Help Browser</application> contains the following elements in <xref linkend="fig-yelp-window"/></para>

      <variablelist>
        <varlistentry>
          <term><interface>Menubar</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><guimenu>File</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>Edit</guimenu></term>

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

                <varlistentry>
                  <term><guimenu>Go</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>Bookmarks</guimenu></term>

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

                <varlistentry>
                  <term><guimenu>Help</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>Toolbar</interface></term>

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

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

                <varlistentry>
                  <term><guibutton>Forward</guibutton></term>

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

                <varlistentry>
                  <term><guibutton>Help Topics</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>Browser Pane</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 Caja 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>Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>New Window</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>Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>About This Document</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>Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Print this Page</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>

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

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

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Print this Document</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>Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Close Window</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>Click <menuchoice>
                <guimenu>Edit</guimenu>

                <guimenuitem>Preferences</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist>A window will appear that looks like <xref linkend="yelp-preferences"/>:</para>

      <para><figure id="yelp-preferences">
          <title><application>Yelp Help Browser</application> Preferences Window</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_preferences.png"/>
            </imageobject>
          </mediaobject>
        </figure>The options that are available in this dialog have the
      following functions:</para>

      <para><variablelist>
          <varlistentry>
            <term><guilabel>Use system fonts</guilabel></term>

            <listitem>
              <para>Hautatu kontrol-lauki hau dokumentazioa MATE 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>Variable Width</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>Fixed Width</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>Browse with caret</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>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Back</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>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Forward</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>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Help Topics</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>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Previous Section</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>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Next Section</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>Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Contents</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>Click <menuchoice>
                <guimenu>Bookmarks</guimenu>

                <guimenuitem>Add Bookmark</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Use the key combination
            <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo></para>
          </listitem>
        </itemizedlist>A window will appear that looks like <xref linkend="yelp-add-bookmark"/>.</para>

      <para><figure id="yelp-add-bookmark">
          <title>Add Bookmark Window</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_add_bookmark.png"/>
            </imageobject>
          </mediaobject>
        </figure>Enter your desired bookmark title in to the
      <guilabel>Title</guilabel> text entry field. Then click
      <guibutton>Add</guibutton> to add the bookmark, or click
      <guibutton>Cancel</guibutton> to cancel the request.</para>
    </section>

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

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

      <para><itemizedlist>
          <listitem>
            <para>Click <menuchoice>
                <guimenu>Bookmarks</guimenu>
                <guimenuitem>Edit Bookmarks...</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Use the key combination
            <keycombo><keycap>Ctrl</keycap><keycap>B</keycap></keycombo></para>
          </listitem>
        </itemizedlist>A window will appear that looks like <xref linkend="yelp-edit-bookmarks"/>.</para>

      <para><figure id="yelp-edit-bookmarks">
          <title>Edit Bookmarks Window</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_edit_bookmarks.png"/>
            </imageobject>
          </mediaobject>
        </figure>You can manage your bookmarks using this window in the
      following ways:</para>

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

            <listitem>
              <para>Use this button to open the selected bookmark in a new
              window.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Rename</guibutton></term>

            <listitem>
              <para>Use this button to rename the title of your
              bookmark.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guibutton>Remove</guibutton></term>

            <listitem>
              <para>Use this button to delete the bookmark from your
              collection.</para>
            </listitem>
          </varlistentry>
        </variablelist>Once you are finished managing your bookmarks, click
      the <guibutton>Close</guibutton> button to exit the <interface>Edit
      Bookmarks Window</interface>.</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>Click <menuchoice>
                <guimenu>Help</guimenu>

                <guimenuitem>Contents</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>Caja</application> fitxategi-kudeatzailearekin, edo arrastatu ikonoa <application>Caja</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/mate/help/gcalctool/C/gcalctool.xml</userinput></screen>

            </listitem>
          </varlistentry>

          <varlistentry>
            <term><option>help:</option> edo <option>mate-help:</option></term>

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

              <screen><userinput>yelp help: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 help: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>MATE dokumentazioaren utilitateak</title>

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

      <para><itemizedlist>
          <listitem>
            <para>Ease translation of documents to different languages.</para>
          </listitem>

          <listitem>
            <para>Provide a set of tools to help package and install
            documentation into the correct location and register the
            documentation with scrollkeeper.</para>
          </listitem>

          <listitem>
            <para>Perform conversion from DocBook format to a format suitable
            for display.</para>
          </listitem>
        </itemizedlist><application>Yelp Help Browser</application> relies on <ulink url="help:mate-doc-xslt">MATE XSLT
      Stylesheets</ulink> to perform conversion from DocBook to HTML.  <ulink url="help:mate-doc-make">MATE Documentation
      Build Utilities</ulink> are relied upon by application authors to install and register documentation within the help system.</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/mate-doc-devel-list">mate-doc-devel-list@gnome.org</ulink>.</para>
    </section>
  </section>

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

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

</section>

</chapter>
