Website-Suche

So drucken und exportieren Sie Manpages als PDF in Linux und Unix


Müssen Sie Unix-Manpages in PDF konvertieren oder ausdrucken? Dieser umfassende Leitfaden zeigt Ihnen genau, wie Sie Manpages auf Linux-, macOS- und BSD-Systemen mit dem Befehl man -t und ps2pdf exportieren, drucken und speichern.

Egal, ob Sie ein schnelles Nachschlage-PDF benötigen, Dokumentationen für das Lernen offline ausdrucken möchten oder Manpages mit Ihrem Team teilen müssen, hier finden Sie den vollständigen Arbeitsablauf.

Dieser Leitfaden enthält auch die Fehlerbehebung für häufige Fehler und ein Spickzettel für schnellen Nachschlag.

Kurze Zusammenfassung

Verwenden Sie man -t command | ps2pdf - command.pdf, um jede Man-Seite sofort in PDF zu konvertieren. Ersetzen Sie command durch den tatsächlichen Namen des Befehls.

Beispiel:

man -t man | ps2pdf - man.pdf

Verstehen des Man-Page-Exports: Wie man -t funktioniert

Wenn Sie man ls ausführen, ruft das System die Quelldatei (im roff-Format geschrieben) ab, verarbeitet sie durch groff (den GNU-Textformatter) und zeigt sie über einen Pager wie less an.

Die Verwendung des -t-Flags sagt man, stattdessen PostScript auszugeben — ein Format, das für den Druck entwickelt wurde und leicht in PDF konvertiert oder direkt an Drucker gesendet werden kann. Dies ist die Grundlage für alle Export-Workflows.

Was hinter den Kulissen passiert:

  1. man findet die entsprechende Handbuchseite-Datei (z. B. /usr/share/man/man1/ls.1.gz)
  2. groff formatiert die roff-Quelle in PostScript
  3. Das PostScript wird entweder angezeigt, gespeichert oder an ein anderes Werkzeug weitergeleitet

Warum PostScript? Es ist eine geräteunabhängige Seitenbeschreibungssprache, die Drucker nativ verstehen, und sie lässt sich sauber in PDF konvertieren.

Was gibt es Neues im Jahr 2026

Linux-Updates:

  • Viele moderne Linux-Distributionen werden jetzt mit groff 1.23+ mit verbesserter Unicode-Unterstützung ausgeliefert.
  • Systemd-basierte Systeme stellen Systemd- und Journald-Dokumentation über die standardmäßigen Manpages bereit.
  • xdg-open über SSH ist auf Wayland-basierten Systemen unzuverlässig.

macOS Änderungen:

  • macOS Sonoma (14.0+) hat das pstopdf-Dienstprogramm entfernt – verwenden Sie stattdessen ps2pdf von Ghostscript.
  • Preview.app unterstützt jetzt kein PostScript in Sequoia (15.0+) mehr.
  • Ghostscript ist jetzt auf macOS für PostScript-zu-PDF-Konvertierungs-Workflows erforderlich.

Neue Werkzeuge:

  • mandoc ist der standardmäßige Man-Seiten-Formatter auf OpenBSD, FreeBSD und modernen macOS.
  • Neuere col-Implementierungen erzeugen sauberere Klartext-Ausgaben als ältere Versionen.
  • Moderne Terminals stellen PostScript nicht dar. PostScript-Ausgaben müssen über einen Dokumentenbetrachter angezeigt oder in PDF konvertiert werden.

Voraussetzungen

Benötigte Werkzeuge (Was Sie brauchen)

In diesem Leitfaden werden wir die folgenden Werkzeuge verwenden:

  • man - Handbuchseiten-Betrachter (Standard auf allen Unix-Systemen)
  • groff - GNU troff Textformatierer
  • ps2pdf - PostScript-zu-PDF-Konverter (Teil von Ghostscript)
  • lp/lpr - CUPS-Druckbefehle
  • mandoc - BSD-Handbuchseiten-Formatter
  • col - Filter rückwärtslaufende Zeilenumbrüche aus der Eingabe

Bereits auf den meisten Systemen installiert:

  • man - Handbuchseiten-Betrachter (Standard auf allen Unix/Linux)
  • groff oder mandoc - Systeme zur Formatierung von Handbuchseiten (groff unter Linux, mandoc unter BSD/macOS)
  • col - Textfilter zum Bereinigen formatierten Outputs (Teil von util-linux unter Linux)

Für die PDF-Konvertierung (erfordert Installation):

  • ps2pdf - PostScript-zu-PDF-Konverter

    • Teil des Ghostscript-Pakets
    • Standardmäßig auf macOS nicht enthalten

