Cum să deschideți și să convertiți POD în PDF pentru a citi documentația Perl

Publicitate

Deși a fost odată an limbaj integral pentru programarea web Care limbaj de programare să înveți - Programare webAstăzi vom arunca o privire asupra diferitelor limbaje de programare web care alimentează Internetul. Aceasta este a patra parte dintr-o serie de programare pentru începători. În partea 1, am învățat elementele de bază ale ... Citeste mai mult , Perl a căzut acum în favoarea unor limbi mai moderne precum 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 învechită. De fapt, o mulțime de site-uri web și instrumente web moderne încă se bazează pe Perl pentru operațiuni de zi cu zi - inclusiv Craigslist, IMDb și DuckDuckGo - deci dacă sunteți interesat să îl aflați, nu lăsa pe nimeni să te oprească sau să te descurajeze 7 trucuri utile pentru stăpânirea unui limbaj de programare nouEste în regulă să fii copleșit când înveți să faci cod. Probabil că veți uita lucrurile la fel de repede când le veți învăța. Aceste sfaturi vă pot ajuta să păstrați mai bine toate aceste informații 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 acesta, de ce este important și ce trebuie să faceți când vă confruntați cu astfel de fișiere.

Ce sunt fișierele POD?

POD reprezintă documentația simplă, care este un limbaj de marcare de bază care este folosit pentru formatarea textului, fără a face eforturi mari. Este similar cu limbajul de marcaj Markdown Ce este Markdown? 4 motive pentru care ar trebui să o înveți acumS-a săturat de editorii HTML și WYSIWYG? Atunci Markdown este răspunsul pentru tine indiferent de cine ești. Citeste mai mult , dar special conceput pentru documentarea codului sursă și a modulelor Perl.

POD poate fi utilizat în două moduri: poate exista direct în cadrul codului sursă al unui fișier Perl sau poate exista ca fișier POD separat. Atunci când există în cadrul codului, puteți gândi la el ca la comentarii în orice alt limbaj de programare, cu excepția celor mai interesante și mai flexibile.

#! / Usr / bin / perl

utilizați strict;

folosiți avertismente;

= pod

= head1 Exemplu antet

Acest script face niște chestii mișto, de genul acesta. 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.

= cut

print „Numai acest cod este executat. \ N“;

Documentația încorporată funcționează bine pentru scripturi autonome sau atunci când doriți să vă asigurați că, de asemenea, oricine se ocupă cu fișierul are acces la documentație, dar poate fi greoaie atunci când doriți să documentați o întreagă bază de cod la un nivel mai mare nivel.

Din fericire, POD poate fi folosit și pentru a crea pagini de tip manual, care sunt mai potrivite pentru documentele orientate către utilizator (din moment ce utilizatorii pot să nu dorească să aducă în sine codul sursă al unui script). Atunci este posibil ca fișierele POD să fie utile.

Cum să citiți fișiere POD

Pentru a fi clar, documentația POD încorporată se găsește în fișierele scriptului Perl efectiv între linii de cod, iar aceste fișiere script au unul dintre cele două formate de extensii: .PL sau .PM. Când vedeți o extensie .POD, indică faptul că fișierul este documentație pură și nu include niciun cod sursă.

Deși este posibil să deschideți fișiere POD în orice editor de text, inclusiv Notepad, probabil că doriți să faceți asta numai dacă editați efectiv documentația brută în sine. Gândiți-vă la acesta ca la deschiderea unui fișier HTML într-un editor: cu toate marcajele, conținutul textului este greu de citit.

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

Cel mai simplu mod este de a utiliza perldoc instrument de linie de comandă care este inclus automat când Perl este instalat în sistemul dvs.. Majoritatea sistemelor OS X și Linux vin cu Perl deja instalat, însă utilizatorii Windows vor trebui să-l instaleze manual. (Din fericire, nu este mai greu decât rularea unui fișier de instalare.)

Lansați acum linia de comandă, navigați până unde se află fișierul POD și tastați perldoc [fișier .POD] pentru a-l vizualiza ca formatat corect. De exemplu, dacă fișierul a fost numit library.pod atunci ați tipat perldoc library.pod si asta e.

Cum să convertiți POD în alte formate

Chiar dacă perldoc instrumentul nu este prea dificil de utilizat, nu este tocmai convenabil 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 în alt format.

Conversia la HTML: Instalați și utilizați pod2html instrument care oferă o modalitate simplă de a traduce orice fișier POD într-un fișier HTML care poate fi citit. Din păcate, poate efectua doar o conversie unu la unu (deci nu puteți combina mai multe fișiere POD într-un singur fișier HTML).

Convertirea în PDF: Instalați și utilizați pod2pdf instrument, care este similar și la fel de ușor de utilizat ca instrumentul pod2html de mai sus, cu excepția faptului că se transformă în PDF și nu în HTML.

O altă opțiune ar fi să convertiți POD în HTML folosind metoda prezentată mai sus, să deschideți fișierul HTML într-un browser precum Chrome sau Firefox, apoi să imprimați pagina ca PDF.

Conversia la Markdown: Instalați și utilizați pod2markdown instrument de traducere între POD și Markdown. Markdown este un limbaj general de marcare, ceea ce înseamnă că utilizatorii sunt mai familiari cu el și există mai multe instrumente care pot accepta și afișa Markdown.

Convertirea în LaTeX: Instalați și utilizați pod2latex instrument. LaTeX este un alt limbaj de marcare, unul mai puțin obișnuit decât Markdown, dar totuși mai popular decât POD. LaTeX este utilizat în principal în documente academice și științifice, dar în cazul în care aveți nevoie, acest convertor există.

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

Acest mesaj a fost util?

După ce ați obținut blocajul, 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ă ai mai folosit un limbaj de marcare. Sperăm că acum vă simțiți confortabil când tratați fișiere POD.

Dacă vă simțiți copleșiți, întrebați-vă acestea întrebări importante pentru codificatorii începători 4 întrebări pentru a vă pune înainte de a învăța cum să codațiÎnvățarea unui limbaj de programare este populară. Dar este pentru toată lumea? Înainte de a vă angaja, puneți-vă următoarele întrebări și fiți sinceri. Citeste mai mult . A avea dificultăți nu înseamnă neapărat asta nu trebuie să fii programator 6 semne că nu vrei să fii programatorNu toată lumea este tăiată pentru a fi programator. Dacă nu sunteți complet sigur că sunteți menit să fiți un programator, iată câteva semne care vă pot indica în direcția corectă. Citeste mai mult , dar este important să fii sincer cu tine însuți și să îți gestionezi așteptările.

Acestea fiind spuse, aveți în vedere aceste sfaturi învățarea a coda fără stres Cum să înveți programarea fără toată stresulPoate că ai decis să urmărești programarea, fie pentru o carieră, fie doar pentru un hobby. Grozav! Dar poate că începi să te simți copleșit. Nu prea grozav. Iată ajutor pentru a vă ușura călătoria. Citeste mai mult și știind cum să spui tutoriale bune de codare de la rău Ce face un bun program de programare?Nu toate tutorialele de programare sunt egale. Unii beneficiază de tine, iar alții sfârșesc să-ți pierzi timpul. Iată ce să caute într-un tutorial de programare de calitate. Citeste mai mult .

Pentru ce folosești Perl? Aveți alte sfaturi de distribuit sau întrebări de pus? Spuneți-ne în comentariile de mai jos!