# Gedit-Handbuch

2007
GNOME-Dokumentationsprojekt
2002
2003
2004
Sun Microsystems
2000
Eric Baudais
2007
Jan Arne Petersen (jap@gnome.org)
GNOME-Dokumentationsprojekt
GNOME-Dokumentationsprojekt
GNOME
Hal
Canary
Fügte die Tabelle der Tastenkombinationen hinzu
Sun Java-Desktop-System-Dokumentationsteam
Sun Microsystems

    gdocteam@sun.com

Eric
Baudais
GNOME-Dokumentationsprojekt

     baudais@okstate.edu

Baris
Cicek hat Informationen aus früheren Revisionen von gedit beigetragen.
Danksagungen
Ajit
George für Informationen zu Plugins.
Danksagungen
gedit V1.0
2000

Eric Baudais baudais@okstate.edu

GNOME-Dokumentationsprojekt

gedit-Handbuch V2.0
März 2002

Sun GNOME Dokumentationsteam

GNOME-Dokumentationsprojekt

gedit-Handbuch V2.1
Juni 2002

Sun GNOME Dokumentationsteam

GNOME-Dokumentationsprojekt

gedit-Handbuch V2.2
August 2002

Sun GNOME Dokumentationsteam

GNOME-Dokumentationsprojekt

gedit-Handbuch V2.3
September 2002

Sun GNOME Dokumentationsteam

GNOME-Dokumentationsprojekt

gedit-Handbuch V2.4
Januar 2003

Sun GNOME Dokumentationsteam

GNOME-Dokumentationsprojekt

gedit-Handbuch V2.5
März 2003

Sun GNOME Dokumentationsteam

GNOME-Dokumentationsprojekt

gedit-Handbuch V2.6
September 2003

Sun GNOME Dokumentationsteam

GNOME-Dokumentationsprojekt

gedit-Handbuch V2.7
März 2004

Sun GNOME Dokumentationsteam

GNOME-Dokumentationsprojekt

gedit-Handbuch V2.8
Juli 2006

Sun Java-Desktop-System-Dokumentationsteam

GNOME-Dokumentationsprojekt

gedit-Handbuch V2.9
Juli 2006

GNOME-Dokumentationsteam

GNOME-Dokumentationsprojekt

In diesem Handbuch wird Version 2.16 von gedit beschrieben.

## Feedback

Wenn Sie Fehler finden oder Vorschläge zur Anwendung gedit oder zu diesem Handbuch haben, folgen Sie den Anweisungen auf der GNOME Feedback Page.

gedit ist der GNOME-Texteditor

## Einführung

Die Anwendung gedit erlaubt es Ihnen Textdateien zu erstellen und zu bearbeiten.

Die Absicht von gedit ist es, ein schlichter und einfach zu verwendendet Texteditor zu sein. Leistungsfähigere Funktionen, die eine Vielzahl von Aufgaben im Zusammenhang mit Textbearbeitung erfüllen, können durch verschiedene Plugins aktiviert werden.

## Erste Schritte

### Gedit starten

Sie können gedit auf eine der folgenden Weisen starten:

Anwendungen-Menü

  Wählen Sie Zubehör Texteditor.

Befehlszeile

  Führen Sie den folgenden Befehl aus: `gedit`

Wenn Sie ein Textdokument im Dateimanager öffnen, wird standardmäßig gedit gestartet und das Dokument angezeigt.

### Das gedit-Fenster

Wenn Sie gedit starten, wird folgendes Fenster angezeigt:

#### gedit-Fenster

Zeigt das gedit-Hauptfenster an.

Das gedit-Fenster enthält folgende Elemente:

Menüleiste

  Die Menüs in der Menüleiste enthalten alle Befehle, die Sie zum Arbeiten mit Dateien in gedit benötigen.

Werkzeugleiste

  Die Werkzeugleiste enthält einen Teil der Befehle, die Sie über die Menüleiste aufrufen können.

Anzeigebereich

  Der Anzeigebereich enthält den Text der Datei, die Sie bearbeiten.

Statusleiste

  In der Statusleiste werden Informationen über die aktuelle gedit-Aktivität und Kontextinformationen über die Menüpunkte angezeigt. Die Statusleiste zeigt auch folgende Informationen an:

  - Position des Cursors: Die Nummer der Zeile und Spalte, in der sich der Cursor befindet.

  - Bearbeitungsmodus: Wenn der Einfügemodus aktiviert ist, wird in der Statusleiste EIN angezeigt. Ist der Überschreibmodus aktiviert, wird in der Statusleiste ÜBS angezeigt. Drücken Sie die Einfg-Taste um den Bearbeitungsmodus zu ändern.

Seitenleiste

  In der Seitenleiste wird eine Liste von offenen Dokumenten und, abhängig von den aktiven Plugins, andere Informationen angezeigt.

  Standardmäßig wird die Seitenleiste nicht angezeigt. Wählen Sie Ansicht Seitenleiste um sie anzuzeigen.

Fußleiste

  Die Fußleiste wird von Programmierwerkzeugen, wie dem Python-Konsole-Plugin, verwendet um Ausgaben anzuzeigen. Standardmäßig wird sie nicht angezeigt.

Wenn Sie mit der rechten Maustaste auf das gedit-Fenster klicken, wird ein Kontextmenü angezeigt. Das Kontextmenü enthält die gängigsten Textbearbeitungsbefehle.

Wie andere GNOME-Anwendungen auch, könnenn Sie Befehle in gedit in unterschiedlicher Weise ausführen: mit dem Menü, mit der Werkzeugleiste oder mit Tastenkombinationen. Von allen Anwendungen verwendete Tastenkombinationen sind im Benutzerhandbuch aufgeführt.

### Gedit aus der Befehlszeile ausführen

Sie können gedit über eine Befehlszeile ausführen und eine oder mehrere Dateien öffnen. Zum Öffnen mehrerer Dateien über eine Befehlszeile geben Sie den folgenden Befehl ein und drücken anschließend die Eingabetaste:

`gedit Datei1.txt Datei2.txt Datei3.txt`

Alternativ können Sie einen URI anstelle eines Dateinamens verwenden.

Weitere Informationen zur Ausführung von gedit aus der Befehlszeile finden Sie in der Unix-Handbuchseite zu gedit: gedit 1.

## Mit Dateien arbeiten

### Eine neue Datei anlegen

Um eine neue Datei anzulegen, wählen Sie Datei Neu. Eine neue Datei wird im gedit-Fenster angezeigt.

### Eine Datei öffnen

Wenn Sie eine Datei öffnen möchten, wählen Sie Datei Öffnen, um das Dialogfeld Datei öffnen anzuzeigen. Wählen Sie die zu öffnende Datei aus, und klicken Sie auf Öffnen. Die Datei wird im gedit-Fenster angezeigt.

Die Anwendung zeichnet die Pfade und Dateinamen der fünf zuletzt bearbeiteten Dateien auf und zeigt die Dateien als Menüpunkte im Menü Datei an. Alternativ können Sie auch auf den Knopf Zuletzt geöffnete Dateien anzeigen (Menüsymbol) in der Werkzeugleiste klicken, um die Liste der zuletzt geöffneten Dateien anzuzeigen.

Sie können mehrere Dateien in gedit öffnen. Für jede geöffnete Datei wird ein Reiter in das Fenster eingefügt. Weitere Informationen dazu finden Sie unter .

### Eine Datei speichern

Sie können Dateien in einer der folgenden Weisen speichern:

- Um Änderungen einer vorhandene Datei zu speichern, wählen Sie Datei Speichern.

- Um eine neue Datei zu speichern oder eine vorhandene Datei unter einem neuen Dateinamen zu speichern, wählen Sie Datei Speichern unter. Geben Sie im Dialogfeld Speichern unter einen Namen für die Datei ein, und klicken Sie auf Speichern.

- Wenn Sie alle Dateien speichern möchten, die gerade in gedit geöffnet sind, wählen Sie Dokumente Alle speichern.

Wenn Sie alle Dateien schließen möchten, die gerade in gedit geöffnet sind, wählen Sie Dokumente Alle schließen.

### Eine Datei über einen URI öffnen

Führen Sie zum Öffnen einer Datei über einen URI (Uniform Resource Identifier) die folgenden Schritte aus:

1. Wählen Sie Datei Ort öffnen, um das Dialogfeld Ort öffnen anzuzeigen.

2. Geben Sie den URI von der Datei die Sie öffnen möchten ein.

3. Verwenden Sie die Zeichenkodierung-Einblendliste um die passende Zeichenkodierung auszuwählen.

4. Klicken Sie auf Öffnen.

Zu den zulässigen Typen für URI gehören `http:`, `ftp:`, `file:` sowie alle anderen von `gnome-vfs` unterstützten Methoden.

Files from some types of URI are opened as read-only, and any changes you make must be saved to a different location. HTTP only allows files to be read. Files opened from FTP are read-only because because not all FTP servers may correctly work with saving remote files.

Saving to FTP servers can be enabled with Configuration Editor, setting the key /apps/gedit-2/preferences/editor/save/writable_vfs_schemes, but this may cause errors.

### Mit Reitern arbeiten

Wenn mehr als eine Datei geöffnet wird, zeigt gedit einen Reiter für jedes Dokument über dem Anzeigebereich. Klicken Sie auf den entsprechenden Reiter um zu einem anderen Dokument zu wechseln.

Um ein Dokument in ein anderes gedit-Fenster zu bewegen, ziehen sie den zur Datei gehörenden Reiter in das Fenster, in welches Sie die Datei verschieben möchten.

To move a document to a new gedit window, either drag its tab to the desktop, or choose Documents Move to New Window .

## Mit Text arbeiten

### Text bearbeiten

Sie können den Text einer Datei auf eine der folgenden Weisen bearbeiten:

- Type new text from the keyboard. The blinking insertion cursor marks the point where new text appears. To change this, use the arrow keys on the keyboard or click with the mouse.

- Um den ausgewählten Text in die Zwischenablage zu kopieren, wählen Sie Bearbeiten Kopieren.

- Wenn Sie den markierten Text aus der Datei löschen und in die Zwischenablage verschieben möchten, wählen Sie Bearbeiten Ausschneiden.

- Um den markierten Text dauerhaft aus der Datei zu löschen, wählen Sie Bearbeiten Löschen.

- Um den Inhalt der Zwischenablage an der Cursorposition einzufügen, wählen Sie Bearbeiten Einfügen. Sie müssen zunächst Text ausschneiden oder kopieren, bevor Sie ihn aus dem Puffer in die Datei einfügen können.

- Um den gesamten Text einer Datei zu markieren, wählen Sie Bearbeiten Alles markieren.

### Änderungen rückgängig machen oder wiederholen

To undo a change you have made, choose Edit Undo . To reverse this action, choose Edit Redo .

## Suchen und Ersetzen

In gedit, there are two ways of searching for text. You can use the Find dialog to search for a specific piece of text, or Incremental Search to highlight matching text as you type it.

### Nach Text suchen

Führen Sie zum Durchsuchen einer Datei nach einem Text folgende Schritte aus:

1. Wählen Sie Suchen Suchen, um das Dialogfeld Suchen anzuzeigen.

2. Geben Sie den Text, nach dem Sie suchen möchten, in das Feld Suchen nach ein. Sie können auch Sonderzeichen wie Neue Zeile oder Tabulator eingeben: Information dazu finden Sie unter .

3. Klicken Sie auf Suchen, um nach dem ersten Auftreten des Textes nach der aktuellen Cursor-Postion zu suchen. Wenn gedit den Text findet wird der Text markiert. Andere Vorkommen des Textes werden hervorgehoben.

4. To find the next occurrence of the string, click Find or choose Search Find Next . To find the previous occurrence of the text, choose Search Find Previous .

