Come aprire e convertire POD in PDF per leggere la documentazione Perl

Annuncio pubblicitario

Anche se una volta era un linguaggio integrale per la programmazione web Quale linguaggio di programmazione imparare - Programmazione WebOggi daremo uno sguardo ai vari linguaggi di programmazione web che alimentano Internet. Questa è la quarta parte di una serie di programmi per principianti. Nella parte 1, abbiamo imparato le basi di ... Leggi di più , Perl è ormai caduto a favore di linguaggi più moderni come Python, Ruby e JavaScript. Pochissime persone pensano che valga la pena imparare il Perl in questi giorni.

Ciò non significa che la lingua sia inutile o obsoleta. In effetti, molti siti Web e strumenti web moderni fanno ancora affidamento su Perl per le operazioni quotidiane - tra cui Craigslist, IMDb e DuckDuckGo - quindi se sei interessato a impararlo, non permettere a nessuno di fermarti o dissuaderti 7 trucchi utili per padroneggiare un nuovo linguaggio di programmazioneVa bene essere sopraffatto quando stai imparando a programmare. Probabilmente dimenticherai le cose velocemente come le impari. Questi suggerimenti possono aiutarti a conservare meglio tutte queste nuove informazioni.

Leggi di più .

Se hai intenzione di imparare il Perl, allora vorrai anche conoscere il POD. Ecco cos'è, perché è importante e cosa fare quando ci si imbatte in tali file.

Cosa sono i file POD?

POD sta per Plain Old Documentation, che è un linguaggio di markup di base che viene utilizzato per formattare il testo senza troppi sforzi. È simile a il linguaggio di markup Markdown Che cos'è Markdown? 4 motivi per cui dovresti impararlo oraStanco degli editor HTML e WYSIWYG? Quindi Markdown è la risposta per te, non importa chi tu sia. Leggi di più , ma specificamente progettato per documentare il codice sorgente e i moduli Perl.

Il POD può essere utilizzato in due modi: può esistere direttamente all'interno del codice sorgente di un file Perl OPPURE può esistere come file POD separato. Quando esiste all'interno del codice, puoi pensarlo come commenti in qualsiasi altro linguaggio di programmazione, tranne che più elaborato e più flessibile.

#! / Usr / bin / perl

usare rigoroso;

usare avvertenze;

= pod

= head1 Esempio di intestazione

Questo script fa cose interessanti, come questa e quella. I seguenti parametri devono esistere affinché funzioni correttamente. Non provare a farlo su una macchina con problemi.

= taglio

print “Viene eseguito solo questo codice. \ N”;

La documentazione integrata funziona bene per gli script autonomi o quando si desidera assicurarsi che anche chiunque si imbatta nel file ha garantito l'accesso alla documentazione, ma può essere ingombrante quando si desidera documentare un'intera base di codice in un livello superiore livello.

Fortunatamente, POD può anche essere utilizzato per creare pagine di tipo manuale più adatte ai documenti orientati all'utente (poiché gli utenti potrebbero non voler approfondire il codice sorgente di uno script stesso). Questo è quando i file POD sono utili.

Come leggere i file POD

Per essere chiari, la documentazione POD incorporata si trova all'interno dei file di script Perl effettivi tra le righe di codice e questi file di script sono disponibili in uno dei due formati di estensione: .PL o .PM. Quando vedi un'estensione .POD, indica che il file è pura documentazione e non include alcun codice sorgente.

Sebbene sia possibile aprire i file POD in qualsiasi editor di testo incluso il Blocco note, è probabile che tu voglia farlo solo se stai effettivamente modificando la documentazione grezza stessa. Pensalo come se aprissi un file HTML in un editor: con tutto il markup, il contenuto del testo effettivo è difficile da leggere.

Invece, dovresti usare un qualche strumento di lettura che prende la documentazione POD grezza e la presenta in un modo di facile lettura.

