Kuidas avada ja teisendada POD-i PDF-failiks, et lugeda Perli dokumentatsiooni

Reklaam

Kuigi see oli kunagi an lahutamatu keel veebiprogrammeerimisel Millist programmeerimiskeelt õppida - veebiprogrammeerimineTäna vaatleme erinevaid Interneti-programmeerimiskeeli. See on algajate programmeerimissarja neljas osa. 1. osas õppisime põhilisi ... Loe rohkem , On Perl nüüd muutunud moodsamate keelte nagu Python, Ruby ja JavaScripti kasuks. Väga vähesed inimesed arvavad, et Perli õppimine on tänapäeval väärt pingutusi.

Kuid see ei tähenda, et keel oleks mõttetu või vananenud. Tegelikult toetuvad paljud kaasaegsed veebisaidid ja veebitööriistad Perlile igapäevastes toimingutes - sealhulgas Craigslistissa, IMDb ja DuckDuckGo - nii et kui olete huvitatud sellest õppima, ärge laske kellelgi teid takistada ega teid heidutada 7 kasulikke nippe uue programmeerimiskeele valdamiseksKoodide õppimisel on okei. Tõenäoliselt unustate asjad nii kiiresti kui õpite. Need näpunäited aitavad teil kogu seda uut teavet paremini säilitada. Loe rohkem .

Kui soovite õppida Perli, siis soovite tutvuda ka POD-iga. Siit saate teada, mis see on, miks see on oluline ja mida teha selliste failide ilmumisel.

Mis on POD-failid?

POD on tavaline vana dokumentatsioon, mis on põhiline märgistuskeel, mida kasutatakse teksti vormindamiseks ilma palju vaeva nägemata. See sarnaneb Markusepi märgistuskeel Mis on Markdown? 4 põhjust, miks peaksite seda nüüd õppimaKas olete tüdinud HTML- ja WYSIWYG-redigeerijatest? Siis on Markdown vastus teile ükskõik, kes te ka pole. Loe rohkem , kuid spetsiaalselt loodud Perli lähtekoodi ja moodulite dokumenteerimiseks.

POD-d saab kasutada kahel viisil: see võib eksisteerida otse Perli faili lähtekoodis VÕI see võib esineda eraldi POD-failina. Kui see koodis eksisteerib, saate seda mõelda nagu kommentaarid mis tahes muus programmeerimiskeeles, välja arvatud fännid ja paindlikumad.

#! / usr / bin / perl

kasutage rangelt;

kasutage hoiatusi;

= pod

= head1 päise näide

See skript teeb lahedaid asju, nagu see ja teine. Selle õigeks toimimiseks peavad olema olemas järgmised parameetrid. Ärge proovige seda teha probleemidega masinas.

= lõika

print “Täidetakse ainult seda koodi. \ n ”;

Manustatud dokumentatsioon sobib hästi eraldiseisvate skriptide korral või kui soovite veenduda, et ka keegi teine, kes failiga kokku puutub on garanteerinud juurdepääsu dokumentidele, kuid see võib olla tülikas, kui soovite dokumenteerida kogu koodbaasi kõrgemal tasemel.

Õnneks saab POD-d kasutada ka käsitsi tüüpi lehtede loomiseks, mis sobivad paremini kasutajale suunatud dokumentide jaoks (kuna kasutajad ei pruugi soovida süveneda skripti enda lähtekoodi). See on siis, kui POD-failid on kasulikud.

Kuidas lugeda POD-faile

Varjatud kujul on manustatud POD-dokumentatsioon Perli skriptifailides koodiridade vahel ja need skriptifailid on ühes kahest laiendvormingust: .PL või .PM. Kui näete laiendit .POD, näitab see, et fail on puhas dokumentatsioon ega sisalda lähtekoodi.

Kuigi POD-faile on võimalik avada mis tahes tekstiredaktoris, sealhulgas Notepadis, soovite seda teha ainult siis, kui redigeerite tegelikult ka toordokumentatsiooni ise. Mõelge sellele nagu HTML-faili avamine redaktoris: kõigi märgistustega on tegelikku teksti sisu raske lugeda.

Selle asemel peaksite kasutama mõnda lugemisriista, mis võtab POD-i toordokumentatsiooni ja esitab selle hõlpsasti loetaval viisil.

Lihtsaim viis on kasutada perldok käsurida, mis lisatakse automaatselt, kui Perl on teie süsteemi installitud. Enamik OS X ja Linux süsteeme on Perliga juba installitud, kuid Windowsi kasutajad peavad selle käsitsi installima. (Õnneks pole see raskem kui installifaili käitamine.)

