使用 Doxia + Ant 的文档

Question

我想使用 Doxia生成一些文档但使用 Ant 调用它(不，Maven 不是一个选项)。我正在寻找一些指示，但经过几次 Google 搜索后没有任何提示出现。

有人已经在 Ant 环境中使用过 Doxia 吗？结果如何？

Answer 1

我不知道任何 Ant Doxia 任务，使用 Maven 或调用 Mvn ant task 确实会更简单从您的 Ant 构建中调用 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" );
        ...
    }
}