After you have closed the Find dialog, you can still move the selection to other occurrences of the text by choosing Search Find Next and Search Find Previous .

To remove the highlighting from the text, choose Search Clear Highlight .

### Incremental Search

Incremental search highlights matching text in the document as you type it letter by letter. (This is similar to the search feature in several web browsers.)

To start an incremental search, choose Search Incremental Search . The search box appears at the top of the display area.

Begin typing, and text that matches will be highlighted in the document. The first instance after the cursor position is also selected.

To advance the selection to the next match while keeping the incremental search box open, press Ctrl G. Press Ctrl Shift G to go back to the previous match.

You can also use the up and down arrow keys or the mouse wheel to move the selection between matches.

### Replacing Text

Wenn Sie nach einer Zeichenkette suchen und diese durch eine andere Zeichenkette ersetzen möchten, gehen Sie folgendermaßen vor:

1. Wählen Sie Suchen Ersetzen, um das Dialogfeld Ersetzen anzuzeigen.

2. Type the string that you want to find, in the Search for field. You can include special characters such as a new line or tab: see .

3. Geben Sie die Zeichenkette, durch die die gefundene Zeichenkette ersetzt werden soll, in das Feld Ersetzen durch ein.

To examine each occurrence of the string before replacing it, click Find. If gedit finds the string, the application selects the string. Click Replace to replace the selected occurrence of the string. To find the next occurrence of the string, click Find again.

To replace all occurrences of the string throughout the document, click Replace All.

### Optionen zum Suchen und Ersetzen

Sowohl im Dialogfeld Suchen als auch im Dialogfeld Ersetzen können Sie die folgenden Optionen festlegen:

- Wählen Sie die Option Groß-/Kleinschreibung berücksichtigen, um nur nach Text zu suchen, der in Groß- und Kleinschreibung mit dem eingegebenen Text übereinstimmt. Zum Beispiel wird mit aktivierten Groß-/Kleinschreibung berücksichtigen "TEXT" nicht in "text" gefunden.

- Wählen Sie die Option Nur vollständige Wörter berücksichtigen, um nur nach Wörtern zu suchen, die den eingegebenen Text in Form vollständiger Wörter enthalten. Zum Beispiel wird mit aktivierten Nur vollständige Wörter berücksichtigen "Text" nicht in "Textur" gefunden.

- Wählen Sie die Option Rückwärts suchen, um Rückwärts in Richtung des Dokumentanfangs zu suchen.

- Wählen Sie die Option Suchen beim Erreichen des Endes am Anfang fortsetzen, um die Suche am anderen Ende des Dokuments fortzusetzen, wenn bei der Suche das Dokumentende oder der Dokumentanfang erreicht wird.

### Sonderzeichen

Sie können folgende Escape-Sequenzen in den zu suchenden oder zu ersetzenden Text einfügen um folgende Sonderzeichen zu verwenden:

`\n`

  Steht für einen Zeilenumbruch.

`\t`

  Steht für einen Tabulator.

`\r`

  Steht für einen Wagenrücklauf.

### Den Cursor in eine bestimmte Zeile setzen

Um den Cursor in eine bestimmten Zeile in der aktuellen Datei zu setzen, wählen Sie Suchen Gehe zu Zeile. Das Zeilennummerfeld erscheint oberhalb des Anzeigebereichs.

Sobald Sie die Nummer der Zeile eingeben, in die der Cursor verschoben werden soll wird die entsprechende Zeile des Dokument angezeigt.

Um das Feld zu schließen und den Cursor in die eingegebene Zeile zu setzen, drücken Sie die Eingabetaste.

## Drucken

### Setting the Page Options

To set the page options, choose File Page Setup to display the Page Setup dialog.

The Page Setup dialog enables you to specify the following print options:

#### General Tabbed Section

Print syntax highlighting

  Select this option to print syntax highlighting. For more information about syntax highlighting, see .

Seitenkopfzeilen drucken

  Wählen Sie diese Option, um auf jeder gedruckten Seite eine Kopfzeile einzufügen. Die Kopfzeile kann nicht konfiguriert werden.

Zeilennummern

  Select the Print line numbers option to include line numbers when you print a file.

  Use the Number every ... lines spin box to specify how often to print the line numbers, for example every 5 lines, every 10 lines, and so on.

Text Wrapping

  Select the Enable text wrapping option to wrap text onto the next line, at a character level, when you print a file. The application counts wrapped lines as one line for line numbering purposes.

  Select the Do not split words over two lines option to wrap text onto the next line, at a word level, when you print a file.

#### Schrift

Rumpf

  Klicken Sie auf diese Schaltfläche, um die Schriftart für den Fließtext einer Datei auszuwählen.

Zeilennummern

  Click on this button to select the font to use to print line numbers.

Headers and footers

  Click on this button to select the font to use to print the headers and footers in a file.

To reset the fonts to the default fonts for printing a file from gedit, click Restore Default Fonts.

### Printing a Document

Mit gedit können Sie die folgenden Druckvorgänge ausführen:

- Print a document to a printer.

- Den Druckbefehl an eine Datei ausgeben

Wenn Sie in eine Datei drucken, sendet gedit die Ausgabe der Datei in eine Datei mit Druckvorstufenformat. Die am meisten verbreiteten Formate der Druckvorstufe sind PostScript und PDF (Portable Document Format).

Um eine Vorschau der auszudruckenden Seiten zu erhalten, wählen Sie Datei Druckvorschau.

Wenn Sie die aktuelle Datei auf einen Drucker oder in eine Datei ausgeben möchten, wählen Sie Datei Drucken, um das Dialogfeld Drucken zu öffnen.

Im Dialogfeld Drucken können Sie die folgenden Druckoptionen festlegen:

#### Job Tabbed Section

Druckbereich

  Wählen Sie eine der folgenden Optionen, um die Anzahl der zu druckenden Seiten festzulegen:

  - Alle

    Wählen Sie diese Option, um sämtliche Seiten der Datei zu drucken.

  - Lines

    Select this option to print the specified lines only. Use the From and To spin boxes to specify the line range.

  - Markierung

    Wählen Sie diese Option, um nur den markierten Text auszudrucken. Diese Option ist nur verfügbar, wenn Sie Text markiert haben.

