Gibt es Code, um POD ähnlich wie search.cpan.org in HTML umzuwandeln? Ich möchte es über meine CPAN-Distributionsmodule laufen lassen, um zu sehen, wie sie aussehen werden, bevor sie veröffentlicht werden.
Der mit Perl mitgelieferte pod2html scheint ziemlich veraltet zu sein. Es macht seltsame Dinge wie das Ablegen temporärer Dateien im aktuellen Verzeichnis und das Erstellen von Links wie "the so-and-so manpage", und die Ausgabe ist der schönen Ausgabe von search.cpan.org weit unterlegen. Aber nicht sicher, was andere Leute benutzen.
Ich habe pod2cpanhtml aus genau den Gründen geschrieben, die Sie beschreiben.
Es ist nur ein kleines Stück Code, das Pod :: Simple :: HTML und das search.cpan.org CSS , aber ich finde es sehr nützlich.
Bevor ich auf CPAN uploade, prüfe ich meinen POD, indem ich ihn in einem Browser von Ссылка ansehe.
Formular dort, klicke ich auf Browse...
Ich navigiere zu dem Verzeichnis, das meinen Code enthält, und doppelklicke auf die Datei .pm
.
Klicken Sie dann auf Submit Query
.
Es ist das, was ich am besten gesehen habe.
Siehe auch pod2cpanhtml.
Zusätzlich zu den Vorschlägen des Mobs war ich ziemlich glücklich mit Pod :: ProjectDocs . Es brauchte einige kleinere Verbesserungen, aber es sieht mehr oder weniger wie CPAN aus.
Laut diesem perlmonks-Thread besteht der Trick darin, Pod::HtmlEasy
. Oder vielleicht ist der Trick, Apache::Pod::HTML
zu verwenden. Oder Pod::Tree
? Ich weiß es nicht, aber es gibt ein paar Vorschläge.
Tags und Links perl