是否可以在不先检查的情况下替换 git 分支的树？

Question

对于github.io 上的页面，通常在主存储库上使用名为gh-pages 的分支来发布与特定存储库关联的网站。

在我当前的项目中，我执行以下步骤来更新托管在 github.io 上的文档。

1. 使用 Doxygen 在主分支上构建 API 文档。
2. 将html 目录移动到临时目录。
3. 查看gh-pages 分支。
4. 将临时目录的内容复制到项目目录中。
5. git commit 和 git push gh-pages 分支。
6. 再次结帐master分支。

是否可以一步将html目录的内容提交到gh-pages分支？

请注意，我不想将html 目录的内容添加到master 分支，因为它是生成的内容而不是源代码。

我已经查看了this question 和this question，但它们似乎无法解决这个问题。

这实际上不是this question 的重复，因为这个问题涉及整个树的替换而不是添加单个文件，我相信前者的操作可以比后者更简洁。

Answer 1

在新的本地存储库中再次克隆您的远程存储库。 在这个新存储库中签出分支 gh_pages。

使用您已经拥有的 repo 进行开发，就像您现在使用它一样。

像现在一样使用 Doxygen 在开发存储库的主分支上构建 API 文档。如果可能，配置该过程以在存储第二个本地存储库的目录中生成输出。否则在创建后将生成的文档移动到第二个本地 repo。

在第二个存储库（文档存储库）中运行 git add .; git commit; git push。

每次需要时重复最后两个步骤。

Answer 2

我编写了以下脚本以避免使用额外的工作目录，尽管@axiac 的回答是解决此问题的有效方法。

#!/bin/bash

# This script will take a directory and replace the contents of a non-current
# branch with it.
if [ "$#" -ne 3 ]; then
    echo \
    "Usage:  replace-branch <top level directory> <branchname> <commit message>"
    exit
fi

root="$1"
branch="$2"
msg="$3"

# First check if the index is polluted, since we will be using it.
save=HEAD
indexDiverges=$(git diff-index --cached  $(git rev-parse HEAD))
if [[ -n "$indexDiverges" ]]; then
    save=$(git write-tree)
fi

# Create a new index
git read-tree --empty
GIT_WORK_TREE=$root git add .

# Check whether the index is actually different from the target.
isDuplicateCommit=$(git diff-index --cached  $(git rev-parse $branch))
if [[ ! -n "$isDuplicateCommit" ]]; then
    echo "The branch already matches the state we are trying to commit!"
    git read-tree $save
    exit
fi

# Write the index out to a new tree
tree=$(git write-tree)

# Commit with the given commit message to the other branch
commithash=$(echo "$msg" | git commit-tree $tree -p $(git rev-parse $branch))

# Move the branch pointer.
git update-ref $(git show-ref --heads "$branch"  | awk '{print $2}') \
    "$commithash"

# Restore the index to its previous state
git read-tree $save

我还决定稍微升级一下，并将其放在GitHub 上并举例说明。