Zum Drucken:

  • CUPS (Common Unix Printing System) mit konfiguriertem Drucker
  • Der Befehl lp oder lpr

Installation von Ghostscript (für ps2pdf)

Um Ghostscript unter Linux zu installieren, verwenden Sie die folgenden Befehle.

Linux:

# Alpine Linux
apk add ghostscript

# Arch Linux / EndeavourOS / Manjaro
sudo pacman -S ghostscript

# Debian / Ubuntu / Linux Mint / Pop!_OS
sudo apt update && sudo apt install ghostscript

# RHEL / Fedora / CentOS / AlmaLinux / Rocky Linux
sudo dnf install ghostscript

# OpenSUSE
sudo zypper install ghostscript

BSD:

# FreeBSD
sudo pkg install ghostscript
# OpenBSD
doas pkg_add ghostscript
# NetBSD
pkgin install ghostscript

macOS:

# Using Homebrew (install from https://brew.sh if needed)
brew install ghostscript

# Or using MacPorts
sudo port install ghostscript

Installation überprüfen

Überprüfen Sie, ob Werkzeuge verfügbar sind:

which ps2pdf  # Should return: /usr/bin/ps2pdf or similar
which man     # Should return: /usr/bin/man
which groff   # Should return: /usr/bin/groff
lpstat -p     # Lists configured printers

Wenn ps2pdf nach der Installation von Ghostscript fehlt, versuchen Sie:

# Find where it was installed
find /usr -name ps2pdf 2>/dev/null

# Or check Ghostscript version
gs --version

Eine Man-Seite als PDF exportieren (empfohlener Arbeitsablauf)

PDF ist das transportabelste Format zum Teilen und Archivieren von Manpages.

Grundlegender PDF-Export

man -t ls | ps2pdf - ls.pdf

Dieser Befehl konvertiert die ls-Handbuchseite in eine PDF-Datei mit dem Namen ls.pdf.

Dies aufgeschlüsselt:

  • man -t ls erzeugt PostScript für den ls-Befehl
  • | leitet die Ausgabe zum nächsten Befehl weiter
  • ps2pdf konvertiert PostScript in PDF
  • - sagt ps2pdf, von der Standardeingabe zu lesen
  • ls.pdf ist der Ausgabedateiname

Eine Man-Seite als PDF exportieren und mit einem Befehl öffnen

Die folgenden Befehle werden die Handbuchseite des angegebenen Befehls in eine PDF-Datei umwandeln und diese PDF-Datei sofort in Ihrem Desktop-Viewer öffnen.

Linux:

man -t ssh | ps2pdf - ssh.pdf && xdg-open ssh.pdf

macOS:

man -t ssh | ps2pdf - ssh.pdf && open ssh.pdf

BSD mit mandoc:

mandoc -Tpdf /usr/share/man/man1/ssh.1 > ssh.pdf && xdg-open ssh.pdf

Man-Seitenabschnitte angeben

Manpages sind in nummerierte Abschnitte gegliedert (1 für Befehle, 5 für Dateiformate usw.).

Um aus einem bestimmten Abschnitt zu exportieren:

man -t 5 passwd | ps2pdf - passwd.5.pdf

Dies exportiert die passwd-Dateiformatdokumentation (Abschnitt 5) anstelle des passwd-Befehls (Abschnitt 1).

Man-Seiten Abschnittsnummern:

  • 1: Benutzerbefehle (ls, grep, usw.)
  • 2: Systemaufrufe (fork, open, etc.)
  • 3: Bibliotheksfunktionen (printf, malloc, usw.)
  • 4: Spezielle Dateien (Geräte in /dev)
  • 5: Dateiformate (passwd, fstab, etc.)
  • 6: Spiele
  • 7: Verschiedenes (Regex, ASCII, etc.)
  • 8: Systemverwaltungsbefehle (mount, iptables, usw.)

Mehrere manuelle Seiten im Stapel exportieren

Sie können mehrere Handbuchseiten auf einmal wie unten exportieren:

for cmd in ls grep sed awk; do
    man -t "$cmd" | ps2pdf - "${cmd}.pdf"
done

Verwenden Sie Anführungszeichen um Variablen, um Randfälle sicher zu behandeln.

Diese Schleife:

  • Konvertiert die Handbuchseiten für ls, grep, sed und awk
  • Speichert jeden einzeln als PDF
  • Erzeugt die Dateien nämlich ls.pdf, grep.pdf, sed.pdf und awk.pdf.

Es führt denselben Arbeitsablauf viermal aus, einmal pro Befehl.

Drucken von Man-Seiten

Direkt drucken ohne Dateien zu speichern

man -t du | lp

Dies sendet PostScript direkt an Ihren Standarddrucker. Es werden keine Zwischenfiles erstellt.

