phpdoc - 将 phpdoc 与现有 docbook 相结合

Question

我想将一些 phpdoc 生成的文档包含在我已经存在的 docbook 文档中。

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

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

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

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

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

score 0 · Accepted Answer

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

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

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

1 回答 1