<?xml version="1.0" encoding="utf-8"?>
<?db.chunk.max_depth 3?>
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:db="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="tools" xml:lang="eu">
    <info><title>Tresnak eta utilitateak</title></info>

  <highlights>
    <para xml:lang="en">This section describes some tools and utilities in the MATE Desktop.</para>
  </highlights>

  <section xml:id="tools-run-app"><info><title>Aplikazioak exekutatzea</title></info>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor xml:id="gospanel-23"/>
    <indexterm xml:lang="en">
      <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 xml:lang="en">Open the <guilabel>Run Application</guilabel> dialog in any of the
        following ways:
        <variablelist>
          <varlistentry><term xml:lang="en">From a panel</term>
          <listitem><para xml:lang="en">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 xml:lang="en">Using shortcut keys</term>
          <listitem>
            <para xml:lang="en">
              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 <application><xref linkend="prefs-keyboard-shortcuts"/></application> tool.
            </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 xml:lang="en">If you enter only the location of a file, an appropriate application will launch to open it.
      If you enter a web page address, your default web browser will open the page. Prefix the web page address with https://, as in https://mate-desktop.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 xml:id="tools-screenshot"><info><title>Pantaila-argazkiak egitea</title></info>
  <!-- preserve id for backwards compatibility: 2.12 -->
  <anchor xml:id="goseditmainmenu-53"/>
  <indexterm xml:lang="en">
    <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 xml:lang="en">
                  <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 xml:lang="en"><keycombo><keycap>Alt</keycap><keycap>Print Screen</keycap></keycombo></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot of the window which is active.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para xml:lang="en">You can use the <application><xref linkend="prefs-keyboard-shortcuts"/></application> tool to modify the default shortcut keys.</para>
    </listitem>
    <listitem>
      <para>Menu-barratik</para>
      <para xml:lang="en">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 xml:lang="en">
                  <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 xml:lang="en">
                  <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 xml:lang="en">
                  <command>--include-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot including the border of the window.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--remove-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot without the border of the window.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--border-effect=shadow</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot and adds a shadow bevel effect around it.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--border-effect=border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot and adds a border effect around it.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--interactive</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Opens a window that lets you set options before taking the screenshot.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--help</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Komandoaren aukerak bistaratzen ditu.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </listitem>
  </itemizedlist>

  <para xml:lang="en">
  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 xml:id="yelp"><info><title>Yelp laguntza-arakatzailea</title></info>
  <indexterm xml:lang="en">
    <primary>Yelp</primary>
  </indexterm>
  <!-- ============= Introduction ============================== -->

  <section xml:id="yelp-introduction"><info><title>Sarrera</title></info>
    <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 xml:lang="en"><application>Yelp Help Browser</application> is internationalized, meaning that it has support
    to view documents in different languages. The documents must be localized
    or translated for each language and installed properly for Yelp Help
    Browser to be able to view them.</para>
  </section>

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

  <section xml:id="yelp-getting-started"><info><title>Yelp abiaraztea</title></info>
  
    <section><info><title><application>Yelp laguntza-arakatzailea</application> abiarazteko</title></info>
      <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><info><title>Interfazea</title></info>
      <para><application>Yelp laguntza-arakatzailea</application> abiaraztean, ondoko leihoa azalduko da.</para>

      <para xml:lang="en"><figure xml:id="fig-yelp-window"><info><title xml:lang="en"><application>Yelp Help Browser</application> Window</title></info>
          <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>Menu-barra</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term xml:lang="en"><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 xml:lang="en"><guimenu>Edit</guimenu></term>

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

                <varlistentry>
                  <term xml:lang="en"><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 xml:lang="en"><guimenu>Bookmarks</guimenu></term>

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

                <varlistentry>
                  <term xml:lang="en"><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>Tresna-barra</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term xml:lang="en"><guibutton>Back</guibutton></term>

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

                <varlistentry>
                  <term xml:lang="en"><guibutton>Forward</guibutton></term>

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

                <varlistentry>
                  <term xml:lang="en"><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 xml:id="yelp-browser-pane" xreflabel="Yelp Browser Pane">
          <term><interface xml:lang="en">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 xml:id="yelp-usage"><info><title>Yelp erabiltzea</title></info>

    <section><info><title>Ireki dokumentua</title></info>
      <para xml:lang="en">To open a document in <application>Yelp Help Browser</application>:
	  
	  <itemizedlist>
		<listitem>
			<para xml:lang="en">In an application, click <menuchoice>
                <guimenu>Help</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice>
			  </para>
		</listitem>	  
		<listitem>
			<para xml:lang="en">Use the Table of Contents to navigate to the desired document.</para>
		</listitem>
		<listitem>
			<para xml:lang="en">You can drag a Docbook XML file from Caja to the Yelp window or launcher.</para>
		</listitem>
		<listitem>
			<para xml:lang="en">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><info><title>Ireki Leiho berria</title></info>
      <para>Leiho berri bat irekitzeko:</para>
	  
      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">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><info><title>Dokumentu honi buruz</title></info>
      <para>Une horretan irekita dagoen dokumentuari buruzko informazioa ikusteko:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">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><info><title>Inprimatu orri bat</title></info>
      <para><application>Yelp laguntza-arakatzailean</application> ikus daitekeen edozein orri inprimatzeko:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

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

    <section><info><title>Inprimatu dokumentu bat</title></info>
      <para>Dokumentu oso bat inprimatzeko:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">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><info><title>Itxi leihoa</title></info>
      <para><application>Yelp laguntza-arakatzaileko</application> leiho bat ixteko, egin ondokoa:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">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><info><title>Ezarri hobespenak</title></info>
      <para><application>Yelp laguntza-arakatzailearen</application> hobespenak ezartzeko:</para>

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">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 xml:lang="en"><figure xml:id="yelp-preferences"><info><title xml:lang="en"><application>Yelp Help Browser</application> Preferences Window</title></info>
          <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 xml:lang="en"><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 xml:lang="en"><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 xml:lang="en"><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 xml:lang="en"><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><info><title>Joan atzera Dokumentuaren historian.</title></info>
      <para>Dokumentuaren historian atzera joateko:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">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 xml:lang="en">Use the <guibutton>Back</guibutton> button in the
            <interface xml:lang="en">Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Joan aurrera Dokumentuaren historian</title></info>
      <para>Dokumentuaren historian aurrera joateko:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">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 xml:lang="en">Use the <guibutton>Forward</guibutton> button in the
            <interface xml:lang="en">Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Joan Laguntza-gaietara</title></info>
      <para>Laguntza-gaietara joateko:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">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 xml:lang="en">Use the <guibutton>Help Topics</guibutton> button in the
            <interface xml:lang="en">Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Joan Aurreko atalera</title></info>
      <para>Aurreko atalera joateko:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">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><info><title>Joan Hurrengo atalera</title></info>
      

      <para>Hurrengo atalera joateko:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">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><info><title>Joan Edukira</title></info>
      

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

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">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><info><title>Gehitu laster-marka bat</title></info>
      

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

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Bookmarks</guimenu>

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

          <listitem>
            <para xml:lang="en">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 xml:lang="en"><figure xml:id="yelp-add-bookmark"><info><title xml:lang="en">Add Bookmark Window</title></info>
          <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><info><title>Editatu laster-markak</title></info>
      <para>Zure laster-marken bilduma editatzeko:</para>

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Bookmarks</guimenu>
                <guimenuitem>Edit Bookmarks...</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">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 xml:lang="en"><figure xml:id="yelp-edit-bookmarks"><info><title xml:lang="en">Edit Bookmarks Window</title></info>
          <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 xml:lang="en"><variablelist>
          <varlistentry>
            <term xml:lang="en"><guibutton>Open</guibutton></term>

            <listitem>
              <para xml:lang="en">Use this button to open the selected bookmark in a new
              window.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><guibutton>Rename</guibutton></term>

            <listitem>
              <para xml:lang="en">Use this button to rename the title of your
              bookmark.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><guibutton>Remove</guibutton></term>

            <listitem>
              <para xml:lang="en">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 xml:lang="en">Edit
      Bookmarks Window</interface>.</para>
    </section>

    <section><info><title>Lortu laguntza</title></info>
      <para xml:lang="en">To get help to use <application>Yelp Help Browser</application> (and see this
      document):</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Help</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>
  </section>

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

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

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

    <section xml:id="yelp-open-drag"><info><title>Dokumentuak Fitxategi-kudeatzailearekin irekitzea</title></info>
        <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 xml:id="yelp-advanced-cmdline" xreflabel="Using the Command Line to Open Documents"><info><title>Dokumentuak komando-errotik irekitzea</title></info>
      <para>Yelp laguntza-arakatzaileak komando-lerrotik ireki ditzake dokumentuak. Hainbat URI (Uniform Resource Identifiers) erabil daitezke horretarako. Besteak beste, hauek:</para>

      <variablelist>
          <varlistentry>
            <term xml:lang="en"><option>file:</option></term>

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

              <screen xml:lang="en"><userinput>yelp file:///usr/share/help/C/mate-control-center/config-mouse.xml</userinput></screen>

            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><option>help:</option></term>

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

              <screen xml:lang="en"><userinput>yelp help:mate-terminal</userinput></screen>

              <para xml:lang="en">If you want to open the help document at a particular section,
              append a slash to the end of the URI, followed by the section id.</para>
              
              <screen xml:lang="en"><userinput>yelp help:mate-user-guide/yelp-advanced-cmdline</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><option>man:</option></term>

            <listitem>
              <para xml:lang="en">Use this URI when you want to access a particular man
              page. You can append the section of the man page you would like
              to view if there are multiple man pages with the same
              name.  The section number should be enclosed in parentheses and 
              therefore it may be necessary to escape the argument so that the
              shell does not interpret the parenthesis.</para>

              <screen xml:lang="en"><userinput>yelp man:mate-panel</userinput></screen>
              
              <para>edo</para>

              <screen xml:lang="en"><userinput>yelp 'man:intro(1)'</userinput>
