# Verktyg

Det här avsnittet beskriver några av de verktyg som finns på GNOME-skrivbordet.

## Kör program

Dialogen Kör program ger dig tillgång till kommandoraden. När du kör ett kommando med dialogen Kör program kan du inte få utdata från kommandot.

Genomför följande steg för att köra ett kommando från kommandoraden:

1. Öppna dialogrutan Kör program på något av följande sätt:

   Från en panel

2. Du kan lägga till knappen Kör program till valfri panel. Se panels-addobject. Klicka på panelknappen Kör program för att öppna dialogrutan Kör program.

Med tangentgenvägar

- Tryck Alt F2. Du kan ändra tangentgenvägen som visar dialogrutan Kör program i inställningsverktyget Tangentbordsgenvägar.

Dialogen Kör program visas.

- Ange kommandot som du vill köra i det tomma fältet, eller välj från listan över kända program.

  Om du endast anger platsen för en fil kommer ett lämpligt program att startas för att öppna den. Om du anger adressen till en webbsida kommer din standardwebbläsare att öppna sidan. Inled webbsidans adress med http://, som i http://www.gnome.org.

  För att välja ett kommando som du tidigare har kört, klicka på nedåtpilen bredvid kommandofältet, välj sedan kommandot som ska köras.

  En annan möjlighet är att använda knappen Kör med fil... för att välja en fil som ska läggas till till kommandoraden. Du kan till exempel skriva emacs som kommandot, och sedan välja vilken fil som ska redigeras.

  Välj alternativet Kör i terminal för att öra programmet eller kommandot i ett terminalfönster. Välj det här alternativet för program eller kommandon som inte skapar fönster att köras i.

- Klicka på knappen Kör i dialogen Kör program.

## Ta skärmbilder

Du kan ta en skärmbild på något av följande sätt:

- Från en panel

  Du kan lägga till en Ta skärmbild-knapp till valfri panel. Läs panels-addobject för instruktioner om hur du gör det. Klicka på knappen Ta en skärmbild för att ta en skärmbild av hela skärmen.

- Med tangentgenvägar

  Använd följande tangentgenväg för att ta en skärmbild:

  Standardtangenter | Funktion
  Print Screen | Tar en skärmbild av hela skärmen.
  Alt Print Screen | Tar en skärmbild av fönstret som är aktivt.

  Du kan använda inställningsverktyget för Tangentbordsgenvägar för att ändra standardgenvägarna.

- Från skrivbordsmenyn

  Välj Program Tillbehör Ta en skärmbild.

- Från terminalen

  Du kan använda kommandot `gnome-screenshot` för att ta en skärmbild. Kommandot `gnome-screenshot` tar en skärmbild av hela skärmen, och visar dialogrutan Spara skärmbild. Använd dialogrutan Spara skärmbild för att spara skärmbilden.

  Du kan också använda följande flaggor till kommandot `gnome-screenshot`:

  Flagga | Funktion
  `--window` | Tar en skärmbild av fönstret som har fokus.
  `--delay=`sekunder`` | Tar en skärmbild efter det specificerade antalet sekunder, och visar sedan Spara skärmbild-dialogen. Använd dialogen Spara skärmbild för att spara skärmbilden.
  `--include-border` | Tar en skärmbild inklusive fönstrets ram.
  `--remove-border` | Tar en skärmbild utan fönstrets ram.
  `--border-effect=shadow` | Tar en skärmbild och lägger till en skuggeffekt runt den.
  `--border-effect=border` | Tar en skärmbild och lägger till en rameffekt runt den.
  `--interactive` | Öppnar ett fönster som låter dig ställa in alternativ innan du tar skärmbilden.
  `--help` | Visar flaggor för kommandot.

När du tar en skärmbild så öppnas dialogen Spara skärmbild. För att spara skärmbilden som en bildfil, ange filnamnet för skärmbilden, välj en plats från rullgardinslistan och klicka på knappen Spara. Du kan även använda knappen Kopiera till urklipp för att kopiera bilden till urklipp eller överföra den till ett annat program genom att dra och släppa den.

