Kako odpreti in spremeniti POD v PDF za branje dokumentacije Perl

Oglas

Čeprav je bil nekoč an sestavni jezik za spletno programiranje Kateri programski jezik za učenje - spletno programiranjeDanes si bomo ogledali različne jezike spletnega programiranja, ki napajajo internet. To je četrti del v seriji programiranja za začetnike. V prvem delu smo se naučili osnovnega ... Preberi več , Perl je zdaj padel ob strani v korist sodobnejših jezikov, kot so Python, Ruby in JavaScript. Zelo malo ljudi meni, da se je vredno naučiti Perla v teh dneh.

Toda to ne pomeni, da je jezik neuporaben ali zastarel. Pravzaprav se številne sodobne spletne strani in spletna orodja še vedno zanašajo na Perl za vsakodnevne operacije - vključno s Craigslistom, IMDb in DuckDuckGo - tako da, če vas zanima, nikomur ne dovolite, da vas ustavi ali odvrača 7 uporabnih trikov za obvladovanje novega programskega jezikaV redu je biti preobremenjen, ko se učiš šifrirati. Verjetno boste stvari pozabili tako hitro, ko se jih boste naučili. Ti nasveti vam lahko pomagajo bolje obdržati vse te nove informacije. Preberi več .

Če se boste naučili Perla, se boste želeli seznaniti tudi s POD. Tukaj je opisano, zakaj je to pomembno in kaj storiti, ko naletite na takšne datoteke.

Kaj so datoteke POD?

POD pomeni kratka navadna dokumentacija, ki je osnovni označevalni jezik, ki se uporablja za oblikovanje besedila brez večjega truda. Podobno je označevalni jezik Kaj je Markdown? 4 razlogi, zakaj bi se ga morali zdaj naučitiSte se naveličali urejevalnikov HTML in WYSIWYG? Potem je Markdown odgovor za vas, ne glede na to, kdo ste. Preberi več , vendar je posebej zasnovan za dokumentiranje izvorne kode in modulov Perl.

POD se lahko uporablja na dva načina: lahko obstaja neposredno znotraj izvorne kode datoteke Perl ALI lahko obstaja kot ločena datoteka POD. Ko obstaja znotraj kode, si lahko o njej mislite kot pripombe v katerem koli drugem programskem jeziku, razen bolj navijaškega in bolj prilagodljivega.

#! / usr / bin / perl

uporabljajte strogo;

uporabite opozorila;

= pod

= head1 Primer glave

Ta skript dela nekaj kul stvari, kot je to in to. Za pravilno delovanje morajo obstajati naslednji parametri. Ne poskušajte to storiti na stroju z težavami.

= rez

natisni »Izvede se samo ta koda. \ n ”;

Vdelana dokumentacija deluje dobro za samostojne skripte ali ko želite, da se prepriča tudi kdo, ki naleti na datoteko ima zagotovljen dostop do dokumentacije, vendar je lahko okorno, če želite dokumentirati celotno kodno bazo na višji stopnjo.

Na srečo se POD lahko uporablja tudi za ustvarjanje strani z ročnim tipom, ki so bolj primerne za uporabniško usmerjene dokumente (ker se uporabniki morda ne želijo poglabljati v izvorno kodo skripta). Takrat pridejo datoteke POD.

Kako brati POD datoteke

Da je jasno, se vdelana dokumentacija POD nahaja v dejanskih datotekah skript Perl med vrsticami kode, te datoteke skripta pa so v enem od dveh razširitvenih formatov: .PL ali .PM. Ko vidite pripono .POD, pomeni, da je datoteka čista dokumentacija in ne vsebuje izhodne kode.

Čeprav je mogoče datoteke POD odpreti v katerem koli urejevalniku besedil, vključno z Beležnico, boste to verjetno želeli storiti le, če sami urejate neobdelano dokumentacijo. Zamislite si to kot odpiranje datoteke HTML v urejevalniku: z vso oznako je dejansko besedilno vsebino težko prebrati.

Namesto tega bi morali uporabiti nekakšno bralno orodje, ki prevzame surovo dokumentacijo POD in jo predstavi na lahko berljiv način.

Najlažji način je uporaba perldoc orodje ukazne vrstice, ki se samodejno vključi, ko Perl je nameščen v vaš sistem. Večina sistemov OS X in Linux prihaja s programom Perl, ki je že nameščen, vendar ga bodo morali uporabniki ročno namestiti. (Na srečo ni težje kot zagnati namestitveno datoteko.)