Nüüd käivitage käsurida, liikuge POD-faili asukohta ja tippige perldoc [.POD-fail] õigesti vormindatud kujul kuvamiseks. Näiteks kui fail sai nime raamatukogu.pod siis kirjutaksid perldoc library.pod ja see ongi kõik.

Kuidas teisendada POD muudeks vorminguteks

Kuigi perldok tööriista pole liiga keeruline kasutada, see pole täpselt mugav, kui soovite jagada dokumentatsiooni teistega või kui soovite seda lugeda arvutist eemal. See on siis, kui võiksite kaaluda konverteerimist muusse vormingusse.

HTML-i teisendamine: Installige ja kasutage pod2html tööriist, mis pakub lihtsat viisi mis tahes POD-faili tõlkimiseks loetavaks HTML-failiks. Kahjuks saab see teostada ainult üks-ühele teisendamise (nii et te ei saa ühendada mitu POD-faili üheks HTML-failiks).

PDF-vormingusse teisendamine: Installige ja kasutage pod2pdf, mis on sarnane ülaltoodud pod2html tööriistaga ja on seda sama hõlpsasti kasutatav, välja arvatud see, et see teisendatakse HTML-i, mitte PDF-iks.

Teine võimalus oleks teisendada POD HTML-is ülaltoodud meetodil, avada HTML-fail brauseris (nt Chrome või Firefox) ja printida leht PDF-vormingus.

Teisendamine Markdowniks: Installige ja kasutage pod2markdown tööriist POD ja Markdowni tõlkimiseks. Markdown on üldotstarbeline märgistuskeel, mis tähendab, et kasutajad tunnevad seda tõenäoliselt paremini ja seal on rohkem tööriistu, mis saavad Markdowni vastu võtta ja kuvada.

Konverteerimine LaTeX-i: Installige ja kasutage pod2latex tööriist. LaTeX on veel üks märgistuskeel, see on vähem levinud kui Markdown, kuid siiski populaarsem kui POD. LaTeX-i kasutatakse peamiselt akadeemilistes ja teaduslikes dokumentides, kuid kui vajate, on see muundur olemas.

Tekstiks teisendamine: Installige ja kasutage pod2text tööriist, mis loob ainult tekstifaili ASCII-põhise vorminguga. Tõenäoliselt ei pea te seda kasutama, kuid kui te kunagi seda teete, siis teadke, et see võimalus on olemas.

Kas see postitus oli kasulik?

Kui olete selle üles riputanud, on POD-failid äärmiselt lihtsad ja mugavad kasutada. Õppimiskõveral on natuke, kuid see on väga väike - eriti kui olete varem kasutanud märgistuskeelt. Loodetavasti tunnete end nüüd mugavalt POD-failidega tegelemisel.

Kui tunnete end jahmununa, küsige endalt neid olulised küsimused algajate koodide jaoks 4 küsimust, mida endalt küsida, enne kui õppida koodimaProgrammeerimiskeele õppimine on populaarne. Kuid kas see on kõigile? Enne sellele pühendumist küsige endalt järgmised küsimused ja olge aus. Loe rohkem . Raskused ei tähenda seda tingimata sa ei pea olema programmeerija 6 märki, et te ei taha olla programmeerijaKõiki ei lõigata programmeerijaks. Kui te pole täiesti kindel, et olete mõeldud programmeerijaks, siis siin on mõned märgid, mis võivad teid õiges suunas näidata. Loe rohkem , kuid on oluline olla enda vastu aus ja juhtida oma ootusi.

Seda silmas pidades võtke arvesse neid näpunäiteid ilma stressita koodide õppimine Kuidas õppida programmeerimist ilma igasuguse stressitaVõib-olla olete otsustanud programmeerimisega tegeleda, kas karjääri või lihtsalt hobina. Tore! Kuid võib-olla olete hakanud tundma end jahmununa. Mitte nii suurepärane. Siin on abi teie reisi hõlbustamiseks. Loe rohkem ja teadmine kuidas öelda head kodeerimise õpetused halvast Mis teeb hea programmeerimisõpetuse?Kõiki programmeerimisõpetusi ei tehta võrdseks. Mõni toob teile kasu ja teised raiskavad teie aega. Siit saate teada, mida kvaliteetsest programmeerimisõpetusest otsida. Loe rohkem .

Milleks te Perli kasutate? Kas teil on muid näpunäiteid jagamiseks või küsimusi, mida küsida? Andke meile allolevates kommentaarides teada!