## Hjälpbläddraren Yelp

### Introduktion

Hjälpbläddraren Yelp visar dig dokumentation om GNOME och andra komponenter från ett stort antal format. De här formaten inkluderar docbook-filer, HTML-hjälpsidor, man-sidor och info-sidor (stöd för man- och info-sidor går att kompilera in). Trotts de olika format som stöds gör Yelp sitt bästa för att ge alla dokument samma utseende och uppförande.

Hjälpbläddraren Yelp är internationaliserad, vilket betyder att den har stöd för att visa dokument på olika språk. Dokumenten måste lokalanpassas eller översättas för varje språk och installeras korrekt för att Hjälpbläddraren Yelp ska kunna visa dem.

### Starta Yelp

#### För att starta Hjälpbläddraren Yelp

Du kan starta Hjälpbläddraren Yelp på följande sätt:

System-menyn

- Välj Hjälp

Kommandorad

- Kör följande kommando: `yelp`

#### Gränssnitt

När du startar Hjälpbläddraren Yelp kommer du att se följande fönster.

##### Yelp-fönster

Hjälpbläddraren Yelp innehåller följande element i fig-yelp-window

Menyrad

- Arkiv

- Använd den här menyn för att öppna ett nytt fönster, visa en sida om detta dokumentet, skriva ut det här dokumentet, eller stänga fönstret.

Redigera

- Använd den här menyn för att kopiera, markera allt, söka eller för att göra inställningar.

Gå

- Använd den här menyn för att gå bakåt, framåt eller till sidan för hjälprubriker. När du visar ett DocBook-dokument kan du använda den här menyn för att gå till nästa avsnitt, föregående avsnitt eller till innehållsförteckningen.

Bokmärken

- Använd den här menyn för att lägga till eller redigera bokmärken.

Hjälp

- Visa information om Hjälpbläddraren Yelp och de som bidragit till projektet genom menyvalet Om. Oppna det här dokumentet genom att välja Innehåll eller genom att trycka på F1.

Verktygsrad

- Bakåt

- Använd den här knappen för att gå bakåt i din dokumenthistorik.

Framåt

- Använd den här knappen för att gå framåt i din dokumenthistorik.

Hjälprubriker

- Använd den här knappen för att gå till huvudinnehållsförteckningen (visas i fig-yelp-window).

Bläddrarpanel

- Bläddrarpanelen är där du kommer presenteras av innehållsförteckningen eller dokumentationen. Använd innehållsförteckningen för att navigera till dokumentet du behöver.

### Använda Yelp

#### Öppna ett dokument

För att öppna ett dokument i Hjälpbläddraren Yelp:

- I ett program, klicka på Hjälp Innehåll

- Använd innehållsförteckningen för att navigera till önskat dokument.

- Du kan dra en Docbook XML-fil från Nautilus till Yelp-fönstret eller programstartare.

- Tryck på F1-tangenten.

Du kan även visa ett specifikt dokument genom att anropa Hjälpbläddraren Yelp från kommandoraden eller genom att dra filer till Yelp. Se yelp-open-specific för mer information om det här.

#### Öppna ett nytt fönster

För att öppna ett nytt fönster:

- Klicka på Arkiv Nytt fönster

- Använd tangentkombinationen Ctrl N

#### Om detta dokument

För att visa information om det öppnade dokumentet:

- Klicka på Arkiv Om detta dokument

Det här alternativet finns endast för DocBook-dokumentation. Juridiska noteringar och en lista över vilka som hjälpt till med dokumentationen finns vanligtvis i det här avsnittet.

#### Skriv ut en sida

För att skriva ut en sida du kan se i Hjälpbläddraren Yelp:

- Klicka på Arkiv Skriv ut den här sidan

#### Skriv ut ett dokument

För att skriva ut ett helt dokument:

