# Työkalut ja apuohjelmat

Tämä osio kertoo joistain Gnome-työpöydän työkaluista ja apuohjelmista.

## Sovellusten suorittaminen

Suorita sovellus -valintaikkuna mahdollistaa komentorivien suorittamisen. Kun komento suoritetaan Suorita sovellus -valintaikkunassa, ei komennon aiheuttamaa tulostetta näytetä.

Suorittaaksesi komennon, tee seuraavasti:

1. Avaa Suorita sovellus -valintaikkuna jollain seuraavista tavoista:

   Paneelista

     Voit lisätä Suorita sovellus -painikkeen mihin tahansa paneeliin. Katso lisätietoja kappaleesta . Napsauta Suorita sovellus -paneelipainiketta avataksesi Suorita sovellus -valintaikkunan.

   Pikanäppäimiä käyttäen

     Paina Alt F2. Voit muuttaa Suorita sovellus -valintaikkunan näyttäviä pikanäppäimiä Pikanäppäimet-asetustyökalussa.

   Suorita sovellus -valintaikkuna tulee näkyviin.

2. Syötä suoritettava komento tyhjään kenttään, tai valitse tunnettujen sovellusten luettelosta.

   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/.

   Valitaksesi aiemmin suoritetun komennon, napsauta alaspäin osoittavaa nuolta komentokentän vieressä, ja valitse suoritettava komento.

   Voit käyttää myös Käynnistä tiedoston kanssa -painiketta valitsemaan tiedoston joka lisätään komentoriville. On esimerkiksi mahdollista syöttää emacs komennoksi ja sen jälkeen valita muokattava tiedosto.

   Valitse Suorita päätteessä -valinta suorittaaksesi sovelluksen tai komennon pääteikkunassa. Valitse tämä valinta sovellukselle tai komennolle joka ei itse luo ikkunaa jossa se suoritetaan.

3. Napsauta Suorita-painiketta Suorita sovellus -valintaikkunassa.

## Kuvakaappausten ottaminen

Kuvakaappaus voidaan ottaa millä tahansa seuraavista tavoista:

- Mistä tahansa paneelista

  Ota kuvakaappaus -painike voidaan lisätä mihin tahansa paneeliin. Lisätietoja tästä: .Napsauta Ota kuvakaappaus -painiketta ottaaksesi kuvan koko näytöstä.

- Pikanäppäimiä käyttäen

  Ottaaksesi kuvakaappauksen käytä seuraavia pikanäppäimiä:

  Oletuspikanäppäimet | Toiminto
  --- | ---
  Print Screen | Ottaa kuvakaappauksen koko näytöstä.
  Alt Print Screen | Ottaa kuvakaappauksen ikkunasta jota hiiri osoittaa.

  Pikanäppäimet -asetustyökalua voidaan käyttää oletuspikanäppäinten muuttamiseen.

- Valikkopalkista

  Valitse Sovellukset Apuohjelmat Ota kuvakaappaus.

- Päätteestä

  Voit käyttää `gnome-screenshot`-komentoa kuvakaappauksen ottamiseksi. `gnome-screenshot`-komento ottaa kaappauksen koko näytöstä, ja näyttää Tallenna kuvakaappaus -valintaikkunan. Käytä Tallenna kuvakaappaus -valintaikkunaan kuvakaappauksen tallentamiseen.

  Voit käyttää myös `gnome-screenshot`-komennon valitsimia seuraavasti:

  Valitsin | Toiminto
  --- | ---
  `--window` | Ottaa kuvakaappauksen kohdistettuna olevasta ikkunasta.
  `--delay=sekuntia` | Ottaa kuvakaappauksen määritellyn sekuntimäärän kuluttua, ja näyttää Tallenna kuvakaappaus -valintaikkunan. Käytä Tallenna kuvakaappaus -valintaikkunaa kuvakaappauksen tallentamiseksi.
  `--include-border` | Takes a screenshot including the border of the window.
  `--remove-border` | Takes a screenshot without the border of the window.
  `--border-effect=shadow` | Ottaa kuvakaappauksen ja lisää siihen viistosti olevan varjotehosteen ympärille.
  `--border-effect=border` | Ottaa kuvakaappauksen ja lisää varjotehosteen ympärille.
  `--interactive` | Opens a window that lets you set options before taking the screenshot.
  `--help` | Näyttää komennon mahdolliset valitsimet.

When you take a screenshot, the Save Screenshot 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 Save button. You can also use the Copy to Clipboard button to copy the image to the clipboard or transfer it to another application by drag-and-drop.

