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

Διαφήμιση

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

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

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

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

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

Το POD αντιπροσωπεύει την απλή παλιά τεκμηρίωση, η οποία είναι μια βασική γλώσσα σήμανσης που χρησιμοποιείται για τη μορφοποίηση κειμένου χωρίς πολύ μεγάλη προσπάθεια. Είναι παρόμοιο με τη γλώσσα σήμανσης Markdown Τι είναι 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 αρχείο] για να το δείτε ως σωστά διαμορφωμένο. Για παράδειγμα, εάν ονομάστηκε το αρχείο 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: Εγκαταστήστε και χρησιμοποιήστε το pod2markdown εργαλείο για μετάφραση μεταξύ POD και Markdown. Το Markdown είναι μια γενική γλώσσα σήμανσης, που σημαίνει ότι οι χρήστες είναι πιο πιθανό να εξοικειωθούν με αυτό και υπάρχουν περισσότερα εργαλεία εκεί έξω που μπορούν να δεχτούν και να εμφανίσουν το Markdown.

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

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

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

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

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

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

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