Наследование Javadoc от зависимостей Maven

Мне нужно наследовать Javadoc из интерфейса, который живет в зависимости от Maven. Чтобы наследовать документацию, я добавил переопределение в плагин javadoc в моем модуле. Я положил его в раздел <reporting> моего POM, потому что хочу сгенерировать Javadoc как часть цели mvn site.Наследование Javadoc от зависимостей Maven

Моя проблема заключается в том, что поворот <includeDependencySources> означает, что источник для указанных зависимостей генерируется как часть Javadoc для моего модуля, что нежелательно. Есть ли способ наследовать документацию из источника зависимости, не генерируя Javadoc для источника зависимости?

<reporting> 
    <plugins> 
     <plugin> 
      <groupId>org.apache.maven.plugins</groupId> 
      <artifactId>maven-javadoc-plugin</artifactId> 
      <version>2.9</version> 
      <configuration combine.self="append"> 
       <source>${jdkVersion}</source> 
       <includeDependencySources>true</includeDependencySources> 
       <includeTransitiveDependencySources>false</includeTransitiveDependencySources> 
       <dependencySourceIncludes> 
        <dependencySourceInclude>com.mysource.object:*</dependencySourceInclude> 
        <dependencySourceInclude>com.mysource.object2:*</dependencySourceInclude> 
        <dependencySourceInclude>com.mysource.common:*</dependencySourceInclude> 
       </dependencySourceIncludes> 
      </configuration> 
      <reportSets> 
       <reportSet> 
        <reports> 
         <report>javadoc</report> 
        </reports> 
       </reportSet> 
      </reportSets> 
     </plugin> 
    </plugins> 
</reporting>

источник

2016-06-30 Lisa Jenkins

Поправка, В 'МВН site' в' site' не цель но _фаз_ [жизненного цикла сайта Maven] (https://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html#Lifecycle_Reference) (хотя привязка по умолчанию к этой фазе является целью «сайта» из 'maven-site-plugin' сокращенно, как вы уже догадались,' site'.) –

Я не нашел подсказки, что это возможно на страницах плагина Maven Site.

Однако, см Apache Maven Site Plugin/FAQ, How do I Integrate static (X)HTML pages into my Maven site?:

Вы можете интегрировать ваши статические страницы, выполнив следующие действия:

Put статические страницы в каталоге ресурсов, ${basedir}/src/site/resources

Создайте свой site.xml и положите его в ${basedir}/src/site

Ссылка на статические страницы, изменив раздел меню, создавать элементы и сопоставить их с именами файлов статических страниц

источник

2016-07-01 03:11:03

Наследование Javadoc от зависимостей Maven

ответ

Смежные вопросы