Il modo più semplice è usare il perldoc strumento da riga di comando che viene incluso automaticamente quando Perl è installato sul tuo sistema. La maggior parte dei sistemi OS X e Linux viene fornito con Perl già installato, ma gli utenti Windows dovranno installarlo manualmente. (Fortunatamente, non è più difficile che eseguire un file di installazione.)

Ora avvia la riga di comando, vai dove si trova il file POD e digita perldoc [.POD file] per vederlo come formattato correttamente. Ad esempio, se il file è stato nominato library.pod allora digiti perldoc library.pod e questo è tutto.

Come convertire POD in altri formati

Anche se il perldoc lo strumento non è troppo difficile da usare, non è esattamente conveniente quando si desidera condividere la documentazione con altri o quando si desidera leggerla dal computer. È allora che potresti voler prendere in considerazione la conversione in un altro formato.

Conversione in HTML: Installa e usa il pod2html strumento che fornisce un modo semplice per tradurre qualsiasi file POD in un file HTML leggibile. Sfortunatamente, può eseguire solo una conversione uno a uno (quindi non puoi combinare più file POD in un singolo file HTML).

Conversione in PDF: Installa e usa il pod2pdf strumento, che è simile e altrettanto facile da usare come lo strumento pod2html sopra, tranne che converte in PDF anziché HTML.

Un'altra opzione sarebbe quella di convertire POD in HTML usando il metodo mostrato sopra, aprire il file HTML in un browser come Chrome o Firefox e quindi stampare la pagina come PDF.

Conversione in Markdown: Installa e usa il pod2markdown strumento per tradurre tra POD e Markdown. Markdown è un linguaggio di markup per scopi generici, il che significa che gli utenti hanno maggiori probabilità di conoscerlo e ci sono più strumenti là fuori che possono accettare e visualizzare Markdown.

Conversione in LaTeX: Installa e usa il pod2latex attrezzo. LaTeX è un altro linguaggio di markup, uno che è meno comune di Markdown, ma ancora più popolare di POD. LaTeX viene utilizzato principalmente nei documenti accademici e scientifici, ma nel caso in cui ne abbiate bisogno, questo convertitore esiste.

Conversione in testo normale: Installa e usa il pod2text strumento, che produce un file di solo testo con formattazione basata su ASCII. Probabilmente non avrai bisogno di usarlo, ma nel caso in cui lo fai, sappi che l'opzione esiste.

Questo post è stato utile?

Una volta capito, i file POD sono estremamente semplici e convenienti da usare. C'è un po 'di una curva di apprendimento, ma è molto minore, soprattutto se prima hai usato un linguaggio di markup. Spero che ora ti senta a tuo agio nel gestire i file POD.

Se ti senti sopraffatto, chiediti questi domande importanti per i programmatori principianti 4 domande da porsi prima di imparare a programmareL'apprendimento di un linguaggio di programmazione è popolare. Ma è per tutti? Prima di impegnarti, poni le seguenti domande e sii onesto. Leggi di più . Avere difficoltà non significa necessariamente che non intendi essere un programmatore 6 segni che non intendi essere un programmatoreNon tutti sono fatti per essere programmatori. Se non sei del tutto sicuro di essere programmatore, ecco alcuni segnali che potrebbero indirizzarti nella giusta direzione. Leggi di più , ma è importante essere onesti con te stesso e gestire le tue aspettative.

Detto questo, segui questi suggerimenti per imparare a programmare senza stress Come imparare a programmare senza stressForse hai deciso di perseguire la programmazione, sia per una carriera o semplicemente per hobby. Grande! Ma forse stai iniziando a sentirti sopraffatto. Non così eccezionale. Ecco un aiuto per facilitare il tuo viaggio. Leggi di più e sapere come distinguere buoni tutorial di programmazione da quelli cattivi Cosa rende un buon tutorial di programmazione?Non tutti i tutorial di programmazione sono uguali. Alcuni avvantaggiano te e altri finiscono per perdere tempo. Ecco cosa cercare in un tutorial di programmazione di qualità. Leggi di più .

Per cosa stai usando Perl? Hai altri suggerimenti da condividere o domande da porre? Fateci sapere nei commenti qui sotto!