So öffnen und konvertieren Sie POD in PDF, um die Perl-Dokumentation zu lesen

Obwohl es einst eine integrale Sprache für die Webprogrammierung war, welche Programmiersprache zu lernen ist - Webprogrammierung welche Programmiersprache zu lernen - Webprogrammierung Heute werden wir uns die verschiedenen Webprogrammiersprachen ansehen, die das Internet unterstützen. Dies ist der vierte Teil einer Programmierserie für Anfänger. In Teil 1 haben wir die Grundlagen von… Lesen Sie mehr, Perl ist jetzt zugunsten modernerer Sprachen wie Python, Ruby und JavaScript auf der Strecke geblieben. Sehr wenige Leute meinen, es lohnt sich heutzutage, Perl zu lernen.

Das bedeutet jedoch nicht, dass die Sprache unbrauchbar oder veraltet ist. In der Tat sind viele moderne Websites und Web-Tools für den täglichen Betrieb immer noch auf Perl angewiesen - einschließlich Craigslist, IMDb und DuckDuckGo. Wenn Sie also etwas lernen möchten, lassen Sie sich von niemandem aufhalten oder abraten Sie 7 nützliche Tricks, um eine neue Programmiersprache zu beherrschen 7 nützliche Tricks, um eine neue Programmiersprache zu beherrschen Es ist in Ordnung, überwältigt zu werden, wenn Sie das Codieren lernen. Sie werden die Dinge wahrscheinlich so schnell vergessen, wie Sie sie lernen. Diese Tipps helfen Ihnen dabei, all diese neuen Informationen besser aufzubewahren. Weiterlesen .

Wenn Sie Perl lernen möchten, sollten Sie sich auch mit POD vertraut machen. Dies ist, warum es so wichtig ist und was zu tun ist, wenn Sie solche Dateien ausführen.

Was sind POD-Dateien??

POD steht für Plain Old Documentation, eine einfache Auszeichnungssprache, mit der Text ohne großen Aufwand formatiert wird. Es ähnelt der Markdown-Markup-Sprache Was ist Markdown? 4 Gründe, warum Sie es jetzt lernen sollten Was ist Markdown? 4 Gründe, warum Sie es jetzt lernen sollten Ermüdet von HTML- und WYSIWYG-Editoren? Dann ist Markdown die Antwort für Sie, egal wer Sie sind. Lesen Sie mehr, aber speziell für die Dokumentation von Perl-Quellcode und -Modulen.

POD kann auf zwei Arten verwendet werden: Es kann direkt im Quellcode einer Perl-Datei oder als separate POD-Datei vorhanden sein. Wenn es im Code vorhanden ist, können Sie es sich wie Kommentare in einer anderen Programmiersprache vorstellen, mit Ausnahme der ausgefalleneren und flexibleren.

#! / usr / bin / perl

Verwenden Sie streng;

Verwende Warnungen;

= pod

= head1 Header Beispiel

Dieses Skript macht einige coole Sachen, so und so. Die folgenden Parameter müssen vorhanden sein, damit es ordnungsgemäß funktioniert. Versuchen Sie dies nicht auf einer Maschine mit Problemen.

= schneiden

drucken “Nur dieser Code wird ausgeführt. \ n”;

Die eingebettete Dokumentation eignet sich gut für eigenständige Skripts oder wenn Sie sicherstellen möchten, dass jeder, dem die Datei angezeigt wird, auch garantierten Zugriff auf die Dokumentation hat. Es kann jedoch umständlich sein, wenn Sie eine gesamte Codebasis auf einer höheren Ebene dokumentieren möchten.

Glücklicherweise können Sie mit POD auch manuelle Seiten erstellen, die besser für benutzerorientierte Dokumente geeignet sind (da Benutzer möglicherweise nicht in den Quellcode eines Skripts eintauchen möchten). Das ist, wenn POD-Dateien nützlich sind.

So lesen Sie POD-Dateien

Es wird darauf hingewiesen, dass die eingebettete POD-Dokumentation in den eigentlichen Perl-Skriptdateien zwischen Codezeilen enthalten ist und diese Skriptdateien in einem von zwei Erweiterungsformaten vorliegen: .PL oder .PM. Wenn Sie eine Erweiterung von .POD sehen, bedeutet dies, dass die Datei reine Dokumentation ist und keinen Quellcode enthält.

Es ist zwar möglich, POD-Dateien in einem beliebigen Texteditor einschließlich Notepad zu öffnen. Möglicherweise möchten Sie dies jedoch nur, wenn Sie die Rohdokumentation selbst bearbeiten. Stellen Sie sich vor, Sie öffnen eine HTML-Datei in einem Editor: Mit dem gesamten Markup ist der Textinhalt schwer lesbar.

Stattdessen sollten Sie ein Lesetool verwenden, das die reine POD-Dokumentation auf einfache und verständliche Art und Weise darstellt.

Der einfachste Weg ist die Verwendung der Perldoc Befehlszeilentool, das automatisch installiert wird, wenn Perl auf Ihrem System installiert wird. Auf den meisten OS X- und Linux-Systemen ist Perl bereits installiert. Windows-Benutzer müssen es jedoch manuell installieren. (Glücklicherweise ist es nicht schwieriger als eine Installationsdatei auszuführen.)

