Doxia + Ant的文档

Question

我想使用Doxia来生成一些文档，但是使用Ant来调用它(不，Maven不是一个选项)。我一直在寻找一些指针，但在谷歌上搜索了几次后，什么也没有出现。

是否有人已经在Ant环境中使用了Doxia ?结果如何？

Answer 1

我不知道有任何Ant任务，在Ant构建中使用Maven或invoke Mvn ant task来调用Doxia真的会更简单……

如果这真的不可行，那么拼凑一个custom ant task来调用Doxia应该是相当简单的。

根据要求，我们提供了一些入门指南：

Maven是基于Plexus的，Doxia组件可以从Plexus提供给应用程序。

getting started with 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" );
        ...
    }
}