# Werkzeuge und Hilfsprogramme

In diesem Kapitel wird die Verwendung der Werkzeuge und Hilfsprogramme in der GNOME-Arbeitsumgebung beschrieben.

## Ausführen von Anwendungen

Über das Dialogfeld Programm ausführen haben Sie Zugriff auf die Befehlszeile. Wenn Sie im Dialogfeld Programm ausführen einen Befehl ausführen, liefert der Befehl keine sichtbare Ausgabe.

Gehen Sie folgendermaßen vor, um in der Befehlszeile einen Befehl auszuführen:

1. Öffnen Sie das Dialogfeld Programm ausführen. Sie haben folgende Möglichkeiten, das Dialogfeld Programm ausführen zu öffnen:

   Über das Panel

2. Sie können den Anwendung ausführen-Knopf zu jedem Panel hinzufügen. Sehen Sie hierzu panels-addobject. Klicken Sie auf den Anwendung ausführen-Knopf, um den Anwendung ausführen-Dialog zu öffnen.

Verwenden von Tastenkombinationen

- Drücken Sie Alt F2. Sie können die Tastenkombination, durch die der Anwendung ausführen-Dialog angezeigt wird, im Tastenkombinationen-Einstellungswerkzeug ändern.

Das Dialogfeld Programm ausführen wird angezeigt.

- Geben Sie den auszuführenden Befehl in das leere Feld ein. Wenn Sie dagegen einen Befehl wählen möchten, den Sie zuvor ausgeführt haben, klicken Sie auf den nach unten weisenden Pfeil neben dem Befehlsfeld, und wählen Sie den auszuführenden Befehl aus.

  Wenn Sie nur den Ort einer Datei öffnen möchten, wird dazu eine passende Anwendung benötigt. Falls es sich um eine Webadresse handelt, wird Ihr Vorgabe-Webbrowser diese Seite öffnen. Setzen Sie vor die Webadresse ein http://, wie in http://gnome.org.

  Wenn Sie einen Befehl wählen möchten, den Sie zuvor ausgeführt haben, klicken Sie auf den nach unten weisenden Pfeil neben dem Befehlsfeld, und wählen Sie den auszuführenden Befehl aus.

  Mit dem Knopf Datei anhängen wählen Sie eine Datei aus, die an den Befehl in der Befehlszeile gehängt wird. Sie können z.B. emacs als Befehl eingeben und anschließend die zu bearbeitende Datei auswählen.

  Wählen Sie die Option Im Terminal ausführen, um die Anwendung oder den Befehl in einem Terminalfenster auszuführen. Wählen Sie diese Option für eine Anwendung oder einen Befehl, die bzw. der kein Fenster für die Ausführung erstellt.

- Klicken Sie im Dialogfeld Programm ausführen auf den Knopf Ausführen.

## So erstellen Sie ein Foto vom Bildschirm

Sie haben folgende Möglichkeiten, ein Foto des Bildschirms zu erstellen:

- Über ein beliebiges Panel

  Sie können einen Bildschirmfoto aufnehmen-Knopf zu einem beliebigen Panel hinzufügen. Hinweise dazu finden Sie in panels-addobject. Klicken Sie auf den Bildschirmfoto aufnehmen-Knopf, um ein Bild des gesamten Bildschirms zu erstellen.

- Verwenden von Tastenkombinationen

  Verwenden Sie zum Erstellen eines Bildschirmfotos die folgenden Tastenkombinationen:

  Standard-Tastenkombinationen | Funktion
  Druck | Erstellt ein Foto des ganzen Bildschirms.
  Alt Druck | Erstellt ein Foto des aktiven Fensters.

  Mit dem Einstellungs-Werkzeug Tastenkombinationen können Sie die vorgegebenen Tastenkombinationen ändern.

- Über das Menü-Panel

  Wählen Sie Anwendungen Werkzeuge Bildschirmfoto aufnehmen.

