Sechzehn Jahre nach Beginn des 21. Jahrhunderts bin ich immer noch verblüfft, dass wir immer noch große Anstrengungen unternehmen müssen, wenn wir eine Manpage sehen wollen
Es gibt verlockende Websites mit HTML-Manpages, die Links wie diese enthalten , aber ich habe keine solche Site mit Seiten gefunden, die für die aktuelle Version von macOS aktualisiert wurden. Und natürlich zeigt eine Website keine Manpages für Software, die Sie über Homebrew usw. installiert haben.
Gibt es eine Lösung für dieses Problem? Ich habe geschaut und geschaut. Das
function manp {
man -t "$1" | open -f -a /Applications/Preview.app/
}
rendert eine Seite und zeigt sie in der Vorschau an (nachdem Sie darauf gewartet haben, dass ein PostScript-Interpreter sie in PDF konvertiert), aber Sie erhalten keine Live-Links.
Die Manpage für Mann sagt:
HTML-SEITEN
Man findet HTML-Seiten, wenn sie in Verzeichnissen mit dem erwarteten Namen ".html" liegen, daher wäre ein gültiger Name für eine HTML-Version der ls(1)-Manpage /usr/share/man/htmlman1/ls.1 .html.
Ich könnte ein Skript schreiben, um alle Manpages überall auf meinem System in HTML zu konvertieren, aber ich wette, jemand hat dies bereits getan. Und ich wette, sie haben auch das Problem gelöst, SIEHE-AUCH-Referenzen als Links darzustellen, was der Befehl man anscheinend nicht tut.
Installieren Sie Bwanaman
, mit dem Sie die Seiten in Ihrem bevorzugten Browser durchsuchen können .
Um die obige Seite zu zitieren: "Geben Sie einfach "man:" gefolgt von der Manpage, nach der Sie suchen, in das URL-Feld Ihres Browsers ein. Drücken Sie die Eingabetaste und lassen Sie Bwana den Rest erledigen." Es hat Live-Links.
Mit bcat können Sie stdout
zu Ihrem Standardbrowser leiten. Eine Alternative zu Ihrer Vorschaufunktion wäre:
bman ()
{
: Display man page in default browser
man $* | col -b | bcat
}
...oder einfach man
den Pager von setzen:
export MANPAGER='col -b | bcat'
man grep
bcat
funktioniert mit jedem Befehl, der schreibt in stdout
:
pbpaste | bcat
make test | bcat
tail -n 1000 -f /var/log/messages | bcat
...usw.
Es ist ein Rubin-Edelstein, also ist die Installation so einfach wie:
gem install bcat
Wenn die "on-the-fly"-Konvertierung nicht ausreicht und Sie HTML auf einmal oder im Voraus erstellen möchten, enthält dieser Beitrag auf Unix.se eine Reihe von Vorschlägen (leider wird eines meiner Lieblingstools, das mächtige pandoc
, ich arbeite nicht dafür...)
daveyost
Peter VP