20

自動的に生成されたHTMLドキュメントを含むディレクトリを持つGithub上のプロジェクトがあります。そのドキュメントをGithubのプロジェクトページ機能内で使用したいと思います。

そこで、プロジェクトのgh-pagesルートブランチを作成する方法についての説明を読みました。これにより、空のブランチが効果的に作成されます。

私が助けて欲しいのは、ブランチ/docsからのパスにあるhtmlファイルをミラーリングして、masterブランチのルートにあるようにすることgh-pagesです。これにアプローチする最良の方法は何ですか？

4

3 に答える 3

16

ここで私自身の質問に答えます...Gitサブモジュールで私が望んでいたことを達成しました。

私は基本的にこの酒のタスクで詳細に説明されているものをコピーしましたが、要約すると：

  • docsパスを一時フォルダーに移動しました。変更をコミットします。
  • 通常の手順に従ってクリーンなgh-pagesブランチを作成しました
  • すべてをtempフォルダーから新しいgh-pagesブランチに移動しました。変更をコミットします。
  • マスターブランチに戻り、リモートgh-pagesをサブモジュールとしてdocsフォルダーに追加します。
  • 変更をコミットします。出来上がり！
于 2011-06-15T11:32:11.410 に答える
1

うーん、私は自分のドキュメントをプッシュするためにこれら2つのMakefileターゲットを書くことになりました。私はupdate-docを作成するだけで、通常は機能します。

TMP_PATH="/tmp/some_path"

## the dir containing HTML docs to push to gh-pages
HTML_DIR="html"

## arbitrary dirs created by the doc build system that should be removed
TRASH=latex

update-doc: doc
        rm -rf ${TMP_PATH} && cp ${HTML_DIR} ${TMP_PATH} -R && rm -rf ${HTML_DIR}
        git fetch
        git checkout gh-pages
        cp ${TMP_PATH}/* . -R
        rm -rf ${TRASH}
        git add .
        git commit -m "Update documentation"
        git push -u origin gh-pages
        rm -rf ${TMP_PATH}
        git checkout master

# command to build documentation; can be customised but
# remember to also change the HTML_DIR and TRASH variables
doc:
        doxygen docs/doxygen.conf

.PHONY: doc update-doc

私は使用してdoxygenいますが、これを他のドキュメントシステムに変更できます。

gh-pagesこれは、ブランチがリモートに存在し、ここで説明されているように作成されたことを前提としています。

于 2015-11-05T18:18:43.037 に答える
0

その場所へのそれらのファイルのシンボリックリンクを作成します。あなたもそれらをコミットすることができるはずです。

于 2011-06-15T02:48:51.607 に答える