Kuinka avata ja muuntaa POD PDF-tiedostoksi Perl-ohjeiden lukemiseksi

Mainos

Vaikka se oli kerran kiinteä kieli web-ohjelmoinnissa Mikä ohjelmointikieli opitaan - Web-ohjelmointiTänään katsomme erilaisia ​​Internet-ohjelmointikieliä, jotka ohjaavat Internetiä. Tämä on aloittelijoiden ohjelmasarjan neljäs osa. Osassa 1 opimme perustiedot ... Lue lisää , Perl on nyt mennyt tielle nykyaikaisten kielten, kuten Python, Ruby ja JavaScript, puolesta. Hyvin harvat ihmiset katsovat, että Perlin oppiminen on vaivan arvoista nykyään.

Mutta se ei tarkoita, että kieli on turha tai vanhentunut. Itse asiassa monet nykyaikaiset verkkosivut ja verkkotyökalut luottavat edelleen Perliin päivittäisessä toiminnassa - mukaan lukien Craigslist, IMDb ja DuckDuckGo - joten jos olet kiinnostunut oppimaan sitä, älä anna kenenkään estää sinua tai rohkaista sinua 7 Hyödyllisiä temppuja uuden ohjelmointikielen hallitsemiseenOn okei hukkua, kun opit koodaamaan. Unohdat asiat todennäköisesti niin nopeasti kuin opit. Nämä vinkit voivat auttaa sinua säilyttämään kaiken uuden tiedon paremmin. Lue lisää .

Jos aiot oppia Perlia, sinun kannattaa tutustua myös POD: iin. Tässä on mitä se on, miksi se on tärkeää ja mitä tehdä, kun törmäät tällaisiin tiedostoihin.

Mitä POD-tiedostot ovat?

POD tarkoittaa tavallista vanhaa dokumentaatiota, joka on perusmerkintökieli, jota käytetään tekstin alustamiseen ilman paljon vaivaa. Se on samanlainen kuin Markdown-merkintäkieli Mikä on Markdown? 4 syytä, miksi sinun pitäisi oppia se nytOletko kyllästynyt HTML- ja WYSIWYG-toimittajiin? Sitten Markdown on vastaus sinulle riippumatta siitä, kuka olet. Lue lisää , mutta on erityisesti suunniteltu Perl-lähdekoodin ja moduulien dokumentointiin.

POD: ta voidaan käyttää kahdella tavalla: se voi esiintyä suoraan Perl-tiedoston lähdekoodissa tai TAI se voi olla erillinen POD-tiedosto. Kun se on koodissa, voit ajatella sitä kuten kommentteja millä tahansa muulla ohjelmointikielellä, paitsi harrastaja ja joustavampi.

#! / Usr / bin / perl

käytä tiukasti;

käytä varoituksia;

= pod

= head1 otsikon esimerkki

Tämä käsikirjoitus tekee hienoja juttuja, kuten tämä ja toinen. Seuraavien parametrien on oltava olemassa, jotta se toimii oikein. Älä yritä tehdä tätä koneella, jolla on ongelmia.

= leikata

print “Vain tämä koodi suoritetaan. \ N”;

Sulautettu dokumentaatio toimii hyvin erillisissä skripteissä tai kun haluat varmistaa, että kaikki, jotka törmäävät tiedostoon on taannut pääsyn asiakirja-aineistoon, mutta se voi olla hankalaa, kun haluat dokumentoida koko kooditietokannan korkeammalla taso.

Onneksi POD: ta voidaan käyttää myös manuaalisen tyyppisten sivujen luomiseen, jotka sopivat paremmin käyttäjälähtöisiin asiakirjoihin (koska käyttäjät eivät ehkä halua tutkia itse skriptin lähdekoodia). Silloin POD-tiedostot ovat hyödyllisiä.

Kuinka lukea POD-tiedostoja

Selvyyden vuoksi sulautettu POD-dokumentaatio löytyy todellisista Perl-skriptitiedostoista koodirivien välissä, ja nämä skriptitiedostot ovat yhdessä kahdesta laajennusmuodosta: .PL tai .PM. Kun näet .POD-laajennuksen, se osoittaa, että tiedosto on puhdasta dokumentaatiota eikä sisällä lähdekoodia.

Vaikka POD-tiedostoja on mahdollista avata missä tahansa tekstieditorissa, mukaan lukien Notepad, haluat todennäköisesti tehdä sen vain, jos muokkaat itse raakatietoja. Ajattele sitä kuin HTML-tiedoston avaaminen editorissa: kaikilla merkinnöillä tekstin todellinen sisältö on vaikea lukea.

Sen sijaan sinun pitäisi käyttää jonkinlaista lukutyökalua, joka ottaa raa'an POD-dokumentoinnin ja esittelee sen helposti luettavalla tavalla.

Helpoin tapa on käyttää perldoc komentorivityökalu, joka sisältyy automaattisesti, kun Perl on asennettu järjestelmään. Suurimmassa osassa OS X- ja Linux-järjestelmiä Perl on jo asennettu, mutta Windows-käyttäjien on asennettava se manuaalisesti. (Onneksi se ei ole vaikeampaa kuin asennustiedoston suorittaminen.)

