Pelkkä vanha dokumentaatio ( eng. Plain old documentation , lyhenne pod ; merkitykseltään lähellä alkuperäistä venäläistä ilmaisua "Good Old Documentation") on yksinkertainen merkintäkieli, jota käytetään dokumentoimaan Perl -ohjelmointikieli .
Pod on suunniteltu yksinkertaiseksi ja puhtaaksi kieleksi, jolla on minimaalinen hyödyllinen syntaksi. Se sulkee tarkoituksella pois mekanismit kirjasimien, kuvien, värien tai taulukoiden kuvaamiseksi. Vaikka Pod ei ole yhtä ilmaisuvoimainen kuin XML :n tai LaTeX :n kaltaiset kielet, kirjoittajat ovat tarkoituksella uhraaneet ilmaisukyvyn yksinkertaisuuden ja mukavuuden vuoksi [1] . Koteloiden kehittämisen päätavoitteet ovat:
Tämä muoto on kuvattu perlpod-manuaalisivulla , ja jotkut pod-kääntäjät on kuvattu pod2man- , pod2html- ja pod2text- man-sivuilla . Vaikka perlpod-käsikirjan kirjoittajat huomauttavat, että podin ominaisuudet eivät todennäköisesti riitä kirjojen kirjoittamiseen siihen [2] , itse asiassa podista on kirjoitettu laajennettu versio. Tämä laajennettu versio sisältää ominaisuuksia taulukon muotoiluun ja alaviitteisiin, ja O'Reilly & Associates on käyttänyt sitä tuottaakseen useita kirjoja Perlistä (tunnetuin Perl Programming [1] Larry Wallilta, Tom Christiansenilta ja John Orvantilta). Toista laajennettua versiota podista, nimeltään mod, käytettiin Mark Jason Dominuksen en:Higher-Order Perl -kirjassa.
Voit lukea ohjelmaan sisäänrakennetun muotoillun POD-dokumentaation mukana toimitetulla katseluohjelmalla:
% perldoc-ohjelma_ja_pod % perldoc perpodLisäksi POD-dokumentaatio on erittäin helppolukuinen, kun tarkastellaan moduulin lähdekoodia.
POD-muodossa oleva kuvaus voidaan muuntaa web-sivuksi perl-apuohjelmalla:
%pod2html --outfile = program.html program_with_podVoit muuntaa asiakirjat pelkkäksi tekstimuotoon käyttämällä:
pod2teksti tiedostonimi.pm > tiedostonimi.txt
POD-dokumentaatio lisätty tiedoston loppuun:
#!/usr/local/bin/perl hei (); sub hello { tulosta "Hei, maailma!\n" ; } __END__ # Tyhjä merkkijono vaaditaan =head1 NIMI # Ohjelman tai moduulin nimi =head1 YHTEENVETO # Yksi rivi, joka kuvaa moduulin tai ohjelman tekemistä =head1 KUVAUS # Documentation array =head1 AUTHOR # Kuka olet =head1 BUGS # Mikä meni pieleen =head1 KATSO MYÖS # lisäinformaatioAsiakirjan merkintäkielet | |
---|---|
toimistoasiakirjat _ | |
tunnettu | |
Vähemmän Tunnettu |