13

Github 建议在项目的根目录中创建 Markdown 格式的文件，如 README.md、LICENCE.md 或 CONTRIBUTORS.md。另一方面，这些文件对于自动生成的 Maven 站点来说是有价值的内容。

将这些文件包含到生成的站点报告中的最佳做法是什么？

我的一个想法是将它们复制到 src/site/markdown 并在成功生成站点后再次删除它们（以避免 SCM 污染）。

4

2 回答 2

8

我README.md使用您在问题中概述的方法解决了 Git 存储库中文件的这个问题，即README.md从根目录复制到${baseDir}/src/site/markdown. 我用来maven-resources-plugin复制文件。我没有在站点生成后删除复制的文件（以避免 SCM 污染），而是.gitignore按照 Bruno 的建议将其添加到.

以下是解决方案的详细说明。

在project.build.plugins部分pom.xml：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-resources-plugin</artifactId>
    <executions>
        <execution>
            <!-- Copy the readme file to the site source files so that a page is generated from it. -->
            <id>copy-readme</id>
            <phase>pre-site</phase>
            <goals>
                <goal>copy-resources</goal>
            </goals>
            <configuration>
                <outputDirectory>${basedir}/src/site/markdown</outputDirectory>
                <resources>
                    <resource>
                        <directory>${basedir}</directory>
                        <includes>
                            <include>README.md</include>
                        </includes>
                    </resource>
                </resources>
            </configuration>
        </execution>
    </executions>
</plugin>

在.gitignore：

# Copied from root to site source files by maven-resources-plugin
/src/site/markdown/README.md

您可以在此处查看相应的提交。

于 2016-02-16T10:20:04.183 回答
0

贡献者应该被放入pom中。许可证文件应该是项目的一部分，通常 LICENSE.txt 作为 Apache 建议的 pom.xml 文件的兄弟。Apache 也建议使用 README.txt。README.md 通常只对 GitHub 在存储库显示期间呈现它有价值。

于 2012-12-06T17:25:17.097 回答