Документация с помощью Doxia + Ant - PullRequest
3 голосов
/ 09 октября 2009

Я хотел бы использовать Doxia для генерации некоторой документации, но вызывать ее с помощью Ant (и нет, Maven не вариант). Я искал несколько указателей, но после нескольких поисков в Google ничего не появлялось.

Кто-нибудь уже использовал Doxia в среде Ant и как это получилось?

1 Ответ

3 голосов
/ 09 октября 2009

Я не знаю ни одной задачи Ant Doxia, действительно было бы проще использовать Maven или вызывать Mvn ant task изнутри вашей сборки Ant для вызова Doxia ...

Если это действительно неосуществимо, было бы довольно просто собрать вместе пользовательскую задачу муравья , чтобы вызвать Доксию.

По запросу, несколько указателей для начала:

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