- Aus einem Terminal

  Sie können ein Bildschirmfoto mit dem Befehl `gnome-panel-screenshot` erstellen. Der Befehl `gnome-panel-screenshot` erstellt ein Foto des gesamten Bildschirms und öffnet das Dialogfeld Bildschirmfoto speichern. Verwenden Sie das Dialogfeld Bildschirmfoto speichern, um das Bildschirmfoto zu speichern.

  Für den Befehl `gnome-screenshot` stehen Ihnen außerdem die folgenden Optionen zur Verfügung:

  Option | Funktion
  `--window` | Erstellt ein Foto des aktiven Fensters.
  `--delay=`Sekunden`` | Erstellt nach der angegebenen Anzahl Sekunden ein Bildschirmfoto und öffnet das Dialogfeld Bildschirmfoto speichern. Verwenden Sie das Dialogfeld Bildschirmfoto speichern, um das Bildschirmfoto zu speichern.
  `--include-border` | Erstellt ein Foto des aktiven Fensters einschließlich des Fensterrahmens.
  `--remove-border` | Erstellt ein Foto des aktiven Fensters ohne den Fensterrahmen.
  `--border-effect=shadow` | Erstellt ein Bildschirmfoto mit einem umlaufenden Schatteneffekt.
  `--border-effect=border` | Erstellt ein Bildschirmfoto mit einem umlaufenden Rahmen.
  `--interactive` | Ein Fenster wird geöffnet, in welchem Sie vor der Aufnahme des Bildschirmfotos einige Einstellungen vornehmen können.
  `--help` | Zeigt Optionen für den Befehl an.

Wenn Sie ein Bildschirmfoto erstellen, wird der Dialog Bildschirmfoto aufnehmen geöffnet. Um ein Bildschirmfoto als Bilddatei zu speichern, geben Sie den Dateinamen ein, wählen den Speicherort aus der Aufklappliste und klicken anschließend auf Speichern. Wahlweise können Sie den Knopf In die Zwischenablage kopieren anklicken, um das Bild über die Zwischenablage durch Ziehen-und-Ablegen in eine andere Anwendung kopieren zu können.

## Yelp-Hilfebrowser

### Einführung

Die Anwendung Yelp-Hilfebrowser erlaubt Ihnen, die Dokumentation von GNOME und anderer Komponenten in einer Vielzahl von Formaten zu betrachten. Diese Formate sind DocBook, HTML-Hilfeseiten, Manpages und Infoseiten (die Unterstützung für Manpages und Infoseiten muss optional bei der Kompilierung von Yelp angegeben werden). Trotz der verschiedenen Formate versucht Yelp, die Dokumente in einer einheitlichen Ansicht darzustellen, unabhängig vom zugrunde liegenden Dokumentformat.

Der Yelp-Hilfebrowser ist internationalisiert, das bedeutet, dass Dokumente in verschiedenen Sprachen angezeigt werden können. Die Dokumente müssen zunächst übersetzt und an einem vorbestimmten Ort gespeichert werden, auf den Yelp zugreifen kann, um die Dokumente darzustellen.

### Yelp starten

#### So starten Sie den Yelp-Hilfebrowser.

Sie können Yelp-Hilfebrowser auf folgende Arten starten:

Menü System

- Wählen Sie Hilfe

Befehlszeile

- Führen Sie den folgenden Befehl aus: `yelp`

#### Benutzeroberfläche

Wenn Sie Yelp-Hilfebrowser starten, sehen Sie folgendes Fenster.

##### Yelp-Hilfebrowser-Fenster

Yelp-Hilfebrowser enthält die folgenden Elemente im fig-yelp-window

Menüleiste

- Datei

- Verwenden Sie dieses Menü, um ein neues Fenster oder die "Über dieses Dokument"-Seite zu öffnen, das aktuelle Dokument zu drucken oder das Fenster zu schließen.

Bearbeiten

- Verwenden sie dieses Menü zum Kopieren, alles auswählen, Suchen..., oder zum Ändern der Einstellungen.

Gehe zu

- Verwenden sie dieses Menü zurück, vor oder zur Hilfethemen-Seite zu navigieren. Wenn Sie ein DocBook-Dokument betrachten, können Sie auf diese Weise zum nächsten Abschnitt, zum vorhergehenden Abschnitt oder zu den Inhalten springen.

Lesezeichen

