Wie man POD zu PDF öffnet und konvertiert, um Perl-Dokumentation zu lesen

Eine POD-Datei ist die einfache alte Dokumentation der Programmiersprache Perl. Wir zeigen Ihnen, wie Sie POD in PDF, HTML, Markdown, LaTeX oder Nur-Text konvertieren.

Eine POD-Datei ist die einfache alte Dokumentation der Programmiersprache Perl.  Wir zeigen Ihnen, wie Sie POD in PDF, HTML, Markdown, LaTeX oder Nur-Text konvertieren.
Werbung

Obwohl es einst eine integrale Sprache für Web-Programmierung war Welche Programmiersprache zu lernen - Web-Programmierung Welche Programmiersprache zu lernen - Web-Programmierung Heute werfen wir einen Blick auf die verschiedenen Web-Programmiersprachen, die das Internet antreiben. Dies ist der vierte Teil einer Anfänger-Programmierserie. In Teil 1 lernten wir die Grundlagen von ... Read More, Perl ist auf der anderen Seite zugunsten moderner Sprachen wie Python, Ruby und JavaScript auf der Strecke geblieben. Nur wenige Leute denken, dass es sich lohnt, Perl in diesen Tagen zu lernen.

Aber das bedeutet nicht, dass die Sprache nutzlos oder veraltet ist. In der Tat, viele moderne Websites und Web-Tools verlassen sich immer noch auf Perl für den täglichen Betrieb - einschließlich Craigslist, IMDb und DuckDuckGo - wenn Sie daran interessiert sind, es zu lernen, lassen Sie niemanden Sie stoppen oder davon abraten Sie 7 Nützliche Tricks zum Beherrschen einer neuen Programmiersprache 7 Nützliche Tricks zum Beherrschen einer neuen Programmiersprache Es ist in Ordnung, überwältigt zu sein, wenn Sie lernen, zu programmieren. Sie werden die Dinge wahrscheinlich so schnell vergessen, wie Sie sie lernen. Diese Tipps können Ihnen helfen, diese neuen Informationen besser zu speichern. Weiterlesen .

Wenn Sie Perl lernen, sollten Sie sich auch mit POD vertraut machen. Hier ist, was das ist, warum es wichtig ist und was zu tun ist, wenn Sie solche Dateien finden.

Was sind POD-Dateien?

POD steht für Plain Old Documentation, eine einfache Auszeichnungssprache, mit der Text ohne großen Aufwand formatiert werden kann. Es ähnelt der Markdown-Auszeichnungssprache 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 existieren ODER es kann als separate POD-Datei existieren. Wenn es innerhalb des Codes existiert, kann man es sich wie Kommentare in jeder anderen Programmiersprache vorstellen, außer schicker und flexibler.

#!/usr/bin/perl

Verwenden Sie streng;

Verwenden Sie Warnungen;

= Hülse

= head1 Header Beispiel

Dieses Skript macht einige coole Sachen, wie dies und das. Die folgenden Parameter müssen vorhanden sein, damit es ordnungsgemäß funktioniert. Versuchen Sie nicht, dies auf einem Computer mit Problemen zu tun.

= schneiden

print "Nur dieser Code wird ausgeführt. \ n ";

Eingebettete Dokumentation eignet sich gut für eigenständige Skripts oder wenn Sie sicherstellen möchten, dass jeder, der auf die Datei stößt, auch garantierten Zugriff auf die Dokumentation hat. Es kann jedoch mühsam sein, wenn Sie eine gesamte Codebasis auf einer höheren Ebene dokumentieren möchten.

Glücklicherweise kann POD auch verwendet werden, um Seiten des manuellen Typs zu erstellen, die besser für benutzerorientierte Dokumente geeignet sind (da Benutzer möglicherweise nicht in den Quellcode eines Skripts selbst eintauchen möchten). Das ist, wenn POD-Dateien nützlich sind.

Wie man POD-Dateien liest

Um es klar zu stellen, die eingebettete POD-Dokumentation findet sich in den eigentlichen Perl-Skriptdateien zwischen den Codezeilen, und diese Skriptdateien sind in zwei Erweiterungsformaten erhältlich: .PL oder .PM. Wenn Sie eine .POD-Erweiterung sehen, zeigt dies an, dass die Datei eine reine Dokumentation ist und keinen Quellcode enthält.

Es ist zwar möglich, POD-Dateien in einem beliebigen Texteditor, einschließlich Notepad, zu öffnen, aber das möchten Sie wahrscheinlich nur tun, wenn Sie die Rohdokumentation selbst bearbeiten. Stellen Sie sich vor, Sie würden eine HTML-Datei in einem Editor öffnen: Der gesamte Text ist schwer zu lesen.

Pod-Dokumentation-Bearbeitung

Stattdessen sollten Sie ein Lesetool verwenden, das die rohe POD-Dokumentation verwendet und sie auf leicht lesbare Weise darstellt.