## Yelp-ohjeselain

### Johdanto

Yelp-ohjeselain 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.

Yelp-ohjeselain 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.

### Yelpin käynnistäminen

#### Käynnistääksesi Yelp-ohjeselaimen

Voit käynnistää Yelp-ohjeselaimen seuraavilla tavoilla:

Järjestelmä-valikko

  Valitse Ohje

Komentorivi

  Suorita seuraava komento: `yelp`

#### Käyttöliittymä

Kun käynnistät Yelp-ohjeselaimen, seuraavanlainen ikkuna ilmestyy.

##### Yelp-ohjeselain-ikkuna

Yelp-ohjeselain sisältää seuraavat elementit kuvassa

Valikkopalkki

  Tiedosto

    Käytä tätä avaamaan uusi ikkuna, katsomaan tietoja ohjeesta -sivua, ohjeen tulostamiseen tai ikkunan sulkemiseen.

  Muokkaa

    Käytä tätä toimintoihin Kopioi, Valitse kaikki, Etsi tai asetusten muuttamiseen.

  Siirry

    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.

  Kirjanmerkit

    Käytä tätä valikkoa kirjanmerkkien lisäämiseen tai muokkaamiseen.

  Ohje

    Tietoja Yelp-ohjeselaimesta ja sen tekijöistä löytyy Tietoja-valikkokohdan kautta. Avaa tämä ohje Ohjeen aiheet-valikkokohdan avulla tai painamalla F1.

Työkalupalkki

  Edellinen

    Käytä tätä painiketta siirtyäksesi asiakirjahistoriassa taaksepäin.

  Seuraava

    Käytä tätä painiketta siirtyäksesi asiakirjahistoriassa eteenpäin.

  Ohjeen aiheet

    Käytä tätä painiketta siirtyäksesi sisällysluetteloon (näkyy kuvassa ).

Selainruutu

  Selainruudussa näytetään sisällysluettelo tai ohje. Käytä sisällysluetteloa ohjeessa siirtymiseen.

### Yelpin käyttö

#### Asiakirjan avaaminen

Avataksesi ohjeen Yelp-ohjeselaimessa, käytä Ohjeen aiheet -valintaa siirtyäksesi haluttuun ohjeeseen.

Vaihtoehtoisesti on mahdollista lukea tiettyä ohjetta käynnistämällä Yelp-ohjeselain komentoriviltä tai raahaamalla tiedostoja Yelpiin. Katso lisätietoja kappaleesta .

#### Avaa uusi ikkuna

Avataksesi uuden ikkunan:

- Napsauta Tiedosto Uusi ikkuna

- Käytä näppäinyhdistelmää Ctrl N

#### Tietoja tästä asiakirjasta

Näyttää tietoja parhaillaan auki olevasta asiakirjasta:

- Napsauta Tiedosto Tietoja tästä asiakirjasta

Tämä valinta on saatavilla ainoastaan DocBook-ohjeille. Oikeudelliset huomautukset ja ohjeen tekijät on yleensä lueteltu tässä osiossa.

#### Tulosta sivu

Tulostaa minkä tahansa Yelp-ohjeselaimessa näytettävissä olevan sivun.

- Napsauta Tiedosto Tulosta tämä sivu

#### Tulosta asiakirja

Tulostaa koko asiakirjan:

- Napsauta Tiedosto Tulosta tämä asiakirja

Tämä valinta on saatavilla vain DocBook-ohjeille.

#### Sulje ikkuna

Sulkeaksesi Yelp-ohjeselaimen ikkunan, tee seuraavasti:

- Napsauta Tiedosto Sulje ikkuna

- Käytä näppäinyhdistelmää Ctrl W

#### Tee asetukset

Tehdäksesi asetuksia Yelp-ohjeselaimessa:

- Napsauta Muokkaa Asetukset

Avautuu ikkuna, joka on kuvassa :

##### Yelp-ohjeselaimen asetusikkuna

Valintaikkunassa olevilla valinnoilla on seuraavat merkitykset:

Käytä järjestelmän kirjasimia

  Valitse tämä näyttääksesi ohjeet käyttäen Gnome-työpöydän oletuskirjasimia.

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

  Vaihteleva leveys

    Tämä on kirjasin jota käytetään kun vakioleveyden kirjasinta ei tarvita. Suurin osa tekstistä on tätä tyyppiä.

  Vakioleveys

    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.

