Cum se deschide și se convertesc POD în PDF pentru a citi documentația Perl

Deși a fost odată o limbă integrală pentru programarea pe web Limbajul de programare ce trebuie învățat - Programarea pe Web Ce limba de programare să învățați - Programare web Astăzi vom examina diferitele limbi de programare web care alimentează Internetul. Aceasta este a patra parte dintr-o serie de programare pentru incepatori. În partea a 1-a, am învățat de bază ... Read More, Perl a căzut acum pe marginea drumului în favoarea unor limbi mai moderne, cum ar fi Python, Ruby și JavaScript. Foarte puțini oameni cred că merită efortul de a învăța Perl în aceste zile.

Dar asta nu înseamnă că limba este inutilă sau depășită. De fapt, o mulțime de site-uri web moderne și instrumente web se bazează pe Perl pentru operațiunile de zi cu zi - inclusiv Craigslist, IMDb și DuckDuckGo - dacă sunteți interesat să învățați acest lucru, nu lăsați pe nimeni să vă oprească sau să descurajeze tu 7 trucuri utile pentru mastering un nou limbaj de programare 7 Trucuri utile pentru mastering un nou limbaj de programare Este bine să fiți copleșiți când învățați să codificați. Probabil veți uita lucrurile cât de repede le veți învăța. Aceste sfaturi vă pot ajuta să păstrați mai bine toate informațiile noi. Citeste mai mult .

Dacă veți învăța Perl, atunci veți dori, de asemenea, să vă familiarizați cu POD. Iată ce este, de ce este important și ce să faceți atunci când rulați în astfel de fișiere.

Ce sunt fișierele POD ?.?

POD este o documentație veche obișnuită, care este un limbaj de bază de marcare utilizat pentru formatul textului fără prea mult efort implicat. Este similar cu limbajul marcaj Markdown Ce este Markdown? 4 motive pentru care ar trebui să o înveți acum Ce este Markdown? 4 motive pentru care ar trebui să-l învățați acum Obosit de editori HTML și WYSIWYG? Apoi, Markdown este răspunsul pentru dvs. indiferent cine sunteți. Citiți mai mult, dar special conceput pentru a documenta codul sursă și modulele Perl.

POD poate fi folosit în două moduri: poate exista direct în cadrul codului sursă al unui fișier Perl SAU poate exista ca un fișier POD separat. Când există în cadrul codului, vă puteți gândi la el ca la comentarii în orice alt limbaj de programare, cu excepția celui mai iubitor și mai flexibil.

#! / Usr / bin / perl

utilizați stricte;

folosiți avertismente;

= pod

= capul1 Exemplu de antet

Acest script face niște lucruri interesante, cum ar fi asta și asta. Următorii parametri trebuie să existe pentru ca acesta să funcționeze corect. Nu încercați să faceți acest lucru pe o mașină cu probleme.

= tăiat

imprimare “Numai acest cod este executat. \ n”;

Documentația încorporată funcționează bine pentru scripturile independente sau când doriți să vă asigurați că oricine întâlnește fișierul a garantat de asemenea accesul la documentație, dar poate fi greoaie atunci când doriți să documentați o întreaga bază de coduri la un nivel mai înalt.

Din fericire, POD poate fi folosit și pentru a crea pagini de tip manual care sunt mai potrivite pentru documente orientate spre utilizator (deoarece este posibil ca utilizatorii să nu vrea să se îmbrace în codul sursă al unui script în sine). Atunci când fișierele POD sunt la îndemână.

Cum se citește fișierele POD

Pentru a fi clar, documentația POD încorporată se găsește în fișierele script perl existente între liniile de cod, iar aceste fișiere script se găsesc în unul din cele două formate de extensie: .PL sau .PM. Când vedeți o extensie .POD, aceasta indică faptul că fișierul este o documentație pură și nu include nici un cod sursă.

În timp ce este posibil să deschideți fișiere POD în orice editor de text, inclusiv în Notepad, probabil că doriți doar să faceți acest lucru dacă editați documentația în sine. Gândiți-vă cum ar fi deschiderea unui fișier HTML într-un editor: cu tot marcajul, conținutul textului real este greu de citit.

În schimb, ar trebui să utilizați un fel de instrument de citire care să ia documentația raw POD și să o prezinte într-un mod ușor de citit.

Cea mai ușoară cale este să utilizați perldoc comanda liniei de comandă care este inclusă automat când Perl este instalat în sistemul dvs. Cele mai multe sisteme OS X și Linux vin cu Perl deja instalat, dar utilizatorii de Windows vor trebui să-l instaleze manual. (Din fericire, nu este mai greu decât executarea unui fișier de instalare.)