Der einfachste Weg ist die Verwendung des perldoc Befehlszeilentools, das automatisch bei der Installation von Perl auf Ihrem System enthalten ist. Bei 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, eine Installationsdatei auszuführen.)

Starten Sie nun die Befehlszeile, navigieren Sie zu der Stelle, an der sich die POD-Datei befindet, und geben Sie perldoc [.POD file], um sie als korrekt formatiert anzuzeigen. Wenn die Datei beispielsweise perldoc library.pod heißt, geben Sie perldoc library.pod und das war's.

Wie man POD in andere Formate umwandelt

Obwohl das perldoc Tool nicht zu schwierig zu verwenden ist, ist es nicht gerade praktisch, wenn Sie die Dokumentation für andere freigeben oder wenn Sie sie von Ihrem Computer lesen möchten. Dann sollten Sie in ein anderes Format konvertieren.

In HTML konvertieren : Installieren und verwenden Sie das pod2html-Tool, das eine einfache Möglichkeit bietet, eine POD-Datei in eine lesbare HTML-Datei zu übersetzen. Leider kann es nur eine Eins-zu-eins-Konvertierung durchführen (Sie können also nicht mehrere POD-Dateien zu einer einzigen HTML-Datei kombinieren).

In PDF konvertieren : Installieren und verwenden Sie das pod2pdf-Tool, das ähnlich wie das oben beschriebene pod2html-Tool ist und genauso einfach zu verwenden ist, außer dass es in PDF und nicht in HTML konvertiert wird.

Eine andere Möglichkeit wäre, POD nach der oben beschriebenen Methode in HTML umzuwandeln, die HTML-Datei in einem Browser wie Chrome oder Firefox zu öffnen und dann die Seite als PDF zu drucken.

Pod-Dokumentation-Abschrift

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

In LaTeX konvertieren : Installieren und verwenden Sie das Tool pod2latex. LaTeX ist eine weitere Markup-Sprache, die weniger verbreitet ist als Markdown, aber immer beliebter als POD. LaTeX wird hauptsächlich in akademischen und wissenschaftlichen Dokumenten verwendet, aber für den Fall, dass Sie es brauchen, existiert dieser Konverter.

Konvertieren in Nur- Text: Installieren und verwenden Sie das Tool pod2text, das eine Nur-Text-Datei mit ASCII-basierter Formatierung erstellt. Sie werden das wahrscheinlich nicht brauchen, aber falls Sie das jemals tun sollten, wissen Sie, dass die Option existiert.

War dieser Beitrag hilfreich?

Sobald Sie den Dreh raus haben, sind POD-Dateien extrem einfach und bequem zu benutzen. Es gibt ein bisschen eine Lernkurve, aber es ist sehr gering - vor allem, 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 Anfänger-Programmierer. 4 Fragen, die Sie sich stellen sollten, bevor Sie lernen 4 Fragen, die Sie sich stellen sollten, bevor Sie lernen, wie man programmiert Eine Programmiersprache zu lernen ist sehr beliebt. Aber ist es für alle? Bevor Sie sich dazu verpflichten, stellen Sie sich die folgenden Fragen und seien Sie ehrlich. Weiterlesen . Schwierig zu sein bedeutet nicht unbedingt, dass du kein Programmierer sein sollst 6 Zeichen, dass du nicht ein Programmierer sein musst 6 Zeichen, dass du kein Programmierer sein musst Nicht jeder ist ein Programmierer. Wenn Sie nicht ganz sicher sind, dass Sie ein Programmierer sein sollen, sind hier einige Zeichen, die Sie in die richtige Richtung weisen können. Lesen Sie mehr, aber es ist wichtig, ehrlich zu sich selbst zu sein und Ihre Erwartungen zu erfüllen.

Davon abgesehen, beachten Sie diese Tipps für das Lernen, wie man ohne Stress programmieren kann. Wie man Programmierung ohne den ganzen Stress lernt. Wie man Programmierung ohne den ganzen Stress lernt Vielleicht haben Sie sich dafür entschieden, Programmieren zu verfolgen, sei es für eine Karriere oder einfach nur als Hobby. Groß! Aber vielleicht fängst du an, dich überwältigt zu fühlen. Nicht so toll. Hier ist Hilfe, um Ihre Reise zu erleichtern. Lesen Sie mehr und wissen Sie, wie man guten Coding-Tutorials von schlecht erzählt Was macht ein gutes Programmierungs-Tutorial? Was macht ein gutes Programmierungs-Tutorial? Nicht alle Programmiertutorials sind gleich. Einige profitieren Sie und andere am Ende verschwenden Ihre Zeit. Hier ist, was Sie in einem hochwertigen Programmier-Tutorial suchen sollten. Weiterlesen .

Wozu benutzt du Perl? Haben Sie weitere Tipps zum Teilen oder Fragen zu stellen? Lass es uns in den Kommentaren wissen!

In this article