我想在我现有的docbook文档中包含一些phpdoc生成的文档。
我的想法是让phpdoc以docbook格式生成文档,然后使用XInclude导入部分(基于包和子包)。我正在使用Docbook 5作为我的文档。有没有办法实现这个目标?
我到目前为止尝试使用XML:DocBook/peardoc2:default
作为phpdoc参数生成docbook。
PHPDocumentor的docbook分为几个文件 - 这很好,但文件看起来像这样
<chapter id="package.default">
<title>default</title>
&package.default.default;
&package.default.foobar;
</chapter>
据我所知,这些是外部实体,但它们需要在DTD中引用 - 这使得它们对我的努力毫无用处,因为phpdoc没有生成DTD,我不希望每个都包含一个文件手工课和方法。
答案 0 :(得分:0)
首先,如果这真的应该是docbook 5,那么你需要在“id”之前使用“xml”:
<chapter xml:id="package.default">
其次,您可以使用XML目录来保存所有实体引用:http://www.sagehill.net/docbookxsl/Catalogs.html