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.pdfVerstehen 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:
manfindet die entsprechende Handbuchseite-Datei (z. B./usr/share/man/man1/ls.1.gz)groffformatiert die roff-Quelle in PostScript- 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
groff1.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 stattdessenps2pdfvon 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:
mandocist 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)groffodermandoc- Systeme zur Formatierung von Handbuchseiten (groff unter Linux, mandoc unter BSD/macOS)col- Textfilter zum Bereinigen formatierten Outputs (Teil vonutil-linuxunter 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
lpoderlpr
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 ghostscriptBSD:
# FreeBSD
sudo pkg install ghostscript
# OpenBSD
doas pkg_add ghostscript
# NetBSD
pkgin install ghostscriptmacOS:
# Using Homebrew (install from https://brew.sh if needed)
brew install ghostscript
# Or using MacPorts
sudo port install ghostscriptInstallation ü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 printersWenn 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 --versionEine 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.pdfDieser Befehl konvertiert die ls-Handbuchseite in eine PDF-Datei mit dem Namen ls.pdf.
Dies aufgeschlüsselt:
man -t lserzeugt PostScript für denls-Befehl|leitet die Ausgabe zum nächsten Befehl weiterps2pdfkonvertiert PostScript in PDF-sagtps2pdf, von der Standardeingabe zu lesenls.pdfist 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.pdfmacOS:
man -t ssh | ps2pdf - ssh.pdf && open ssh.pdfBSD mit mandoc:
mandoc -Tpdf /usr/share/man/man1/ssh.1 > ssh.pdf && xdg-open ssh.pdfMan-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.pdfDies 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"
doneVerwenden 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 | lpDies 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.pdfAn einen bestimmten Drucker drucken
Überprüfen Sie zuerst die verfügbaren Drucker:
lpstat -pGeben Sie dann den Drucker an:
man -t date | lp -d HP_LaserJet_ProErsetzen 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,10Dies 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 landscapeSie können das Layout vor dem Drucken auch öffnen und überprüfen, indem Sie den Befehl verwenden:
man -t ip | ps2pdf - ip.pdfRänder und Skalierung anpassen
man -t df | lp -o scaling=110 -o page-left=36Optionen 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.pdfArbeiten 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.psPostScript-Dateien anzeigen
Linux/BSD:
evince sort.ps
# or
okular sort.ps
# or
xdg-open sort.psmacOS:
open sort.ps # Opens in PreviewVorhandenes PostScript in PDF konvertieren
Wenn Sie bereits eine .ps-Datei haben:
ps2pdf sort.ps sort.pdfDieser 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.txtDieser 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.txtDas 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.pdfEs 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 lsDies druckt den Pfad zur Handbuchseite-Datei, die Sie dann an mandoc übergeben können.
Beispielausgabe:
/usr/share/man/man1/ls.1.gzVollständiger Arbeitsablauf
mandoc -Tpdf "$(man -w ls)" > ls.pdfEs 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 ghostscriptNach 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.pdfOption 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 laterUnleserliche 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/Fedora2. Handbuchseite existiert nicht:
# Check if the man page exists
man -w commandname
# If it returns nothing, the man page isn't installed3. Beschädigte Handbuchseite:
# Try a different man page to rule out corruption
man -t man | ps2pdf - test.pdfWenn 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-docSuche nach dem Befehl:
# Find which package provides the man page
apt-cache search "man page" | grep commandnameWarnung: "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 fileDrucken auf den falschen Drucker oder kein Standarddrucker festgelegt
Verfügbare Drucker prüfen:
lpstat -pStandarddrucker festlegen:
lpoptions -d printer_nameGeben Sie den Drucker immer ausdrücklich an:
man -t ls | lp -d correct_printer_nameDruckwarteschlange überprüfen:
lpstat -o # Show pending jobs
cancel job_id # Cancel a job if neededPDF-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.pdfOder PDF-Einstellungen anpassen:
man -t ls | ps2pdf -dPDFSETTINGS=/printer - ls.pdfOptionen 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.pdfDruckberechtigung 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 accessmacOS: „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.pdfLösung 2 - Alternative Vorschau-Methode:
man -t command | open -f -a Preview
# If this fails, PostScript support is disabledLösung 3 - Installieren Sie Ghostscript:
brew install ghostscript
# Then use ps2pdf as shown aboveBSD: "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 # macOSErwartete 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"
doneBeliebte 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.pdfVernetzung:
# 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.pdfEntwicklungstools:
# 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.pdfDocker und Container:
man -t docker | ps2pdf - docker.pdf
man -t docker-compose | ps2pdf - docker-compose.pdf
man -t podman | ps2pdf - podman.pdfTextverarbeitung:
# 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.pdfShell-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.pdfDokumentation mit einem Kollegen teilen
man -t systemctl | ps2pdf - systemctl-reference.pdf
# Email or upload systemctl-reference.pdfOffline 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 | lpDie 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 grepMit benutzerdefiniertem Dateinamen exportieren
man -t 5 crontab | ps2pdf - crontab-file-format.pdfMehrere 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.pdfAlle PDFs mit pdfunite zusammenführen:
pdfunite /tmp/ls.pdf /tmp/cp.pdf /tmp/mv.pdf file-commands.pdfOder die Verwendung von Ghostscript:
gs -dBATCH -dNOPAUSE -sDEVICE=pdfwrite \
-sOutputFile=file-commands.pdf \
/tmp/ls.pdf /tmp/cp.pdf /tmp/mv.pdfSie können auch das pdftk-Dienstprogramm verwenden:
pdftk /tmp/ls.pdf /tmp/cp.pdf /tmp/mv.pdf cat output file-commands.pdfFü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
manundgroff; für die PDF-Konvertierung wirdps2pdf(Ghostscript) benötigt - PDF-Export:
man -t command | ps2pdf - output.pdfkonvertiert Manpages in tragbare PDFs - Direktdruck:
man -t command | lpsendet Man-Seiten direkt an Ihren Drucker - Einfacher Text:
man-Befehl | col -bx > output.txterstellt saubere, durchsuchbare Textdateien - macOS Spezial:
man -t command | open -f -a Previewöffnet in Preview ohne zusätzliche Werkzeuge - BSD-Alternative: Systeme mit
mandockönnenmandoc -Tpdf $ (man -w command) > output.pdfverwenden
Spickzettel
Man-Seite in PDF umwandeln (Linux/macOS):
man -t ls | ps2pdf - ls.pdfMan-Seite direkt drucken:
man -t command | lpIn Klartext exportieren:
man command | col -bx > command.txtmacOS: In Vorschau öffnen:
man -t ssh | open -f -a PreviewFür weitere Details siehe die Handbuchseite des jeweiligen Befehls:
man man- Erfahren Sie mehr über das man-Systemman groff- GNU roff Textformatierer-Dokumentationman mandoc- BSD-Handbuchseiten-Formatter (BSD-Systeme)man lp- Sende Aufträge an CUPS-Druckerman 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++