<userinput>yelp 'man:intro(2)'</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><option>info:</option></term>

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

              <screen xml:lang="en"><userinput>yelp info:make</userinput></screen>
            </listitem>
          </varlistentry>
        </variablelist>
    </section>
   </section>

    <section><info><title>Eskatu ahala Edukia freskatzea</title></info>
      <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 xml:id="yelp-moreinfo"><info><title>Informazio gehiago</title></info>
    <para xml:lang="en">This section details some helper applications which 
    <application>Yelp Help Browser</application> uses, and provides resources where you can get more information
    about <application>Yelp Help Browser</application>.</para>

    <section><info><title>Scrollkeeper</title></info>
      <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><info><title>MATE dokumentazioaren utilitateak</title></info>
      <para>MATErekin banatutako dokumentazioak utilitate multzo hau darabil hainbat gauza egiteko:</para>

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">Ease translation of documents to different languages.</para>
          </listitem>

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

    <section><info><title>Orri nagusia eta Posta-zerrenda</title></info>
      <para xml:lang="en">For further information on <application>Yelp Help Browser</application>, please visit the Documentation Project homepage, <uri xlink:href="http://mate-desktop.org">http://mate-desktop.org</uri>, or subscribe to
      the mailing list, <uri xlink:href="http://ml.mate-desktop.org/listinfo/mate-dev">http://ml.mate-desktop.org/listinfo/mate-dev</uri>.</para>
    </section>
  </section>

  <section xml:id="yelp-joininggdp"><info><title>Parte hartu MATEren dokumentazio-proiektuan</title></info>
    <para xml:lang="en">If you are interested in helping produce and update documentation
    for the MATE project, please visit the Documentation Project homepage: <uri xlink:href="http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team">http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team</uri></para>
  </section>
</section>
</chapter>
