如何让我的自定义Maven报告插件显示在生成的站点中的项目报告下？

Question

我编写了一个新的maven报告插件，它在生成网站时生成并生成并输出html文件。

如何让网站的“项目报告”部分包含指向它的链接？

Answer 1

作为一种解决方法，您可以在自定义site.xml中手动重新定义项目报告部分：

    <!-- Inherit this menu for sub modules. -->
    <menu name="Module Documentation" inherit="top" >
        <item name="Overview" href="index.html" >
        </item>

        <item name="Information" href="project-info.html" >
            <item name="Dependencies" href="dependencies.html" />
            <item name="Project Plugins" href="plugins.html" />
            <item name="Project Summmary" href="project-summary.html" />
            ...
        </item>

        <item name="Reports" href="project-reports.html" >
            <item name="Checkstyle" href="checkstyle.html" />
            <item name="Your Report" href="your-report.html" />
            ...
        </item>
    </menu>

缺点是：

• 您必须指定每个报告。
• 您还必须提供project-reports.html（例如，通过project-reports.apt），您将丢失包含所有报告的自动生成的概述页面。
• 如果某些模块不包含所有报告，则必须提供单独的site.xml文件以覆盖父site.xml。

请参阅网站插件文档中的Configuring the Site Descriptor。