phphook标注技巧_GitGitHub 中文术语表 Linux 中国

文章目录 [+]

我们根据 GitHub 等文档，网络整理了部分常用的 Git 和 GitHub 中的术语的中定亲名及其阐明。

作者：硬核老王

Git 和 GitHub 已经成为了开拓者的根本工具，尤其是参与开源软件开拓时常常会利用它们。
但是在 Git 和 GitHub 利用过程中碰着的很多术语并没有标准的或约定俗成的中文译名，因此，我们根据 GitHub 、 Git 等文档，并结合我们的翻译老例，网络整理了 Git 和 GitHub 中常用术语的中文译名及其阐明。

phphook标注技巧_GitGitHub 中文术语表 Linux 中国

这里值得把稳是术语有复刻、挂钩、议题、星标、变基、仓库等，这些术语之前要么常常中英文殽杂利用，要么中文译法不愿定，我们根据多年的翻译和开拓履历，在 GitHub 译法的根本上进行推敲，整理了如下的术语表供大家利用参考。
此外，“复刻”这个翻译该当是我们 LCTT 首倡的；而“议题”这个对 issue 的译法也比之前的一些其它译法更为精准；“仓库”一词还有存储库、版本库等译法，但是仓库一词彷佛更加得当。

（图片来自网络侵删）

受让人(assignee)

分配到某个议题的用户。

追溯(blame)

Git 中的“追溯”功能描述对文件每行的最新修正，一样平常会显示修订、作者和韶光。
这很有用，例如，可以跟踪何时添加了功能，或者哪个提交导致了特定漏洞。

分支(branch)

分支是仓库的平行版本。
它包含在仓库中，但不影响紧张或 master 分支，可让你自由事情而不中断“即时”版本。
在实行所需的变动后，可以将分支合并回 master 分支以发布变动。

检出(checkout)

你可以在命令行上利用 git checkout 创建新分支，将当前的事情分支变动为不同的分支，乃至利用 git checkout [branchname] [path to file]从不同的分支切换到不同版本的文件。
“检出”操作会利用工具数据库中的树工具或 blob 更新事情树的全部或部分，以及更新索引和 HEAD（如果全体事情树指向新分支）。

优选(cherry-picking)

从一系列变动（常日是提交）中选择一部分变动，并在不同的代码库年夜将它们记录为新的变动系列。
在 Git 中，这通过 git cherry-pick 命令来实行，在另一个分支上解压缩现有提交引入的变动，并根据当前分支的提示将其记录为新提交。

清洁(clean)

事情树在对应该前头部引用的版本时是清洁的。
另请参阅“脏”。

克隆(clone)

克隆是指存在于打算机上而非网站做事器其他位置的仓库副本，或者是复制的操作。
在克隆时，可在首选编辑器中编辑文件，利用 Git 跟踪变动而无需保持在线。
你克隆的仓库仍与远程版本连接，以便当你在线时将本地变动推送到远程，以保持同步。

行为准则(code of conduct)

为如何参与社区制订标准的文档。

代码所有者(code owner)

被指定为部分仓库代码所有者的个人。
当有人打开对代码所有者拥有的代码进行变动的拉取要求（非草稿模式）时，会自动申请代码所有者审查。

协作者(collaborator)

协作者是受仓库所有者约请参与，对仓库拥有读取和写入权限的人。

提交(commit)

提交或“修订”是对一个文件（或一组文件）的个别变动。
在进行提交以保存事情时，Git 会创建唯一的 ID（也称为 "SHA" 或“哈希”），用于记录提交的特定变动以及提交者和提交韶光。
提交常日包含一条提交，个中简要解释所做的变动。

提交作者(commit author)

进行提交的用户。

提交 ID(commit ID)

也称为 SHA。
用于识别提交的 40 字符校验和的哈希。

提交(commit message)

随附于提交的简短描述性笔墨，用于沟通提交引入的变动。

持续集成(continuous integration)

也称为 CI。
在个人对 GitHub 上配置的仓库提交变动后运行自动化构建和测试的过程。
CI 是软件开拓中一种帮助检测缺点的常用最佳实践。

贡献指南(contribution guidelines)

解释人们应如何参与项目的文档。

贡献(contributions)

