Hogyan lehet megnyitni és konvertálni a POD fájlt PDF-fájlba a Perl dokumentáció olvasása céljából

Hirdetés

Bár ez egykor volt szerves nyelv a webes programozáshoz Melyik programozási nyelvet kell megtanulni - Webes programozásMa áttekintjük a különféle internetes programozási nyelveket, amelyek táplálják az internetet. Ez a kezdő programozási sorozat negyedik része. Az 1. részben megtanultuk a ... Olvass tovább , Perl már elkerülte az útját a modernabb nyelvek, például a Python, a Ruby és a JavaScript javára. Nagyon kevés ember gondolja, hogy manapság megéri erőfeszítéseket megtanulni Perlt.

De ez nem azt jelenti, hogy a nyelv haszontalan vagy elavult. Valójában sok modern webhely és webes eszköz továbbra is támaszkodik a Perlre a napi műveletek során - ideértve a Craigslistot, az IMDb-t és a DuckDuckGo-t is - tehát ha érdekli a tanulás, ne hagyja, hogy bárki megállítson vagy visszatartson téged 7 Hasznos trükkök az új programozási nyelv elsajátításáhozRendben, hogy elkönnyebbül, amikor kódolni tanul. Valószínűleg elfelejti a dolgokat, amint megtanulja őket. Ezek a tippek segítenek az új információk jobb megőrzésében. Olvass tovább .

Ha Perl-t fog tanulni, akkor is meg kell ismerkednie a POD-val. Íme, mi ez, miért fontos, és mit kell tenni, amikor ilyen fájlokat futtat be.

Mik a POD fájlok?

A POD a Plain Old Documentation kifejezést jelenti, amely egy alapvető jelölőnyelv, amelyet a szöveg formázására használnak anélkül, hogy sok erőfeszítést igényelne. Hasonló a a Markdown jelölőnyelv Mi a Markdown? 4 ok, amiért érdemes most megtanulniaUnod már a HTML és a WYSIWYG szerkesztõket? Akkor a Markdown a válasz az Ön számára, függetlenül attól, hogy ki vagy. Olvass tovább , de kifejezetten a Perl forráskódjának és moduljainak dokumentálására tervezték.

A POD kétféle módon használható: létezhet közvetlenül a Perl fájl forráskódjában, vagy külön POD fájlként is létezhet. Ha létezik a kódban, akkor úgy gondolhatja, mint bármely más programozási nyelv megjegyzése, kivéve a rajongó és rugalmasabb.

#! / Usr / bin / perl

szigorúan használja;

használjon figyelmeztetéseket;

= pod

= head1 fejléc példa

Ez a szkript csinál néhány jó dolgot, mint ez és ez. A következő paramétereknek létezniük kell annak megfelelő működéséhez. Ne próbálkozzon ezzel problémás gépeken.

= vágás

nyomtatás “Csak ez a kód kerül végrehajtásra. \ N”;

A beágyazott dokumentáció jól működik önálló szkriptek esetén, vagy ha azt szeretné, hogy megbizonyosodjon arról, hogy bárki, aki a fájllal is találkozik garantált hozzáférést biztosít a dokumentációhoz, de nehézkes lehet, ha egy teljes kódtáblát magasabbra akar dokumentálni szint.

Szerencsére a POD felhasználható kézi típusú oldalak létrehozására is, amelyek jobban megfelelnek a felhasználó-orientált dokumentumokhoz (mivel a felhasználók nem akarják belemerülni egy szkript forráskódjába). Ez az, amikor a POD fájlok hasznosak lesznek.

POD fájlok olvasása

A világosság kedvéért a beágyazott POD dokumentáció a tényleges Perl szkriptfájlokban található a kódsorok között, és ezek a szkriptfájlok két kiterjesztési formátum egyikében vannak: .PL vagy .PM. Amikor egy .POD kiterjesztést lát, ez azt jelzi, hogy a fájl tiszta dokumentáció és nem tartalmaz forráskódot.

Bár a POD fájlokat bármilyen szövegszerkesztőben megnyithatja, ideértve a Jegyzettömböt is, valószínűleg csak akkor akarja ezt megtenni, ha maga a nyers dokumentációt szerkeszti. Gondoljon úgy, mint egy HTML fájl megnyitása egy szerkesztőben: az összes jelöléssel együtt a szöveg tényleges tartalma nehezen olvasható.

Ehelyett valamilyen olvasóeszközt kell használnia, amely átveszi a nyers POD dokumentációt, és könnyen olvasható módon bemutatja.