- Verwenden Sie dieses Menü, um Lesezeichen hinzuzufügen oder diese zu bearbeiten.

Hilfe

- Betrachten Sie die Informationen über den Yelp-Hilfebrowser und die Mitwirkenden am Projekt über den Menüeintrag Info. Öffnen Sie dieses Dokument über den Menüeintrag Inhalte oder durch Drücken von F1.

Werkzeugleiste

- Zurück

- Verwenden Sie diesen Knopf, um in der Dokumenten-Chronik zurück zu gehen.

Vor

- Verwenden Sie diesen Knopf, um in der Dokumenten-Chronik nach vorn zu gehen.

Hilfe-Themen

- Verwenden Sie diesen Knopf, um zum Haupt-Inhaltsverzeichnis zurück zu gehen (wie in fig-yelp-window).

Browseransicht

- In der Browseransicht wird das Inhaltsverzeichnis oder die Dokumentation selbst dargestellt. Verwenden Sie das Inhaltsverzeichnis, um zum gewünschten Dokument zu navigieren.

### Verwendung von Yelp

#### Ein Dokument öffnen

So öffnen Sie ein Dokument im Yelp-Hilfebrowser:

- Klicken Sie in einer Anwendung auf Hilfe Inhalte

- Verwenden Sie das Inhaltsverzeichnis, um zum gewünschten Dokument zu navigieren.

- Sie können eine DocBook-XML-Datei aus Nautilus in das Fenster des Hilfebrowsers oder einen Anwendungsstarter ziehen.

- Drücken Sie die Taste F1.

Alternativ können Sie ein einzelnes Dokument betrachten, indem Sie den Yelp-Hilfebrowser aus einer Befehlszeile aufrufen oder ein solches Dokument in das Yelp-Fenster ziehen und dort ablegen. Weitere Informationen finden Sie im Abschnitt yelp-open-specific.

#### Ein neues Fenster öffnen

So öffnen Sie ein neues Fenster:

- Wählen Sie Datei Neues Fenster.

- Drücken Sie Strg N.

#### Über dieses Dokument

So zeigen Sie Informationen über das aktuell geöffnete Dokument an:

- Wählen Sie Datei Informationen über dieses Dokument.

Diese Option ist nur für DocBook-Dokumentation verfügbar. In diesem Abschnitt werden die rechtlichen Hinweise und die Mitwirkenden an der Dokumentation angezeigt.

#### Eine Seite drucken

So drucken Sie eine beliebige Seite, die Sie im Yelp-Hilfebrowser betrachten können:

- Wählen Sie Datei Diese Seite drucken.

#### Ein Dokument drucken

So drucken Sie ein komplettes Dokument:

- Wählen Sie Datei Aktuelles Dokument drucken.

Diese Option ist nur für Dokumente im DocBook-Format verfügbar.

#### So schließen Sie ein Fenster

Um ein Fenster des Yelp-Hilferowsers zu schließen, gehen Sie wie folgt vor:

- Wählen Sie Datei Fenster schließen.

- Drücken Sie Strg W.

#### Einstellungen ändern

So ändern Sie die Einstellungen im Yelp-Hilferowser:

- Wählen Sie Bearbeiten Einstellungen.

Ein Fenster wie in yelp-preferences wird geöffnet:

##### Yelp-Hilfebrowser-Einstellungsfenster

Die Optionen dieses Dialogs haben die folgenden Funktionen:

Systemschrift verwenden

- Aktivieren Sie dieses Ankreuzfeld, um die Dokumentation in der von der GNOME-Arbeitsumgebung vorgegebenen Schrift darzustellen.

  Um eigene Schriften für die Dokumentation auszuwählen, deaktivieren Sie das Ankreuzfeld und klicken Sie auf die Knöpfe mit dem Text Variable Breite beziehungsweise Feste Breite.

  Variable Breite

- Diese Schrift wird verwendet, wenn eine Schrift mit statischer oder fester Breite nicht notwendig ist. Dies betrifft den größten Teil des Textes.

Feste Breite