GitHub 上的特定活动。

贡献者(contributor)

贡献者是指对仓库没有协作者权限但参与过项目，并且他们打开的拉取要求已合并到仓库的职员。

默认分支(default branch)

仓库中的基本分支，除非你指定不同的分支，否则会自动对它完成所有拉取要乞降代码提交。
此分支常日称为 master。

游离的 HEAD (detached HEAD)

如果你操作的是游离的 HEAD，Git 将会警告你，这意味着 Git 不指向某个分支，并且你的任何提交都不会涌如今提交历史记录中。
例如，在检出并非任何特定分支最新提交的任意提交时，你操作的是“游离的 HEAD”。

差异(diff)

差异是指两个提交之间的变动或保存的变动之间的差异，它将从视觉上描述文件自上次提交后添加或删除的内容。

脏(dirty)

事情树如果包含尚未提交到当前分支的变动，将被视为“脏”。

快进(fast-forward)

快进是一种分外类型的合并，在个中你有修订以及“合并”另一个分支的变动作为现有分支的子系。
在这种情形下，你无法进行新的合并提交，而只是更新此修订。
这在远程仓库的远程跟踪分支中常常发生。

功能分支(feature branch)

用于试验新功能或修复未正式利用的议题的分支。
也称为主题分支。

围栏代码块(fenced code block)