- Klicka på Arkiv Skriv ut det här dokumentet

Det här alternativet finns bara för DocBook-dokumentation.

#### Stäng ett fönster

Gör följande för att stänga ett fönster i Hjälpbläddraren Yelp:

- Klicka på Arkiv Stäng fönster

- Använd tangentkombinationen Ctrl W

#### Ändra inställningar

För att ändra inställningar i Hjälpbläddraren Yelp:

- Klicka på Redigera Inställningar

Ett fönster kommer att visas som ser ut som yelp-preferences:

##### Inställningsfönstret i Hjälpbläddraren Yelp

Alternativen som finns i den här dialogen har följande funktioner:

Använd systemtypsnitt

- Kryssa i det här alternativet för att visa dokumentation med standardtypsnitten som används av GNOME-skrivbordet.

  För att välja dina egna typsnitt för att visa dokumentation, ta bort krysset från det här alternativet och kryssa för knapparna bredvid texten Variabelt breddsteg eller Fast breddsteg.

  Variabelt breddsteg

- Det här typsnittet kommer användas när ett typsnitt med statisk eller fast bredd inte behövs. Nästan all text kommer använda det här typsnittet.

Fast breddsteg

- Det här är typsnittet som används när alla tecken måste vara av samma storlek. Det här typsnittet används främst för att skriva kommandon, programblock eller annan text som faller under någon av de här kategorierna.

Bläddra med markör

- Kryssa för det här alternativet om du vill se en markör i yelp-browser-pane. Det här låter dig bläddra i dokumentet enklare genom att du kan se var markören är.

#### Gå bakåt i dokumenthistoriken

För att gå bakåt i dokumenthistoriken:

- Klicka på Gå Bakåt

- Använd tangentkombinationen Alt Vänsterpil

- Använd knappen Bakåt i Verktygsraden

#### Gå framåt i dokumenthistoriken

För att gå framåt i dokumenthistoriken;

- Klicka på Gå Framåt

- Använd tangentkombinationen Alt Högerpil

- Använd knappen Framåt i Verktygsraden

#### Gå till hjälprubriker

För att gå till hjälprubriker;

- Klicka på Gå Hjälprubriker

- Använd tangentkombinationen Alt Home

- Använd knappen Hjälpämnen i Verktygsraden

#### Gå till föregående avsnitt

För att gå till det föregående avsnittet:

- Klicka på Gå Föregående avsnitt

- Använd tangentkombinationen Alt Uppåtpil

Det här alternativet finns bara i DocBook-formaterade dokument.

#### Gå till nästa avsnitt

För att gå till nästa avsnitt:

- Klicka på Gå Nästa avsnitt

- Använd tangentkombinationen Alt Nedåtpil

Det här alternativet finns bara i DocBook-formaterade dokument.

#### Gå till innehållsförteckningen

För att gå till innehållsförteckningen för ett dokument:

- Klicka på Gå Innehåll

Det här alternativet finns bara i DocBook-formaterade dokument.

#### Lägg till ett bokmärke

För att lägga till ett bokmärke för ett speciellt dokument:

- Klicka på Bokmärken Lägg till bokmärke

- Använd tangentkombinationen Ctrl D

Ett fönster kommer visas som ser ut som yelp-add-bookmark.

##### Lägg till bokmärkesfönstret

Skriv det namn du vill ge bokmärket i textfältet Titel. Klicka sedan på Lägg till för att lägga till bokmärket, eller klicka på Avbryt för att avbryta tilläggningen.

#### Redigera bokmärken

För att redigera din samling av bokmärken:

- Klicka på Bokmärken Redigera bokmärken...

- Använd tangentkombinationen Ctrl B

Ett fönster kommer visas som ser ut som yelp-edit-bookmarks.

##### Redigera bokmärkesfönstret

Du kan hantera dina bokmärken med det här fönstret på följande sätt:

Öppna

- Använd den här knappen för att öppna det valda bokmärket i ett nytt fönster.

