如何使用 EGit 和 Eclipse 将 JavaDoc 从 master 分支移动到 GitHub 上的 gh-pages 分支？

Question

我有一个托管在 GitHub 上的 Java 项目。 我希望允许查看此托管的 JavaDoc HTML 页面。 为此，我创建了gh-pahes分支。

如何使用 EGit 和 Eclipse IDE 将 JavaDoc（创建到master分支）轻松移动/提交到gh-pages分支？ 我经常重新生成 JavaDoc，并希望找到一种方法来轻松地将新版本的 JavaDoc 提交到gh-pages但在master分支中工作。

Answer 1

这不在 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>
      ...

然后我在 master 中将“apidocs”添加到我的 .gitignore 中。 然后为了制作和移动 javadoc，我执行以下操作 - 从 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 文件夹不见了。

Answer 2

我建议你使用你的存储库的第二个克隆和一个检出的gh-pages分支。 然后，您可以轻松移动和提交生成的文件，而无需在 master 和 gh-pages 分支之间切换。

Answer 3

我发现不是我想要的那么好的解决方案，但它是有效的：

1. 在 GitHub 中创建gh-pages分支。
2. 结帐这个分支。
3. 从gh-pages切换到master并生成javadoc 。
4. 提交javadocs 。
5. 从master切换到gh-pages分支。
6. 您可以看到gh-pages分支包含javadoc文件夹。
7. 只需将此文件夹提交到gh-pages 。
8. 看怎么更新！

如何更新：

1. 在master分支中删除所有javadoc目录并重新生成javadoc 。
2. 只提交生成的javadoc ！ .
3. 从master切换到gh-pages分支。
4. 删除旧的javadoc并提交此更改！
5. 右键单击您的项目并选择Team -> Show in History 。
6. 发现您从master分支使用javadoc提交。
7. 右键单击此提交并选择Cherry Pick 。

仅此而已！ 现在您从master分支副本提交到gh-pages分支！

我不知道为什么我需要使用特殊分支来访问 GitHub 中的 HTML 文档？！ 使用 Google Code更有用！