[MSITE-723] "About" report generated even though index.apt is available in "generated-site"

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 2.0, 3.0, 3.4
• Fix Version/s: 3.5
• Assignee: Herve Boutemy
• Reporter: Andrius Velykis
• Created: 17/Oct/12 06:52
• Updated: 19/Apr/24 16:53
• Resolved: 06/Feb/16 21:59

Description

Normally, if there is an apt/index.apt file in the /src/site directory, About report is not generated, and the following message is displayed: Skipped "About" report, file "index.html" already exists for the English version.

Expecting the same behaviour, I have a situation, where the index.apt file is generated automatically (e.g. copied from somewhere) during `pre-site` phase. maven-site-plugin allows specifying an additional `generatedSiteDirectory` parameter for these files (see http://maven.apache.org/plugins/maven-site-plugin/site-mojo.html).

However, in this case, the "About" report is generated and overrides the copied file from `generatedSiteDirectory` parameter.

I would expect the "About" report to be not generated, if index.apt is available in the `generatedSiteDirectory`.

I have attached a sample project, which uses `antrun` to copy a file to /target/generated-site/apt/index.apt. When you run `mvn site`, it will still display the default "About" page. As an example that `generatedSiteDirectory` works, I also copy the same file to index-copy.apt and an index-copy.html is generated correctly.

Issue Links

• causes: MSITE-1006 MSITE-723 causes duplicate document rendering and log output
• relates to: DOXIASITETOOLS-336 Make SiteRenderingContext#siteDirectories editable aware
• links to: GitHub Pull Request #179