0

phpdoc で生成されたドキュメントを、既存の docbook ドキュメントに含めたいと考えています。

私のアイデアは、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 がなく、すべてのクラスとメソッドにファイルを含めたくないため、私の努力には役に立ちません。手で。

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 に答える