文档教程开源治理【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址https://gitcode.com/gh_mirrors/fi/first-contributions点击查看免费下载导读本文以 first-contributions 仓库的入门指南docs/translations/README.sl.md斯洛文尼亚语版为主体结合仓库内英文 README.md 与斯洛文尼亚语进阶材料系统讲解开源协作中最经典的fork → clone → edit → pull request工作流。读完本文你将掌握用命令行完成一次真实开源贡献的全部技能Fork 上游仓库、克隆到本地、创建特性分支、修改文件并提交、推送到远程、提交 Pull Request 等待审核合并并了解如何配置 Git 身份、如何让 Fork 与上游保持同步。项目定位为什么需要一个安全的练习场first-contributions 的核心定位非常明确帮助初学者迈出开源贡献的第一步。指南开篇就点出了动机——与别人协作时犯错会显得格外尴尬因此项目专门为新手搭建了一个可以放心练习的环境让读者在真实仓库中走完一遍完整贡献流程而不是仅仅阅读文章、观看教程见 docs/translations/README.sl.md 引言部分。该文档是整个仓库多语言体系中的一份斯洛文尼亚语Slovenščina翻译遵循项目一贯的排版惯例英文术语一律用括号括注原文如ukazna vrstica (command line)帮助非英语母语读者在母语与英文术语之间建立对应关系。英文原版入口位于仓库根目录 README.md全部语言版本索引见 docs/translations/Translations.md。准备工作安装并配置 Git在开始之前请确认本机已经安装 Git。如果没有除查阅 Git 官方安装说明外仓库内还提供了面向不同操作系统的安装指南例如 installing-git-ubuntu.md 与 installing-git-arch.md。配置提交者身份三种作用域许多新手在第一次执行git commit时会看到如下报错因为 Git 必须知道你是谁才能把提交与姓名、邮箱绑定$ git commit *** Please tell me who you are. Run git config --global user.email youexample.com git config --global user.name Your Name to set your accounts default identity. Omit --global to set the identity only in this repository.按仓库内 configuring-git.sl.md 的讲解身份信息有三种配置方式作用域逐级收窄1. 全局配置推荐覆盖本机所有仓库$ git config --global user.email youexample.com $ git config --global user.name Your Name2. 仓库级配置仅对当前仓库生效适合需要以工作邮箱提交特定项目如公司项目的场景写法与全局配置相同只是去掉--global标志$ git config user.email youalternate.com $ git config user.name Your Name3. 命令行级配置仅对当前这一条命令生效所有 Git 命令都接受-c前缀用于创建临时配置$ git -c user.nameYour Name -c user.emailyouexample.com commit -m Your commit message三种方式的优先级为command-line repository global同一变量若在多个层级同时设置Git 采用更具体层级的值。除此之外还有几个常用的非身份配置项值得了解core.editor指定撰写提交信息的编辑器、commit.template指定提交信息模板文件、color.ui布尔值控制 Git 输出是否着色。第一步Fork 本仓库Fork 是进入开源世界的第一个动作。打开 first-contributions 仓库页面点击页面顶部的Fork按钮GitHub 就会在你自己的账户下创建一份该仓库的副本repository 常被简称为 repo。这一步的意义在于你没有上游仓库的写权限但对自己账户下的这份副本拥有完全控制权后续所有改动都在自己的副本上完成再通过 Pull Request 把改动交还给上游。第二步Clone 到本地Fork 完成的是云端复制Clone 则是把代码拉到你的电脑上。操作流程如下进入你自己的 GitHub 账户打开刚才 Fork 出来的仓库点击Clone or download英文版 README 中为Code按钮按钮复制仓库地址点击复制按钮旁的copy to clipboard图标或直接按CtrlC打开终端切换到你想存放代码的目录执行git clone url naslov, ki si ga ravno skopiral把引号内的内容替换为你刚从 GitHub 复制的地址即你自己那份 Fork 的地址而非上游仓库地址。例如如果你的 GitHub 用户名是this-is-yougit clone https://github.com/this-is-you/first-contributions.git执行后GitHub 上first-contributions仓库的全部内容就被复制到了你的电脑上。第三步创建分支分支是 Git 协作的基石——它让你可以在不干扰主干默认分支的情况下独立开发新特性。首先进入仓库目录cd first-contributions然后用git checkout创建并切换到新分支git checkout -b add-your-new-branch-name分支名并不强制以add开头但在这个练习中用它很合理——因为这条分支的目的就是把自己的名字添加进名单。例如git checkout -b add-janez-novak这里需要说明一个版本差异英文原版 README.md 目前推荐使用更新式的git switch -c your-new-branch-name命令并特别说明如果遇到switch is not a git command的报错说明本机 Git 版本较旧此时退回git checkout -b your-new-branch-name即可。两条命令在创建并切换分支的语义上等价只是checkout兼容更老的 Git 版本。第四步修改文件并提交进入核心练习环节。用文本编辑器打开仓库根目录的 Contributors.md 文件把你的名字加进去——注意不要加在文件开头或结尾而是加在中间任意位置然后保存。这一看似随意的规定实则训练你学会与他人协作时避免无谓冲突、融入集体改动的协作习惯。提交改动共分三步1. 查看状态。在项目目录执行git status会看到Contributors.md已被标记为有改动——这正是练习验证修改已被 Git 感知的直观方式。2. 暂存改动把文件加入刚创建的分支git add Contributors.md3. 提交改动git commit -m Add your-name to Contributors list将your-name替换为你的名字引号内是随改动一起保存的提交说明commit message。Git 社区对提交信息有明确的规范期待一句话说清楚做了什么是最基本的门槛。仓库中的 Contributors.md 本身就是这套流程被反复实践的最好佐证这份名单目前已有数千行、近六千条贡献者记录每一条都对应一位初学者通过本文所述流程完成的一次真实提交。你加入的那一行将和其他名字一起构成这个项目最独特的贡献者纪念碑。第五步推送到 GitHub本地提交完成还不够需要把改动推送到 GitHub 上你自己的 Fork 中git push origin add-your-branch-name将add-your-branch-name替换为第三步创建的分支名。origin是 Git 对你本地仓库所关联的远程仓库即你的 Fork的默认命名。英文原版 README.md 中推荐写成git push -u origin your-branch-name其中的-u--set-upstream会建立本地分支与远程分支的跟踪关系此后在该分支上直接执行git push即可无需再指定远程与分支名。英文原版还针对推送失败给出了排查指引如果遇到Support for password authentication was removed的认证错误说明当前使用 HTTPS 地址配合密码认证的方式已被 GitHub 淘汰应改用 SSH 密钥认证此时可以先运行git remote -v检查远程地址若显示的是https://github.com/your-username/your_repo.git则用如下命令切换为 SSH 地址git remote set-url origin gitgithub.com:your-username/your_repo.git第六步提交 Pull Request 等待合并推送成功后回到 GitHub 查看你自己的仓库页面会看到一个醒目的Compare pull request按钮。点击它然后提交Submit这个 Pull Request。至此你的改动正式进入上游维护者的审核队列对方合并后你会收到一封邮件通知告知改动已被合并进项目主干。Pull Request 是开源协作的提议-审核-合并机制你无权直接改动上游仓库但可以通过 PR 提交改动建议由维护者审核把关后合入。这也是为什么必须先在 GitHub 上 Fork 一份副本——所有协作动作都围绕只读上游 可写副本 PR 回交这个三角结构展开。完成后的下一步进阶 Git 主题与 Fork 同步恭喜你已经走完fork → clone → edit → pull request这一整套标准流程——它正是日后参与任何开源项目时反复遇到的协作模式。持续精进的方向包括官方 Web 应用维护着一个适合新手起步的项目清单收录了带有简单 issue问题的开源项目可以作为你下一次贡献的目标。在深入进阶之前建议先阅读仓库内的 斯洛文尼亚语附加资料索引英文版见 additional-material.md它按场景整理了以下实用主题主题适用场景文档修改已提交的内容amend需要修改远程仓库中已有的提交amending-a-commit.sl.md配置 Git 环境想更精细地控制 Git 配置configuring-git.sl.md与上游仓库保持同步Fork 落后于上游、需要拉取最新改动keeping-your-fork-synced-with-this-repository.sl.md把提交移到另一个分支提交位置放错了分支moving-a-commit-to-a-different-branch.sl.md删除文件从本地仓库移除文件removing-a-file.sl.md删除分支PR 合并后清理分支removing-branch-from-your-repository.sl.md解决合并冲突处理 merge conflictresolving-merge-conflicts.sl.md回滚已推送的提交revert撤销已推到 GitHub 的提交reverting-a-commit.sl.md压缩提交squash维护者要求把多个提交合并成一个squashing-commits.sl.md撤销本地提交本地仓库改乱了想恢复原状undoing-a-commit.sl.md更多学习链接博客、技巧站点等延伸资料Useful-links-for-further-learning.md进阶必学Triangle Workflow三角工作流参与多人开源项目后让 Fork 跟上上游会是你最常做的操作。仓库内 keeping-your-fork-synced-with-this-repository.sl.md 详细讲解了这套被命名为Triangle Workflow的同步机制整个体系涉及三个仓库——上游公共仓库upstream、你 GitHub 上的 Forkorigin、你本地的克隆。由于 Pull Request 只能从你的 GitHub Fork 发起因此保持本地 → Fork → upstream三级同步的节奏是# 1. 确保在主分支上可用 git status 查看当前分支 git checkout master # 2. 把上游仓库注册为名为 upstream 的远程 git remote add upstream https://github.com/Roshanjossey/first-contributions # 3. 拉取上游最新改动 git fetch upstream # 4. 把上游主分支合入本地主分支 git rebase upstream/master # 5. 把更新后的本地主分支推送到你的 Fork git push origin master完成这五步后本地仓库与你的 GitHub Fork 都同步到了上游最新状态。今后每当 GitHub 提示 Fork 落后于上游时重复上述流程即可。不习惯命令行图形化工具教程一览指南特别照顾了不熟悉命令行的读者提供了完整的图形界面工具GUI教程清单见 docs/translations/README.sl.md 末尾的Vodiči za uporabo drugih orodij一节覆盖主流平台与 IDE工具教程GitHub Desktopgithub-desktop-tutorial.mdVisual Studio 2017github-windows-vs2017-tutorial.mdGitKrakengitkraken-tutorial.mdVisual Studio Codegithub-windows-vs-code-tutorial.mdAtlassian Sourcetreesourcetree-macos-tutorial.mdIntelliJ IDEAgithub-windows-intellij-tutorial.md附核心命令速查表把本文涉及的命令汇总如下方便练习时对照# Fork 后克隆自己的副本 git clone https://github.com/your-username/first-contributions.git # 进入仓库并创建特性分支 cd first-contributions git checkout -b add-your-name # 新版 Git 可用 git switch -c add-your-name # 修改 Contributors.md 后暂存并提交 git add Contributors.md git commit -m Add your-name to Contributors list # 推送到远程 Fork git push origin add-your-name # 推荐 git push -u origin add-your-name # 进阶让 Fork 与上游保持同步 git remote add upstream upstream-url git fetch upstream git rebase upstream/master git push origin master一次贡献六步走完Fork 建副本、Clone 拉代码、Branch 开分支、Commit 留痕迹、Push 传远程、PR 交审核。这套流程就是开源世界的入门仪式也是你后续参与任何项目的起点。赞分享文档教程开源治理【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址https://gitcode.com/gh_mirrors/fi/first-contributions点击查看免费下载相关推荐first-contributions 首次贡献实战指南从 Fork 到 Pull Request 走通开源协作全流程first contributions 首次贡献实战指南从 Fork 到 Pull Request 走通开源协作全流程 本指南以 docs/translati文档教程开源治理first-contributions 新手开源贡献指南从 Fork 到 Pull Request 的完整实战流程first contributions 新手开源贡献指南从 Fork 到 Pull Request 的完整实战流程 本指南基于开源仓库 first contr文档教程开源治理first-contributions 实战指南从 Fork 到 Pull Request 的首次开源贡献完整流程first contributions 实战指南从 Fork 到 Pull Request 的首次开源贡献完整流程 本指南以开源仓库 first contri文档教程开源治理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考