Welches "man2html" kommt mit den VDR Man-Pages klar?

Ich habe mal etwas vorbereitet:

https://github.com/vdr-projects/vdr/wiki

Für die "man.1" sieht das auch schon ganz "OK" aus aber alles was ich versucht habe weigert sich "man.5" zu konvertieren.

Getestet habe ich das "man2html" das mit Arch kommt. Keine Ahnung mit welchen Man-Pages das irgendwas tun soll, aber mit allen VDR-Man-Pages und testhalber mit der Manpage von "bash" wird einfach nur der rohe groff-Code in ein <PRE> gepackt.

Edit: "man2html" wird korrekt so verwendet:

man 1 vdr | man2html

Und gibt dann einfach Plain Text in ein <PRE> gegurkt zurück. Das ist nicht mein Ziel! Ein paar sinnvoll verbaute HTML-Tags sollten schon drin sein...

Nächster Test:

man -Thtml ./vdr.5

Mit der "vdr.1" gibt das ganz brauchbares HTML aber mit der "vdr.5" gibt es HTML und einige PNG-Bilder. Grund: groff unterstützt beim Wandeln nach HTML keine Tabellen. Zumindest in der "vdr.5" sind aber solche vorhanden. Jetzt will mir groff aus den Tabellen erst Bilder basteln was natürlich Mist ist.

Gibt es weitere Tools? Eventuell auch eines das mit der "vdr.5" klarkommt? Wenn gar nichts anderes hilft würde ich halt versuchen die VDR Man-Page vorher durch ein "sed" zu gurken um die Tabellen gegen irgend was "konvertierbares" zu ersetzen.

wirbel Das "groff -Thtml" ist scheinbar vom "Backend" her exakt gleich mit "man -Thtml". Gleiches Problem.

seahawk1986 Schaut deutlich besser aus:

https://github.com/vdr-project…e-formats-and-conventions

Vielleicht ein bisschen viele Links die über GitHub Wiki nicht aufgelöst werden können. Da wird wohl doch noch ein "sed" nachgeschaltet werden müssen um das alles loszuwerden.

Edit: GitHub Wiki mag nur das "id=..." nicht am "<dt>". Wenn ich das "id" eins weiter auf das "<a>" schiebe, dann gehen auch die Links. Sollte auch mit sed gehen.

The idea is to automatically convert existing documentation. So far man pages and SVDRP documentation is not available on the web in an up-to-date version. If I get an automatic converter going, then I could update them with every VDR release without too much manual work.

And I agree that this "groff" language is kind of bad. For the projects I have man pages for, I use "POD" to create them. POD initially came from "Perl" but I've seen this being used in some plain C++ projects, too.

I think I'll get something going with "mandoc". This produces the best result so far. And most of the unneeded stuff can be disabled with options. I think I'll create a small script which converts all the documentation with just one call. Should even be possible to upload this script directly to the wiki repo (GitHub wikis are just GIT repos). So a documentation update would be pretty simple. Call script, create commit, push.

Already way better: https://github.com/vdr-project…e-formats-and-conventions

Still some work to do but the mandoc output works well as a template.