Mit ‘podwebserver’ getaggte Beiträge

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