Wenn Sie vor dem Drucken eine Vorschau anzeigen möchten, führen Sie Folgendes aus:

man -t du | ps2pdf - du.pdf

An einen bestimmten Drucker drucken

Überprüfen Sie zuerst die verfügbaren Drucker:

lpstat -p

Geben Sie dann den Drucker an:

man -t date | lp -d HP_LaserJet_Pro

Ersetzen Sie HP_LaserJet_Pro durch den tatsächlichen Druckernamen aus lpstat.

Drucke nur bestimmte Handbuchseiten

Für umfangreiche Handbuchseiten wie bash:

man -t bash | lp -P 1-5,10

Dies druckt die Seiten 1-5 und Seite 10. Beachten Sie, dass dies physische Seitennummern sind, nicht Abschnitte der Handbuchseite.

Wenn Sie zuerst Seitenzahlen ansehen möchten, tun Sie Folgendes:

man -t bash | ps2pdf - bash.pdf

Überprüfen Sie dann die Seitenbereiche vor dem Drucken.

Im Querformat drucken

Nützlich für Seiten mit breiten Tabellen oder langen Befehlszeilen:

man -t ip | lp -o landscape

Sie können das Layout vor dem Drucken auch öffnen und überprüfen, indem Sie den Befehl verwenden:

man -t ip | ps2pdf - ip.pdf

Ränder und Skalierung anpassen

man -t df | lp -o scaling=110 -o page-left=36

Optionen hängen von Ihrem Druckertreiber ab. Häufige Optionen sind:

  • scaling=<Prozent> - Größe vergrößern oder verkleinern (Standard 100)
  • page-left=<points> - Linker Rand in Punkten (72 Punkte=1 Zoll)
  • page-top=<points> - Oberer Rand in Punkt

Bitte beachten Sie, dass Skalierung zu Beschnitt führen kann.

  • Vergrößerter Inhalt kann von der Seite ablaufen
  • Lange Zeilen können unerwartet umbrechen

Testen Sie immer zuerst mit einer Vorschau.

Um Ränder und Maßstab vor dem Drucken zu überprüfen, führen Sie aus:

man -t df | ps2pdf - df.pdf

Arbeiten mit PostScript-Dateien

Manchmal benötigt man die Zwischen-PostScript-Datei zur Überprüfung oder zur Konvertierung mit anderen Werkzeugen.

Eine Man-Seite als PostScript speichern

man -t sort > sort.ps

PostScript-Dateien anzeigen

Linux/BSD:

evince sort.ps
# or
okular sort.ps
# or
xdg-open sort.ps

macOS:

open sort.ps  # Opens in Preview

Vorhandenes PostScript in PDF konvertieren

Wenn Sie bereits eine .ps-Datei haben:

ps2pdf sort.ps sort.pdf

Dieser Befehl speichert die sort-Handbuchseite als PostScript-Datei mit dem Namen sort.ps.

Man-Seiten als Nur-Text exportieren

Für die Suche, Versionskontrolle oder E-Mail ist reiner Text oft besser als formatierte Ausgaben.

Sauberen Text exportieren

man sort | col -bx > sort.txt

Dieser Befehl speichert die sort-Handbuchseite als sauberen Klartext in einer Datei namens sort.txt.

Der col -bx-Befehl entfernt:

  • Backspace-Zeichen, die für fett/unterstrichen verwendet werden
  • Steuerzeichen
  • Durchgestrichene Formatierung

Dies erzeugt sauberen, durchsuchbaren Text, der sich für den grep-Befehl, Editoren oder E-Mail eignet.

Klartext mit grundlegender Formatierung beibehalten

man sort | col -b > sort.txt

Das Weglassen des -x-Flags erhält einige grundlegende Formatierungen, entfernt jedoch weiterhin Steuerzeichen.

BSD-spezifisch: Verwendung von mandoc

Moderne BSD-Systeme (OpenBSD, FreeBSD) verwenden mandoc anstelle von groff. Es kann PDF direkt erzeugen, ohne PostScript als Zwischenformat zu verwenden.

Direkte PDF-Erstellung

mandoc -Tpdf /usr/share/man/man1/ls.1 > ls.pdf

Es konvertiert die ls-Handbuchseite direkt in eine PDF-Datei, ohne man, groff oder Ghostscript zu verwenden. Dies ist auf BSD-Systemen und macOS üblich.

Finde die Man-Page-Quelldatei

man -w ls

Dies druckt den Pfad zur Handbuchseite-Datei, die Sie dann an mandoc übergeben können.

Beispielausgabe:

/usr/share/man/man1/ls.1.gz

Vollständiger Arbeitsablauf

mandoc -Tpdf "$(man -w ls)" > ls.pdf

