我有一个托管在 GitHub 上的 java 项目。我想允许查看此托管的 JavaDoc HTML 页面。为此,我创建了gh-pahes
分支。
如何使用 EGit 和 Eclipse IDE轻松将 JavaDoc(创建到master
分支中)移动/提交到分支中?gh-pages
我经常重新生成 JavaDoc,并希望找到一种方法来轻松地将新版本的 JavaDoc 提交gh-pages
到master
分支中。
这不在 Eclipse 中,但这是我在没有第二个 repo 克隆的情况下在命令行中进行移动的方式。首先,我配置我的 javadoc 插件以在我的 pom.xml 中使用它在我的项目目录中的文件夹“apidocs”中生成文档
<build>
<plugins>
...
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.10.3</version>
<configuration>
<reportOutputDirectory>apidocs</reportOutputDirectory>
</configuration>
</plugin>
...
然后我将“apidocs”添加到我的 .gitignore 中。然后为了制作和移动 javadocs,我执行以下操作 - 从 master 开始:
mvn javadoc:javadoc
tar cfv apidocs.tar apidocs
git checkout gh-branches
tar xfv apidocs.tar
git commit -a
git push
rm apidocs.tar
git checkout master
诀窍是 tar 文件(永远不会在 repo 中结束)确实在分支之间的切换中幸存下来 - 而当我切换分支时,文件夹层次结构中 apidocs 文件的更改似乎消失了。
很好,当我切换回 master 时 - apidocs 文件夹不见了。
我建议您使用带有签出gh-pages
分支的存储库的第二个克隆。然后,您可以轻松移动和提交生成的文件,而无需在 master 和 gh-pages 分支之间切换。
我发现没有我想要的那么好的解决方案,但它是有效的:
如何更新:
仅此而已!现在你从master分支副本提交到gh-pages分支!
我不知道为什么我需要使用特殊分支来访问我在 GitHub 中的 HTML 文档?!使用谷歌代码更有用!