- Diese Schrift wird verwendet, wenn alle Zeichen die gleiche Breite haben müssen. Üblicherweise wird eine solche Schrift zur Kennzeichnung von Befehlen, Programmcode-Blöcken oder anderen Texten verwendet, die unter diese Kategorien fallen.

Mit Textcursor navigieren

- Aktivieren Sie dieses Ankreuzfeld, wenn Sie einen Textcursor im yelp-browser-pane anzeigen lassen möchten. Dadurch können Sie das Dokument leichter durchsuchen, da immer ein Cursor im Dokument angezeigt wird.

#### In der Dokumentenchronik zurückgehen

So gehen Sie in der Dokumentenchronik zurück:

- Wählen Sie Gehe zu Zurück.

- Drücken Sie Alt Pfeiltaste links.

- Verwenden Sie den Zurück-Knopf in der Werkzeugleiste.

#### In der Dokumentenchronik vorgehen

So gehen Sie in der Dokumentenchronik vor:

- Wählen Sie Gehe zu Vor.

- Drücken Sie Alt Pfeiltaste rechts.

- Verwenden Sie den Vor-Knopf in der Werkzeugleiste.

#### Zu den Hilfethemen gehen

So gehen Sie zu den Hilfethemen:

- Wählen Sie Gehe zu Hilfe-Themen.

- Drücken Sie Alt Pos1.

- Verwenden Sie den Hilfe-Themen-Knopf in der Werkzeugleiste.

#### Zum vorherigen Abschnitt gehen

So gehen Sie zum vorherigen Abschnitt:

- Wählen Sie Gehe zu Vorheriger Abschnitt.

- Drücken Sie Alt Bild auf.

Diese Option ist nur in DocBook-formatierten Dokumenten verfügbar.

#### Zum nächsten Abschnitt gehen

So gehen Sie zum nächsten Abschnitt:

- Wählen Sie Gehe zu Nächster Abschnitt.

- Drücken Sie Alt Bild ab.

Diese Option ist nur in DocBook-formatierten Dokumenten verfügbar.

#### Zum Inhalt gehen

So gehen Sie zum Inhalt eines Dokuments:

- Wählen Sie Gehe zu Inhalte.

Diese Option ist nur in DocBook-formatierten Dokumenten verfügbar.

#### Lesezeichen hinzufügen

So fügen Sie ein Lesezeichen für ein bestimmtes Dokument hinzu:

- Wählen Sie Lesezeichen Lesezeichen hinzufügen.

- Drücken Sie Strg D.

Ein Fenster wie in yelp-add-bookmark wird geöffnet:

##### Lesezeichen-hinzufügen-Fenster

Geben Sie den gewünschten Titel des Lesezeichens in das Titel-Textfeld ein. Dann klicken Sie auf Hinzufügen, um das Kesezeichen hinzuzufügen, oder auf Abbrechen, um den Vorgang abzubrechen.

#### Lesezeichen bearbeiten

so bearbeiten Sie Ihre Lesezeichen-Sammlung:

- Wählen Sie Lesezeichen Lesezeichen bearbeiten.

- Drücken Sie Strg B.

Ein Fenster wie in yelp-edit-bookmarks wird geöffnet.

##### Lesezeichen-bearbeiten-Fenster

Sie haben folgende Möglichkeiten, Ihre Lesezeichen in diesem Fenster zu bearbeiten:

Öffnen

- Klicken Sie auf diesen Knopf, um das gewählte Lesezeichen in einem neuen Fenster zu öffnen.

Umbenennen

- Klicken Sie auf diesen Knopf, um den Titel des Lesezeichens zu ändern.

Entfernen

- Klicken Sie auf diesen Knopf, um das Lesezeichen aus der Sammlung zu entfernen.

Wenn Sie mit der Bearbeitung der Lesezeichen fertig sind, klicken Sie auf den Schließen-Knopf, um das Lesezeichen-hinzufügen-Fenster zu schließen.

#### Hilfe erhalten

So erhalten sie Hilfe mit dem Yelp-Hilfebrowser (und können das vorliegende Dokument betrachten):

- Klicken Sie auf Hilfe Inhalte

### Erweiterte Funktionen

#### Öffnen spezifischer Dokumente

##### Öffnen von Dateien im Dateimanager