Copies

  Use the Number of copies spin box to specify the number of copies of the file that you want to print.

  If you print multiple copies of the file, select the Collate option to collate the printed copies.

#### Registerkartenbereich "Drucker"

Printer

  Use this drop-down list to select the printer to which you want to print the file.

Settings

  Use this drop-down list to select the printer settings.

  To configure the printer, click Configure. For example, you can enable or disable duplex printing, or schedule delayed printing, if this functionality is supported by the printer.

Location

  Use this drop-down list to select one of the following print destinations:

  CUPS

    Print the file to a CUPS printer.

    If the selected printer is a CUPS printer, CUPS is the only entry in this drop-down list.

  lpr

    Print the file to a printer.

  Datei

    Print the file to a PostScript file.

    Click Save As to display a dialog where you specify the name and location of the PostScript file.

  Custom

    Use the specified command to print the file.

    Type the name of the command in the text box. Include all command-line arguments.

State

  This functionality is not supported in this version of gedit.

Type

  This functionality is not supported in this version of gedit.

Comment

  This functionality is not supported in this version of gedit.

#### Reiter "Papier"

Papierformat

  Legen Sie mit dieser Einblendliste das Format des Papiers fest, auf dem die Datei gedruckt werden soll.

Breite

  Legen Sie mithilfe des Drehfeldes die Papierbreite fest. Über die danebenstehende Einblendliste können Sie die Maßeinheit einstellen.

Höhe

  Legen Sie mithilfe dieses Drehfeldes die Höhe des Papiers fest.

Einzugsausrichtung

  Mit dieser Einblendliste geben Sie an, wie das Papier im Drucker ausgerichtet ist.

Papierausrichtung

  Wählen Sie mithilfe dieser Einblendliste die Papierausrichtung aus.

Layout

  Wählen Sie mithilfe dieser Einblendliste das Seitenlayout aus. Eine Vorschau des gerade ausgewählten Layouts wird im Bereich Vorschau angezeigt.

Papiereinzug

  Wählen Sie mithilfe dieser Einblendliste den Papiereinzug aus.

## Programmierfunktionen

Several of gedit's features for programming are provided with plugins. For example, the Tag List plugin provides a list of commonly-used tags for different markup languages: see .

### Syntax Highlighting

Syntax highlighting makes source code easier to read by showing different parts of the text in different colors.

gedit chooses an appropriate syntax highlighting mode based on a document's type. To override the syntax highlighting mode, choose View Highlight Mode , then choose one of the following menu items:

Normal

  Do not display any syntax highlighting.

Sources

  Display syntax highlighting to edit source code. Use the Sources submenu to select the source code type.

Markup

  Display syntax highlighting to edit markup code. Use the Markup submenu to select the markup code type.

Scripts

  Display syntax highlighting to edit script code. Use the Scripts submenu to select the script code type.

Others

  Display syntax highlighting to edit other types of code. Use the Others submenu to select the code type.

For more information about how to configure syntax highlighting, see .

### Piping the Output of a Command to a File

You can use gedit to pipe the output of a command to a text file. For example, to pipe the output of an `ls` command to a text file, type `ls | gedit`, then press Return.

Die Ausgabe des Befehls `ls` wird im gedit-Fenster in einer neuen Textdatei angezeigt.

Alternatively, you can use the External tools plugin to pipe command output to the current file.

## Tastenkombinationen

Use shortcut keys to perform common tasks more quickly than with the mouse and menus. The following tables list all of gedit's shortcut keys.

For more on shortcut keys, see the Desktop User Guide.

Reiter

Tastenkombinationen für Reiter:

Tastenkombination | Befehl
--- | ---
Strg + Alt + Bild_Ab | Aktiviert den vorherigen Reiter.
Strg + Alt + Bild_Ab | Aktiviert den nächsten Reiter.
Strg + W | Schließt den Reiter.
Umschalt + Strg + L | Alle Reiter speichern.
Umschalt + Strg + W | Alle Reiter schließen.
Alt + n | Den n-ten Reiter aktivieren.

Dateien

Tastenkombinationen zum Arbeiten mit Dateien:

Tastenkombination | Befehl
--- | ---
Strg + N | Eine neues Dokument anlegen.
Strg + O | Ein Dokument öffnen.
Strg + L | Einen Ort öffnen.
Strg + S | Das aktuelle Dokument auf die Festplatte speichern.
Umschalt + Strg + S | Das aktuelle Dokument unter einem anderen Dateinamen speichern.
Strg + P | Das aktuelle Dokument drucken.
Umschalt + Strg + P | Druckvorschau.
Strg + W | Das aktuelle Dokument schließen.
Strg + Q | Gedit beenden.

Bearbeiten

Tastenkombinationen zum Bearbeiten von Dokumenten:

Tastenkombination | Befehl
--- | ---
Strg + Z | Letzten Vorgang rückgängig machen.
Umschalt + Strg + Z | Den rückgängig gemachten Vorgang wiederholen.
Strg + X | Den markierten Text oder die markierte Region ausschneiden und in die Zwischenablage verschieben.
Strg + C | Den markierten Text oder die markierte Region in die Zwischenablage kopieren.
Strg + V | Den Inhalt der Zwischenablage einfügen.
Strg + A | Alles markieren.

Leisten

Tastenkombinationen zum Anzeigen und Verbergen von Leisten:

Tastenkombination | Befehl
--- | ---
F9 | Die Seitenleiste anzeigen/verbergen.
Strg + F9 | Die Fußleiste anzeigen/verbergen.

Suchen

Tastenkombinationen zum Suchen:

Tastenkombination | Befehl
--- | ---
Strg + F | Einen Text suchen.
Strg + G | Das nächste Vorkommen des gleichen Textes suchen.
Umschalt + Strg + G | Das vorherige Vorkommen des gleichen Textes suchen.
Strg + K | Inkrementelle Suche.
Strg + H | Suchen und ersetzen.
Umschalt + Strg + K | Hervorhebung zurücksetzen.
Strg + I | Zu einer bestimmten Zeile gehen.

Werkzeuge

Tastenkombinationen für Werkzeuge:

Tastenkombination | Befehl
--- | ---
Umschalt + F7 | Rechtschreibprüfung (mit Plugin).
Alt + F12 | Remove trailing spaces (with plugin).
Strg + T | Einzug erhöhen (mit Plugin).
Umschalt + Strg + T | Einzug vermindern (mit Plugin).
F8 | "make" im aktuellen Verzeichnis ausführen (mit Plugin).
Umschalt + Strg + D | Verzeichnisinhalt anzeigen (mit Plugin).

Hilfe

Tastenkombinationen für Hilfe:

Tastenkombination | Befehl
--- | ---
F1 | Das gedit-Handbuch öffnen.

## Einstellungen

Um gedit zu konfigurieren, wählen Sie Bearbeiten Einstellungen. Das Dialogfeld Einstellungen enthält die folgenden Kategorien:

### Ansicht-Einstellungen

Text Wrapping

  Select the Enable text wrapping option to have long lines of text flow into paragraphs instead of running off the edge of the text window. This avoids having to scroll horizontally

  Select the Do not split words over two lines option to have the text wrapping option preserve whole words when flowing text to the next line. This makes text easier to read.

Zeilennummern

  Select the Display line numbers option to display line numbers on the left side of the gedit window.

Current Line

  Select the Highlight current line option to highlight the line where the cursor is placed.

Right Margin

  Select the Display right margin option to display a vertical line that indicates the right margin.

  Use the Right margin at column spin box to specify the location of the vertical line.

Bracket Matching

  Select the Highlight matching bracket option to highlight the corresponding bracket when the cursor is positioned on a bracket character.

### Editor Preferences

Reiter

  Use the Tab width spin box to specify the width of the space that gedit inserts when you press the Tab key.

  Select the Insert spaces instead of tabs option to specify that gedit inserts spaces instead of a tab character when you press the Tab key.

Auto Indentation

  Select the Enable auto indentation option to specify that the next line starts at the indentation level of the current line.

File Saving

  Select the Create a backup copy of files before saving option to create a backup copy of a file each time you save the file. The backup copy of the file contains a ~ at the end of the filename.

  Select the Autosave files every ... minutes option to automatically save the current file at regular intervals. Use the spin box to specify how often you want to save the file.

### Font & Colors Preferences

Font

  Select the Use default theme font option to use the default system font for the text in the gedit text window.

  The Editor font field displays the font that gedit uses to display text. Click on the button to specify the font type, style, and size to use for text.

Colors

  Select the Use default theme colors option to use the default theme colors in the gedit text window.

  Click on the Normal text color color button to display the color selector dialog. Select a color to use to display normal text in the gedit text window.

  Click on the Background color color button to display the color selector dialog. Select a background color for the gedit text window.

  Click on the Selected text color color button to display the color selector dialog. Select a color to use to display selected text.

  Click on the Selection color color button to display the color selector dialog. Select a background color to use to highlight a text selection.

### Syntax Highlighting Preferences

Enable syntax highlighting

  Select this option to highlight the syntax of the text that you edit.

Highlight mode

  Use this drop-down list to select a syntax mode to configure.

Elements

  Use this list box to select a syntax element to configure.

Format buttons

  Use the following buttons to change the format of the selected syntax element:

  Schaltfläche | Format
  --- | ---
  Shows icon for bold format. | Bold
  Shows icon for italic format. | Italic
  Shows icon for underline. | Underline
  Shows icon for strikethrough. | Strikethrough

Foreground

  Select this option to change the font color of the selected syntax element. Click on the color button to display the color selector dialog, then select the font color.

Background

  Select this option to change the background color of the selected syntax element. Click on the color button to display the color selector dialog, then select the background color.

Reset to Default

  Click on this button to reset the foreground color and background color of the selected syntax element to the default values.

### Plugins Preferences

Plugins add extra features to gedit. For more information on plugins and how to use the built-in plugins, see .

#### Enabling a Plugin

To enable a gedit plugin, perform the following steps:

1. Wählen Sie Bearbeiten Einstellungen.

2. Select the Plugins tab.

3. Select the check box next to the name of the plugin that you want to enable.

4. Click Close to close the Preferences dialog.

#### Disabling a Plugin

A plugin remains enabled when you quit gedit.

To disable a gedit plugin, perform the following steps:

1. Wählen Sie Bearbeiten Einstellungen.

2. Select the Plugins tab.

3. Deselect the check box next to the name of the plugin that you want to disable.

4. Click Close to close the Preferences dialog.

## Plugins

### Arbeiten mit Plugins

You can add extra features to gedit by enabling plugins. A plugin is a supplementary program that enhances the functionality of an application. Plugins add new items to the gedit menus for the new features they provide.

Several plugins come built-in with gedit, and you can install more. The gedit website lists third-party plugins.

To enable and disable plugins, or see which plugins are currently enabled, use the Plugins Preferences.

The following plugins come built-in with gedit:

- Change Case allows you to change the case of the selected text.

- Document Statistics shows the number of lines, words, and characters in the document.

- External Tools allows you to execute external commands from gedit.

- File Browser allows you to browse your files and folders in the side pane.

- Indent Lines adds or removes indentation from the selected lines.

- Insert Date/Time adds the current date and time into a document.

- Modelines allows you to set editing preferences for individual documents, and supports Emacs, Kate and Vim-style modelines.

- Python Console allows you to run commands in the python programming language.

- Snippets allows you to store frequently-used pieces of text and insert them quickly into a document.

- Sort arranges selected lines of text into alphabetical order.

- Spell Checker corrects the spelling in the selected text, or marks errors automatically in the document.

