Πώς να ανοίξετε και να μετατρέψετε το POD σε PDF για να διαβάσετε την τεκμηρίωση Perl

Ένα αρχείο POD είναι η απλή παλιά τεκμηρίωση της γλώσσας προγραμματισμού Perl. Σας δείχνουμε πώς να μετατρέψετε το POD σε PDF, HTML, Markdown, LaTeX ή απλό κείμενο.

Ένα αρχείο POD είναι η απλή παλιά τεκμηρίωση της γλώσσας προγραμματισμού Perl.  Σας δείχνουμε πώς να μετατρέψετε το POD σε PDF, HTML, Markdown, LaTeX ή απλό κείμενο.
Διαφήμιση

Αν και ήταν κάποτε μια αναπόσπαστη γλώσσα για τον προγραμματισμό web Ποια γλώσσα προγραμματισμού για να μάθετε - Προγραμματισμός ιστού Ποια γλώσσα προγραμματισμού για να μάθετε - Προγραμματισμός Web Σήμερα θα ρίξουμε μια ματιά στις διάφορες γλώσσες προγραμματισμού στο διαδίκτυο που τροφοδοτούν το Internet. Αυτό είναι το τέταρτο μέρος σε μια σειρά αρχαρίων προγραμματισμού. Στο μέρος 1, μάθαμε τις βασικές ... Διαβάστε περισσότερα, Perl έχει πέσει τώρα από το δρόμο υπέρ των πιο σύγχρονων γλωσσών όπως Python, Ruby, και JavaScript. Πολύ λίγοι άνθρωποι σκέφτονται ότι αξίζει την προσπάθεια να μάθουν Perl αυτές τις μέρες.

Αλλά αυτό δεν σημαίνει ότι η γλώσσα είναι άχρηστη ή ξεπερασμένη. Στην πραγματικότητα, πολλοί σύγχρονοι ιστότοποι και εργαλεία ιστού εξακολουθούν να βασίζονται στον Perl για καθημερινές λειτουργίες - συμπεριλαμβανομένων των Craigslist, IMDb και DuckDuckGo - οπότε αν σας ενδιαφέρει να το μάθετε, μην αφήσετε κανέναν να σας σταματήσει ή να αποτρέψει σας 7 Χρήσιμα τεχνάσματα για τη διδασκαλία μιας νέας γλώσσας προγραμματισμού 7 Χρήσιμα τεχνάσματα για τη διδασκαλία μιας νέας γλώσσας προγραμματισμού Είναι εντάξει να είστε συγκλονισμένοι όταν μαθαίνετε να κωδικοποιείτε. Ίσως θα ξεχάσετε τα πράγματα τόσο γρήγορα όσο τα μαθαίνετε. Αυτές οι συμβουλές μπορούν να σας βοηθήσουν να διατηρήσετε καλύτερα όλες αυτές τις νέες πληροφορίες. Διαβάστε περισσότερα .

Εάν πρόκειται να μάθετε Perl, τότε θα θέλετε επίσης να εξοικειωθούν με POD. Εδώ είναι τι είναι αυτό, γιατί είναι σημαντικό, και τι πρέπει να κάνετε όταν συναντάτε τέτοια αρχεία.

Τι είναι τα αρχεία POD;

Το POD υποδηλώνει την απλή παλιά τεκμηρίωση, η οποία είναι μια βασική γλώσσα σήμανσης που χρησιμοποιείται για τη μορφοποίηση κειμένου χωρίς πολύ μεγάλη προσπάθεια. Είναι παρόμοιο με τη γλώσσα Markdown Markup What Is Markdown? 4 λόγοι για τους οποίους πρέπει να το μάθετε τώρα Τι είναι Markdown; 4 λόγοι για τους οποίους πρέπει να το μάθετε τώρα Κουρασμένος από τους εκδότες HTML και WYSIWYG; Τότε Markdown είναι η απάντηση για σας, δεν έχει σημασία ποιος είσαι. Διαβάστε περισσότερα, αλλά ειδικά σχεδιασμένα για την τεκμηρίωση του πηγαίου κώδικα και των ενοτήτων του Perl.

