Kā atvērt un pārveidot POD uz PDF, lai lasītu Perl dokumentāciju

Reklāma

Lai gan tas kādreiz bija neatņemama valoda tīmekļa programmēšanai Kura programmēšanas valoda jāapgūst - Web programmēšanaŠodien mēs apskatīsim dažādās tīmekļa programmēšanas valodas, kas darbina internetu. Šī ir ceturtā daļa iesācēju programmēšanas sērijā. 1. daļā mēs iemācījāmies ... Lasīt vairāk , Perls tagad ir atteicies no ceļa par labu modernākām valodām, piemēram, Python, Ruby un JavaScript. Ļoti maz cilvēku domā, ka šajās dienās ir vērts mēģināt iemācīties Perlu.

Bet tas nenozīmē, ka valoda ir bezjēdzīga vai novecojusi. Patiesībā daudzas mūsdienu vietnes un tīmekļa rīki joprojām paļaujas uz Perl ikdienas darbībām - ieskaitot Craigslist, IMDb un DuckDuckGo - tātad, ja jūs interesē to apgūt, neļauj nevienam tevi apturēt vai atrunāt 7 noderīgi triki jaunas programmēšanas valodas apguveiIr pareizi satriecties, kad mācāties kodēt. Jūs, iespējams, aizmirsīsit lietas tik ātri, kā jūs tos uzzināsit. Šie padomi var palīdzēt labāk saglabāt visu šo jauno informāciju. Lasīt vairāk .

Ja jūs mācīsities Perlu, tad jūs arī vēlēsities iepazīties ar POD. Lūk, kas tas ir, kāpēc tas ir svarīgi, un ko darīt, kad rodas šādi faili.

Kas ir POD faili?

POD ir vienkāršā vecā dokumentācija, kas ir pamata iezīmēšanas valoda, kuru izmanto teksta formatēšanai bez lielām pūlēm. Tas ir līdzīgs Markdown iezīmēšanas valoda Kas ir Markdown? 4 iemesli, kāpēc jums tas būtu jāiemācās tagadNoguris no HTML un WYSIWYG redaktoriem? Tad Markdown ir atbilde jums neatkarīgi no tā, kas jūs esat. Lasīt vairāk , bet īpaši paredzēts Perl avota koda un moduļu dokumentēšanai.

POD var izmantot divos veidos: tas var pastāvēt tieši Perl faila avota kodā VAI tas var pastāvēt kā atsevišķs POD fails. Kad tas pastāv kodā, jūs varat domāt par to kā komentārus jebkurā citā programmēšanas valodā, izņemot mīļotāju un elastīgāku.

#! / usr / bin / perl

izmantojiet stingri;

izmantojiet brīdinājumus;

= pāksts

= head1 galvenes piemērs

Šis skripts izdara dažas lieliskas lietas, piemēram, šo un to. Lai tā darbotos pareizi, ir jābūt šādiem parametriem. Nemēģiniet to izdarīt mašīnā, kurai ir problēmas.

= sagriezti

drukāt “Tiek izpildīts tikai šis kods. \ n ”;

Iegultā dokumentācija labi darbojas savrupajos skriptos vai gadījumos, kad vēlaties pārliecināties, ka arī visiem, kas saskārušies ar failu garantē piekļuvi dokumentācijai, taču tas var būt apgrūtinoši, ja vēlaties dokumentēt visu kopa bāzi augstāk līmenis.

Par laimi, POD var izmantot arī manuāla tipa lapu izveidošanai, kas ir labāk piemērotas uz lietotāju orientētiem dokumentiem (jo lietotāji, iespējams, nevēlas iedziļināties paša skripta avota kodā). Tas ir tad, kad noderēs POD faili.

Kā lasīt POD failus

Skaidri sakot, iegultās POD dokumentācija ir atrodama faktiskajos Perl skriptu failos starp koda rindām, un šiem skriptu failiem ir viens no diviem paplašinājumu formātiem: .PL vai .PM. Kad redzat .POD paplašinājumu, tas norāda, ka fails ir tikai dokumentācija un tajā nav iekļauts avota kods.

Lai gan POD failus var atvērt jebkurā teksta redaktorā, ieskaitot Notepad, jūs, iespējams, to vēlaties darīt tikai tad, ja rediģējat pašu neapstrādāto dokumentāciju. Padomājiet par to, kā HTML faila atvēršanu redaktorā: ņemot vērā visus iezīmējumus, faktisko teksta saturu ir grūti lasīt.

Tā vietā jums vajadzētu izmantot sava veida lasītāja rīku, kas ņem neapstrādātu POD dokumentāciju un iepazīstina to ar viegli lasāmu veidu.

Vienkāršākais veids ir izmantot perldoc komandrindas rīks, kas automātiski tiek iekļauts, kad Perl ir instalēts jūsu sistēmā. Lielākajai daļai OS X un Linux sistēmu ir jau instalēta Perl, bet Windows lietotājiem tas būs manuāli jāinstalē. (Par laimi, tas nav grūtāk, kā palaist instalēšanas failu.)

