关于复刻
在自己使用 GitHub 一段时间后,您可能会发现自己也想参与别人的项目。 或者,也许您想使用某人的项目作为自己项目的起点。 此过程称为复刻。
创建“复刻”就是生成他人项目的个人副本。 复刻可作为原始存储库和个人副本之间的桥梁。 您可以提交拉取请求,通过提供对原始项目的更改来帮助改善其他人的项目。 复刻是 GitHub 社交编� �的� �心。 有关详细信息,请参阅“为存储库创建分支”。
复刻仓库
本教程使用 Spoon-Knife 项目,这是一个托管在 GitHub.com 上的测试存储库,可让� 测试分支和拉取请求工作流。
- 导航到位于 https://github.com/octocat/Spoon-Knife 的
Spoon-Knife
项目。 - 单击“分支”。
- 为分支存储库选择所有者。
- 默认情况下,分支的名称与其父存储库的相同。 可更改分支的名称以进一步区分它。
- 可以选择性地添� 分支的说明。
- 选择是仅将默认分支还是将所有分支复制到新分支。 对于许多分支场景(例如参与开源项目),� 只需复制默认分支。 默认情况下,只复制默认分支。
- 单击“创建分支”。
注意:如果要从父存储库复制其他分支,可从“分支”页执行此操作 。 有关详细信息,请参阅“创建和� 除存储库中的分支”。
克隆复刻
您已经成功复刻了 Spoon-Knife 存储库,但到目前为止,它仅存在于 GitHub Enterprise Server 上。 为了能够处理该项目,您需要将其克隆到您的计算机。
您可以使用命令行、GitHub CLI 或 GitHub Desktop 克隆复刻。
-
在 GitHub Enterprise Server 上,导航到 Spoon-Knife 存储库的分支。
-
在文件列表上方,单击 “代� �”。
-
复制存储库的 URL。
- 要使用 HTTPS 克隆存储库,在“HTTPS”下单击 。
- 要使用 SSH 密钥克隆存储库,包括组织的 SSH 证书颁发机构颁发的证书,请单击“SSH”,然后单击 。
- 要使用 GitHub CLI 克隆存储库,请单击“GitHub CLI”,然后单击 。 1. 打开终端终端Git Bash。 4. 将当前的工作目录更改为您想要存储克隆目录的位置。
-
键入
git clone
,然后粘贴之前复制的 URL。 它将如下所示,使用� 的 GitHub Enterprise Server 用户名替换YOUR-USERNAME
:$ git clone https://hostname/YOUR-USERNAME/Spoon-Knife
-
按 Enter。 将创建您的本地克隆。
$ git clone https://hostname/YOUR-USERNAME/Spoon-Knife > Cloning into `Spoon-Knife`... > remote: Counting objects: 10, done. > remote: Compressing objects: 100% (8/8), done. > remove: Total 10 (delta 1), reused 10 (delta 1) > Unpacking objects: 100% (10/10), done.
若要详细了解 GitHub CLI,请参阅“关于 GitHub CLI”。
若要创建分支的克隆,请使用 --clone
� �记。
gh repo fork repository --clone=true
-
在“文件”菜单中,单击“克隆存储库” 。
创建和推送更改
继续使用� 喜欢的文本编辑器(例如 Visual Studio Code)对项目进行一些更改。 例如,可以更改 index.html
中的文本以添� � 的 GitHub 用户名。
当您准备好提交更改时,请暂存并提交更改。 git add .
告诉 Git � 希望在下一次提交中包含所有更改。 git commit
会拍摄这些更改的快照。
git add .
git commit -m "a short description of the change"
git add .
git commit -m "a short description of the change"
有关如何在 GitHub Desktop 中暂存和提交更改的详细信息,请参阅“提交和查看项目的更改”。
暂存和提交文件时,您主要是告诉 Git:“好吧,拍摄我的更改快照!” 您可以继续进行更多更改,并拍摄更多提交快照。
目前,您的更改仅存在于本地。 当您准备好将更改推送到 GitHub Enterprise Server 时,请将更改推送到远程。
git push
git push
有关如何在 GitHub Desktop 中推送更改的详细信息,请参阅“将更改推送到 GitHub”。
创建拉取请求
最后,您可以对主项目提出更改建议了! 这是产生他人项目复刻的最后一步,可以说是最重要的一步。 如果您做了您认为有益于整个社区的改变,绝对应该考虑回馈社区。
为此,请转到项目所在的 GitHub Enterprise Server 存储库。 在本示例中,它位于 https://www.github.com/<your_username>/Spoon-Knife
。 � 将看到一个横幅,指示� 的分支是 octocat:main
之前的一个提交。 单击“参与”,然后单击“打开拉取请求” 。
GitHub Enterprise Server 会将� 带到一个页面,其中显示了分支和 octocat/Spoon-Knife
存储库之间的差异。 单击“创建拉取请求”。
GitHub Enterprise Server 将带您进入一个页面,您可以在其中输入更改的� �题和说明。 重要的是要提供尽可能多的有用信息,在首要位置说明您提出此拉取请求的理由。 项目所有者需要能够确定您的更改是否像您认为的那� �对每个人都有用。 最后,单击“创建拉取请求”。
管理反馈
拉取请求是一个讨论区域。 在这种情况下,Octocat 非常繁忙,可能不会合并您的更改。 对于其他项目,如果项目所有者拒绝您的拉取请求,或者要求提供有关请求原� 的更多信息,请不要生气。 甚至可能是项目所有者选择不合并您的拉取请求,这完全没问题。 您的副本将存在于互联网上。 谁知道呢 - 也许您从未见过的人会发现您的更改比原始项目更有价值。
查找项目
您已成功复刻并回馈存储库。 来吧,再贡献一些!