Το POD μπορεί να χρησιμοποιηθεί με δύο τρόπους: μπορεί να υπάρχει απευθείας μέσα στον πηγαίο κώδικα ενός αρχείου Perl Ή μπορεί να υπάρχει ως ξεχωριστό αρχείο POD. Όταν υπάρχει μέσα στον κώδικα, μπορείτε να το σκεφτείτε σαν σχόλια σε οποιαδήποτε άλλη γλώσσα προγραμματισμού, εκτός από τα πιο φτηνά και πιο ευέλικτα.

#!/usr/bin/perl

χρήση αυστηρή?

χρήση προειδοποιήσεων.

= pod

= κεφαλίδα1 Παράδειγμα κεφαλίδας

Αυτό το σενάριο κάνει μερικά δροσερά πράγματα, όπως αυτό και αυτό. Πρέπει να υπάρχουν οι ακόλουθες παράμετροι για να λειτουργήσει σωστά. Μην προσπαθήσετε να το κάνετε αυτό σε μια μηχανή με προβλήματα.

= κοπεί

print "Εκτελείται μόνο αυτός ο κώδικας. \ n ";

Η ενσωματωμένη τεκμηρίωση λειτουργεί καλά για αυτόνομα σενάρια ή όταν θέλετε να βεβαιωθείτε ότι όποιος συναντά το αρχείο έχει επίσης εγγυηθεί την πρόσβαση στην τεκμηρίωση, αλλά μπορεί να είναι δυσκίνητη όταν θέλετε να τεκμηριώσετε ολόκληρο τον κώδικα σε υψηλότερο επίπεδο.

Ευτυχώς, το POD μπορεί επίσης να χρησιμοποιηθεί για τη δημιουργία σελίδων χειροκίνητου τύπου που είναι πιο κατάλληλα για έγγραφα με γνώμονα το χρήστη (δεδομένου ότι οι χρήστες ενδέχεται να μην θέλουν να βυθιστούν στον πηγαίο κώδικα ενός ίδιου του σεναρίου). Αυτό συμβαίνει όταν τα αρχεία POD είναι χρήσιμα.

Πώς να διαβάσετε αρχεία POD

Για να είναι σαφές, η ενσωματωμένη τεκμηρίωση POD βρίσκεται μέσα στα πραγματικά αρχεία δέσμης ενεργειών Perl μεταξύ των γραμμών κώδικα και αυτά τα αρχεία δέσμης ενεργειών έρχονται σε μία από τις δύο μορφές επέκτασης: .PL ή .PM. Όταν βλέπετε μια επέκταση .POD, υποδηλώνει ότι το αρχείο είναι καθαρή τεκμηρίωση και δεν περιλαμβάνει πηγαίο κώδικα.

Παρόλο που είναι δυνατό να ανοίξετε αρχεία POD σε οποιοδήποτε πρόγραμμα επεξεργασίας κειμένου, συμπεριλαμβανομένου του Σημειωματάριου, ίσως θέλετε να το κάνετε αυτό μόνο αν επεξεργάζεστε την ίδια την αρχική τεκμηρίωση. Σκεφτείτε το όπως το άνοιγμα ενός αρχείου HTML σε ένα πρόγραμμα επεξεργασίας: με όλο το markup, το πραγματικό περιεχόμενο κειμένου είναι δύσκολο να διαβαστεί.

υπο-τεκμηρίωση-επεξεργασία

Αντ 'αυτού, θα πρέπει να χρησιμοποιήσετε κάποιο είδος εργαλείου αναγνώστης που παίρνει την ακατέργαστη τεκμηρίωση POD και το παρουσιάζει με τρόπο εύκολο να το διαβάσετε.