Es findet die echte Quelldatei für die ls-Handbuchseite und konvertiert sie direkt in PDF.

Fehlerbehebung bei häufigen Problemen

Fehler: "ps2pdf: Befehl nicht gefunden"

Ursache: Ghostscript ist nicht installiert.

Lösung - Ghostscript installieren:

# Debian/Ubuntu
sudo apt install ghostscript

# RHEL/Fedora/CentOS
sudo dnf install ghostscript

# Arch Linux
sudo pacman -S ghostscript

# macOS (requires Homebrew)
brew install ghostscript

# FreeBSD
sudo pkg install ghostscript9-base

# OpenBSD
doas pkg_add ghostscript

Nach der Installation überprüfen Sie: which ps2pdf sollte einen Pfad wie /usr/bin/ps2pdf zurückgeben.

Fehler: "Anzeige kann nicht geöffnet werden" beim Verwenden von xdg-open

Ursache: Versuch, eine GUI-Anwendung über SSH ohne X11-Weiterleitung zu öffnen.

Lösungen:

Option 1 - X11-Weiterleitung verwenden:

ssh -X user@host
man -t ls | ps2pdf - ls.pdf && xdg-open ls.pdf

Option 2 - Auf lokales System kopieren:

# On remote system
man -t ls | ps2pdf - ls.pdf

# On local system
scp user@host:ls.pdf .

Option 3 - Nur die PDF erstellen (Überspringe das Öffnen):

man -t ls | ps2pdf - ls.pdf
# Copy manually or view later

Unleserliche Ausgabe oder leeres PDF

Häufige Ursachen und Lösungen:

1. Fehlendes groff:

# Verify groff is installed
which groff

# Install if missing
sudo apt install groff  # Debian/Ubuntu
sudo dnf install groff  # RHEL/Fedora

2. Handbuchseite existiert nicht:

# Check if the man page exists
man -w commandname

# If it returns nothing, the man page isn't installed

3. Beschädigte Handbuchseite:

# Try a different man page to rule out corruption
man -t man | ps2pdf - test.pdf

Wenn das funktioniert, ist die ursprüngliche Handbuchseite beschädigt

Fehler: „Keine Handbucheintragung für Befehl“

Ursache: Die Dokumentation des Befehls ist nicht installiert.

Lösungen:

Installationsdokumentationspaket:

# Ubuntu/Debian
sudo apt install manpages manpages-dev

# For specific software, install its -doc package
sudo apt install git-doc python3-doc

Suche nach dem Befehl:

# Find which package provides the man page
apt-cache search "man page" | grep commandname

Warnung: "einige Zeichen konnten nicht in PostScript konvertiert werden"

Ursache: Die Man-Seite enthält Unicode-Zeichen, die in PostScript nicht unterstützt werden.

Lösung:

# Force UTF-8 encoding
man -t -Tutf8 command | ps2pdf - output.pdf

# Or use col to clean the output first
man command | col -bx > clean.txt
# Then work with the text file

Drucken auf den falschen Drucker oder kein Standarddrucker festgelegt

Verfügbare Drucker prüfen:

lpstat -p

Standarddrucker festlegen:

lpoptions -d printer_name

Geben Sie den Drucker immer ausdrücklich an:

man -t ls | lp -d correct_printer_name

Druckwarteschlange überprüfen:

lpstat -o  # Show pending jobs
cancel job_id  # Cancel a job if needed

PDF-Ausgabe hat winzige oder falsche Schriftarten

Ursache: Probleme beim Einbetten von Schriftarten mit Ghostscript.

Lösung - Schrift Einbetten erzwingen:

man -t ls | ps2pdf -dEmbedAllFonts=true - ls.pdf

Oder PDF-Einstellungen anpassen:

man -t ls | ps2pdf -dPDFSETTINGS=/printer - ls.pdf

Optionen für -dPDFSETTINGS:

  • /screen - Niedrige Auflösung (72 dpi), kleinste Dateien
  • /ebook - Mittlere Auflösung (150 dpi)
  • /printer - Hohe Auflösung (300 dpi) - Empfohlen
  • /prepress - Höchste Qualität (300+ dpi), große Dateien

Fehlende oder gekürzte Abschnitte in der Man-Seite

Ursache: Unzureichende Verarbeitung oder komplexe Formatierung.

Lösung 1 - Verwenden Sie den Nur-Text-Export:

man command | col -bx > command.txt

Überprüfen Sie nach dem Export, ob alle Inhalte vorhanden sind.

Lösung 2 - Erhöhen Sie den groff-Speicher:

groff -Tps -man /usr/share/man/man1/command.1 | ps2pdf - output.pdf

Druckberechtigung verweigert