Byt namn

- Använd den här knappen för att andra namnet på ditt bokmärke.

Ta bort

- Använd den här knappen för att ta bort bokmärket från din samling.

När du är färdig med att hantera dina bokmärken stänger du Redigera bokmärkesfönstret genom att klicka på knappen Stäng.

#### Få hjälp

För att få hjälp med Hjälpbläddraren Yelp (och läsa det här dokumentet):

- Klicka på Hjälp Innehåll

### Avancerade funktioner

#### Öppna specifika dokument

##### Öppna dokument från filhanteraren

För att öppna ett dokument, såsom en XML-fil, från filhanteraren, öppna dokumentet i filhanteraren Nautilus, eller dra ikonen från Nautilus till dokumentpanelen i Yelp eller programstartare.

##### Använd kommandoraden för att öppna dokument

Hjälpbläddraren Yelp har stöd för att dokument öppnas från kommandoraden. Det finns ett antal URI:er (Uniform Resource Identifiers) som kan användas. Några av dessa är:

`file:`

- Använd den här URI:n när du vill komma åt en fil med yelp, till exempel:

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

`ghelp:` eller `gnome-help:`

- Använd den här URI:n när du vill komma åt GNOMEs hjälpdokument, som oftast skrivs i DocBook-formatet.

      yelp ghelp:gcalctool

  Lägg till ett frågetecken på slutet av URI:en följt av avsnittets id om du vill öppna ett speciellt avsnitt i ett hjälpdokument.

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

`man:`

- Använd den här URI:n när du vill komma åt en speciell man-sida. Du kan lägga till avsnittet av man-sidan du vill visa om det finns flera man-sidor med samma namn. Avsnittsnumret bör stå inuti parenteser, och därför kan det vara nödvändigt att skriva det som en specialsekvens så att skalet inte tolkar parenteserna.

      yelp man:gcalctool

  eller

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

`info:`

- Använd den har URI:n när du vill komma åt en specifik GNU info-sida.

      yelp info:make

#### Uppdatera innehåll efter önskemål

Hjälpbläddraren Yelp har stöd för tangentgenvägen Ctrl R, vilket kommer att läsa om DocBook-dokumentet som är öppet just nu. Det här gör att utvecklarna kan visa ändringarna i dokumenten när de görs.

### Mer information

Det här avsnittet behandlar några av de hjälpprogram som Hjälpbläddraren Yelp använder, och länkar till resurser där du kan få mer information om Hjälpbläddraren Yelp.

#### Scrollkeeper

Hjälpbläddraren Yelp använder scrollkeeper för att generera innehållsförteckningar för DocBook- och HTML-dokumentation, och håller även reda på översättningar för varje dokument.

#### Dokumentationsverktyg för GNOME

Dokumentationen som distribueras med GNOME använder den här verktygsuppsättningen för en mängd olika saker:

- Förenkla översättning av dokument till olika språk.

- Erbjuda en uppsättning verktyg för att hjälpa till med att paketera och installera dokumentation till rätt plats och registrera dokumentationen med scrollkeeper.

- Genomför konvertering från DocBook-formatet till ett format som är lämpligt att visa.

Hjälpbläddraren Yelp använder GNOME XSLT:s formatmallar för att genomföra konverteringen från DocBook till HTML. GNOME Dokumentationsbyggverktyg används av programskapare för att installera och registrera dokumentation i hjälpsystemet.

#### Webbsida och sändlista

För ytterligare information om Hjälpbläddraren Yelp, besök dokumentationsprojektets webbsida, http://live.gnome.org/Yelp, eller prenumerera på sändlistan, gnome-doc-devel-list@gnome.org.

### Gå med i GNOME:s Dokumentationsprojekt

Om du är intresserad i att hjälpa till att producera och uppdatera dokumentationen för GNOME-projektet, besök webbsidan för dokumentationsprojektet: http://live.gnome.org/DocumentationProject