Pod :: Template. POD :: TEMPLATE ist ein Perl-Modul zum Bauen von Pod-Dokumentationen von Vorlagen.
Jetzt downloaden

Pod :: Template. Ranking & Zusammenfassung

Pod :: Template. Stichworte

Perl-Modul Gebäude Pod Pod-Dokumentation Templates-Dokumentation.

Pod :: Template. Beschreibung

POD :: Template ist ein Perl-Modul zum Bauen von Pod-Dokumentationen von Vorlagen. POD :: Template ist ein Perl-Modul zum Bauen von Pod-Dokumentationen von Templates.Synopsis ### als Modul ### Verwenden Sie POD :: Template; Mein $ Parser = Neue Pod :: Vorlage; $ Parser-> Analyse (Vorlage => 'Dokumentation.PTMPL'); Drucken $ Parser-> AS_String ### als Skript ### $ podtmpl -i Dir1 -i Dir2 Dokumentation.PTMPL ### Ein einfaches Modul, das zur Verwendung von POD :: Template ###-Paket MY :: -Modul bereitgestellt wird; = TEMPLATE print_me = head2 print_me ($ string) druckt sein Argument aus. = subdruck_me schneiden {Druckverschiebung; RETURN 1} ### Eine einfache Pod-Datei namens extra / zusätzlich.pod ### = pod = template return_vals Diese Subroutine gibt 1 für den Erfolg und das Underef zum Versagen zurück. = cut ### Eine einfache Pod :: Template-Template ### = Fügen Sie mein :: Modul = zusätzlich / zusätzlich ein. Text'); = head2 Funktionen = einfügen My :: Modul-> print_me = extra-> return_vals = Cutwriting-Dokumentation in einem Projekt, das von mehreren Personen gepflegt wird, die mehr als ein Modul überspannt, das mehr als ein Modul überspannt, ist eine schwierige Angelegenheit. Es gibt viele Dinge zu berücksichtigen: LocationsBould-Pod (über jeder Funktion), am unteren Rand des Moduls oder in einer bestimmten Datei? Der erste ist leichter für die Entwickler, aber die letzteren sind besser für die Pod-Betreuer Gehört es in der Reihenfolge, in der die Funktionen geschrieben oder durch ein anderes Prinzip bestellt werden, z. B. Häufigkeit der Nutzung oder Funktionstyp? Die erste Option ist wiederum besser für die Entwickler, während die zweiten beiden für den Benutzer besser sind.ReferencesHOW Sollte eine Funktion in einer anderen Datei erwähnt werden? Sollte die Dokumentation einfach "siehe Andere :: Modul" sagen, oder sollte es den entsprechenden Abschnitt enthalten? Vervielfältigung bedeutet, dass die Dokumentation eher veraltet ist, aber es ist schlecht, dass ein Benutzer zahlreiche Dokumente lesen muss, um einfach herauszufinden, was eine vererbte Methode macht Sollten sie in jede Datei eingefügt werden oder können die Hauptdatei angenommen werden, um das gesamte Projekt abzudecken? Pod :: Template bietet eine Lösung für diese Probleme: Die Dokumentation ist aus Vorlagen aufgebaut. Anforderungen: · Perl.

Pod :: Template. Zugehörige Software