同步操作将从 Halo/halo 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
欢迎关注并有想法参与 Halo 的开发,以下是关于如何参与到 Halo 项目的指南,仅供参考。
所有的代码尽可能都有依据(Issue),不是凭空产生。
这个步骤非常适合首次贡献者。
在 halo-dev 组织下,有非常多的仓库。每个仓库下都有可能包含一些“首次贡献者”友好的 Issue,主要是为了给贡献者提供一个友好的体验。 该类 Issue
一般会用 good-first-issue
标签标记。标签 good-first-issue
表示该 Issue 不需要对 Halo 有深入的理解也能够参与。
请点击:good-first-issue 查看关于 Halo 的 Good First Issue。
若对任何一个 Issue 感兴趣,请尝试在 Issue 进行回复,讨论解决 Issue 的思路。确定后可直接通过 /assign
或者 /assign @GitHub 用户名
认领这个
Issue。这样可避免两位贡献者在同一个问题上花时间。
Fork 此仓库
点击 Halo 仓库主页右上角的 Fork
按钮即可。
Clone 仓库到本地
git clone https://github.com/{YOUR_USERNAME}/halo --recursive
# 或者 git clone git@github.com:{YOUR_USERNAME}/halo.git --recursive
添加主仓库
添加主仓库方便未来同步主仓库最新的 commits 以及创建新的分支。
git remote add upstream https://github.com/halo-dev/halo.git
# 或者 git remote add upstream git@github.com:halo-dev/halo.git
git fetch upstream master
创建新的开发分支
我们需要从主仓库的主分支创建一个新的开发分支。
git checkout upstream/master
git checkout -b {BRANCH_NAME}
提交代码
git add .
git commit -s -m "Fix a bug king"
git push origin {BRANCH_NAME}
合并主分支
在提交 Pull Request 之前,尽量保证当前分支和主分支的代码尽可能同步,这时需要我们手动操作。示例:
git fetch upstream/master
git merge upstream/master
git push origin {BRANCH_NAME}
进入此阶段说明已经完成了代码的编写,测试和自测,并且准备好接受 Code Review。
回到自己的仓库页面,选择 New pull request
按钮,创建 Pull request
到原仓库的 master
分支。
然后等待我们 Review 即可,如有 Change Request
,再本地修改之后再次提交即可。
提交 Pull Request 的注意事项:
master
。例如:即使某个 Bug 于 Halo 1.4.x 被发现,但是提交 Pull Request 仍只针对
master
分支,等待 Pull Request 合并之后,我们会通过 /cherrypick release-1.4
或者 /cherry-pick release-1.4
指令将此 Pull Request
的修改应用到 release-1.4
和 release-1.5
分支上。Code Review 阶段可能需要 Pull Request 作者重新修改代码,请直接在当前分支 commit 并 push 即可,无需关闭并重新提交 Pull Request。示例:
git add .
git commit -s -m "Refactor some code according code review"
git push origin bug/king
同时,若已经进入 Code Review 阶段,请不要强制推送 commits 到当前分支。否则 Reviewers 需要从头开始 Code Review。
请参考 https://docs.halo.run/developer-guide/core/code-style ,请确保所有代码格式化之后再提交。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。