Zdaj zaženite ukazno vrstico, pojdite do mesta, kjer se nahaja datoteka POD, in vnesite perldoc [.POD datoteka] da si ogledate pravilno oblikovano. Na primer, če je bila datoteka poimenovana library.pod nato vtipkate perldoc library.pod in to je to.

Kako pretvoriti POD v druge oblike

Kljub temu perldoc orodje ni pretežko za uporabo, ni ravno priročno, če želite dokumentacijo deliti z drugimi ali ko jo želite prebrati stran od računalnika. Takrat boste morda želeli razmisliti o pretvorbi v drugo obliko.

Pretvarjanje v HTML: Namestite in uporabite pod2html orodje, ki omogoča preprost način za prenos katere koli datoteke POD v berljivo datoteko HTML. Na žalost lahko izvede samo pretvorbo ena na ena (tako da ne morete kombinirati več datotek POD v eno datoteko HTML).

Pretvarjanje v PDF: Namestite in uporabite pod2pdf orodje, ki je podobno in ravno tako enostavno za uporabo kot zgoraj pod2html orodje, le da se pretvori v PDF in ne v HTML.

Druga možnost bi bila pretvorba POD v HTML z zgoraj prikazano metodo, odprite datoteko HTML v brskalniku, kot sta Chrome ali Firefox, in stran natisnite v obliki PDF.

Pretvarjanje v Markdown: Namestite in uporabite pod2markdown orodje za prevajanje med POD in Markdown. Markdown je označevalni jezik splošnega pomena, kar pomeni, da ga uporabniki verjetno bolj poznajo in je več orodij, ki lahko sprejmejo in prikažejo Markdown.

Pretvarjanje v LaTeX: Namestite in uporabite pod2latex orodje. LaTeX je še en označevalni jezik, ki je manj pogost kot Markdown, vendar še vedno bolj priljubljen kot POD. LaTeX se uporablja predvsem v akademskih in znanstvenih dokumentih, vendar v primeru, da ga potrebujete, ta pretvornik obstaja.

Pretvarjanje v navadno besedilo: Namestite in uporabite pod2text orodje, ki ustvari samo besedilno datoteko z oblikovanjem na osnovi ASCII. Tega verjetno ne boste potrebovali, toda v primeru, da to storite, vedite, da možnost obstaja.

Je bila ta objava koristna?

Ko jih obiščete, so datoteke POD zelo preproste in priročne za uporabo. Krivulja učenja je malo, vendar je zelo majhna - še posebej, če ste že prej uporabljali označevalni jezik. Upajmo, da se zdaj počutite udobno pri obdelavi datotek POD.

Če se počutite preobremenjeni, se vprašajte pomembna vprašanja za začetnike kodirnike 4 vprašanja, ki si jih morate zastaviti, preden se naučite kako kodiratiUčenje programskega jezika je priljubljeno. A je to za vse? Preden se zavežete, si postavite naslednja vprašanja in bodite iskreni. Preberi več . Če imate težave, to ne pomeni nujno ne mislite biti programer 6 znakov, da ne želite biti programerNiso vsi odrezani kot programer. Če niste povsem prepričani, da ste mišljeni kot programer, je nekaj znakov, ki vas lahko usmerijo v pravo smer. Preberi več , vendar je pomembno biti iskren do sebe in upravljati svoja pričakovanja.

Kot rečeno, upoštevajte te nasvete učenje kako kodirati brez stresa Kako se naučiti programiranja brez vseh stresovMogoče ste se odločili, da se lotite programiranja, bodisi zaradi kariere ali zgolj kot hobija. Super! Mogoče pa se začnete počutiti preobremenjeni. Ni tako super. Tukaj je pomoč za lažjo pot. Preberi več in vedeti kako povedati dobre vaje za kodiranje od slabih Kaj je dobro vadnico o programiranju?Niso vse programske vaje enake. Nekatere koristi, ki jih vi in ​​drugi na koncu zapravite. Tukaj je tisto, kar je treba iskati v vadbi o kakovostnem programiranju. Preberi več .

Za kaj uporabljate Perl? Imate še kakšne nasvete za izmenjavo ali vprašanja, ki jih lahko postavite? Sporočite nam v spodnjih komentarjih!