- Tag List lets you insert commonly-used tags for HTML and other languages from a list in the side pane.

- User Name inserts the username of the current user into the document.

### Change Case Plugin

The Change Case plugin changes the case of the selected text.

The following items are added to the Edit menu when the Change Case plugin is enabled:

Menu Item | Action | Example
--- | --- | ---
Bearbeiten Change Case All Upper Case | Change each character to uppercase. | `This text` becomes `THIS TEXT`
Bearbeiten Change Case All Lower Case | Change each character to lowercase. | `This Text` becomes `this text`
Bearbeiten Change Case Invert Case | Change each lowercase character to uppercase, and change each uppercase character to lowercase. | `This Text` becomes `tHIS tEXT`
Bearbeiten Change Case Title Case | Change the first character of each word to uppercase. | `this text` becomes `This Text`

### Plugin "Statistik zum Dokument"

The Document Statistics plugin counts the number of lines, words, characters with spaces, characters without spaces, and bytes in the current file. The plugin displays the results in a Document Statistics dialog. To use the Document Statistics plugin, perform the following steps:

1. Choose Tools Document Statistics to display the Document Statistics dialog. The Document Statistics dialog displays the following information about the file:

   - Die Anzahl der Zeilen im aktuellen Dokument

   - Die Anzahl der Wörter im aktuellen Dokument

   - Die Anzahl der Zeichen im aktuellen Dokument (einschließlich Leerzeichen)

   - Die Anzahl der Zeichen im aktuellen Dokument (ohne Leerzeichen)

   - Die Anzahl der Bytes im aktuellen Dokument

2. You can continue to update the gedit file while the Document Statistics dialog is open. To refresh the contents of the Document Statistics dialog, click Update.

### External Tools Plugin

The External Tools plugin allows you to execute external commands from gedit. You can pipe some content into a command and exploit its output (for example, sed), or launch a predefined command (for example, make).

Use the External Tools Manager to create and edit commands. To run an external command, choose it from the Tools menu.

#### Built-in Commands

The following commands are provided with the External Tools plugin:

Build

  Runs make in the current document's directory.

Directory Listing

  Lists the contents of the current document's directory in a new document.

Environment Variables

  Displays the environment variables list in the bottom pane.

Grep

  Searches for a term in all files in the current document directory, using pattern matching. Results are shown in the bottom pane.

Remove Trailing Spaces

  Removes all spaces from the end of lines in the document.

#### Defining a Command

To add an external command, choose Tools External Tools.

In the External Tools Manager window, click New. You can speficy the following details for the new command:

Beschreibung

  This description is shown in the statusbar when the menu command is chosen.

Accelerator

  Enter a keyboard shortcut for the command.

Commands

  The actual commands to be run. Several gedit environment variables can be used to pass content to these commands: see .

Input

  The content to give to the commands (as stdin): the entire text of the current document, the current selection, line, or word.

Output

  What to do with the output of the commands: display in the bottom pane, put in a new document, or place in the current document, at the end, at the cursor position, or replacing the selection or the entire document.

Applicability

  Determines which sort of documents can be affected by the command, for example whether saved or not, and local or remote.

#### Editing and Removing Tools

To edit a tool, select it in the list and make changes to its properties.

To rename a tool, click it again in the list.

To restore a built-in tool that you have changed, press Revert.

To remove a tool, select it in the list and press Remove. You can not remove built-in tools, only those you have created yourself.

#### Variables

You can use the following variables in the Commands field of the command definition:

- GEDIT_CURRENT_DOCUMENT_URI

- GEDIT_CURRENT_DOCUMENT_NAME

- GEDIT_CURRENT_DOCUMENT_SCHEME

- GEDIT_CURRENT_DOCUMENT_PATH

- GEDIT_CURRENT_DOCUMENT_DIR

- GEDIT_DOCUMENTS_URI

- GEDIT_DOCUMENTS_PATH

### File Browser Plugin

The File Browser Plugin shows your files and folders in the side pane, allowing you to quickly open files.

To view the File Browser, choose View Side Pane and then click on the tab showing the File Browser icon at the bottom of the side pane.

#### Browsing your Files

The File Browser tab initially shows your file manager bookmarks. To browse the contents of any item, double-click it.

To show a parent folder, choose from the drop-down list, or press the up arrow on the File Browser's toolbar.

To show the folder that contains the document you are currently working on, right-click in the file list and choose Set root to active document.

#### Eine Datei öffnen

To open a file in gedit, double-click it in the file list.

#### Creating Files and Folders

To create a new, empty text file in the current folder shown in the browser, right-click in the file list and choose New File.

To create a new folder in the current folder shown in the browser, right-click in the file list and choose New Folder.

### Plugin "Zeilen einrücken"

The Indent Lines plugin adds or removes space from the beginning of lines of text.

To indent or unindent text, perform the following steps:

1. Wählen Sie die Zeilen aus, deren Einzug Sie ändern möchten. Um den Einzug einer einzelnen Zeile zu ändern, setzen Sie den Cursor einfach an eine beliebige Stelle in dieser Zeile.

2. - To indent the text, choose Edit Indent .

   - To remove the indentation, choose Edit Unindent .

The amount of space used, and whether tab character or space characters are used, depends on the Tab Stops settings in the Editor Preferences: see .

### Plugin "Datum/Uhrzeit einfügen"

The Insert Date/Time plugin inserts the current date and time into a document. To use the Insert Date/Time plugin, perform the following steps:

1. Wählen Sie Bearbeiten Datum/Uhrzeit einfügen.

   If you have not configured the Insert Date/Time plugin to automatically insert the date/time without prompting you for the format, gedit displays the Insert Date and Time dialog. Select the appropriate date/time format from the list. Click Insert to close the Insert Date and Time dialog. gedit inserts the date/time at the cursor position in the current file.

   If you have configured gedit to use one particular date/time format, the Insert Date and Time dialog is not displayed. The date/time is automatically entered at the cursor position in the current file.

#### Configuring the Insert Date/Time Plugin

