ant - Ant のドキュメンテーション ジェネレーター?

Question

私の会社では、Ant に基づく非常に複雑なビルド システムを使用しています。それを理解するのに長い時間がかかりました。私は現在それを再構築しており、新しい開発者がそれを勝ち取りやすくすることにもなります.

build.xml ファイルとそのインクルードに基づいてドキュメントを生成できる (優れた) ドキュメント ジェネレータはありますか?

Answer 1

XSLT ルールを記述して、リンクまたは次のように HTML に変換できます。

(うーん、またはbuild.xmlにCSSを使用する方がはるかに簡単かもしれません)

すなわち

<target name="tar1" depends="tar2, tar3">
....
</target>

に来る

<div class="target">
    <a name="tar1"><p class="name">tar1</p></a>
    <div class="deps-list">
        Depends on:
        <ul>
            <li><a href="#tar2">tar2</a></li>
            <li><a href="#tar3">tar3</a></li>
        </ul>
    </div>
    <div class="content">
        Tasks:
        <ul>
            <li><p class="taskname">Copy</p><p class="taskargs">args...</p></li>
            ...
        </ul>
    </div>
</div>