<?xml version="1.0" encoding="utf-8"?>
<!-- -*- indent-tabs-mode: nil -*- -->
<chapter id="tools">
  <title>Työkalut ja apuohjelmat</title>

  <highlights>
    <para>Tämä osio kertoo joistain Gnome-työpöydän työkaluista ja apuohjelmista.</para>
  </highlights>

  <section id="tools-run-app">
    <title>Sovellusten suorittaminen</title>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor id="gospanel-23"/>
    <indexterm>
      <primary>Suorita sovellus -valintaikkuna</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>Avaa <guilabel>Suorita sovellus</guilabel> -valintaikkuna jollain seuraavista tavoista: <variablelist>
          <varlistentry><term>Paneelista</term>
          <listitem><para>Voit lisätä <application>Suorita sovellus</application> -painikkeen mihin tahansa paneeliin. Katso lisätietoja kappaleesta <xref linkend="panels-addobject"/>. Napsauta <guibutton>Suorita sovellus</guibutton> -paneelipainiketta avataksesi <guibutton>Suorita sovellus</guibutton> -valintaikkunan.</para></listitem></varlistentry>
          <varlistentry><term>Pikanäppäimiä käyttäen</term>
          <listitem>
            <para>Paina <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. Voit muuttaa <guilabel>Suorita sovellus</guilabel> -valintaikkunan näyttäviä pikanäppäimiä <link linkend="prefs-keyboard-shortcuts"><application>Pikanäppäimet</application>-asetustyökalussa</link>.</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>Jos syötät vain tiedoston sijainnin, sopiva sovellus käynnistyy sen avaamiseksi. Jos syötät WWW-osoitteen, oletus-WWW-selain käynnistyy näyttämään sivun. Laita WWW-sivun osoitteen eteen http://, esimerkiksi http://www.gnome.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 id="tools-screenshot">
  <title>Kuvakaappausten ottaminen</title>
  <!-- preserve id for backwards compatibility: 2.12 -->
  <anchor 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><keycombo><keycap>Alt</keycap><keycap>Print Screen</keycap></keycombo></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Ottaa kuvakaappauksen ikkunasta jota hiiri osoittaa.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para><link linkend="prefs-keyboard-shortcuts"><application>Pikanäppäimet</application> -asetustyökalua</link> voidaan käyttää oletuspikanäppäinten muuttamiseen.</para>
    </listitem>
    <listitem>
      <para>Valikkopalkista</para>
      <para>Valitse <menuchoice><guimenu>Sovellukset</guimenu><guimenuitem>Apuohjelmat</guimenuitem><guimenuitem>Ota kuvakaappaus</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para>Päätteestä</para>
      <para>Voit käyttää <command>gnome-screenshot</command>-komentoa kuvakaappauksen ottamiseksi. <command>gnome-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>gnome-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>
                  <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>
                  <command>--delay=<replaceable>sekuntia</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>
                  <command>--include-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Ottaa kuvakaappauksen mukaanlukien ikkunan reunan.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <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>
                  <command>--border-effect=border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para>Ottaa kuvakaappauksen ja lisää varjotehosteen ympärille.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para>
                  <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.</para>
  