Tagad palaidiet komandrindu, dodieties uz vietu, kur atrodas POD fails, un ierakstiet perldoc [.POD fails] lai to skatītu kā pareizi formatētu. Piemēram, ja failam tika piešķirts nosaukums bibliotēka.pod tad jūs ierakstīsit perldoc bibliotēka.pod un tas arī viss.

Kā pārveidot POD citos formātos

Kaut arī perldoc rīku nav pārāk grūti izmantot, tas nav tieši ērti, ja vēlaties koplietot dokumentāciju ar citiem vai kad vēlaties to lasīt prom no datora. Tas ir, kad varat apsvērt iespēju konvertēt citā formātā.

Konvertēšana uz HTML: Instalējiet un izmantojiet pod2html rīks, kas nodrošina ērtu veidu, kā jebkuru POD failu tulkot lasāmā HTML failā. Diemžēl tas var veikt tikai viens pret vienu konvertēšanu (tāpēc nevar apvienot vairākus POD failus vienā HTML failā).

Konvertēšana uz PDF: Instalējiet un izmantojiet pod2pdf rīks, kas ir līdzīgs un tikpat viegli lietojams kā iepriekš minētais rīks pod2html, izņemot to, ka tas tiek pārveidots par PDF, nevis HTML.

Vēl viena iespēja būtu pārveidot POD uz HTML, izmantojot iepriekš parādīto metodi, pārlūkā, piemēram, Chrome vai Firefox, atvērt HTML failu un pēc tam izdrukāt lapu kā PDF.

Konvertēšana uz atzīmi: Instalējiet un izmantojiet pod2markdown rīks tulkošanai starp POD un Markdown. Atzīmēšana ir vispārējas nozīmes iezīmēšanas valoda, kas nozīmē, ka lietotāji, visticamāk, to pārzina, un tur ir vairāk rīku, kas var pieņemt un parādīt atzīmi.

Konvertēšana uz LaTeX: Instalējiet un izmantojiet pod2latex rīks. LaTeX ir vēl viena iezīmēšanas valoda, tā ir retāk sastopama kā Markdown, taču joprojām ir populārāka par POD. LaTeX galvenokārt tiek izmantots akadēmiskos un zinātniskos dokumentos, taču, ja jums tas ir nepieciešams, šis pārveidotājs pastāv.

Konvertēšana uz vienkāršu tekstu: Instalējiet un izmantojiet pod2text rīks, kas rada tikai teksta failu ar formatējumu uz ASCII. Jums, iespējams, nevajadzēs to izmantot, taču, ja jūs kādreiz to darāt, zināt, ka šī iespēja pastāv.

Vai šī ziņa bija noderīga?

Kad esat to pakavējis, POD faili ir ārkārtīgi vienkārši un ērti lietojami. Ir mazliet mācīšanās līkne, taču tā ir ļoti maza - it īpaši, ja iepriekš esat izmantojis iezīmēšanas valodu. Cerams, ka tagad jūs jūtaties ērti, strādājot ar POD failiem.

Ja jūtaties satriekts, pajautājiet sev to svarīgi jautājumi iesācēju kodētājiem 4 jautājumi, ko sev uzdot pirms iemācīties kodētProgrammēšanas valodas apguve ir populāra. Bet vai tas ir visiem? Pirms apņematies, uzdodiet sev šādus jautājumus un esiet godīgi. Lasīt vairāk . Grūtību rašanās nebūt nenozīmē to jums nav paredzēts būt programmētājam 6 pazīmes, ka jūs nevēlaties būt programmētājsNe visi ir izgriezti, lai būtu programmētāji. Ja neesat pilnīgi pārliecināts, ka esat domāts kā programmētājs, šeit ir dažas pazīmes, kas var norādīt jūs pareizajā virzienā. Lasīt vairāk , taču ir svarīgi būt godīgam pret sevi un pārvaldīt cerības.

To sakot, ņemiet vērā šos padomus iemācīties kodēt bez stresa Kā iemācīties programmēšanu bez visa stresaVarbūt jūs esat nolēmis turpināt programmēšanu, vai nu karjeru, vai tikai hobiju. Lieliski! Bet varbūt jūs sākat justies satriekti. Ne tik lieliski. Šī ir palīdzība jūsu ceļojuma atvieglošanai. Lasīt vairāk un zinot kā pateikt labas kodēšanas pamācības no sliktām Kas padara labu programmēšanas apmācību?Ne visas programmēšanas konsultācijas ir vienādas. Daži labumi jums, un citi galu galā tērē savu laiku. Lūk, ko meklēt kvalitātes programmēšanas apmācībā. Lasīt vairāk .

Kādam nolūkam jūs izmantojat Perl? Vai jums ir citi padomi, kā arī jautājumi vai jautājumi, ko uzdot? Paziņojiet mums komentāros zemāk!