Ursache: Benutzer ist nicht in der Druckergruppe oder es bestehen CUPS-Zugriffsrestriktionen.

Lösung:

# Add user to lp group
sudo usermod -aG lp $USER

# Log out and back in for group changes to take effect

# Or check CUPS permissions
sudo nano /etc/cups/cupsd.conf
# Ensure your user has access

macOS: „Vorschau kann PostScript-Datei nicht öffnen“

Ursache: Neuere macOS-Versionen haben die PostScript-Unterstützung eingeschränkt.

Lösung 1 - Verwenden Sie ps2pdf:

man -t command | ps2pdf - command.pdf && open command.pdf

Lösung 2 - Alternative Vorschau-Methode:

man -t command | open -f -a Preview
# If this fails, PostScript support is disabled

Lösung 3 - Installieren Sie Ghostscript:

brew install ghostscript
# Then use ps2pdf as shown above

BSD: "mandoc: FEHLER: kann nicht gelesen werden"

Ursache: Falscher Dateipfad oder Berechtigungen.

Lösung:

# Find the correct path
man -w command

# Use the full path
mandoc -Tpdf "$(man -w command)" > output.pdf

# Check file permissions
ls -l "$(man -w command)"

Ausgabe enthält die Abschnittsnummer nicht im Dateinamen

Kein Fehler, sondern eine häufige Verwirrung.

Um Abschnittsnummern in exportierte Dateinamen einzufügen:

# Get section number first
SECTION=$(man -w grep | sed 's/.*\.\([0-9]\).*/\1/')
man -t grep | ps2pdf - "grep.${SECTION}.pdf"

# Or just add it manually
man -t 5 crontab | ps2pdf - crontab.5.pdf

Überprüfung des erfolgreichen Exports

Überprüfen Sie immer Ihr PDF, bevor Sie es teilen:

# Check file size (should be > 0 bytes)
ls -lh output.pdf

# Check PDF integrity
pdfinfo output.pdf

# Quick visual check
xdg-open output.pdf  # Linux
open output.pdf       # macOS

Erwartete Dateigrößen:

  • Kleine Manpages (wie ls): 20-50 KB
  • Mittlere Handbuchseiten (wie bash): 100-300 KB
  • Große Handbuchseiten (wie ffmpeg): 500 KB - 2 MB

Wenn Ihr PDF weniger als 5 KB groß ist, ist etwas schiefgelaufen.

Praktische Anwendungsfälle

Sie könnten sich fragen, warum ich eine Manpage in PDF- oder PS-Format exportieren sollte. Hier sind einige Anwendungsfälle.

Erstellen Sie eine persönliche Referenzbibliothek

mkdir -p ~/manuals/pdf
cd ~/manuals/pdf

# Export frequently-used commands
for cmd in bash ssh git rsync tar grep sed awk find; do
    man -t "$cmd" | ps2pdf - "${cmd}.pdf"
done

Beliebte Befehle zum Exportieren

Hier sind häufig exportierte Handbuchseiten für die Offline-Referenz:

Systemverwaltung:

# Core system commands
man -t systemctl | ps2pdf - systemctl.pdf
man -t journalctl | ps2pdf - journalctl.pdf
man -t crontab | ps2pdf - crontab.pdf
man -t sudo | ps2pdf - sudo.pdf

# File system and disk management
man -t mount | ps2pdf - mount.pdf
man -t fdisk | ps2pdf - fdisk.pdf
man -t df | ps2pdf - df.pdf
man -t lsblk | ps2pdf - lsblk.pdf

Vernetzung:

# Network utilities
man -t ip | ps2pdf - ip.pdf
man -t netstat | ps2pdf - netstat.pdf
man -t ss | ps2pdf - ss.pdf
man -t iptables | ps2pdf - iptables.pdf
man -t tcpdump | ps2pdf - tcpdump.pdf

Entwicklungstools:

# Git and version control
man -t git | ps2pdf - git.pdf
man -t git-commit | ps2pdf - git-commit.pdf
man -t git-rebase | ps2pdf - git-rebase.pdf

# Compilers and build tools
man -t gcc | ps2pdf - gcc.pdf
man -t make | ps2pdf - make.pdf
man -t cmake | ps2pdf - cmake.pdf

Docker und Container:

man -t docker | ps2pdf - docker.pdf
man -t docker-compose | ps2pdf - docker-compose.pdf
man -t podman | ps2pdf - podman.pdf

Textverarbeitung:

# Essential text tools
man -t grep | ps2pdf - grep.pdf
man -t sed | ps2pdf - sed.pdf
man -t awk | ps2pdf - awk.pdf
man -t find | ps2pdf - find.pdf
man -t xargs | ps2pdf - xargs.pdf

Shell-Scripting:

# Bash reference
man -t bash | ps2pdf - bash.pdf
man -t zsh | ps2pdf - zsh.pdf

# Configuration files
man -t 5 bashrc | ps2pdf - bashrc.pdf
man -t 5 crontab | ps2pdf - crontab-format.pdf

Dokumentation mit einem Kollegen teilen

man -t systemctl | ps2pdf - systemctl-reference.pdf
# Email or upload systemctl-reference.pdf

Offline lernen oder annotieren

In PDF exportieren und dann in einem PDF-Reader öffnen, der Anmerkungen unterstützt. Dies ist besonders nützlich, um komplexe Befehle wie iptables oder ffmpeg zu studieren.

Schneller Druckertest

man -t cal | lp

Die cal-Man-Page ist kurz – perfekt zum Testen der Druckerkonfiguration.

Einschränkungen und Überlegungen

1. Ausgabeerscheinung:

Man-Seiten, die auf diese Weise konvertiert werden, sind funktional, aber nicht gestaltet. Sie verwenden grundlegende Schriftarten und einfache Layouts. Für öffentliche Dokumentation sollten Sie Werkzeuge wie Pandoc oder spezielle Dokumentationssysteme in Betracht ziehen.

2. Nicht alle Formatierungen bleiben erhalten:

Komplexe Tabellen, spezielle Symbole oder Formatierungen werden möglicherweise nicht perfekt konvertiert. Überprüfen Sie immer das Ergebnis, bevor Sie es breit teilen.

3. Ressourcennutzung:

Drucken verbraucht Papier und Tinte. Verwenden Sie die Druckvorschau oder den PDF-Export zur Überprüfung, bevor Sie Aufträge an den Drucker senden.

4. Alternative Werkzeuge existieren:

Für den HTML-Export sollte man man2html in Betracht ziehen. Für gestaltete PDFs sollte man sich Dokumentationsgeneratoren wie Sphinx oder Asciidoctor ansehen, wenn man Referenzmaterialien von Grund auf erstellt.

Fortgeschrittene Tipps

Erstellen Sie eine Shell-Funktion für schnelle Exporte

Fügen Sie zu Ihrer ~/.bashrc oder ~/.zshrc hinzu:

manpdf() {
    local name="${*: -1}"
    local open_cmd="xdg-open"
    command -v open >/dev/null && open_cmd="open"
    man -t "$@" | ps2pdf - "${name}.pdf" && "$open_cmd" "${name}.pdf"
}

Verwendung :

manpdf grep

Mit benutzerdefiniertem Dateinamen exportieren

man -t 5 crontab | ps2pdf - crontab-file-format.pdf

Mehrere Handbuchseiten zu einer PDF-Datei zusammenführen

# Export individually
man -t ls | ps2pdf - /tmp/ls.pdf
man -t cp | ps2pdf - /tmp/cp.pdf
man -t mv | ps2pdf - /tmp/mv.pdf

Alle PDFs mit pdfunite zusammenführen:

pdfunite /tmp/ls.pdf /tmp/cp.pdf /tmp/mv.pdf file-commands.pdf

Oder die Verwendung von Ghostscript:

gs -dBATCH -dNOPAUSE -sDEVICE=pdfwrite \
   -sOutputFile=file-commands.pdf \
   /tmp/ls.pdf /tmp/cp.pdf /tmp/mv.pdf

Sie können auch das pdftk-Dienstprogramm verwenden:

pdftk /tmp/ls.pdf /tmp/cp.pdf /tmp/mv.pdf cat output file-commands.pdf

Für weitere Details verweisen Sie auf diesen Leitfaden:

  • PDF-Dateien in der Befehlszeile unter Linux zusammenführen

Häufig gestellte Fragen (FAQ)

F: Wie konvertiere ich eine Man-Seite in ein PDF unter Linux?

A: Verwenden Sie den Befehl: man -t command_name | ps2pdf - output.pdf. Zum Beispiel, um die grep-Man-Seite zu konvertieren: man -t grep | ps2pdf - grep.pdf. Dies erfordert ps2pdf aus dem Ghostscript-Paket.

F: Warum erhalte ich die Meldung "ps2pdf: Befehl nicht gefunden"?

A: Dieser Fehler bedeutet, dass Ghostscript nicht installiert ist. Installieren Sie es mit:

- Debian/Ubuntu: sudo apt install ghostscript
- RHEL/Fedora: sudo dnf install ghostscript
- macOS: brew install ghostscript
- FreeBSD: sudo pkg install ghostscript

F: Wie drucke ich eine Man-Seite vom Terminal aus?

A: Verwenden Sie man -t command | lp, um auf Ihrem Standarddrucker zu drucken, oder man -t command | lp -d printer_name, um einen Drucker anzugeben. Überprüfen Sie verfügbare Drucker mit lpstat -p.