</section>

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

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

    <para><application>Yelp-ohjeselain</application> on sovellus Gnomen 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><application>Yelp-ohjeselain</application> on kansainvälistetty, tarkoittaen sitä että sillä on mahdollista katsella ohjeita eri kielillä. Ohjeet tulee olla käännetty jokaiselle kielelle erikseen ja asennettuna oikein jotta Yelp-ohjeselain voi näyttää ne.</para>
  </section>

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

  <section id="yelp-getting-started">
    <title>Yelpin käynnistäminen</title>

    <section>
      <title>Käynnistääksesi <application>Yelp-ohjeselaimen</application></title>

      <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>
      <title>Käyttöliittymä</title>

      <para>Kun käynnistät <application>Yelp-ohjeselaimen</application>, seuraavanlainen ikkuna ilmestyy.</para>

      <para><figure id="fig-yelp-window">
          <title><application>Yelp-ohjeselain</application>-ikkuna</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_window.png"/>
            </imageobject>
          </mediaobject>
        </figure><application>Yelp-ohjeselain</application> sisältää seuraavat elementit kuvassa <xref linkend="fig-yelp-window"/></para>

      <variablelist>
        <varlistentry>
          <term><interface>Valikkopalkki</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term><guimenu>Tiedosto</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><guimenu>Muokkaa</guimenu></term>

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

                <varlistentry>
                  <term><guimenu>Siirry</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><guimenu>Kirjanmerkit</guimenu></term>

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

                <varlistentry>
                  <term><guimenu>Ohje</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><guibutton>Edellinen</guibutton></term>

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

                <varlistentry>
                  <term><guibutton>Seuraava</guibutton></term>

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

                <varlistentry>
                  <term><guibutton>Ohjeen aiheet</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 id="yelp-browser-pane" xreflabel="Yelp Browser Pane">
          <term><interface>Selainruutu</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 id="yelp-usage">
    <title>Yelpin käyttö</title>

    <section>
      <title>Asiakirjan avaaminen</title>

      <para>Avataksesi ohjeen <application>Yelp-ohjeselaimessa</application>, käytä Ohjeen aiheet -valintaa siirtyäksesi haluttuun ohjeeseen.</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>
      <title>Avaa uusi ikkuna</title>

      <para>Avataksesi uuden ikkunan:</para>

      <para><itemizedlist>
          <listitem>
            <para>Napsauta <menuchoice><guimenu>Tiedosto</guimenu><guimenuitem>Uusi ikkuna</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>
      <title>Tietoja tästä asiakirjasta</title>

      <para>Näyttää tietoja parhaillaan auki olevasta asiakirjasta:</para>

      <para><itemizedlist>
          <listitem>
            <para>Napsauta <menuchoice><guimenu>Tiedosto</guimenu><guimenuitem>Tietoja tästä asiakirjasta</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>
      <title>Tulosta sivu</title>

      <para>Tulostaa minkä tahansa <application>Yelp-ohjeselaimessa</application> näytettävissä olevan sivun.</para>

      <para><itemizedlist>
          <listitem>
            <para>Napsauta <menuchoice><guimenu>Tiedosto</guimenu><guimenuitem>Tulosta tämä sivu</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Tulosta asiakirja</title>

      <para>Tulostaa koko asiakirjan:</para>

      <para><itemizedlist>
          <listitem>
            <para>Napsauta <menuchoice><guimenu>Tiedosto</guimenu><guimenuitem>Tulosta tämä asiakirja</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>Tämä valinta on saatavilla vain DocBook-ohjeille.</para>
        </note></para>
    </section>

    <section>
      <title>Sulje ikkuna</title>

      <para>Sulkeaksesi <application>Yelp-ohjeselaimen</application> ikkunan, tee seuraavasti:</para>

      <para><itemizedlist>
          <listitem>
            <para>Napsauta <menuchoice><guimenu>Tiedosto</guimenu><guimenuitem>Sulje ikkuna </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>
      <title>Tee asetukset</title>

      <para>Tehdäksesi asetuksia <application>Yelp-ohjeselaimessa</application>:</para>

      <para><itemizedlist>
          <listitem>
            <para>Napsauta <menuchoice><guimenu>Muokkaa</guimenu><guimenuitem>Asetukset</guimenuitem></menuchoice></para>
          </listitem>
        </itemizedlist>Avautuu ikkuna, joka on kuvassa <xref linkend="yelp-preferences"/>:</para>

      <para><figure id="yelp-preferences">
          <title><application>Yelp-ohjeselaimen</application> asetusikkuna</title>

          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_preferences.png"/>
            </imageobject>
          </mediaobject>
        </figure>Valintaikkunassa olevilla valinnoilla on seuraavat merkitykset:</para>

      <para><variablelist>
          <varlistentry>
            <term><guilabel>Käytä järjestelmän kirjasimia</guilabel></term>

            <listitem>
              <para>Valitse tämä näyttääksesi ohjeet käyttäen Gnome-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><guilabel>Vaihteleva leveys</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><guilabel>Vakioleveys</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><guilabel>Selaa kohdistimella</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>
      <title>Mene taaksepäin ohjehistoriassa</title>

      <para>Mennäksesi taaksepäin ohjehistoriassa:</para>

      <para><itemizedlist>
          <listitem>
            <para>Napsauta <menuchoice><guimenu>Siirry</guimenu><guimenuitem>Edellinen</guimenuitem></menuchoice></para>
          </listitem>

          <listitem>
            <para>Käytä näppäinyhdistelmää <keycombo><keycap>Alt</keycap><keycap>Left</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para>Käytä <guibutton>Edellinen</guibutton>-painiketta <interface>työkalupalkissa</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Mene eteenpäin ohjehistoriassa</title>

      <para>Mennäksesi eteenpäin ohjehistoriassa:</para>

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

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

          <listitem>
            <para>Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Right</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para>Use the <guibutton>Forward</guibutton> button in the
            <interface>Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Mene ohjeen aiheisiin</title>

      <para>Mennäksesi ohjeen aiheisiin:</para>

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

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

          <listitem>
            <para>Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Home</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para>Use the <guibutton>Help Topics</guibutton> button in the
            <interface>Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section>
      <title>Go to Previous Section</title>

      <para>To go to the previous section:</para>

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

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

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

    <section>
      <title>Go to Next Section</title>

      <para>To go to the next section:</para>

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

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

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

    <section>
      <title>Go to Contents</title>

      <para>To go to the contents for a document:</para>

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

                <guimenuitem>Contents</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para>This option is only available in DocBook formatted
          documents.</para>
        </note></para>
    </section>

    <section>
      <title>Add a Bookmark</title>

      <para>To add a bookmark for a particular document:</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>Edit Bookmarks</title>

      <para>To edit your collection of bookmarks:</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>Get Help</title>

      <para>To get help using <application>Yelp Help Browser</application> (and see this
      document):</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>Edistyneet ominaisuudet</title>

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

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

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

      <para>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><option>file:</option></term>

            <listitem>
              <para>Use this URI when you want to access a file with
              yelp, for example:</para>

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

            </listitem>
          </varlistentry>

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

            <listitem>
              <para>Use this URI when you want to access GNOME help documents,
              which are typically written in DocBook format.</para>

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

              <para>If you want to open the help document at a particular section,
              append a question mark to the end of the URI, followed by the section id.</para>
              
              <screen><userinput>yelp ghelp:user-guide?yelp-advanced-cmdline</userinput></screen>
            </listitem>
          </varlistentry>

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

            <listitem>
              <para>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 parenthesis and 
              therefore it may be necessary to escape the argument so that the
              shell does not interpret the parenthesis.</para>

              <screen><userinput>yelp man:gcalctool</userinput></screen>
              
              <para>or</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>Use this URI when you want to access a particular GNU info
              page.</para>

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

   </section>

    <section>
      <title>Refreshing Content on Demand</title>

      <para><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 id="yelp-moreinfo">
    <title>Lisätietoa</title>

    <para>This section details some of the 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>
      <title>Scrollkeeper</title>

      <para><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>
      <title>GNOME Documentation Utilites</title>

      <para>The documentation distributed with GNOME uses this set of
      utilities for a variety of things:</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="ghelp:gnome-doc-xslt">GNOME XSLT
      Stylesheets</ulink> to perform conversion from DocBook to HTML.  <ulink url="ghelp:gnome-doc-make">GNOME Documentation 
      Build Utilities</ulink> are relied upon by application authors to install and register documentation within the help system.</para>
    </section>

    <section>
      <title>Homepage and Mailing List</title>

      <para>For further information on <application>Yelp Help Browser</application>, please visit the Documentation Project homepage, <ulink url="http://live.gnome.org/Yelp">http://live.gnome.org/Yelp</ulink>, or subscribe to
      the mailing list, <ulink type="http" url="http://mail.gnome.org/mailman/listinfo/gnome-doc-devel-list">gnome-doc-devel-list@gnome.org</ulink>.</para>
    </section>
  </section>

  <section id="yelp-joininggdp">
    <title>Gnomen dokumentaatioprojektiin liittyminen</title>

    <para>Jos olet kiinnostunut Gnome-projektin ohjeiden tuottamisesta ja päivittämisestä, käy dokumentaatioprojektin kotisivuilla: <ulink url="http://live.gnome.org/DocumentationProject">http://live.gnome.org/DocumentationProject</ulink></para>
  </section>

</section>

</chapter>