Selaa kohdistimella

  Valitse tämä valinta jos haluat nähdä kohdistimen ikkunan osassa . Tämä mahdollistaa ohjeen selaamisen helpommin näyttämällä missä kohdistin sijaitsee ohjeessa.

#### Mene taaksepäin ohjehistoriassa

Mennäksesi taaksepäin ohjehistoriassa:

- Napsauta Siirry Edellinen

- Käytä näppäinyhdistelmää Alt Left

- Käytä Edellinen-painiketta työkalupalkissa

#### Mene eteenpäin ohjehistoriassa

Mennäksesi eteenpäin ohjehistoriassa:

- Click Go Forward

- Use the key combination Alt Right

- Use the Forward button in the Toolbar

#### Mene ohjeen aiheisiin

Mennäksesi ohjeen aiheisiin:

- Click Go Help Topics

- Use the key combination Alt Home

- Use the Help Topics button in the Toolbar

#### Go to Previous Section

To go to the previous section:

- Click Go Previous Section

- Use the key combination Alt Up

This option is only available in DocBook formatted documents.

#### Go to Next Section

To go to the next section:

- Click Go Next Section

- Use the key combination Alt Down

This option is only available in DocBook formatted documents.

#### Go to Contents

To go to the contents for a document:

- Click Go Contents

This option is only available in DocBook formatted documents.

#### Add a Bookmark

To add a bookmark for a particular document:

- Click Bookmarks Add Bookmark

- Use the key combination Ctrl D

A window will appear that looks like .

##### Add Bookmark Window

Enter your desired bookmark title in to the Title text entry field. Then click Add to add the bookmark, or click Cancel to cancel the request.

#### Edit Bookmarks

To edit your collection of bookmarks:

- Click Bookmarks Edit Bookmarks...

- Use the key combination Ctrl B

A window will appear that looks like .

##### Edit Bookmarks Window

You can manage your bookmarks using this window in the following ways:

Open

  Use this button to open the selected bookmark in a new window.

Rename

  Use this button to rename the title of your bookmark.

Remove

  Use this button to delete the bookmark from your collection.

Once you are finished managing your bookmarks, click the Close button to exit the Edit Bookmarks Window.

#### Get Help

To get help using Yelp Help Browser (and see this document):

- Click Help Contents

### Edistyneet ominaisuudet

#### Opening Specific Documents

##### Opening Documents from the File Manager

To open a document, such as an XML file, from the file manager, open the document in Nautilus File Manager, or drag the icon from Nautilus to the Yelp document pane or launcher.

##### Using the Command Line to Open Documents

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:

`file:`

  Use this URI when you want to access a file with yelp, for example:

      yelp file:///usr/share/gnome/help/gcalctool/C/gcalctool.xml

`ghelp:` or `gnome-help:`

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

      yelp ghelp:gcalctool

  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.

      yelp ghelp:user-guide?yelp-advanced-cmdline

`man:`

  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.

      yelp man:gcalctool

  or

      yelp 'man:intro(1)'
      yelp 'man:intro(2)'

`info:`

  Use this URI when you want to access a particular GNU info page.

      yelp info:make

#### Refreshing Content on Demand

Yelp Help Browser supports the Ctrl R shortcut keys, which will reload the DocBook document that is currently open. This allows developers to view changes to documents as they are made.

### Lisätietoa

This section details some of the helper applications which Yelp Help Browser uses, and provides resources where you can get more information about Yelp Help Browser.

#### Scrollkeeper

Yelp Help Browser uses scrollkeeper to generate the table of contents for DocBook and HTML documentation, and also keep track of translations for each document.

#### GNOME Documentation Utilites

The documentation distributed with GNOME uses this set of utilities for a variety of things:

- Ease translation of documents to different languages.

- Provide a set of tools to help package and install documentation into the correct location and register the documentation with scrollkeeper.

- Perform conversion from DocBook format to a format suitable for display.

Yelp Help Browser relies on GNOME XSLT Stylesheets to perform conversion from DocBook to HTML. GNOME Documentation Build Utilities are relied upon by application authors to install and register documentation within the help system.

#### Homepage and Mailing List

For further information on Yelp Help Browser, please visit the Documentation Project homepage, http://live.gnome.org/Yelp, or subscribe to the mailing list, gnome-doc-devel-list@gnome.org.

### Gnomen dokumentaatioprojektiin liittyminen

Jos olet kiinnostunut Gnome-projektin ohjeiden tuottamisesta ja päivittämisestä, käy dokumentaatioprojektin kotisivuilla: http://live.gnome.org/DocumentationProject