Format, Format

Viele Manpages liegen im groff-Format vor – es handelt sich um eine Textauszeichnungsmethode, die der von Markup-Sprachen (z. B. HTML und SGML) oder dem Satzsystem LaTeX ähnelt. Mit speziellen Formatierungsbefehlen beschreiben Sie das Aussehen bzw. die Struktur des Textes. Anschließend wandeln Sie auf der Kommandozeile groff-Dokumente in formatierte ASCII-Ausgaben, HTML-Seiten oder PostScript-Dateien um.

Viele groff-Formatierungsbefehle stehen in Zeilen, die mit einem Punkt beginnen. Dahinter stehen jeweils Anweisungen, welche die Struktur der Manpage beschreiben. So stehen beispielsweise .SH für eine Kapitelüberschrift in einer Manpage und .PP für einen Zeilenumbruch bzw. neuen Paragraphen. Darüber hinaus gibt es die Möglichkeit, mit Zeichenfolgen Elemente im Fließtext (und nicht in eigenen Zeilen) zu beschreiben: So schalten Sie mit \fB auf das Schriftattribut "fett" ("bold") um und mit \fP wieder zurück auf die vorherige Schriftart. Tabelle 1 zeigt die wichtigsten Formatierungsbefehle zum Nachschlagen; darüber hinaus lohnt sich ein Blick in die Manpage zu groff_man(7).

Tabelle 1: Formatierung in <C>groff<C>

