将 phpdoc 与现有 docbook 相结合答案

【问题标题】：Combining phpdoc with existing docbook将 phpdoc 与现有 docbook 相结合
【发布时间】：2010-06-10 14:47:43
【问题描述】：

我想将一些 phpdoc 生成的文档包含到我现有的 docbook 文档中。

我的想法是让 phpdoc 生成 docbook 格式的文档，然后使用 XInclude 导入它的部分（基于包和子包）。我正在使用 Docbook 5 作为我的文档。有什么方法可以实现吗？

到目前为止，我尝试的是使用XML:DocBook/peardoc2:default 作为 phpdoc 参数生成文档手册。

PHPDocumentor 的 docbook 分为几个文件 - 这很好，但文件看起来像这样

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

据我了解，这些是外部实体，但需要在 DTD 中引用它们 - 使它们对我的工作毫无用处，因为 phpdoc 没有生成 DTD，我不想为每个实体都包含一个文件手动类和方法。

【问题讨论】：

【解决方案1】：

首先，如果这真的应该是 docbook 5，您需要在“id”之前使用“xml”，如下所示：

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

其次，您可以使用 XML 目录来保存所有实体引用：http://www.sagehill.net/docbookxsl/Catalogs.html

【讨论】：