A legegyszerűbb módszer a perldoc parancssori eszköz, amely automatikusan bekerül, ha A Perl telepítve van a rendszerre. A legtöbb OS X és Linux rendszerhez a Perl már telepítve van, de a Windows felhasználóknak manuálisan kell telepíteniük. (Szerencsére nem nehezebb, mint futtatni a telepítő fájlt.)

Most indítsa el a parancssort, keresse meg a POD fájlt, és írja be perldoc [.POD fájl] hogy megfelelően formázott legyen. Például, ha a fájl neve lett library.pod akkor írja be perldoc library.pod és ez az.

Hogyan konvertálhatjuk a POD-t más formátumokba

Annak ellenére, hogy a perldoc eszköz használata nem túl nehéz, nem igazán kényelmes, ha meg akarja osztani a dokumentációt másokkal, vagy amikor el akarja olvasni a számítógépről. Ekkor érdemes megfontolnia a konvertálást más formátumra.

Konvertálás HTML formátumra: Telepítse és használja a pod2html eszköz, amely egyszerű módon lefordíthat bármilyen POD fájlt olvasható HTML fájlba. Sajnos csak egy-egy konverziót képes végrehajtani (így nem kombinálhat több POD fájlt egyetlen HTML fájlba).

Konvertálás PDF-re: Telepítse és használja a pod2pdf eszköz, amely hasonló és ugyanolyan egyszerűen használható, mint a fenti pod2html eszköz, azzal a különbséggel, hogy HTML helyett PDF formátumba konvertálja.

Egy másik lehetőség a POD HTML formátummá konvertálása a fent bemutatott módszerrel, a HTML fájl megnyitása egy böngészőben, például a Chrome vagy a Firefox, majd az oldal PDF formátumban történő kinyomtatása.

Átalakítás Markdown-ként: Telepítse és használja a pod2markdown eszköz a POD és a Markdown közötti fordításhoz. A Markdown egy általános célú jelölőnyelv, ami azt jelenti, hogy a felhasználók nagyobb valószínűséggel ismeri azt, és vannak több eszköz, amely képes elfogadni és megjeleníteni a Markdown-ot.

Konvertálás LaTeX-re: Telepítse és használja a pod2latex eszköz. A LaTeX egy másik jelölőnyelv, ritkább, mint a Markdown, de mégis népszerűbb, mint a POD. A LaTeX-et főként akadémiai és tudományos dokumentumokban használják, de szükség esetén ez a konverter létezik.

Konvertálás sima szöveggé: Telepítse és használja a pod2text eszköz, amely csak szöveges fájlt állít elő ASCII-alapú formázással. Valószínűleg nem kell ezt használnia, de ha valaha is megtenné, akkor tudd, hogy ez a lehetőség létezik.

Hasznos volt ez a bejegyzés?

Miután megkaptad, a POD fájlok rendkívül egyszerűek és kényelmesek. Van egy kicsit a tanulási görbe, de nagyon kicsi - különösen, ha korábban már használt jelölési nyelvet. Remélhetőleg most már kényelmesebben érzi magát a POD fájlokkal.

Ha túlterheltek, kérdezd meg magadtól ezeket fontos kérdések az újszülött kódolók számára 4 kérdés, hogy tegye fel magát, mielőtt elsajátítja a kódolástA programozási nyelv elsajátítása népszerű. De ez mindenki számára elérhető? Mielőtt elkötelezi magát, tegye fel magának a következő kérdéseket, és legyen őszinte. Olvass tovább . A nehézség nem feltétlenül jelenti azt nem azt akarod, hogy programozó legyen 6 Jelek arra, hogy nem akarsz programozó lenniNem mindenki készül arra, hogy programozó legyen. Ha nem biztos abban, hogy programozónak szántad, íme néhány jel, amely a helyes irányba mutathat. Olvass tovább , de fontos, hogy őszinte legyünk önmagunkkal és kezeljük elvárásainkat.

Ennek ellenére figyelembe vette ezeket a tippeket megtanulni, hogyan kell kódolni stressz nélkül Hogyan lehet megtanulni a programozást minden stressz nélkülLehet, hogy úgy döntött, hogy folytatja a programozást, akár karriert, akár csak hobbit. Nagy! De lehet, hogy elárasztottnak érzi magát. Nem olyan nagyszerű. Ez segít az utazás megkönnyítésében. Olvass tovább és tudás hogyan lehet elmondani a jó kódolási útmutatót a rosszról Mi teszi a jó programozási útmutatót?Nem minden programozási útmutatót teszünk egyenlővé. Néhány haszna az Ön számára, mások pedig pazarolja az idejét. Íme, mit kell keresnie egy minőségi programozási útmutatóban. Olvass tovább .

Mire használja a Perlt? Van más tipp megosztására vagy kérdései? Tudassa velünk az alábbi megjegyzésekben!