Сочетание phpdoc с существующей docbook

Question

Я хотел бы включить некоторые документы, сгенерированные phpdoc, в мою уже существующую документацию docbook.

Моя идея состояла в том, чтобы позволить phpdoc генерировать документацию в формате docbook, а затем импортировать части (на основе пакетов и подпакетов), используя XInclude. Я использую Docbook 5 для своей документации. Есть ли способ достичь этого?

---

То, что я попробовал это далеко генерирующий DocBook с использованием XML:DocBook/peardoc2:default в качестве параметра PHPDoc.

DocBook PhpDocumentor разделен на несколько файлов - тот большой, но файлы выглядеть как этот

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

Насколько я понимаю, это те внешние объекты, но они должны быть ссылки в DTD - делает они бесполезны для моих усилий, поскольку нет DTD, сгенерированных phpdoc, и я не хочу включать файл для каждого класса и метода вручную.

Answer 1

Во-первых, если это действительно должно быть DocBook 5, вам нужно «XML» до «ид», как это:

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

Во-вторых, вы можете использовать каталог XML, чтобы держать все ваши ссылки на объекты: http://www.sagehill.net/docbookxsl/Catalogs.html