documentation - Doxia + Ant によるドキュメンテーション

Question

Doxiaを使用してドキュメントを生成したいのですが、Ant で呼び出します (いいえ、Maven はオプションではありません)。いくつかのポインターを探していましたが、Googleで数回検索しても何も表示されませんでした。

Doxia を Ant 環境で既に使用している人はいますか? その結果はどうでしたか?

Answer 1

Ant Doxia タスクについては知りません。Ant ビルド内から Maven または invoke Mvn ant タスクを使用して Doxia を呼び出す方が簡単です...

これが実際に不可能な場合は、Doxia を呼び出すカスタム Ant タスクをまとめるのがかなり簡単です。

要求に応じて、開始するためのいくつかのポインター:

Maven はPlexusに基づいており、Doxia コンポーネントは Plexus コンテナからアプリケーションに利用できます。Plexus の使用を開始する
ためのチュートリアルがあり、ラッパーの作成に関する背景情報に役立つ場合があります。

次の例は、スタンドアロン アプリケーションでSiteToolsコンポーネントを取得する方法を示しています。上記の Ant チュートリアルのように、Ant タスクで実行をラップするのは簡単です。

public class DoxiaPlexusTest
{
    public static void main( String[] args )
        throws Exception {
        // create a new container
        PlexusContainer container = new DefaultPlexusContainer();

        SiteTool siteTool = container.lookup( SiteTool.class );

        try {
            new DoxiaPlexusTest().letsDoDoxia(siteTool);
        finally {
            // stop the components and container
            container.dispose();
        }
    }

    public void letsDoDoxia(SiteTool siteTool) {
        List localesList = siteTool.getAvailableLocales( locales );
        String relativePath = siteTool.getRelativePath( "C:/foo/child",
                            "C:/foo/master" );
        ...
    }
}