Was ist der einfache Weg, um alle Manpages in HTML zu konvertieren?

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

  • gerendert in einer proportionalen Schriftart (d. h. nicht Courier oder ähnliches)
  • mit Links zu anderen verlinkten Seiten

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.

Antworten (2)

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.

Leider ist Bwana für macOS 10.12 anscheinend kaputt und wird derzeit nicht gepflegt. Eine andere Version von bwana bietet eine bessere Formatierung, hat aber die gleichen Probleme.
Ich verwende es unter macOS 10.12 und es funktioniert einwandfrei. Bwana-Version 2.7

Mit bcat können Sie stdoutzu Ihrem Standardbrowser leiten. Eine Alternative zu Ihrer Vorschaufunktion wäre:

bman () 
{ 
    : Display man page in default browser
    man $* | col -b | bcat
}

...oder einfach manden Pager von setzen:

export MANPAGER='col -b | bcat'
man grep

bcatfunktioniert 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...)