Perldoku offline im Browser lesen mit Pod::Webserver

Veröffentlicht: März 30, 2015 in Perl
Schlagwörter:, ,

perldoc ist eine gute Möglichkeit die Dokumentation von Perl und der installierten Module zu lesen und sie in beliebigen Formaten auszugeben. Wer es etwas einfacher mag, greift zum Modul Pod::Webserver.

Der podwebserver stellt die Dokumentation im HTML-Format über HTTP dar. Natürlich könnte man die Dokumentation auch über im CPAN oder meta::cpan lesen, die Verwendung des podwebservers hat allerdings den Vorteil das man die Dokumention für genau die Perl-Version und die Modulversionen sehen kann welche auf dem System installiert sind.
Der podwebserver wird von der Kommandozeile aus gestartet (keine Root-Rechte erforderlich).

podwebserver

Wird der podwebserver ohne Optionen gestartet, kann man anschliessend über die Adresse localhost:8020 auf die Dokumentation zugreifen. Möchte man den Webserver nicht an localhost oder einen anderen Port binden, verwendet man den folgenden Aufruf:

podwebserver -H hostname -p port

Um das ganze zu vereinfachen kann man sich auch ein kleines Shellskript basteln und die Doku auch gleich im Browser öffnen. Im folgendem Beispiel wird iceweasel (firefox unter Debian) als Browser verwendet.

#!/bin/sh
podwebserver &
sleep 5
iceweasel -remote 'openurl( http://localhost:8020/, new-tab)' &

Debianpaket: libpod-webserver-perl

Advertisements

Kommentar verfassen

Trage deine Daten unten ein oder klicke ein Icon um dich einzuloggen:

WordPress.com-Logo

Du kommentierst mit Deinem WordPress.com-Konto. Abmelden /  Ändern )

Google+ Foto

Du kommentierst mit Deinem Google+-Konto. Abmelden /  Ändern )

Twitter-Bild

Du kommentierst mit Deinem Twitter-Konto. Abmelden /  Ändern )

Facebook-Foto

Du kommentierst mit Deinem Facebook-Konto. Abmelden /  Ändern )

w

Verbinde mit %s