Chinese language support

(1)Things a non Programmer can do.zh-cn.md (2)undoing-a-commit.zh-cn.md (3)Useful-links-for-further-learning.zh-cn.md (4)why-using-branches.zh-cn.md (5)git-bash-windows-tutorial.zh-cn.md (6)github-cli-tutorial.zh-cn.md
2026-05-14 01:31:50 +00:00 · 2025-05-13 16:39:06 +08:00
parent 0106eff0b5
commit 28ce46db61
7 changed files with 612 additions and 33 deletions
@@ -0,0 +1,109 @@
+[![开源之爱](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges)
+[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM)
+[![许可证: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![开源贡献者](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions)
+
+# First Contributions （首次贡献）
+
+| <img alt="GitHub Desktop" src="https://cdn.icon-icons.com/icons2/2157/PNG/512/github_git_hub_logo_icon_132878.png" width="200"> | GitHub 命令行工具 (CLI) |
+| ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
+
+这是给我们这些终端爱好者准备的指南，感谢 [Github-CLI](https://cli.github.com/)，我们可以在终端中完成所有事情。你的第一次贡献应该是有趣、有成就感的，它将激励你继续前进！
+
+这个指南稍微有些挑战，因为我们不会使用任何图形界面。但它仍然非常有趣，并且你一定可以跟得上！
+
+你需要准备以下工具：
+
+- 安装 Git (如何安装 [git](https://git-scm.com/downloads))
+- Github 账户
+
+现在我们需要在系统中安装 `github-cli` 工具，方法请见[官方文档](https://github.com/cli/cli#installation)
+
+接着输入以下命令登录 CLI：
+
+```bash
+gh auth login
+```
+
+按照指示完成登录，我们就准备好了！
+
+# Fork 这个仓库
+
+只需运行以下命令即可：
+
+```bash
+gh repo fork firstcontributions/first-contributions
+```
+
+**重要提示：命令会提示你是否需要克隆仓库，请选择 “yes”**
+
+# 创建你的分支
+
+使用 Git 创建一个新分支，命名时请用你的名字替换示例中的部分，例如：
+
+```bash
+git switch -c add-john-doe
+```
+
+# 做出必要更改并提交
+
+现在，你可以用文本编辑器打开  `Contributors.md` 文件并添加你的名字。将你的名字加在文件的任何地方，然后保存文件。
+
+在项目目录中执行 `git status` 命令查看更改。
+<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
+
+使用 `git add` 命令将更改添加到你刚创建的分支：
+`git add Contributors.md`
+
+然后使用 `git commit` 命令提交更改：
+`git commit -m "Add your-name to Contributors list`
+请将 `your-name` 替换为你的名字。
+
+# 推送更改到 GitHub
+
+使用下面的命令推送更改：
+
+```
+git push origin -u your-branch-name
+```
+
+请将 `your-branch-name` 替换为你之前创建的分支名称。
+
+<details>
+<summary> <strong>如果在推送过程中出现错误，请点击这里：</strong> </summary>
+
+- ### 身份验证错误
+     <pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
+  remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
+  fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
+  请参考 [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) 来生成并配置 SSH key。
+
+</details>
+
+# 提交你的更改以供审查
+
+在你的仓库目录下运行以下命令来创建 Pull Request：
+
+```bash
+gh pr create --repo firstcontributions/first-contributions
+```
+
+接着提交 Pull Request。
+
+你可以使用 `gh status` 命令来查看你的 PR 状态。
+
+## 接下来做什么？
+
+恭喜你！你刚完成了一个常见的开源贡献流程 — fork -> clone -> edit -> pull request！
+
+你可以通过访问 [web app](https://firstcontributions.github.io/#social-share) 与朋友和关注者分享你的贡献。
+
+如果你有任何疑问或需要帮助，也可以加入我们的 Slack 团队：[Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA)。
+
+现在你可以开始为其他项目做贡献了。我们收集了一些适合入门的项目，你可以在[the list of projects in the web app](https://firstcontributions.github.io/#project-list)上查看。
+
+### [Additional material](additional-material/git_workflow_scenarios/additional-material.md)
+
+## 使用其他工具的教程
+
+[Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)