Käynnistä nyt komentorivi, siirry POD-tiedoston sijaintiin ja kirjoita perldoc [.POD-tiedosto] nähdäksesi sen oikein muotoilluna. Jos tiedosto oli esimerkiksi nimetty library.pod sitten kirjoitat perldoc-kirjasto.pod ja siinä se on.

Kuinka muuntaa POD muihin muotoihin

Vaikka perldoc -työkalua ei ole liian vaikea käyttää, se ei ole aivan kätevä, kun haluat jakaa asiakirjat muiden kanssa tai kun haluat lukea sen tietokoneelta. Silloin kannattaa ehkä harkita muuntamista toiseen muotoon.

Muuntaminen HTML: ksi: Asenna ja käytä pod2html työkalu, joka tarjoaa helpon tavan kääntää kaikki POD-tiedostot luettavissa olevaksi HTML-tiedostoksi. Valitettavasti se voi suorittaa vain yhden muuntamisen (joten et voi yhdistää useita POD-tiedostoja yhdeksi HTML-tiedostoksi).

Muuntaminen PDF: ksi: Asenna ja käytä pod2pdf -työkalu, joka on samanlainen ja yhtä helppo käyttää kuin yllä oleva pod2html-työkalu, paitsi että se muuntuu PDF-muotoon HTML: n sijasta.

Toinen vaihtoehto olisi muuntaa POD HTML: ksi yllä esitetyllä tavalla, avata HTML-tiedosto selaimessa, kuten Chrome tai Firefox, ja tulostaa sitten sivu PDF-muodossa.

Muuntaminen merkinnäksi: Asenna ja käytä pod2markdown työkalu kääntämään POD: n ja Markdownin välillä. Markdown on yleiskäyttöinen merkintäkieli, eli käyttäjät tuntevat sen todennäköisemmin, ja siellä on enemmän työkaluja, jotka voivat hyväksyä ja näyttää Markdownin.

Muuntaminen LaTeX: ksi: Asenna ja käytä pod2latex työkalu. LaTeX on toinen merkintäkieli, joka on vähemmän yleinen kuin Markdown, mutta silti suositumpi kuin POD. LaTeX: ää käytetään pääasiassa akateemisissa ja tieteellisissä asiakirjoissa, mutta tarvittaessa tämä muunnin on olemassa.

Muuntaminen tekstitekstiin: Asenna ja käytä pod2text -työkalu, joka tuottaa vain tekstitiedoston ASCII-pohjaisella muotoilulla. Sinun ei todennäköisesti tarvitse käyttää tätä, mutta jos tiedät aina, tiedä, että vaihtoehto on olemassa.

Oliko tämä viesti hyödyllinen?

Kun olet ripustanut sen, POD-tiedostot ovat erittäin yksinkertaisia ​​ja käteviä käyttää. On vähän oppimiskäyrää, mutta se on hyvin pieni - varsinkin jos olet käyttänyt merkintäkieltä aiemmin. Toivottavasti voit nyt mukavasti käsitellä POD-tiedostoja.

Kysy itseltäsi nämä, jos tunnet hätää tärkeitä kysymyksiä aloittelijakoodereille 4 kysymystä itsellesi ennen koodin oppimistaOhjelmointikielen oppiminen on suosittua. Mutta onko kaikille? Ennen kuin sitoudut siihen, kysy itseltäsi seuraavat kysymykset ja ole rehellinen. Lue lisää . Vaikeuksien vaikeaminen ei välttämättä tarkoita sitä sinua ei ole tarkoitettu ohjelmoijaksi 6 merkkiä siitä, että et halua olla ohjelmoijaKaikkia ei ole leikattu ohjelmoijaksi. Jos et ole täysin varma, että sinun on tarkoitus olla ohjelmoija, tässä on joitain merkkejä, jotka voivat osoittaa sinut oikeaan suuntaan. Lue lisää , mutta on tärkeää olla rehellinen itseäsi kohtaan ja hallita odotuksiasi.

Tästä huolimatta ota huomioon nämä vinkit oppiminen koodaamaan ilman stressiä Kuinka oppia ohjelmointi ilman stressiäEhkä olet päättänyt jatkaa ohjelmointia joko uran tai vain harrastuksena. Loistava! Mutta ehkä olet alkanut tuntea itsesi uhriksi. Ei kovin hyvä. Tässä on apua matkasi helpottamiseen. Lue lisää ja tietäminen kuinka kertoa hyvät koodausoppaat pahasta Mikä tekee hyvästä ohjelmointiohjeesta?Kaikkia ohjelmointiohjeita ei tehdä yhtäläisiksi. Jotkut hyödyt sinulle ja toiset lopulta tuhlaavat aikaa. Tässä on mitä etsiä laadukkaasta ohjelmointikoulutuksesta. Lue lisää .

Mihin käytät Perlia? Onko sinulla muita jaettavissa olevia vinkkejä tai kysymyksiä? Kerro meille alla olevissa kommenteissa!