使用maven-site-plugin生成项目站点未生成index.html问题咨询

核心问题说明 #

Maven Site Plugin本身不会自动生成index.html，你当前的配置仅在菜单中声明了index.html的入口，既没有提供首页的源内容，也没有开启自动生成默认首页的开关，因此不会生成该文件。

解决方案 #

方案1：手动编写首页源文件（推荐）

在项目的src/site目录下创建对应格式的首页源文件，插件会在构建时自动编译为index.html：

• 若使用Markdown格式：创建src/site/markdown/index.md，写入你想要展示的首页内容（比如项目介绍、使用指引等）
• 若使用APT/Asciidoc等其他格式，对应创建src/site/apt/index.apt或者src/site/asciidoc/index.adoc即可

方案2：配置插件自动生成默认首页

如果不需要自定义首页内容，直接修改pom中maven-site-plugin的配置，开启自动生成默认index页的开关：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-site-plugin</artifactId>
    <version>3.9.1</version>
    <configuration>
        <generateIndexPage>true</generateIndexPage>
    </configuration>
</plugin>

开启后插件会自动生成包含项目基础信息的默认index.html，不需要手动编写源文件。

修改配置后重新执行mvn clean site:site，即可在target/site目录下看到生成的index.html文件。

内容的提问来源于stack exchange，提问作者Matthias