Kako otvoriti i pretvoriti POD u PDF za čitanje Perl dokumentacije

Iako je to nekoć bio integralni jezik za web programiranje Koji programski jezik za učenje - Web programiranje Koji programski jezik za učenje - Web programiranje Danas ćemo pogledati razne jezike web programiranja koji pokreću Internet. Ovo je četvrti dio u seriji za početnike programiranja. U prvom dijelu smo naučili osnovne…, Perl je sada pao na stranu modernih jezika poput Python, Ruby i JavaScript. Vrlo malo ljudi misli da je vrijedno truda naučiti Perl ovih dana.

Ali to ne znači da je jezik beskoristan ili zastario. Zapravo, mnoštvo suvremenih web stranica i web alata i dalje se oslanja na Perl za svakodnevne operacije - uključujući Craigslist, IMDb i DuckDuckGo - pa ako ste zainteresirani za učenje, ne dozvolite da vas niko zaustavi ili odvraća vi 7 korisni trikovi za savladavanje novog jezika programiranja 7 korisni trikovi za savladavanje novog jezika programiranja U redu je biti preopterećen kada učite kodirati. Vjerojatno ćete zaboraviti stvari čim ih naučite. Ovi savjeti mogu vam pomoći da bolje zadržite sve te nove informacije. .

Ako ćete naučiti Perl, tada ćete se također htjeti upoznati s POD-om. Evo što je to, zašto je to važno i što učiniti kada naletite na takve datoteke.

Što su POD datoteke?

POD označava običnu staru dokumentaciju, osnovni jezik za označavanje koji se koristi za formatiranje teksta bez mnogo napora. To je slično jeziku za označavanje Markdown Što je Markdown? 4 razloga zašto biste to sada trebali naučiti Što je Markdown? 4 razloga zašto biste ga trebali naučiti sada Umoriti HTML i WYSIWYG urednike? Tada je Markdown odgovor za vas bez obzira tko ste. , ali posebno dizajniran za dokumentiranje Perl izvornog koda i modula.

POD se može koristiti na dva načina: može postojati izravno u izvornom kodu Perl datoteke ILI može postojati kao zasebna POD datoteka. Kad on postoji unutar koda, možete ga razmišljati kao komentare na bilo kojem drugom programskom jeziku, osim fanciernijeg i fleksibilnijeg.

#! / Usr / bin / perl

koristiti strogi;

koristiti upozorenja;

= mahuna

= head1 Primjer zaglavlja

Ova skripta čini neke super stvari, poput ovog i onoga. Za pravilno funkcioniranje moraju postojati sljedeći parametri. Ne pokušavajte to raditi na stroju s problemima.

= rezati

otisak “Samo se ovaj kod izvršava. \ n”;

Ugrađena dokumentacija dobro funkcionira za samostalne skripte ili kada želite biti sigurni da je i onaj tko naiđe na datoteku također zajamčen pristup dokumentaciji, ali može biti nezgodan kada želite dokumentirati čitavu bazu kodova na višoj razini.

Srećom, POD se također može koristiti za izradu stranica s ručnim tipkama koje su bolje pogodne za dokumente orijentirane prema korisniku (jer korisnici možda ne žele dublje ulaziti u izvorni kod skripte). Tada vam pomažu datoteke POD.

Kako čitati POD datoteke

Da budemo jasni, ugrađena POD dokumentacija nalazi se unutar stvarnih datoteka skripte Perl između redaka koda, a te datoteke skripta dolaze u jednom od dva proširenja formata: .PL ili .PM. Kad vidite .POD proširenje, to pokazuje da je datoteka čista dokumentacija i da ne sadrži izvorni kod.

Iako je moguće POD datoteke otvoriti u bilo kojem uređivaču teksta, uključujući Notepad, to vjerojatno želite učiniti samo ako sami uređujete neobrađenu dokumentaciju. Zamislite to kao otvaranje HTML datoteke u uređivaču: uz sve oznake, stvarni tekstualni sadržaj teško je pročitati.

Umjesto toga, trebali biste upotrijebiti nekakav alat za čitanje koji uzima neobrađenu dokumentaciju POD-a i predstavlja ga na jednostavan način za čitanje.

Najlakši način je upotreba perldoc alat naredbenog retka koji se automatski uključuje kada je Perl instaliran u vaš sustav. Većina OS X i Linux sustava dolazi s već instaliranim Perlom, ali Windows korisnici će ga morati ručno instalirati. (Srećom, nije teže nego pokrenuti instalacijsku datoteku.)

