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

Oglas

Iako je to nekad bio an integralni jezik za web programiranje Koji programski jezik za naučiti - web programiranjeDanas ćemo pogledati različite jezike web programiranja koji pokreću Internet. Ovo je četvrti dio u seriji za početnike programiranja. U prvom dijelu smo naučili osnovne ... Čitaj više , Perl je sada pao zaobilazno u korist modernijih jezika kao što su 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 se mnoštvo suvremenih web stranica i web alata i dalje oslanja na Perl za svakodnevne operacije - uključujući Craigslist, IMDb i DuckDuckGo - pa ako ste zainteresirani za učenje, ne dopusti nikome da te zaustavi ili odvrati 7 korisnih trikova za savladavanje novog programskog jezikaU redu je biti preopterećen kada učite kodirati. Vjerojatno ćete stvari zaboraviti čim ih naučite. Ovi savjeti mogu vam pomoći da bolje zadržite sve te nove informacije. Čitaj više .

Ako ćete naučiti Perl, tada ćete se htjeti upoznati i s POD-om. Evo što je to, zašto je to važno i što trebate učiniti kad naiđete 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 označni jezik za označavanje Što je Markdown? 4 razloga zašto biste to trebali naučiti sadaUmorni su za HTML i WYSIWYG urednike? Tada je Markdown odgovor za vas bez obzira tko ste. Čitaj više , 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 dobre stvari, poput ovog i onoga. Za pravilno funkcioniranje moraju postojati sljedeći parametri. Ne pokušavajte to raditi na stroju s problemima.

= rez

ispis „izvršava se samo ovaj kôd. \ N”;

Ugrađena dokumentacija dobro funkcionira za samostalne skripte ili kada želite biti sigurni da će i onaj tko naiđe na datoteku također ima zajamčeni pristup dokumentaciji, ali može biti glomazan kada želite dokumentirati čitavu bazu kodova na većoj razina.

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 su korisne 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 datoteke POD moguće 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 POD dokumentaciju i predstavlja je na jednostavan način za čitanje.

Najlakši način je upotreba perldoc alat naredbenog retka koji se automatski uključuje kada Perl je instaliran na 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 tada biste upisali perldoc library.pod i to je to.

Kako pretvoriti POD u druge formate

Iako je perldoc alat nije previše težak za upotrebu, nije baš zgodan 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 pod2html alat koji pruža jednostavan način prevođenja bilo koje POD datoteke u čitljivu HTML datoteku. Nažalost, može provesti samo konverziju pojedinačno (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 pretvaranje POD-a u HTML pomoću gore prikazane metode, otvaranje HTML datoteke u pregledniku kao što je Chrome ili Firefox, a zatim ispisati stranicu kao PDF.

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

Pretvaranje u LaTeX: Instalirajte i koristite pod2latex alat. LaTeX je još jedan označni jezik, koji je rjeđi od Markdown-a, ali još 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 pod2text alat koji proizvodi tekstualnu datoteku s ASCII temeljenim oblikovanjem. Vjerojatno vam to neće trebati koristiti, ali u slučaju da to ikad učinite, znajte da opcija postoji.

Je li ovaj post bio koristan?

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

Ako se osjećate preplavljeno, zapitajte se ovo važna pitanja za početnike kodiranja 4 pitanja koja trebate sebi postaviti prije nego što naučite kako kodiratiUčenje programskog jezika popularno je. Ali je li to za svakoga? Prije nego što se obvezate, postavite sebi sljedeća pitanja i budite iskreni. Čitaj više . Imati poteškoće ne znači to nužno Ne biste trebali biti programer 6 Znakovi da ne treba biti programerNisu svi sigurni da su programeri. Ako niste sasvim sigurni da ste namijenjeni programeru, evo nekoliko znakova koji vas mogu usmjeriti u pravom smjeru. Čitaj više , ali važno je biti iskren prema sebi i upravljati svojim očekivanjima.

Kao što se kaže, poslušajte ove savjete naučiti kako kodirati bez stresa Kako naučiti programiranje bez ikakvog stresaMožda ste se odlučili baviti programiranjem, bilo radi karijere 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. Čitaj više i znajući kako reći dobre tutoriale kodiranja od loših Što je dobar vodič za programiranje?Nisu svi programski udžbenici jednaki. Neke koristi vam, a drugima iscrpljuju vaše vrijeme. Evo što potražiti u kvalitetnom programskom vodiču. Čitaj više .

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