你可以在代码块前后利用三个反引号 ```，通过 GitHub Flavored Markdown 创建缩进代码块。

获取(fetch)

在利用 git fetch 时，你将从远程仓库添加变动到本地事情分支，而不提交它们。
与 git pull 不同，提取可让你在变动提交到本地分支之前前辈行审查。

跟进（用户）(following (users))

获取关于另一个用户的贡献和活动的关照。

逼迫推送(force push)

一种利用本地变动覆盖远程仓库的 Git 推送，不管是否冲突。

复刻(fork)

复刻是其他用户仓库在你的帐户上的个人副本。
复刻许可你自由变动项目而不影响原始上游仓库。
你也可以在上游仓库中打开拉取要求，并使复刻同步最新的变动，由于两个仓库仍旧相互连接。

gitfile

一种普通的 .git 文件，始终位于事情树的根部，指向 Git 目录，包含全体 Git 仓库及其元数据。
你可以在命令行上利用 git rev-parse --git-dir 查看仓库（实际仓库）的此文件。

HEAD

当前分支。

挂钩(hook)

在多个 Git 命令正常实行时，对可选脚本进行标注以许可开拓者添加功能或检讨。
常日，挂钩许可预先验证和潜在中止命令，并且许可在操作完成后再发事后关照。

实例(instance)

组织包含在其配置和掌握的虚拟机中的 GitHub 私有副本。

议题(issue)

议题是发起的与仓库干系的改进、任务或问题。
（对付公共仓库）任何人都可创建议题，然后由仓库协作者调度。
每个议题都包含自己的谈论线程。
你也可以利用标签将议题归类并分配到某人。

密钥指纹(key fingerprint)

用于识别较长公钥的简短字节系列。

关键词(keyword)

用在拉取要求中时关闭议题的特定笔墨。

标签(label)

议题或拉取要求的标记。
仓库随附一系列默认标签，但用户也可创建自定义标签。

LFS

Git Large File Storage。
一种开源 Git 扩展，用于对大文件进行版本掌握。

容许证(license)

一种可随附于项目的文档，奉告们能够对你的源代码实行哪些操作，不能实行哪些操作。

行注释(line comment)

拉取要求内特定代码行上的评论。

主干(master)

默认开拓分支。
只要创建 Git 仓库，就会创建一个名为 master 的分支，并且它会变为活动的分支。
大多数情形下，这包含本地开拓，但纯属老例，而非必需。

提及(mention)

一种通过在用户名前加上 @ 符号来发送给用户的关照。
GitHub 上组织中的用户也可成为可提及的团队一部分。

合并(merge)

合并是从一个分支（在相同的仓库中或来自一个分叉）提取变动，然后将其运用到另一个分支。
这常日是作为“拉取要求”（可视为要求合并）或通过命令行完成。
如果没有冲突的变动，可通过 GitHub.com web 界面利用拉取要求完成合并，或始终通过命令行完成。

合并冲突(merge conflict)

合并的分支之间发生的差异。
当人们对同一文件的同一行进行不同的变动时，或者一个人编辑某文件而另一个人删除该文件时，就会发生合并冲突。
必须办理合并冲突后才可合并分支。

合并要求(merge request)

合并要求（MR）是 GitLab 上类似于 GitHub 上的拉取要求的观点。

里程碑(milestone)

一种跟踪仓库中议题或拉取要求组进度的办法。

镜像(mirror)

仓库的新副本。

非快进(non-fast-forward)

当仓库确当地副本未与上游仓库同步时，你在推送本地变动之前须要提取上游变动。

关照(notification)

web 或电子邮件（根据你的设置）传送的更新，供应你感兴趣的活动的干系信息。

外部协作者(outside collaborator)

已被付与访问一个或多个组织的仓库但对组织没有其他访问权限的用户，且不属于组织的成员。

开源(open source)

开源软件是可供任何人自由利用、修正和共享（以修正和未修正的形式）的软件。
本日，“开源”的观点常日扩展到软件以外，代表一种协作原则，个中事情材料在线供任何人分叉、修正、谈论和参与。

源(origin)

默认上游仓库。
大多数项目至少有一个它们跟踪的上游项目。
默认情形下，源用于该目的。

所有者(owner)

对组织有完备管理权限的组织成员。

私有贡献(private contributions)

对私有（与公共相对）仓库的贡献。

私有仓库(private repository)

私有仓库仅对仓库所有者和所有者指定的协作者可见。

生产分支(production branch)

包含可利用或支配到运用程序或站点的终极变动的分支。

个人资料(profile)

显示 GitHub 上用户活动干系信息的页面。

受保护分支(protected branch)

受保护分支在仓库管理员选择保护的分支上禁止多项 Git 功能。
必要检讨未通过或必需审查未批准，不能对它们实行逼迫推送、删除和变动合并，或者不能从 GitHub web 界面上传文件到个中。
受保护分支常日是默认分支。

公共贡献(public contributions)

对公共（与私有相对）仓库的贡献。

公共仓库(public repository)

公共仓库可供任何人查看，包括不是 GitHub 用户的职员。

拉取(pull)

拉取是指提取与合并变动。
例如，如果有人编辑了你操作的远程文件，你要将这些变动拉取到本地副本，以使其保持最新。
另请参阅“提取”。

拉取权限(pull access)

读取权限的同义词。

拉取要求(pull request)

拉取要求（PR）是发起变动用户提交的仓库，然后被仓库协作者接管或谢绝。
像议题一样，每个拉取要求都有自己的论坛。

拉取要求审查(pull request review)

拉取要求中协作者批准变动或在拉取要求合并之前申请进一步变动的评论。

推送(push)

推送是指将提交的变动发送到 GitHub.com 上的远程仓库。
例如，如果你在本地变动内容，便可推送这些变动，让其他人访问。

推送分支(push a branch)

成功将分支推送到远程仓库后，利用本地分支中的变动来更新远程分支。
在你“推送分支”时，Git 将会到远程仓库中搜索分支的头部引用，并验证它是分支本地头部引用的嫡系原型。
在验证后，Git 将拉取所有工具（从本地头部引用可获取，而远程仓库中缺失落）到远程工具数据库，然后更新远程头部引用。
如果远程头部不是本地头部的原型，推送将会失落败。

推送权限(push access)

写入权限的同义词。

读取权限(read access)

对仓库的权限级别，许可用户拉取或者读取仓库中的信息。
所有公共仓库向所有 GitHub 用户付与读取权限。
拉取权限的同义词。

自述文件(README)

包含仓库中文件干系信息的文本文件，常日是仓库访问者看到的第一个文件。
自述文件连同仓库容许证、参与指南以及行为准则，帮助你互换哀求和管理项目的参与。

变基(rebase)

将一系列变动从一个分支重新运用到不同的基本分支，并将该分支的头部重置为结果。

发布(release)

GitHub 封装软件并向用户供应软件的办法。

远程(remote)

这是托管于做事器（很可能是 GitHub.com）上的仓库或分支版本。
远程版本可以连接到本地克隆，以使变动保持同步。