Acum, lansați linia de comandă, navigați la locația unde se află fișierul POD și tastați fișierul perldoc [.POD] pentru ao vizualiza ca formatat corect. De exemplu, dacă fișierul a fost denumit library.pod atunci veți scrie perldoc library.pod si asta e.

Cum se convertesc POD la alte formate

Chiar dacă perldoc instrumentul nu este prea greu de utilizat, nu este exact convenabil atunci când doriți să partajați documentația cu alții sau când doriți să o citiți departe de computer. Atunci este posibil să doriți să luați în considerare conversia într-un alt format.

Conversia în HTML: Instalați și utilizați instrumentul pod2html care oferă o modalitate ușoară de a traduce orice fișier POD într-un fișier HTML care poate fi citit. Din păcate, poate efectua o conversie unu-la-unu (astfel încât să nu puteți combina mai multe fișiere POD într-un singur fișier HTML).

Conversia în PDF: Instalați și utilizați instrumentul pod2pdf, care este similar și la fel de ușor de utilizat ca și instrumentul pod2html de mai sus, cu excepția faptului că convertește mai degrabă în format PDF decât în ​​format HTML.

O altă opțiune ar fi conversia POD în HTML utilizând metoda de mai sus, deschiderea fișierului HTML într-un browser precum Chrome sau Firefox, apoi imprimarea paginii ca PDF.

Conversia la Markdown: Instalați și utilizați instrumentul pod2markdown pentru a traduce între POD și Markdown. Markdown este un limbaj de markup pentru scopuri generale, ceea ce înseamnă că utilizatorii au mai multe șanse să fie familiarizați cu acesta și există mai multe instrumente care pot accepta și afișa Markdown.

Conversia la LaTeX: Instalați și utilizați instrumentul pod2latex. LaTeX este un alt limbaj de markup, unul mai puțin cunoscut decât Markdown, dar mai popular decât POD. LaTeX este utilizat în principal în documente academice și științifice, dar în cazul în care aveți nevoie de el, acest convertor există.

Conversia în Text simplu: Instalați și utilizați instrumentul pod2text, care produce un fișier cu text numai cu formatare bazată pe ASCII. Probabil că nu va trebui să folosiți acest lucru, dar dacă veți face vreodată, știți că există opțiunea.

A fost acest post util?

Odată ce ați atârnat de ea, fișierele POD sunt extrem de simple și convenabile de utilizat. Există un pic de curbă de învățare, dar este foarte minor - mai ales dacă ați folosit un limbaj de markup înainte. Sperăm că acum vă simțiți confortabil în legătură cu fișierele POD.

Dacă vă simțiți copleșiți, întrebați-vă aceste întrebări importante pentru codificatorii newbie 4 Întrebări pentru a vă întreba înainte de a învăța Cum de a codifica 4 întrebări pentru a vă întreba înainte de a învăța Cum de a codifica Învățarea unui limbaj de programare este popular. Dar este pentru toata lumea? Înainte de a vă angaja, adresați-vă următoarele întrebări și fiți cinstiți. Citeste mai mult . Dificultatea nu înseamnă neapărat că nu trebuie să fii programator. 6 Semne că nu înseamnă să fii programator 6 Semne că nu înseamnă să fii programator Nu toată lumea este tăiată ca programator. Dacă nu sunteți sigur că sunteți menit să fii programator, iată câteva semne care vă pot îndruma în direcția cea bună. Citește mai mult, dar este important să fiți sincer cu dvs. și să vă gestionați așteptările.

Acestea fiind spuse, luati in considerare aceste sfaturi pentru a invata cum sa codati fara stres Cum sa invatati programarea fara toata stresul Cum sa invatati programarea fara toata stresul Poate ca v-ati decis sa urmariti programarea, fie pentru o cariera, fie ca un hobby. Grozav! Dar poate că începi să te simți copleșit. Nu prea grozav. Iată ajutorul pentru a vă ușura călătoria. Citiți mai multe și știind cum să spuneți tutoriale bune de codare de la rău Ce face un bun tutorial de programare? Ce face un bun tutorial de programare? Nu toate tutorialele de programare sunt egale. Unele beneficiază de tine și de ceilalți ajung să-ți pierzi timpul. Iată ce să căutați într-un tutorial de programare de calitate. Citeste mai mult .

Pentru ce folosiți Perl? Ai alte sfaturi pentru a partaja sau pentru a pune întrebări? Spuneți-ne în comentariile de mai jos!

Explorați mai multe despre: conversia fișierelor, PDF, programare.