0

我想将一些 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,我不想为每个类和方法都包含一个文件用手。

4

1 回答 1

0

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

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

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

于 2010-06-10T16:24:41.543 回答