<?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="fi">
    <info><title>Työkalut ja apuohjelmat</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>Sovellusten suorittaminen</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>Suorita sovellus</guilabel> -valintaikkuna mahdollistaa komentorivien suorittamisen. Kun komento suoritetaan <guilabel>Suorita sovellus</guilabel> -valintaikkunassa, ei komennon aiheuttamaa tulostetta näytetä.</para>
    <para>Suorittaaksesi komennon, tee seuraavasti:</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>Suorita sovellus</guilabel> -valintaikkuna tulee näkyviin.</para>
    </listitem>
    <listitem>
      <para>Syötä suoritettava komento tyhjään kenttään, tai valitse tunnettujen sovellusten luettelosta.</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>Valitaksesi aiemmin suoritetun komennon, napsauta alaspäin osoittavaa nuolta komentokentän vieressä, ja valitse suoritettava komento.</para>
      <para>Voit käyttää myös <guibutton>Käynnistä tiedoston kanssa</guibutton> -painiketta valitsemaan tiedoston joka lisätään komentoriville. On esimerkiksi mahdollista syöttää <application>emacs</application> komennoksi ja sen jälkeen valita muokattava tiedosto.</para>
      <para>Valitse <guilabel>Suorita päätteessä</guilabel> -valinta suorittaaksesi sovelluksen tai komennon pääteikkunassa. Valitse tämä valinta sovellukselle tai komennolle joka ei itse luo ikkunaa jossa se suoritetaan.</para>
    </listitem>
    <listitem>
      <para>Napsauta <guibutton>Suorita</guibutton>-painiketta <guilabel>Suorita sovellus</guilabel> -valintaikkunassa.</para>
    </listitem>
      </orderedlist>
  </section>

<section xml:id="tools-screenshot"><info><title>Kuvakaappausten ottaminen</title></info>
  <!-- preserve id for backwards compatibility: 2.12 -->
  <anchor xml:id="goseditmainmenu-53"/>
  <indexterm><primary>kuvakaappaukset, ottaminen</primary></indexterm>
  <para>Kuvakaappaus voidaan ottaa millä tahansa seuraavista tavoista:</para>
  <itemizedlist>
    <listitem>
      <para>Mistä tahansa paneelista</para>
      <para><guibutton>Ota kuvakaappaus</guibutton> -painike voidaan lisätä mihin tahansa paneeliin. Lisätietoja tästä: <xref linkend="panels-addobject"/>.Napsauta <guibutton>Ota kuvakaappaus</guibutton> -painiketta ottaaksesi kuvan koko näytöstä.</para>
    </listitem>
    <listitem>
      <para>Pikanäppäimiä käyttäen</para>
      <para>Ottaaksesi kuvakaappauksen käytä seuraavia pikanäppäimiä:</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>Oletuspikanäppäimet</para>
              </entry>
              <entry>
                <para>Toiminto</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para><keycap>Print Screen</keycap></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Ottaa kuvakaappauksen koko näytöstä.</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>Ottaa kuvakaappauksen aktiivisena olevasta ikkunasta.</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>Valikkopalkista</para>
      <para xml:lang="en">Choose <menuchoice><guimenu>Applications</guimenu><guimenuitem>Accessories</guimenuitem>
      <guimenuitem>Take Screenshot</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para>Päätteestä</para>
      <para>Voit käyttää <command>mate-screenshot</command>-komentoa kuvakaappauksen ottamiseksi. <command>mate-screenshot</command>-komento ottaa kaappauksen koko näytöstä, ja näyttää <guilabel>Tallenna kuvakaappaus</guilabel> -valintaikkunan. Käytä <guilabel>Tallenna kuvakaappaus</guilabel> -valintaikkunaan kuvakaappauksen tallentamiseen.</para>
      <para>Voit käyttää myös <command>mate-screenshot</command>-komennon valitsimia seuraavasti:</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>Valitsin</para>
              </entry>
              <entry>
                <para>Toiminto</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>Ottaa kuvakaappauksen kohdistettuna olevasta ikkunasta.</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>Ottaa kuvakaappauksen määritellyn sekuntimäärän kuluttua, ja näyttää <guilabel>Tallenna kuvakaappaus</guilabel> -valintaikkunan. Käytä <guilabel>Tallenna kuvakaappaus</guilabel> -valintaikkunaa kuvakaappauksen tallentamiseksi.</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>Ottaa kuvakaappauksen mukaan lukien ikkunan reunan.</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>Ottaa kuvakaappauksen ilman ikkunan reunaa.</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>Ottaa kuvakaappauksen ja lisää siihen viistosti olevan varjotehosteen ympärille.</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>Ottaa kuvakaappauksen ja lisää reunatehosteen ympärille.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para><command>--interactive</command></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Avaa ikkunan, jossa voidaan tehdä asetuksia ennen kuvakaappauksen ottamista.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--help</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Näyttää komennon mahdolliset valitsimet.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </listitem>
  </itemizedlist>

  <para>Kun otat kuvakaappauksen, <guilabel>Tallenna kuvakaappaus</guilabel> -valintaikkuna avautuu. Tallentaaksesi kuvakaappauksen kuvatiedostoksi, syötä kuvakaappaukselle tiedostonimi ja valitse sijainti pudotusvalikon luettelosta. Napsauta sitten <guilabel>Tallenna</guilabel>-painiketta. Voit myös käyttää <guilabel>Kopioi leikepöydälle</guilabel> -painiketta kopioidaksesi kuvan leikepöydälle, tai siirtää kuvan toiseen sovellukseen raahamalla ja pudottamalla.</para>
  
