Лучший способ установить альтернативное расположение JavaDoc для всех модулей?

Question

Я хотел бы установить альтернативное расположение JavaDoc для всех моих модулей в многомодульном проекте maven. К сожалению, мне приходится полагаться на относительные пути или использовать свойства maven, такие как ${basedir}, так как это командный проект на Subversion, и абсолютный путь не будет одинаковым для всех нас.

Каков наилучший способ сделать это? Если у меня есть структура проекта

родитель
   sub1
   sub2
   sub3
      документы

И я хочу поместить API в sub3/docs, тогда как я могу указать всем моим модулям выводить файлы HTML в sub3/docs, когда родительский модуль распознает путь к нему, отличный от подмодулей?

Заранее спасибо.

Answer 1

Вы хотите как можно меньше загрязнять сборку своего проекта, особенно повторяющимися изменениями сборки. Вместо этого вам лучше создать отдельный процесс сборки, который собирает выходные данные javadoc из стандартного местоположения во всех проектах и ​​публикует их где угодно.

Answer 2

Добавьте следующее в родительский pom и убедитесь, что дочерний pom не определяет свой собственный плагин javadoc.

       <build>
       <plugins>
       <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.7</version>

            <configuration>
                <outputDirectory>${project.parent.basedir}/sub3</outputDirectory>
                <reportOutputDirectory>${project.parent.basedir}/sub3</reportOutputDirectory>
                <destDir>docs</destDir>
            </configuration>
        </plugin>
        </plugins>
        </build>