F: Kann ich Handbuchseiten auf macOS exportieren, ohne zusätzliche Software zu installieren?

A: Ja! Verwende man -t command | open -f -a Preview, um die Man-Seite direkt in Preview zu öffnen, und speichere sie dann als PDF. Beachte, dass neuere macOS-Versionen pstopdf entfernt haben, daher benötigst du für die direkte Konvertierung ps2pdf von Ghostscript.

F: Was macht der Befehl "man -t"?

A: Die -t-Option weist man an, das PostScript-Format auszugeben, anstatt die Anzeige in einem Pager zu zeigen. PostScript ist eine Druckersprache, die in PDF umgewandelt oder direkt an Drucker gesendet werden kann. Betrachten Sie es als die druckfertige Version der Man-Seite.

F: Wie exportiere ich mehrere Handbuchseiten auf einmal?

A: Verwenden Sie eine Schleife:

for cmd in ls grep sed awk; do
man -t "$cmd" | ps2pdf - "$ {cmd}.pdf"
done

F: Warum sieht mein exportiertes PDF anders aus als die Anzeige im Terminal?

A: Das Terminal verwendet ANSI-Formatierung (fett, unterstrichen), während PDF echte Schriftarten nutzt. Der Inhalt ist identisch, aber die visuelle Darstellung unterscheidet sich. Das ist normal und zu erwarten.

F: Wie finde ich Handbuchseiten in bestimmten Abschnitten?

A: Handbuchseiten sind in Abschnitte (1-8) gegliedert. Verwenden Sie man Abschnittsnummer Befehl. Zum Beispiel zeigt man 5 passwd das Format der passwd-Datei (Abschnitt 5) anstelle des passwd-Befehls (Abschnitt 1). Exportieren Sie mit man -t 5 passwd | ps2pdf - passwd5.pdf.

F: Kann ich die Exportierung von Handbuchseiten in Skripten automatisieren?

A: Ja! Hier ist eine Funktion, die du zu deiner .bashrc hinzufügen kannst:

manpdf() {
man -t "$@" | ps2pdf - "$ {1}.pdf" && xdg-open "$ {1}.pdf"
}


Dann verwende: manpdf grep

F: Was ist der Unterschied zwischen ps2pdf, ps2pdf12, ps2pdf13 und ps2pdf14?

A: Diese erzeugen verschiedene PDF-Versionen:

- ps2pdf - Standard (derzeit PDF 1.4)
- ps2pdf12 - PDF 1.2 (kompatibel mit Acrobat 3+)
- ps2pdf13 - PDF 1.3 (kompatibel mit Acrobat 4+)
- ps2pdf14 - PDF 1.4 (kompatibel mit Acrobat 5+)

Für maximale Kompatibilität verwenden Sie ps2pdf13. Für moderne Systeme ist der Standard ps2pdf in Ordnung.

F: Wie speichere ich Handbuchseiten als HTML statt als PDF?

A: Verwendung: man command | groff -mandoc -Thtml > command.html. Allerdings ist PDF im Allgemeinen für Man-Pages zuverlässiger und portabler.

F: Kann ich man-Seiten unter BSD ohne ps2pdf exportieren?

A: Ja! BSD-Systeme mit mandoc können direkt PDF erzeugen: mandoc -Tpdf /usr/share/man/man1/ls.1 > ls.pdf. Den Pfad der Man-Seite finden Sie mit man -w ls.

F: Warum erhalte ich "Anzeige kann nicht geöffnet werden", wenn ich xdg-open über SSH benutze?

A: Du versuchst, eine GUI-Anwendung über SSH ohne X11-Weiterleitung zu öffnen. Verwende entweder ssh -X für X11-Weiterleitung oder kopiere das PDF auf deinen lokalen Rechner: scp user@host:file.pdf .

F: Wie drucke ich nur bestimmte Seiten einer langen Handbuchseite?

A: Verwenden Sie die -P-Option mit lp: man -t bash | lp -P 1-5 druckt nur die Seiten 1-5. Beachten Sie, dass dies physische Seitenzahlen sind, nicht Abschnittszahlen.

F: Wie kann ich nach Befehlen suchen, wenn ich den Namen nicht kenne?

A: Verwenden Sie apropos keyword, um Man-Seitennamen und Beschreibungen zu durchsuchen. Zum Beispiel findet apropos compress alle kompressionsbezogenen Befehle.

F: Kann ich Handbuchseiten in andere Formate wie EPUB oder DOCX umwandeln?

A: Zwar möglich, aber kompliziert und liefert selten gute Ergebnisse. Man-Seiten sind für die Anzeige im Terminal und im Druck gedacht. Für Dokumentation in anderen Formaten suchen Sie besser nach offizieller Projektdokumentation, anstatt Man-Seiten zu konvertieren.