</section>

<!-- ============= Yelp ============================= -->
<section xml:id="yelp"><info><title>Yelp-ohjeselain</title></info>
  <indexterm xml:lang="en">
    <primary>Yelp</primary>
  </indexterm>
  <!-- ============= Introduction ============================== -->

  <section xml:id="yelp-introduction"><info><title>Johdanto</title></info>
    <para><application>Yelp-ohjeselain</application> on sovellus Maten ja muiden komponenttien eri muodoissa olevien ohjeiden selaamiseen. Näitä muotoja ovat docbook-tiedostot, HTML-ohjesivut, man-sivut ja info-sivut (tuki man- ja info-sivuille voidaan kääntää valinnaisena ominaisuuksena mukaan). Huolimatta eri muodoista jota tuetaan, Yelp yrittää näyttää ohjeet saman näköisinä riippumatta alkuperäisestä ohjeen muodosta.</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>Yelpin käynnistäminen</title></info>
  
    <section><info><title>Käynnistääksesi <application>Yelp-ohjeselaimen</application></title></info>
      <para>Voit käynnistää <application>Yelp-ohjeselaimen</application> seuraavilla tavoilla:</para>

      <para><variablelist>
          <varlistentry>
            <term><guimenu>Järjestelmä</guimenu>-valikko</term>

            <listitem>
              <para>Valitse <application>Ohje</application></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>Komentorivi</term>

            <listitem>
              <para>Suorita seuraava komento: <command>yelp</command></para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section><info><title>Käyttöliittymä</title></info>
      <para>Kun käynnistät <application>Yelp-ohjeselaimen</application>, seuraavanlainen ikkuna ilmestyy.</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>Valikkopalkki</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term xml:lang="en"><guimenu>File</guimenu></term>

                  <listitem>
                    <para>Käytä tätä avaamaan uusi ikkuna, katsomaan tietoja ohjeesta -sivua, ohjeen tulostamiseen tai ikkunan sulkemiseen.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guimenu>Edit</guimenu></term>

                  <listitem>
                    <para>Käytä tätä toimintoihin Kopioi, Valitse kaikki, Etsi tai asetusten muuttamiseen.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guimenu>Go</guimenu></term>

                  <listitem>
                    <para>Käytä tätä valikkoa siirtyäksesi takaisin, eteenpäin tai ohjeen aiheiden sivulle. Katsottaessa DocBook-ohjetta tämän valikon kautta on mahdollista siirtyä seuraavaan tai edelliseen osioon, tai sisällysluetteloon.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guimenu>Bookmarks</guimenu></term>

                  <listitem>
                    <para>Käytä tätä valikkoa kirjanmerkkien lisäämiseen tai muokkaamiseen.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guimenu>Help</guimenu></term>

                  <listitem>
                    <para>Tietoja Yelp-ohjeselaimesta ja sen tekijöistä löytyy <guimenuitem>Tietoja</guimenuitem>-valikkokohdan kautta. Avaa tämä ohje <guimenuitem>Ohjeen aiheet</guimenuitem>-valikkokohdan avulla tai painamalla <keycap>F1</keycap>.</para>
                  </listitem>
                </varlistentry>
              </variablelist></para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term><interface>Työkalupalkki</interface></term>

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

                  <listitem>
                    <para>Käytä tätä painiketta siirtyäksesi asiakirjahistoriassa taaksepäin.</para>
                  </listitem>
                </varlistentry>

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

                  <listitem>
                    <para>Käytä tätä painiketta siirtyäksesi asiakirjahistoriassa eteenpäin.</para>
                  </listitem>
                </varlistentry>

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

                  <listitem>
                    <para>Käytä tätä painiketta siirtyäksesi sisällysluetteloon (näkyy kuvassa <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>Selainruudussa näytetään sisällysluettelo tai ohje. Käytä sisällysluetteloa ohjeessa siirtymiseen.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </section>
  </section>

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

  <section xml:id="yelp-usage"><info><title>Yelpin käyttö</title></info>

    <section><info><title>Asiakirjan avaaminen</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>Vaihtoehtoisesti on mahdollista lukea tiettyä ohjetta käynnistämällä Yelp-ohjeselain komentoriviltä tai raahaamalla tiedostoja Yelpiin. Katso lisätietoja kappaleesta <xref linkend="yelp-open-specific"/>.</para>
    </section>

    <section><info><title>Avaa uusi ikkuna</title></info>
      <para>Avataksesi uuden ikkunan:</para>
	  
      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>New Window</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Käytä näppäinyhdistelmää <keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Tietoja tästä asiakirjasta</title></info>
      <para>Näyttää tietoja parhaillaan auki olevasta asiakirjasta:</para>

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

                <guimenuitem>About This Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Tämä valinta on saatavilla ainoastaan DocBook-ohjeille. Oikeudelliset huomautukset ja ohjeen tekijät on yleensä lueteltu tässä osiossa.</para>
        </note></para>
    </section>

    <section><info><title>Tulosta sivu</title></info>
      <para>Tulostaa minkä tahansa <application>Yelp-ohjeselaimessa</application> näytettävissä olevan sivun.</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>Tulosta asiakirja</title></info>
      <para>Tulostaa koko asiakirjan:</para>

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

                <guimenuitem>Print this Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Tämä valinta on saatavilla vain DocBook-ohjeille.</para>
        </note></para>
    </section>

    <section><info><title>Sulje ikkuna</title></info>
      <para>Sulkeaksesi <application>Yelp-ohjeselaimen</application> ikkunan, tee seuraavasti:</para>

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

                <guimenuitem>Close Window</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Käytä näppäinyhdistelmää <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>Tee asetukset</title></info>
      <para>Tehdäksesi asetuksia <application>Yelp-ohjeselaimessa</application>:</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>Valitse tämä näyttääksesi ohjeet käyttäen Mate-työpöydän oletuskirjasimia.</para>

              <para>Valitaksesi omat kirjasimet ohjeiden näyttämiseen, poista tämä valinta ja napsauta painikkeita <guilabel>Vaihteleva leveys</guilabel>- tai <guilabel>Vakioleveys</guilabel>-tekstien vieressä.</para>

              <para><variablelist>
                  <varlistentry>
                    <term xml:lang="en"><guilabel>Variable Width</guilabel></term>

                    <listitem>
                      <para>Tämä on kirjasin jota käytetään kun vakioleveyden kirjasinta ei tarvita. Suurin osa tekstistä on tätä tyyppiä.</para>
                    </listitem>
                  </varlistentry>

                  <varlistentry>
                    <term xml:lang="en"><guilabel>Fixed Width</guilabel></term>

                    <listitem>
                      <para>Tätä kirjasinta käytetään, kun kaikkien tekstin kirjainten tulee olla saman kokoisia. Tätä kirjasinta käytetään yleensä näyttämään komennot, ohjelmalohkot tai muut tekstit jotka kuuluvat tällaisiin teksteihin.</para>
                    </listitem>
                  </varlistentry>
                </variablelist></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><guilabel>Browse with caret</guilabel></term>

            <listitem>
              <para>Valitse tämä valinta jos haluat nähdä kohdistimen ikkunan osassa <xref linkend="yelp-browser-pane"/>. Tämä mahdollistaa ohjeen selaamisen helpommin näyttämällä missä kohdistin sijaitsee ohjeessa.</para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section><info><title>Mene taaksepäin ohjehistoriassa</title></info>
      <para>Mennäksesi taaksepäin ohjehistoriassa:</para>

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

                <guimenuitem>Back</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para>Käytä näppäinyhdistelmää <keycombo><keycap>Alt</keycap><keycap>Left</keycap></keycombo></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>Mene eteenpäin ohjehistoriassa</title></info>
      <para>Mennäksesi eteenpäin ohjehistoriassa:</para>

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

                <guimenuitem>Forward</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Right</keycap></keycombo></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>Mene ohjeen aiheisiin</title></info>
      <para>Mennäksesi ohjeen aiheisiin:</para>

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

                <guimenuitem>Help Topics</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Home</keycap></keycombo></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 xml:lang="en">Go to Previous Section</title></info>
      <para xml:lang="en">To go to the previous section:</para>

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

                <guimenuitem>Previous Section</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Up</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para xml:lang="en">This option is only available in DocBook formatted
          documents.</para>
        </note></para>
    </section>

    <section><info><title xml:lang="en">Go to Next Section</title></info>
      

      <para xml:lang="en">To go to the next section:</para>

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

                <guimenuitem>Next Section</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Down</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para xml:lang="en">This option is only available in DocBook formatted
          documents.</para>
        </note></para>
    </section>

    <section><info><title xml:lang="en">Go to Contents</title></info>
      

      <para xml:lang="en">To go to the contents for a document:</para>

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

                <guimenuitem>Contents</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para xml:lang="en">This option is only available in DocBook formatted
          documents.</para>
        </note></para>
    </section>

    <section><info><title xml:lang="en">Add a Bookmark</title></info>
      

      <para xml:lang="en">To add a bookmark for a particular document:</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>Muokkaa kirjanmerkkejä</title></info>
      <para>Muokataksesi kirjanmerkkikokoelmaasi:</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 xml:lang="en">Get Help</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>Edistyneet ominaisuudet</title></info>

   <section xml:id="yelp-open-specific" xreflabel="Opening Specific Documents"><info><title xml:lang="en">Opening Specific Documents</title></info>

    <section xml:id="yelp-open-drag"><info><title xml:lang="en">Opening Documents from the File Manager</title></info>
        <para xml:lang="en">To open a document, such as an XML file, from the file manager, open the document in <application>Caja</application> File Manager, or drag the icon from <application>Caja</application> to the <application>Yelp</application> document pane
        or launcher.</para>
    </section>

    <section xml:id="yelp-advanced-cmdline" xreflabel="Using the Command Line to Open Documents"><info><title xml:lang="en">Using the Command Line to Open Documents</title></info>
      <para xml:lang="en">Yelp Help Browser supports opening documents from the command
      line. There are a number of URIs (Uniform Resource Identifiers) that can
      be used. These include:</para>

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

            <listitem>
              <para xml:lang="en">Use this URI when you want to access a file with
              yelp, for example:</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 xml:lang="en">Use this URI when you want to access MATE help documents,
              which are typically written in DocBook format.</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 xml:lang="en">or</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 xml:lang="en">Use this URI when you want to access a particular GNU info
              page.</para>

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

    <section><info><title xml:lang="en">Refreshing Content on Demand</title></info>
      <para xml:lang="en"><application>Yelp Help Browser</application> supports the
      <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo> shortcut keys, which will reload the DocBook
      document that is currently open. This allows developers to view changes
      to documents as they are made.</para>
    </section>
  </section>

  <section xml:id="yelp-moreinfo"><info><title>Lisätietoa</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 xml:lang="en">Scrollkeeper</title></info>
      <para xml:lang="en"><application>Yelp Help Browser</application> uses scrollkeeper to generate the table of
      contents for DocBook and HTML documentation, and also keep track of
      translations for each document.</para>
    </section>

    <section><info><title xml:lang="en">MATE Documentation Utilites</title></info>
      <para xml:lang="en">The documentation distributed with MATE uses this set of
      utilities for a variety of things:</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 xml:lang="en">Homepage and Mailing List</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>Maten dokumentaatioprojektiin liittyminen</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>