Um ein Dokument, wie beispielsweise eine XML-Datei, im Dateimanager zu öffnen, öffnen Sie das Dokument im Nautilus-Dateimanager, oder ziehen Sie das Symbol aus Nautilus in das Yelp-Dokumentenfenster oder auf den Anwendungsstarter.

##### Verwendung der Befehlszeile zum Öffnen von Dokumenten

Yelp-Hilfebrowser unterstützt das Öffnen von Dokumenten in einer Befehlszeile. Eine Reihe von URI's (Uniform Resource Identifiers) steht dazu zur Verfügung. Diese sind:

`file:`

- Verwenden Sie diesen URI, wenn Sie mit Yelp auf eine Datei zugreifen möchten, zum Beispiel:

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

`ghelp:` oder `gnome-help:`

- Verwenden Sie diesen URI, wenn Sie auf GNOME-Hilfedokumente zugreifen möchten, welche typischerweise im DocBook-Format verfasst sind.

      yelp ghelp:gcalctool

  Wenn Sie ein Hilfedokument aus einer bestimmten Sektion öffnen möchten, hängen Sie eine Fragemarkierung ans Ende des URI's an, gefolgt von der Sektionskennung.

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

`man:`

- Verwenden Sie diesen URI, wenn Sie auf eine bestimmte Manpage zugreifen möchten. Sie können die Sektion der gewünschten Manpage anhängen, falls mehrere Manpages gleichen Namens existieren. Die Sektionskennung sollte in Klammern gesetzt werden, außerdem kann es nötig sein, das Argument zu markieren, so dass die Shell die Klammern nicht interpretiert.

      yelp man:gcalctool

  oder

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

`info:`

- Verwenden Sie diesen URI, um eine bestimmte GNU-Infoseite zu öffnen.

      yelp info:make

#### Inhalt bei Bedarf neu laden

Yelp-Hilfebrowser unterstützt die Strg R-Tastenkombination, mit der der Inhalt des aktuellen Dokuments neu geladen wird. Dies erlaubt Entwicklern, Änderungen im Dokument sofort anzeigen zu lassen.

### Weitere Informationen

Dieser Abschnitt zeigt einige der von Yelp-Hilfebrowser verwendeten Hilfsanwendungen sowie stellt Ressourcen bereit, über die Sie mehr Informationen über Yelp-Hilfebrowser erhalten können.

#### Scrollkeeper

Yelp-Hilfebrowser benutzt Scrollkeeper, um das Inhaltsverzeichnis für DocBook- und HTML-Dokumentationen zu erstellen und nach Übersetzungen für jedes Dokument zu suchen und diese ins Dokument einzubauen.

#### GNOME-Dokumentationswerkzeuge

Die mit GNOME mitgelieferte Dokumentation enthält eine Reihe von Werkzeugen für verschiedene Anwendungsfälle;

- Erleichterung der Übersetzung des Dokuments in verschiedene Sprachen.

- Stellt eine Reihe von Werkzeugen zur Paketierung und Installation von Dokumentationen an die korrekten Orte bereit, sowie zur Registrierung der Dokumentationen mittls Scrollkeeper.

- Wandelt das DocBook-Format in ein anzeigetaugliches Format um.

Yelp-Hilfebrowser ist für die Umwandlung von DocBook nach HTML abhängig von GNOME XSLT Stylesheets, um die Umwandlung von DocBook in HTML auszuführen. Die GNOME Documentation Build Utilities benötigen Anwendungsentwickler, um die Dokumentation in das Hilfesystem zu integrieren und dort zu registrieren.

#### Homepage und Mailingliste

Für weitere Informationen über den Yelp-Hilfebrowser besuchen Sie bitte die Homepage des Dokumentationsprojekts, http://live.gnome.org/Yelp, oder melden Sie sich an der Mailingliste an, gnome-doc-devel-list@gnome.org.

### Unterstützen des GNOME-Dokumentationsprojekts

Wenn Sie daran interesssiert sind, Dokumentationen für das GNOME-Projekt zu erstellen oder zu aktualisieren, besuchen Sie bitte dessen Homepage: http://live.gnome.org/DocumentationProject