Wichtige Erkenntnisse

  • Voraussetzungen: Die meisten Systeme haben man und groff; für die PDF-Konvertierung wird ps2pdf (Ghostscript) benötigt
  • PDF-Export: man -t command | ps2pdf - output.pdf konvertiert Manpages in tragbare PDFs
  • Direktdruck: man -t command | lp sendet Man-Seiten direkt an Ihren Drucker
  • Einfacher Text: man-Befehl | col -bx > output.txt erstellt saubere, durchsuchbare Textdateien
  • macOS Spezial: man -t command | open -f -a Preview öffnet in Preview ohne zusätzliche Werkzeuge
  • BSD-Alternative: Systeme mit mandoc können mandoc -Tpdf $ (man -w command) > output.pdf verwenden

Spickzettel

Man-Seite in PDF umwandeln (Linux/macOS):

man -t ls | ps2pdf - ls.pdf

Man-Seite direkt drucken:

man -t command | lp

In Klartext exportieren:

man command | col -bx > command.txt

macOS: In Vorschau öffnen:

man -t ssh | open -f -a Preview

Für weitere Details siehe die Handbuchseite des jeweiligen Befehls:

  • man man - Erfahren Sie mehr über das man-System
  • man groff - GNU roff Textformatierer-Dokumentation
  • man mandoc - BSD-Handbuchseiten-Formatter (BSD-Systeme)
  • man lp - Sende Aufträge an CUPS-Drucker
  • man ps2pdf - Optionen des PostScript-zu-PDF-Konverters

Alternative Ansätze

Hier sind einige alternative Ansätze für man -t:

  • Pandoc - Universeller Dokumentenkonverter (kann Markdown in Manpages umwandeln)
  • ronn/ronn-ng - Erstellen Sie Handbuchseiten aus Markdown
  • help2man - Erzeugt einfache Manpages aus der Programmhilfeausgabe
  • man2html - Konvertiert Manpages in HTML (weniger zuverlässig als PDF)

Zusammenfassung

Das Exportieren und Drucken von Handbuchseiten ist einfach, sobald man den PostScript-Workflow versteht. Der Kernbefehl "man -t" erzeugt druckerfreundliche Ausgaben, die man speichern, konvertieren oder direkt drucken kann.

Für die meisten Benutzer bietet der PDF-Workflow (man -t command | ps2pdf - output.pdf) das beste Gleichgewicht zwischen Portabilität und Qualität. Für schnelle Ausdrucke vermeidet das direkte Weiterleiten an lp Zwischenablagen. Für die Textverarbeitung erzeugt col -bx sauberen, durchsuchbaren Output.

Diese Techniken verwenden standardmäßige Unix-Tools, die seit Jahrzehnten stabil sind. Sie funktionieren über verschiedene Distributionen und Unix-Varianten hinweg mit minimalen Abhängigkeiten. Beherrschen Sie diese Grundlagen, und Sie werden zuverlässigen Dokumentationszugang unabhängig von Ihrer Umgebung haben.

Ressourcen

  • Linux-Manpages-Projekt - Quelle für Linux-Manpages
  • CUPS-Druckanleitung - Referenz der Druckeroptionen
  • Ghostscript-Dokumentation - ps2pdf-Details
  • groff-Handbuch - Textformatierungssystem

Verwandte Lektüre:

  • Effizient lernen, Man-Pages in Linux zu verwenden
  • Effizient in Linux-Handbuchseiten suchen
  • Gute Alternativen zu Man-Pages, die jeder Linux-Benutzer kennen sollte
  • Eine bestimmte Sektion in den Man-Seiten unter Linux anzeigen
  • Finde die längste Man-Seite in Linux
  • Vergessene Linux-Befehle leicht wieder abrufen
  • Erstellen und Pflegen Sie Ihre eigenen Man-Seiten
  • Man-Pages in Alpine Linux installieren
  • Fehlende Handbuchseiten von Befehlen auf Ubuntu installieren
  • Pinfo – Ein CLI-Programm zum Lesen von Info- und Man-Seiten in Farbe
  • Hilfe zum Find-Befehl in Linux finden (Man, Info, Apropos, Whatis, –help)
  • Durchsuchen und Lesen des gesamten Arch Wiki als Linux-Handbuchseiten
  • Linux-Befehlsübersichten mit dem Tealdeer-Tool anzeigen
  • Linux-Befehlsübersichten mit Eg anzeigen
  • Navi: Ein interaktives Kommandozeilen-Spickzettel-Tool
  • Linux-Befehle unterwegs suchen, lernen und üben mit Tldr++