.TH Titel-/Kopfzeile der Manpage
.SH Kapitel- bzw. Sektionsüberschrift
.SS Überschrift zweiter Ordnung
.PP Neuer Paragraph / Zeilenumbruch
.HP Beginn eines eingerückten Absatzes
.RE Ende eines eingerückten Absatzes
.IP Liste mit Aufzählungszeichen; in der Zeile nach der Formatanweisung steht als Aufzählungszeichen entweder eine Ziffer, ein Gliederungspunkt (\(bu oder ein Gedankenstrich (\(em), in der dritten Zeile die Definition.
.TP Liste ohne Aufzählungszeichen; die Zeile nach der Formatanweisung enthält die Bezeichner, die dritte Zeile die Beschreibung.
." Kommentar
\fB Formatiert den nachfolgenden Text fett ("bold")
\fI Formatiert den nachfolgenden Text kursiv ("italic")
\fR Formatiert den nachfolgenden Text mit Serifen ("roman")
\fP Schaltet zur vorherigen Schriftart zurück

Das Grundgerüst erstellen

Learning by doing – am schnellsten lernen Sie die groff-Befehle, indem Sie eine eigene Manpage schreiben. Mehr als einen einfachen Text-Editor brauchen Sie dazu nicht. Legen Sie eine neue Datei an und geben Sie dieser beispielsweise die Endung .1, wenn es sich um ein Benutzerkommando handelt, das später in der ersten Manpage-Abteilung liegen soll. Die erste Zeile einer Manpage enthält traditionell den Titel, die Manpage-Sektion und das Datum der letzten Bearbeitung; tragen Sie also ein:

.TH HUHN 1 "22. Oktober 2004"

Als Nächstes legen Sie die einzelnen Kapitel an. Welche der schon genannten Sektionen Sie verwenden wollen, bleibt Ihnen selbst überlassen – es handelt sich lediglich um eine Konvention, nicht um eine feste Vorgabe; Sie können auch eigene Abschnitte definieren. Die einzelnen Sektionen fangen jeweils mit dem Befehl .SH an und stehen in einer neuen Zeile, danach folgt der Name der Sektion:

.SH NAME
.SH SYNOPSIS
.SH DESCRIPTION
.SH SEE ALSO
.SH BUGS
.SH AUTHOR

Ein Unterkapitel namens Options soll im Abschnitt DESCRIPTION die einzelnen Befehlsparameter erklären. Fügen Sie dazu ein strukturierendes Element ein:

.SH DESCRIPTION
.SS Options
…

LinuxCommunity kaufen

Einzelne Ausgabe
 
Abonnements
 
TABLET & SMARTPHONE APPS
Bald erhältlich
Get it on Google Play

Deutschland

Ähnliche Artikel

  • man und info
    Schnell eine Befehlsoption nachschauen, einfach stöbern, was ein Kommando sonst noch alles kann, oder ausführliche Hilfetexte lesen mit Querverweisen – mit man und info bleiben Sie im Bilde.
  • Shell-Tipps
    Erfahrene Linux-Nutzer schwören auf flexible Kommandozeilentools, mit denen sie manche Aufgabe schneller bewältigen als in grafischen Programmen. Wir stellen interessante Anwendungen und Aufrufparameter vor, um auch Einsteiger zu einem Ausflug in die Shell zu ermutigen.
  • Zu Befehl
    Auch wenn viele Dinge sich bequem über grafische Oberflächen wie KDE oder GNOME regeln lassen – wer sein Linux-System richtig ausreizen möchte, kommt um die Kommandozeile nicht herum. Und auch sonst gibt es viele Situationen, wo es gut ist, sich im Befehlszeilendschungel ein wenig auszukennen.
  • Kein Kauderwelsch
    Mit Po4a haben Sie alle notwendigen Werkzeuge an der Hand, um Dokumentationen an eine Landessprache anzupassen.
  • Shell-Tipps
    Erfahrene Linux-Nutzer schwören auf flexible Kommandozeilentools, mit denen sich manche Aufgabe schneller bewältigen lässt als in grafischen Programmen. Wir stellen die wichtigsten Anwendungen vor, um auch Einsteiger zu einem Ausflug in die Shell zu ermutigen.
Kommentare

Infos zur Publikation

LU 02/2016: Alt-PCs flott machen

Digitale Ausgabe: Preis € 4,95
(inkl. 19% MwSt.)

Mit der Zeitschrift LinuxUser sind Sie als Power-User, Shell-Guru oder Administrator im kleinen Unternehmen monatlich auf dem aktuelle Stand in Sachen Linux und Open Source.

Sie sind sich nicht sicher, ob die Themen Ihnen liegen? Im Probeabo erhalten Sie drei Ausgaben zum reduzierten Preis. Einzelhefte, Abonnements sowie digitale Ausgaben erwerben Sie ganz einfach in unserem Online-Shop.

NEU: DIGITALE AUSGABEN FÜR TABLET & SMARTPHONE

HINWEIS ZU PAYPAL: Die Zahlung ist auch ohne eigenes Paypal-Konto ganz einfach per Kreditkarte oder Lastschrift möglich!       

Der Tipp der Woche

Schon gewußt?

14.11.2015

Auch unter Ubuntu 15.10 kann man wieder mit dem Startmedienersteller (alias Startup Disk Creator) ein Live-System auf einem USB-Stick einrichten. ...

Fehler des Startmedienerstellers von Ubuntu 15.10 umgehen

Aktuelle Fragen

Tails Update
Val Lerie, 11.01.2016 10:51, 0 Antworten
Hallo zusammen, updaten > update Speichern unter > Persistent nicht möglich, mit der Meldung;...
Recoll
Jürgen Heck, 20.12.2015 18:13, 4 Antworten
Wie kann man mit Recoll nach bestimmten Zeichen/Satzzeichen bzw. Zeichenkombinationen suchen, z....
Wings Platinum 4 auf Linux?
Bodo Steguweit, 18.12.2015 11:37, 4 Antworten
Hallo in die Runde ich nutze für meine Diashows Wings Platinum 4 als Diareferent. Arbeite jetzt...
Bandbreite regulieren
Georg Armani, 25.11.2015 16:50, 1 Antworten
Hallo, ich bin ein Neuling in Sachen Linux und hoffe auf Hilfe. Ich habe zwei Windows Rechner...
Windows 10 verhindert LINUX
Hans Wendel, 17.11.2015 17:47, 7 Antworten
Hallo alle, mit einem W10-Laptop (vorher war Win7) wollte ich LINUX ausprobieren. Alles, was ni...