Ο ευκολότερος τρόπος είναι να χρησιμοποιήσετε το εργαλείο γραμμής εντολών perldoc που συμπεριλαμβάνεται αυτόματα όταν το Perl είναι εγκατεστημένο στο σύστημά σας. Τα περισσότερα συστήματα OS X και Linux έρχονται με το Perl ήδη εγκατεστημένο, αλλά οι χρήστες των Windows θα πρέπει να το εγκαταστήσουν με το χέρι. (Ευτυχώς, δεν είναι πιο δύσκολο από το να τρέχετε ένα αρχείο εγκατάστασης.)

Τώρα ξεκινήστε τη γραμμή εντολών, περιηγηθείτε στο σημείο όπου βρίσκεται το αρχείο POD και πληκτρολογήστε το perldoc [.POD file] για να το δείτε ως σωστά διαμορφωμένο. Για παράδειγμα, αν το αρχείο ονομάστηκε library.pod τότε θα πληκτρολογείτε perldoc library.pod και αυτό είναι.

Πώς να μετατρέψετε το POD σε άλλες μορφές

Παρόλο που το εργαλείο perldoc δεν είναι πολύ δύσκολο να χρησιμοποιηθεί, δεν είναι ακριβώς βολικό όταν θέλετε να μοιραστείτε την τεκμηρίωση με άλλους ή όταν θέλετε να το διαβάσετε μακριά από τον υπολογιστή σας. Τότε μπορεί να θέλετε να εξετάσετε τη μετατροπή σε άλλη μορφή.

Μετατροπή σε HTML: Εγκαταστήστε και χρησιμοποιήστε το εργαλείο pod2html το οποίο παρέχει έναν εύκολο τρόπο για να μεταφράσετε οποιοδήποτε αρχείο POD σε ένα ευανάγνωστο αρχείο HTML. Δυστυχώς, μπορεί να πραγματοποιήσει μόνο μετατροπή ένας προς έναν (έτσι δεν μπορείτε να συνδυάσετε πολλά αρχεία POD σε ένα μόνο αρχείο HTML).

Μετατροπή σε PDF: Εγκαταστήστε και χρησιμοποιήστε το εργαλείο pod2pdf, το οποίο είναι παρόμοιο και εξίσου εύκολο με το εργαλείο pod2html παραπάνω, εκτός από το ότι μετατρέπει σε PDF αντί HTML.

Μια άλλη επιλογή θα ήταν να μετατρέψετε το POD σε HTML χρησιμοποιώντας την παραπάνω μέθοδο, να ανοίξετε το αρχείο HTML σε ένα πρόγραμμα περιήγησης όπως το Chrome ή τον Firefox και στη συνέχεια να εκτυπώσετε τη σελίδα ως PDF.

υπο-τεκμηρίωση-markdown

Μετατροπή σε Markdown: Εγκαταστήστε και χρησιμοποιήστε το εργαλείο pod2markdown για μετάφραση μεταξύ POD και Markdown. Το Markdown είναι μια γενική γλώσσα σήμανσης, που σημαίνει ότι οι χρήστες είναι πιο πιθανό να εξοικειωθούν με αυτό και υπάρχουν περισσότερα εργαλεία εκεί έξω που μπορούν να αποδεχθούν και να εμφανίσουν το Markdown.

Μετατροπή σε LaTeX: Εγκαταστήστε και χρησιμοποιήστε το εργαλείο pod2latex. Το LaTeX είναι μια άλλη γλώσσα σήμανσης, η οποία είναι λιγότερο κοινή από την Markdown, αλλά είναι ακόμα πιο δημοφιλής από την POD. Το LaTeX χρησιμοποιείται κυρίως σε ακαδημαϊκά και επιστημονικά έγγραφα, αλλά σε περίπτωση που το χρειάζεστε, ο μετατροπέας αυτός υπάρχει.

