Plug-iny slouží pro dodatečné ovlivnění generování HTML dokumentace.
Na formuláři je rozbalovací seznam se seznamem skupin a listovací seznam příslušných pluginů.
Každý plugin může mít vlastní dialog pro nastavení příslušných voleb.
Některé skupiny pluginů mají to omezení, že lze spustit pouze jen jeden plugin např.: DIAMP, DIAP, DIAF atd.
Jiné např.: CONV toto omezení nemá.
V současné době je osm skupin:
DIAMP (Detailní info o metodě/proceduře)
DIAP (Detailní info o vlastnosti)
DIAC (Detailní info o třídě)
DIAF (Detailní info o souboru)
EFRX (Rozšíření FRX)
PJXEX (Rozšířené vlastnosti projektu)
AC (Po vytvoření)
DCOP (Dynamické přidání tříd, objektů a PEMs)
CONV (Převod HTML do...)
BC (Před vytvořením)
Přehled projektu je odkaz na dokument, který shrnuje informace o projektu, tedy jakýsi úvod.
Pokud to je jednoduchý dokument, lze mu nastavit aby se automaticky překopíroval do repositáře.
VFP má tři základní způsoby definování komentáře: NOTE, * a &&.
Dále v registrech je uložen takzvaný automatický komentář a jeho výchozí hodnota je: *!*.
Někteří programátoři si však tento komentář předefinovávají nebo používají jiný shluk písmen (custom scripts).
Tento dialog umožňuje definovat seznam vlastních typů komentářů, tím se umožní PDM korektně zpracovat informace za komentářem.
Sdílejí-li některé projekty soubory, je zcela zbytečné aby se HTML dokumentace vytvářela znovu pro každý VFP projekt.
S využitím SSZ (Seznam souborů na zpracování) lze z efektivnit tvorbu HTML dokumentace.
Je-li definován tento seznam, pak se nejdříve vygenerujou odkazy všech souborů a tříd z VCX knihoven a PRG souborů (to může chvíli trvat) z uvedených spřátelených PDM projektů, i hlavního PDM projektu, a potom se vytváří HTML dokumentace pro hlavní PDM projekt.
Soubory, které se nezpracovávají, se snaží najít odkaz v seznamu kotev.
Pokud ho najdou, pak se automaticky použije.
Zpracováva-li se seznam PDM projektů, pak:
Nejdříve se zpracují PDM projekty, které nemají spřátelené projekty.
Pak se vytvoří seznam kotev zbylých PDM projektů a jejich spřátelených projektů.
Tato část může být časově náročná, neboť se analyzují i PRG soubory a vyhledávají se v nich definice tříd.
Nakonec se zbylé PDM projekty zpracují.
Tímto lze zajistit vytvoření kompletní HTML dokumentace nejen VFP projektů ve stromové závislosti, ale i v křížové závislosti.
a) Stromová závislost
Projekt frameworku obahuje třídy, které využívají na sobě nezávislé projekty a), nebo závislé v jednom směru b).
a) FrameWork b) FrameWork
| |
| |
----------------- -----------------
| | | |
| | | |
Sklady DKP Sklady <-------- Firmy
a) Křížová závislost
Projekt frameworku obahuje třídy, které využívají na sobě závislé projekty a poskytují si navzájem třídy.
FrameWork
|
|
-----------------
| |
| |
Sklady <-----> Půjčovna
Některé tabulky mají indexy definovány s použitím externím či interních funkcí kde parametrem může být třeba proměnná definovaná za běhu nebo načítána z externího souboru (proměnné z mem souboru).
V tom případě je nutné potřebné soubory zavést před vlastním generováním (Setup) a uvolnit po dokončení generování (Cleanup).
Při zavádění se nesmí zapomenout na klauzuli "ADDITIVE" aby nedošlo k nechtěnému uvolnění souborů nutných pro běh PDM.
Obecné
- GUI
- Umístění a název visuální knihovny s definicí GUI.
Kdo chce, může si napsat vlastní GUI.
- Jazyk
- Složka kde se nachází DBF tabulky s definicí lokalizovaných řetězců.
Tabulky jsou dvě, jedna pro vlastní jádro a další se definicí řetězců pro generované xhtml.
Tabulka s lokalizovanými řetězci pro GUI se nachází jinde a je automaticky použita.
- Asociovat PDM soubor
- Mezi jednu z "dobrých vlastností" aplikace patří možnost zajištění integrace s shellem OS.
- Oprava registry/Vymazání registry
- Pokud je potřeba vyčistit registry od záznamů aplikace klikněte na tlačítko "Vymazání registry".
Kliknutí na "Oprava registry" zajistí uvedení záznamů do výchozího stavu.
- Zavaděč
- VFP IDE umožňuje zavolat při startu jakoukoliv aplikaci.
To ho se dá využít k ovlivnění výchozí VFP nabídky a přidat si volby pro volání vlastních utilit.
Součástí PDM od verze 1.2.0 je vlastní loader který toto umožňuje (stačí překompilovat) a je natolik univerzální, že jej lze použít i pro volání běžných EXE modulů.
- Integrovat s VFP IDE
- Toto zajistí, že PDM požádá zavaděč o registraci nebo odregistraci.
Prohlížeče
Mít možnost spustit jednu aplikaci pro prohlídnutí výsledného xhtml je takové něšťastné, proto je zde možnost si definovat jakoukoliv aplikaci a jednu z nich si označit jako výchozí.
- ID
- Unikátní identifikátor prohlížeče.
Zadává se pouze při přidání nové aplikace.
- Titulek
- Titulek, popis, aplikace zabrazující se v rozblovacím seznamu.
- Soubor
- Umístění a název aplikace.
- Nastavit jako výchozí
- Vybraný prohlížeč nastaví jako výchozí.
Výchozí přípony
Přiřazení určitého typu souboru do skupiny je nutné pro správné zpracování.
Výchozí nastavení by mělo pokrývat rozmezí FP 2.0 až VFP 9.0.
doporučuji do něj vůbec nazasahovat.
Uživatelské GUI
- Pouze PDM nabídka
- V době vývoje samotného PDM je potřeba mít zobrazeny nabídky jak VFP IDE tak i nabídky PDM pro snadnější ladění.
Někdy je však toto vyžadováno i při spuštění PDM z VFP IDE.
- Pamamatovat si maximálně n otevřených souborů
- Maximální počet otevřených souborů jež si PDM pamatuje.
- Zobrazit MRU seznam
- Příznak, zda se má vůbec zobrazit seznam nejčastěji používaných souborů.
- Zobrazit maximálně n souborů
- Počet souborů, které se zobrazí v MRU.
- Zobrazit maximálně n oken
- Počet oken, které se zobrazí v seznamu oken.
- Spustit prohlížeč
- Po vygenerování dokumentace se dá nastavit, zda se má spustit výchozí prohlížeč.
Korm voleb "Vždy" či "Zeptat se" je i volba "Nikdy" :-)