Was ist eine Manpage ?
Eine Manpage (kurz für Manualpage) ist die traditionelle Form der Softwaredokumentation auf einem Unix-ähnlichen Betriebssystem wie Ubuntu. Für die allermeisten Befehle und Programme gibt es eine Manpage, die die Optionen auflistet und deren Verwendung erklärt.
Wie kann ich Manpages finden und anzeigen?
Offline in einem Terminal
Handbuchseiten werden automatisch zusammen mit den darin beschriebenen Befehlen auf Ihrem System installiert. Zum Anzeigen und Durchsuchen von Manpages gibt es den Befehl man
:
man mv
Zeigt die Manpage von mv
while an
man -k mv
durchsucht Namen und Kurzbeschreibungen aller installierten Manpages nach dem String mv
. POSIX Erweiterte Reguläre Ausdrücke sind erlaubt und es ist eine Suche , so dass diese auch zB finden git-mv
und semver
, wenn Sie genau suchen möchten mv
benutzen ^mv$
statt.
Siehe Was ist der Unterschied zwischen "Mann" und "Mann (#)"? um über Manpage-Abschnitte zu lesen. Weitere Informationen finden Sie in man
der Manpage. ;)
Wie kann ich beeinflussen, wie eine Manpage angezeigt wird?
Das Standardprogramm zum Anzeigen von Manpages ist less
. Dieser sogenannte Pager bietet eine hilfreiche Suchfunktion, bei der nur /
der Suchbegriff gefolgt wird, z
/--version
und drücken Sie Enter. Dadurch wird jeder Befund markiert und zum ersten gescrollt. Drücken Sie N, um zum nächsten Ergebnis zu gelangen, und ⇧ Shift+ N, um zum vorherigen Ergebnis zu gelangen (siehe Wie kann ich in einer Manpage suchen? ). Eine Liste der Befehle drücken H, zum Beenden less
drücken Q.
Daneben less
gibt es noch andere Pager : pg
, most
und w3m
nur um drei aufzulisten . Ich empfehle most
: Es kommt mit einem sehr nützlichen Färbung von Schlüsselwörtern einen Mann Seite machen viel einfacher zu lesen und zu navigieren, für sich selbst sehen:
Verwenden Sie die folgende -P
Option, um eine Manpage in einem anderen als dem Standard-Pager anzuzeigen :
man -P most mv
Wenn Sie die Standard-Pager- Manpages ändern möchten, werden zwei Optionen angezeigt:
Ändern Sie den Standard-Pager nur von man
export MANPAGER=most
Um die Änderung dauerhaft zu machen, fügen Sie diesen Befehl Ihrer ~/.bashrc
Datei hinzu.
Ändern Sie den Standard-Pager Ihres gesamten Systems
sudo update-alternatives --config pager
Fans können sogar (ab) vim
als das verwenden MANPAGER
, siehe diesen Artikel von muru .
Manpages werden in der Schriftart angezeigt, die in den Einstellungen Ihres Terminalemulators angegeben ist. Wenn Sie regelmäßig mit dem Terminal arbeiten, möchten Sie möglicherweise diese Schriftart ändern. Ich kann Hack nur empfehlen - eine Schriftart, die für den Quellcode entwickelt wurde. Der Screenshot oben zeigt die Schönheit.
Offline über GUI
Eine schöne und einfache Möglichkeit, Manpages mit einer einfachen GUI anzuzeigen, ist das vorinstallierte yelp
Programm. Um eine Manpage mit yelp
execute yelp man:PROGRAM
oder zu starten gnome-help man:PROGRAM
, zB:
yelp man:mv
Sie können Hilfeseiten auch mit Ihrem bevorzugten Browser anzeigen. Siehe Wie öffne ich Hilfeseiten in einem Webbrowser? zB für man mv
in firefox
:
man -Hfirefox mv
Last but not least können Sie konvertieren man - Seiten zu PDF und betrachten Sie sie mit Ihrem bevorzugten PDF - Viewer finden Sie unter : Gibt es eine Möglichkeit Info / Mann - Seiten zu PDF drucken?
Online
Sie können die Manpages der Programme anzeigen, die über die Repositorys aller derzeit unterstützten Ubuntu-Versionen verfügbar sind, und zwar mit der Kurz-URL manpg.es/PROGRAM
, z . B. http://manpg.es/mv . Dies öffnet mv
die Manpage für die neueste Ubuntu-Version. Sie können eine andere Version in der oberen Leiste auswählen. Zum Suchen nach Manpages können Sie zB http://manpages.ubuntu.com/cgi-bin/search.py?q=mv verwenden .
Wie oben erläutert, man
können nur Manpages der auf dem System installierten Software angezeigt werden. Das Paket enthält Manpages von http://manpages.ubuntu.com mit einem Terminal-Pager .dman
bikeshed
Andere Quellen
Wenn Sie Dokumentationen aus anderen Online-Quellen lesen, sollten Sie die Programmversion im Auge behalten. Die meisten Programme haben eine --version
Option, die die Version des betreffenden Programms anzeigt, z
$ mv --version
mv (GNU coreutils) 8.25
Es gibt viele Websites, die sich der einfachen Verfügbarkeit von Manpages verschrieben haben. Ich werde nur die beiden vorstellen, die mir am besten gefallen:
- man7.org wird mit nützlichen Syntax-Hervorhebungen geliefert , enthält jedoch nur die letzte veröffentlichte Version des Programms
- manpag.es hostet Manpages von Ubuntu-Releases, die seit langem EOL sind
Quelle nicht bereits verlinkt: https://wiki.ubuntuusers.de/man/