Sada pokrenite naredbeni redak, pomaknite se do mjesta gdje se nalazi datoteka POD i upišite perldoc [.POD datoteka] da biste vidjeli kako je pravilno oblikovan. Na primjer, ako je datoteka dobila ime library.pod onda bi upisali perldoc library.pod i to je to.

Kako pretvoriti POD u druge formate

Iako je perldoc Alat nije previše težak za uporabu, nije baš prikladan kada želite dijeliti dokumentaciju s drugima ili kad želite čitati dalje od računala. Tada ćete možda htjeti razmotriti pretvaranje u drugi format.

Pretvaranje u HTML: Instalirajte i koristite alat pod2html koji omogućava jednostavan način prevođenja bilo koje POD datoteke u čitljivu HTML datoteku. Nažalost, može izvršiti konverziju samo jedan na jedan (tako da ne možete kombinirati više POD datoteka u jednu HTML datoteku).

Pretvaranje u PDF: Instalirajte i koristite pod2pdf alat koji je sličan i jednako jednostavan za upotrebu kao i gornji alat pod2html, osim što se pretvara u PDF, a ne u HTML.

Druga mogućnost bi bila pretvoriti POD u HTML pomoću gore prikazane metode, otvoriti HTML datoteku u pregledniku poput Chromea ili Firefoxa, a zatim ispisati stranicu kao PDF.

Pretvaranje u Markdown: Instalirajte i koristite alat za pod2markdown za prevođenje između POD i Markdown. Markdown je označni jezik opće namjene, što znači da je vjerovatnije da će ga korisnici upoznati i postoji više alata koji mogu prihvatiti i prikazati Markdown.

Pretvaranje u LaTeX: Instalirajte i koristite alat pod2latex. LaTeX je još jedan označni jezik, onaj koji je manje uobičajen od Markdown-a, ali koji je ipak popularniji od POD-a. LaTeX se uglavnom koristi u akademskim i znanstvenim dokumentima, ali u slučaju da vam treba, ovaj pretvarač postoji.

Pretvaranje u običan tekst: Instalirajte i koristite alat pod2text koji proizvodi tekstualnu datoteku s ASCII temeljenim oblikovanjem. Vjerojatno vam neće trebati ovo koristiti, ali u slučaju da to ikad učinite, znajte da opcija postoji.

Je li ovaj post bio od pomoći?

Nakon što je zaključite, POD datoteke su vrlo jednostavne i praktične za korištenje. Postoji pomalo krivulja učenja, ali vrlo je mala - pogotovo ako ste prije koristili označni jezik. Nadamo se da se sada osjećate ugodno u radu sa POD datotekama.

Ako se osjećate prenapučeno, postavite si ova važna pitanja za kodnike za početnike 4 pitanja koja ćete se zapitati prije učenja kako šifrirati 4 pitanja koja ćete se zapitati prije nego što naučite kako kodirati Učenje programskog jezika je popularno. Ali je li to za svakoga? Prije nego što se obvezate, postavite sebi sljedeća pitanja i budite iskreni. , Imati poteškoće ne znači nužno da niste namijenjeni programeru. 6 Znakova da ne morate biti programer 6 Znakovi da ne biste trebali biti programer Nisu svi istaknuti da su programeri. Ako niste sasvim sigurni da ste namijenjeni programeru, evo nekoliko znakova koji vas mogu usmjeriti u pravom smjeru. , ali važno je biti iskren prema sebi i upravljati svojim očekivanjima.

Kao što je rečeno, poslušajte ove savjete za učenje kako kodirati bez stresa Kako naučiti programirati bez ikakvog stresa Kako naučiti programirati bez ikakvog stresa Možda ste se odlučili baviti programiranjem, bilo za karijeru ili samo kao hobi. Sjajno! Ali možda se počinjete osjećati preplavljeno. Nije tako sjajno. Evo pomoći da vam olakša putovanje. i znati kako reći dobre tutorijale za kodiranje od lošeg Što je dobar nastavnik za programiranje? Što je dobar vodič za programiranje? Nisu svi programski udžbenici jednaki. Neki profitiraju i vi i drugi, gubite vrijeme. Evo što potražiti u kvalitetnom programskom vodiču. .

Za što koristiš Perl? Imate li još kakvih savjeta za dijeljenje ili postavljanja pitanja? Javite nam u komentarima u nastavku!