Μετατροπή σε απλό κείμενο: Εγκαταστήστε και χρησιμοποιήστε το εργαλείο pod2text, το οποίο παράγει ένα αρχείο μόνο για κείμενο με μορφοποίηση βασισμένη σε ASCII. Πιθανώς δεν θα χρειαστεί να το χρησιμοποιήσετε, αλλά σε περίπτωση που κάνετε ποτέ, ξέρετε ότι υπάρχει η επιλογή.

Αυτή η δημοσίευση ήταν χρήσιμη;

Μόλις το κρεμάσετε, τα αρχεία POD είναι εξαιρετικά απλά και βολικά χρήσιμα. Υπάρχει μια καμπύλη μάθησης, αλλά είναι πολύ μικρή - ειδικά αν έχετε χρησιμοποιήσει μια γλώσσα σήμανσης πριν. Ας ελπίσουμε ότι τώρα αισθάνεστε άνετα να ασχολείστε με τα αρχεία POD.

Εάν αισθάνεστε συγκλονισμένοι, ρωτήστε τον εαυτό σας αυτές τις σημαντικές ερωτήσεις για τους κωδικοποιητές newbie 4 ερωτήσεις για να ρωτήσετε τον εαυτό σας πριν μάθετε πώς να κωδικοποιήσετε 4 ερωτήσεις για να ρωτήσετε τον εαυτό σας πριν μάθετε πώς να κωδικοποιήσετε τη γλώσσα προγραμματισμού είναι δημοφιλής. Αλλά είναι για όλους; Πριν δεσμευθείτε σε αυτό, αναρωτηθείτε τις ακόλουθες ερωτήσεις και είστε ειλικρινείς. Διαβάστε περισσότερα . Έχοντας δυσκολία δεν σημαίνει απαραίτητα ότι δεν είστε πρόθυμοι να είστε προγραμματιστής 6 Σημάδια που δεν σημαίνει ότι πρέπει να είστε προγραμματιστής 6 Σημάδια που δεν σας ενδιαφέρουν να είστε προγραμματιστές Όχι ο καθένας κόβεται να είναι προγραμματιστής. Εάν δεν είστε απόλυτα σίγουροι ότι θέλετε να είστε προγραμματιστής, υπάρχουν μερικές ενδείξεις που μπορεί να σας οδηγήσουν προς τη σωστή κατεύθυνση. Διαβάστε περισσότερα, αλλά είναι σημαντικό να είστε ειλικρινείς με τον εαυτό σας και να διαχειριστείτε τις προσδοκίες σας.

Τούτου λεχθέντος, λάβετε υπόψη αυτές τις συμβουλές για να μάθετε πώς να κωδικοποιείτε χωρίς άγχος Πώς να μάθετε τον προγραμματισμό χωρίς το άγχος Πώς να μάθετε τον προγραμματισμό χωρίς όλο το άγχος Ίσως έχετε αποφασίσει να συνεχίσετε τον προγραμματισμό, είτε για μια σταδιοδρομία είτε για ένα χόμπι. Εξαιρετική! Αλλά ίσως αρχίζετε να αισθάνεστε συγκλονισμένοι. Οχι και τόσο καλό. Εδώ μπορείτε να διευκολύνετε το ταξίδι σας. Διαβάστε περισσότερα και γνωρίζοντας πώς να πείτε καλά μαθήματα κωδικοποίησης από το κακό Τι κάνει ένα σωστό πρόγραμμα προγραμματισμού; Τι κάνει ένα σωστό πρόγραμμα προγραμματισμού; Δεν είναι όλα τα tutorials προγραμματισμού ισότιμα. Ορισμένοι σας ωφελούν και οι άλλοι καταλήγουν να χάνουν το χρόνο σας. Εδώ είναι τι να αναζητήσετε σε ένα ποιοτικό φροντιστήριο προγραμματισμού. Διαβάστε περισσότερα .

Για τι χρησιμοποιείτε το Perl; Έχετε άλλες συμβουλές για να μοιραστείτε ή να θέσετε ερωτήσεις; Ενημερώστε μας στα σχόλια παρακάτω!

In this article