Github：将 gh-pages 镜像到 master

Question

我正在开发一个托管在 GitHub 上的 jQuery 插件。它包含一个演示，我手动复制并推送到分支gh-pages，我想做的是拥有它，所以当我将更改推送到master时，它会自动推送到gh-pages，或者至少是它们被镜像的设置。

我已经看过这个question，但不确定它是否真的回答了我关于这些要求的问题：

1. 我使用Tower，我不介意使用终端 (Mac) 来更改配置，只要解决方案与此 GUI 配合使用即可。
2. 我只希望在某些存储库上“镜像”，而不是在我机器上的所有存储库上。

干杯

Answer 1

将以下两行添加到.git/config 的[remote "origin"] 部分：

push = +refs/heads/master:refs/heads/gh-pages
push = +refs/heads/master:refs/heads/master

每次您push 时，它也会自动将 master 推送到 gh-pages。 我将它用于jQuery Lifestream project。

Answer 2

git checkout gh-pages
git merge master
git push origin gh-pages

Answer 3

不要做上面 denbuzze 建议的事情！！推送中的 +（加号）使其安静地接受非快进更新。我发现这很难通过导致悬空提交而不可避免地导致工作丢失。只需删除加号即可使其成为一种更安全的方法。

push = refs/heads/master:refs/heads/gh-pages
push = refs/heads/master:refs/heads/master

现在不会导致强制更新，而是会导致警告和拉取建议

To https://github.com/someuser/repo.git
 ! [rejected]        master -> gh-pages (fetch first)
 ! [rejected]        master -> master (fetch first)
error: failed to push some refs to 'https://github.com/someuser/repo.git'
hint: Updates were rejected because the remote contains work that you do
hint: not have locally. This is usually caused by another repository pushing
hint: to the same ref. You may want to first integrate the remote changes
hint: (e.g., 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

Answer 4

我正在为@denbuzze 和@MCSDWVL 的答案添加进一步的解释。

如果您想在每次运行 git push origin 时自动推送到 master 和 gh-pages，您可能需要将 Refspec 添加到您的 repo 的 git 配置中。

因此，根据git-scm book，您可以通过将两个push 值添加到repo 配置文件.git/config 中来添加两个RefSpecs：

[remote "origin"]
url = https://github.com/<github_user>/<repo_name>
      fetch = +refs/heads/*:refs/remotes/origin/*
      push = refs/heads/master:refs/heads/master
      push = refs/heads/master:refs/heads/gh-pages

这将导致git push origin ：

1. 将本地master分支推送到远程master分支
2. 将本地master分支推送到远程gh-pages分支

默认情况下。

注意：在规范之前使用 + 会导致强制推送到 repo。谨慎使用：

refspec 的格式是可选的+，后跟<src>:<dst>，其中<src> 是远程端引用的模式，<dst> 是这些引用将在本地写入的位置。 + 告诉 Git 更新引用，即使它不是快进。

Answer 5

我个人喜欢将其包装在别名中：

alias gpogh="git checkout gh-pages && git merge master && git push origin gh-pages && git checkout -"

这会将您的 master 镜像到 gh-pages，推送到 github，然后切换回您正在处理的上一个分支。

Answer 6

提交并推送掌握..

然后：

git checkout gh-pages  // -> go to gh-pages branch
git rebase master // bring gh-pages up to date with master
git push origin gh-pages // commit the changes
git checkout master // return to the master branch

Answer 7

或者你可以只使用下面的 cmd，这会将你的本地 master 分支推送到 gh-pages master 分支。 git push -f origin master:gh-pages

Answer 8

更新：GitHub now allows pages to be published from any branch and directory you want.

---

将gh-pages 分支用作主分支对我来说要容易得多。 “大师”没有什么神奇之处；这只是另一个分支名称。 gh-pages 有一些神奇之处，因为这是 GitHub 寻找 index.html 为您的页面提供服务的地方。

在my other answer on this topic阅读更多内容。

使用gh-pages作为master也比子树容易，子树比镜像容易。您可以按照here 或here 的描述使用git subtree：如果您有一个包含演示的目录，您可以使用一个命令将该目录推送到gh-branch。假设您将目录命名为 gh-pages 以说明问题。然后，在您提交更改并将更改推送到 master 后，运行此命令以更新 gh-pages：

git subtree push --prefix gh-pages origin gh-pages

问题是如果您在gh-pages 中的文件引用了它之外的其他目录中的文件。符号链接不起作用，因此您必须复制用作 gh-pages 的目录中的文件。

如果您use gh-pages as master，则不会出现此问题。