Starten Sie nun die Befehlszeile, navigieren Sie zu dem Ort, an dem sich die POD-Datei befindet, und geben Sie ein Perldoc [.POD-Datei] um es als korrekt formatiert anzusehen. Zum Beispiel, wenn die Datei benannt wurde Bibliothek.pod dann würdest du tippen perldoc library.pod und das ist es.

Wie konvertiert man POD in andere Formate?

Obwohl die Perldoc Das Tool ist nicht zu schwer zu benutzen, es ist nicht gerade praktisch, wenn Sie die Dokumentation mit anderen teilen oder wenn Sie sie von Ihrem Computer lesen möchten. Dann möchten Sie vielleicht in ein anderes Format konvertieren.

In HTML konvertieren: Installieren und verwenden Sie das Tool pod2html, mit dem Sie eine beliebige POD-Datei auf einfache Weise in eine lesbare HTML-Datei übersetzen können. Leider kann nur eine 1: 1-Konvertierung durchgeführt werden (Sie können also nicht mehrere POD-Dateien in einer einzigen HTML-Datei kombinieren.).

In PDF konvertieren: Installieren und verwenden Sie das pod2pdf-Tool, das dem pod2html-Tool oben ähnlich ist und genauso einfach zu verwenden ist, mit der Ausnahme, dass es in PDF und nicht in HTML konvertiert wird.

Eine andere Option wäre, POD mit der oben gezeigten Methode in HTML zu konvertieren, die HTML-Datei in einem Browser wie Chrome oder Firefox zu öffnen und die Seite als PDF zu drucken.

In Markdown konvertieren: Installieren Sie und verwenden Sie das Tool pod2markdown, um zwischen POD und Markdown zu übersetzen. Markdown ist eine Markup-Sprache für allgemeine Zwecke. Das bedeutet, dass Benutzer mit dieser Funktion eher vertraut sind und es mehr Tools gibt, die Markdown akzeptieren und anzeigen können.

Umstellung auf LaTeX: Installieren und verwenden Sie das Tool pod2latex. LaTeX ist eine weitere Auszeichnungssprache, die zwar weniger häufig als Markdown, aber immer noch beliebter als POD ist. LaTeX wird hauptsächlich in akademischen und wissenschaftlichen Dokumenten verwendet. Falls Sie es benötigen, ist dieser Konverter jedoch vorhanden.

In einfachen Text konvertieren: Installieren und verwenden Sie das Tool pod2text, das eine Nur-Text-Datei mit ASCII-Formatierung erzeugt. Sie werden dies wahrscheinlich nicht brauchen, aber wenn Sie es jemals tun, sollten Sie wissen, dass die Option existiert.

War dieser Beitrag hilfreich??

Sobald Sie den Dreh raus haben, sind POD-Dateien extrem einfach und bequem zu bedienen. Es gibt eine gewisse Lernkurve, die jedoch sehr gering ist - insbesondere, wenn Sie zuvor eine Auszeichnungssprache verwendet haben. Hoffentlich fühlen Sie sich jetzt wohl mit POD-Dateien.

Wenn Sie sich überfordert fühlen, stellen Sie sich diese wichtigen Fragen für Neulinge-Codierer. Aber ist es für alle? Bevor Sie sich dazu verpflichten, stellen Sie sich die folgenden Fragen und seien Sie ehrlich. Weiterlesen . Schwierigkeiten zu haben bedeutet nicht zwangsläufig, dass Sie nicht als Programmierer gedacht sind. 6 Zeichen, dass Sie nicht als Programmierer gedacht sind. 6 Zeichen, dass Sie nicht als Programmierer gedacht sind. Nicht jeder ist als Programmierer gedacht. Wenn Sie nicht ganz sicher sind, ob Sie ein Programmierer sein sollen, finden Sie hier einige Hinweise, die möglicherweise in die richtige Richtung weisen. Lesen Sie mehr, aber es ist wichtig, ehrlich zu sein und Ihre Erwartungen zu verwalten.

Beachten Sie die folgenden Tipps, um zu lernen, wie man ohne Stress programmiert. Wie man Programmieren ohne all den Stress lernt. Wie man Programmieren ohne all den Stress lernt. Vielleicht haben Sie sich entschieden, das Programmieren zu beginnen, sei es für eine Karriere oder nur als Hobby. Großartig! Aber vielleicht fangen Sie an, sich überfordert zu fühlen. Nicht so toll. Hier finden Sie Hilfe, um Ihre Reise zu erleichtern. Lesen Sie mehr und wissen Sie, wie man gute Codierungs-Tutorials von bad unterscheidet. Was macht ein gutes Programmier-Tutorial aus? Was macht ein gutes Lernprogramm aus? Nicht alle Programmier-Tutorials sind gleich. Einige profitieren davon, dass Sie und andere Ihre Zeit verschwenden. Hier ist, worauf Sie in einem Qualitätsprogrammierungs-Tutorial achten sollten. Weiterlesen .

Wofür verwenden Sie Perl? Haben Sie noch weitere Tipps oder Fragen? Lass es uns in den Kommentaren wissen!

Erfahren Sie mehr über: Dateikonvertierung, PDF, Programmierung.