2010-06-10 12 views
0

Je voudrais inclure une documentation générée par phpdoc dans ma documentation docbook déjà existante.Combinaison de phpdoc et de docbook existant

Mon idée était de laisser phpdoc générer la documentation au format docbook puis d'importer des parties (basées sur des paquets et des sous-paquetages) en utilisant XInclude. J'utilise Docbook 5 pour ma documentation. Y'a-t-il une quelconque façon de réussir cela?


Ce que j'ai essayé ce qui est loin de générer un DocBook en utilisant XML:DocBook/peardoc2:default comme paramètre phpdoc.

de DocBook de PHPDocumentor est divisé en plusieurs fichiers - thats ce grand, mais les fichiers ressembler à quelque chose comme ça

<chapter id="package.default"> 
<title>default</title> 
&package.default.default; 
&package.default.foobar; 
</chapter> 

Pour autant que je comprends ce sont des entités externes, mais ils doivent être référencés dans une DTD - faire ils sont inutiles pour mon effort, car il n'y a pas de DTD générée par phpdoc et je ne veux pas inclure un fichier pour chaque classe et méthode à la main.

Répondre

0

En premier lieu, si cela est vraiment censé être DocBook 5, vous avez besoin « xml » avant « id » comme ceci:

<chapter xml:id="package.default"> 

Deuxièmement, vous pouvez utiliser un catalogue XML pour contenir toutes vos références d'entité: http://www.sagehill.net/docbookxsl/Catalogs.html