Um das Plugin "Datum/Uhrzeit einfügen" zu konfigurieren, gehen Sie wie folgt vor:

1. Wählen Sie Bearbeiten Einstellungen.

2. Select the Plugins tab.

3. Wählen Sie das Plugin Datum/Uhrzeit einfügen.

4. Click Configure Plugin to display the Configure insert date/time plugin dialog.

5. Wählen Sie eine der folgenden Optionen aus:

   - Wenn Sie beim Einfügen von Datum und Uhrzeit jedes Mal nach dem gewünschten Format gefragt werden möchten, wählen Sie die Option Nach dem Format fragen.

   - Wenn Sie hingegen möchten, dass gedit bei jedem Einfügen automatisch ein bestimmtes Format für Datum und Uhrzeit verwendet, so aktivieren Sie die Option Folgendes Format verwenden und wählen anschließend das gewünschte Format aus der Liste aus. Ist diese Option aktiviert, so fragt Sie gedit nicht mehr nach dem Format, wenn Sie den Menübefehl Bearbeiten Datum und Uhrzeit einfügen wählen.

   - Sie können auch ein benutzerdefiniertes Format für Datum und Uhrzeit festlegen, das bei allen folgenden Einfügevorgängen verwendet wird. Aktiveren Sie hierzu die Option Benutzerdefiniertes Format verwenden und geben Sie das gewünschte Format im entsprechenden Textfeld ein. Weiterführende Informationen zum Einstellen eines benutzerdefinierten Formats finden Sie unter strftime 3. Ist diese Option aktiviert, so fragt Sie gedit nicht mehr nach dem Format, wenn Sie den Menübefehl Bearbeiten Datum und Uhrzeit einfügen wählen.

6. Klicken Sie auf OK, um das Dialogfeld Plugin 'Datum/Uhrzeit einfügen' konfigurieren zu schließen.

7. Um das Dialogfeld Einstellungen zu schließen, klicken Sie auf Schließen.

### Modelines Plugin

The Modelines plugin allows you to set preferences for individual documents. A modeline is a line of text at the start or end of the document with settings that gedit recognises.

Preferences set using modelines take precedence over the ones specified in the preference dialog.

You can set the following preferences with modelines:

- Tab width

- Indent width

- Leerzeichen an Stelle von Tabulatoren einfügen

- Text Wrapping

- Right margin width

The Modelines plugin supports a subset of the options used by other text editors Emacs, Kate and Vim.

#### Emacs Modelines

The first two lines of a document are scanned for Emacs modelines.

The Emacs options for tab-width, indent-offset, indent-tabs-mode and autowrap are supported. For more information, see the GNU Emacs Manual.

#### Kate Modelines

The first and last ten lines a document are scanned for Kate modelines.

The Kate options for tab-width, indent-width, space-indent, word-wrap and word-wrap-column are supported. For more information, see the Kate website.

#### Vim Modelines

The first and last three lines a document are scanned for Vim modelines.

The Vim options for et, expandtab, ts, tabstop, sw, shiftwidth, wrap, and textwidth are supported. For more information, see the Vim website.

### Python Console Plugin

The Python Console Plugin allows you to run commands in the python programming language from gedit. Enabling the plugin adds a tab to the bottom pane. This shows recent output and a command prompt field.

Commands entered into the python console are not checked before they are run. It is therefore possible to hang gedit, for example by entering an infinite loop.

### Snippets Plugin

The Snippets plugin allows you to store frequently-used pieces of text, called snippets, and insert them quickly into a document.

Snippets are specific to the language syntax of the current document. For example, when you are working with an HTML document, you can choose from a list of snippets that are useful for HTML. In addition, some snippets are global, and are available in all documents.

A number of built-in snippets are installed with gedit, which can be modified.

#### Inserting Snippets

To insert a snippet into a document, type its tab trigger and press Tab. A snippet's tab trigger is usually the first few letters of the snippet, or something else that is short and easy to remember.

Alternatively, press Ctrl Space to see a list of snippets you can insert.

#### Adding Snippets

To create a new snippet, do the following:

1. Choose Tools Manage Snippets. The Snippets Manager window opens.

2. The list of snippets is grouped by language. Select the language you want to add a snippet to, or a snippet in that language group. To add a snippet for all languages, choose Global at the top of the list. The syntax of the document you are currently working with is shown by default.

3. Click New. A new snippet appears in the list.

4. Enter the following information for the new snippet:

   Name

     Enter a name for the snippet in the text field within the snippet list. The name of a snippet serves only as a reminder of its purpose. You can change name of a snippet you create by clicking on it in the list.

   Snippet text

     Enter the text of the snippet in the Edit snippet text box. For special codes you can use, see .

     You can switch back to the document window to copy text without closing the Snippets Manager window.

   Tab Trigger

     Enter the tab trigger for the snippet. This is the text that you type before pressing Tab to insert the snippet.

     The tag must be either a single word comprising only letters, or any single character. The Tab trigger will highlight in red if an invalid tab trigger is entered.

   Tastenkombination

     Type a shortcut key to use for inserting the snippet.

#### Editing and Removing Snippets

To edit a snippet, select it in the list and make changes to its text and activation properties.

To rename a snippet, click it again in the list.

To restore a built-in snippet that you have changed, press Revert.

To remove a snippet, select it in the list and press Remove. You can not remove built-in snippets, only those you have created yourself.

#### Snippet Substitutions

In addition to inserting stored text, a snippet can include customizable text, or mark spaces where you can add text once the snippet is inserted in your document.

You can use the following placeholder codes in snippet text:

Tab placeholders

  `$n` defines a tab placeholder, where `n` is any number from 1 upwards.

  `${n:default}` defines a tab placeholder with a default value.

  A tab placeholder marks a place in the snippet text where you can add extra text after the snippet is inserted.

  To use tab placeholders, insert the snippet as normal. The cursor is placed at the first tab placeholder. Type text, and press Tab to advance to the next tab placeholder. The number in the placeholder code defines the order in which tab advances to each place in the text.

  Press Shift Tab to return to the previous tab placeholder. Pressing Tab when there are no more tab placeholders moves the cursor to the end of the snippet text, or to the end placeholder if it exists.

