1

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

如何使用 EGit 和 Eclipse IDE轻松将 JavaDoc(创建到master分支中)移动/提交到分支中?gh-pages我经常重新生成 JavaDoc,并希望找到一种方法来轻松地将新版本的 JavaDoc 提交gh-pagesmaster分支中。

4

3 回答 3

2

这不在 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 文件夹不见了。

于 2015-06-13T06:13:00.163 回答
0

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

于 2012-08-13T19:50:31.550 回答
0

我发现没有我想要的那么好的解决方案,但它是有效的:

  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 文档?!使用谷歌代码更有用!

于 2012-08-21T14:09:13.450 回答