Mirror placeholders

  A repeated tab placeholder will mirror the placeholder already defined. This allows you to type in text only once that you want to appear several times in the snippet.

End placeholder

  `$0` defines the end placeholder. This allows you to finish working with the snippet with the cursor at a point other than the end of the snippet text.

Environmental variables

  Environmental variable such as `$PATH` and `$HOME` are substituted in snippet text. The following variables specific to gedit can also be used:

  $GEDIT_SELECTED_TEXT

    The currently selected text.

  $GEDIT_FILENAME

    The full filename of the document, or an empty string if the document isn't saved yet.

  $GEDIT_BASENAME

    The basename of the filename of the document, or an empty string if the document isn't saved yet.

  $GEDIT_CURRENT_WORD

    The word at the cursor's location in the document. When this variable is used, the current word will be replaced by the snippet text.

Shell placeholders

  `$(cmd)` is replaced by the result of executing cmd in a shell.

  `$(n:cmd)` allows you to give this placeholder a reference, where n is any number from 1 upwards. Use `$n` to use the output from one shell placeholder as input in another.

Python placeholders

  `$<cmd>` is replaced by the result of evaluating cmd in the python interpreter.

  `$<a:cmd>` specifies another python placeholder as a dependency, where a gives its order in the snippet. This allows you to use python functions defined in another snippet. To specify several dependencies, separate the numbers with commas thus: `$<a,b:cmd>`

  To use a variable in all other python snippets, declare it as `global`.

### Plugin "Sortieren"

The Sort plugin arranges selected lines of text into alphabetical order.

Der Sortiervorgang kann nicht rückgängig gemacht werden; es empfiehlt sich daher, die Datei vor dem Sortieren zu speichern. Um nach dem Sortiervorgang ggf. die zuletzt gespeicherte Version der Datei wiederherzustellen, wählen Sie Datei Zurücksetzen.

Die Arbeit mit dem Plugin "Sortieren" gestaltet sich wie folgt:

1. Select the lines of text you want to sort.

2. Choose Edit Sort . The Sort dialog opens.

3. Choose the options you want for the sort:

   - To arrange the text in reverse order, select Reverse order.

   - To delete duplicate lines, select Remove duplicates.

   - To ignore case sensitivity, select Ignore case.

   - To have the sort ignore the characters at the start of the lines, set the first character that should be used for sorting in the Start at column spin box.

4. To perform the sort operation, click Sort.

### Spell Checker Plugin

The Spell Checker plugin checks the spelling in the selected text. You can configure gedit to check the spelling automatically, or you can check the spelling manually, in the specified language. The language setting, and the autocheck spelling properties, apply per document. To use the Spell checker plugin, perform the following steps:

1. Choose Tools Set Language to display the Set language dialog. Select the appropriate language from the list. Click OK to close the Set language dialog.

2. To check the spelling automatically, choose Tools Autocheck Spelling . To unset the automatic spell check, choose Tools Autocheck Spelling again. When automatic spell checking is set, an icon is displayed beside the Autocheck Spelling menu item. Automatic spell checking is unset by default, each time gedit starts.

   Unknown spellings are displayed in a different color, and underlined. Right-click on an unknown spelling, then select Spelling Suggestions from the popup menu:

   - To replace the unknown spelling with another spelling in the list, select the replacement spelling from the Spelling Suggestions popup menu.

   - To add the unknown spelling to your personal dictionary, select Spelling Suggestions Add .

   - To ignore all occurrences of the unknown spelling, so that they are no longer flagged as unknown but are not added to your personal dictionary, select Spelling Suggestions Ignore All . The unknown word is ignored in the current gedit session only.

3. To check the spelling manually, choose Tools Check Spelling .

   If there are no spelling errors, an Information dialog displays a message stating that the document does not contain misspelled words. Click OK to close the Information dialog.

   If there are spelling errors, the Check Spelling dialog is displayed:

   - The Misspelled word is displayed at the top of the dialog.

   - A suggested known spelling is displayed in the Change to text box. You can replace this with another known spelling by selecting a spelling from the Suggestions list, or you can enter text directly into the Change to text box.

   - To check the spelling of the text in the Change to text box, click Check Word. If this is a known word, the Suggestions list is replaced with the text `(correct spelling)`. If the word is not known, new entries appear in the Suggestions list.

   - To ignore the current occurrence of the unknown word, click Ignore. To ignore all occurrences of the unknown word, click Ignore All. The unknown word is ignored in the current gedit session only.

   - To change the current occurrence of the unknown word to the text in the Change to text box, click Change. To change all occurrences of the unknown word to the text in the Change to text box, click Change All.

   - To add the unknown word to your personal dictionary, click Add word.

   - To close the Check Spelling dialog, click Close.

### Plugin "Tagliste"

The Tag List plugin allows you to insert common tags from a list in the side pane.

To use the Tag List plugin, perform the following steps:

1. Choose View Side Pane .

2. By default, the side pane shows a tab containing a list of open documents. Click on the tab showing a + icon at the bottom of the side pane to show the tag list tab.

3. Select the appropriate tag category from the drop-down list. For example, HTML - Tags.

4. Blättern Sie in der Tagliste nach dem gewünschten Tag.

5. Um einen Tag an der Cursorposition in die aktuelle Datei einzufügen, doppelklicken Sie in der Tagliste darauf. Sie können den Tag auch wie folgt einfügen:

   - To insert a tag in the current file and change the focus from the side pane to the display area, press Return.

   - To insert a tag in the current file and maintain the focus on the Tag list plugin window, press Shift Return.

### Plugin "Benutzername"

The User name plugin inserts the username of the current user into the document.

To insert your username at the cursor position, choose Edit Insert User Name .

This plugin is mostly provided as an example of how to create your own plugins. For more information on creating plugins, see the gedit website.