Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenDocCN
succinctly-zh
提交
7e3ee686
S
succinctly-zh
项目概览
OpenDocCN
/
succinctly-zh
10 个月 前同步成功
通知
0
Star
1
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
S
succinctly-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
前往新版Gitcode,体验更适合开发者的 AI 搜索 >>
提交
7e3ee686
编写于
1月 08, 2022
作者:
W
wizardforcel
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
2022-01-08 19:07:30
上级
b158a469
变更
15
显示空白变更内容
内联
并排
Showing
15 changed file
with
62 addition
and
32 deletion
+62
-32
trans/github/01.md
trans/github/01.md
+2
-0
trans/github/02.md
trans/github/02.md
+2
-0
trans/github/03.md
trans/github/03.md
+2
-0
trans/github/04.md
trans/github/04.md
+2
-0
trans/github/05.md
trans/github/05.md
+2
-0
trans/github/06.md
trans/github/06.md
+2
-0
trans/github/07.md
trans/github/07.md
+2
-0
trans/github/08.md
trans/github/08.md
+34
-32
trans/github/09.md
trans/github/09.md
+2
-0
trans/github/10.md
trans/github/10.md
+2
-0
trans/github/11.md
trans/github/11.md
+2
-0
trans/github/12.md
trans/github/12.md
+2
-0
trans/github/13.md
trans/github/13.md
+2
-0
trans/github/14.md
trans/github/14.md
+2
-0
trans/github/15.md
trans/github/15.md
+2
-0
未找到文件。
trans/github/01.md
浏览文件 @
7e3ee686
# 一、Git 概览——一种信仰
虽然这本书侧重于 GitHub,但 Git 中的一些基本概念和术语将有助于您在学习 GitHub 时理解。
工作目录是计算机或网络共享上的一个文件夹。每个开发人员都有所有代码和相关文件的完整副本。您可以在工作目录中完成所有开发工作,并让 Git 管理该文件夹的版本控制方面。
...
...
trans/github/02.md
浏览文件 @
7e3ee686
# 二、起步
开始使用 GitHub 的最好方法是打开你的浏览器,直接跳进去。打开自己喜欢的浏览器,进入
[
https://github.com/
](
https://github.com/
)
打开 GitHub 主页面。您将看到类似于以下内容的屏幕:
![](
img/00005.jpeg
)
...
...
trans/github/03.md
浏览文件 @
7e3ee686
# 三、安装 Git
为了将您自己的项目添加到 GitHub,您需要在您的计算机上创建一个本地存储库(只是一个文件夹)。然后,您将使用 Git 软件将该文件夹的内容复制到 GitHub 服务器。虽然这本书侧重于 GitHub,但是对 Git 的一些简单理解对于使用 GitHub 存储库是必要的。
| !
[](
img/00007.jpeg
)
| 提示:如果你有兴趣了解更多关于 Git 的知识,一定要下载 Ryan Hodson 的电子书《Git 简洁》。 |
...
...
trans/github/04.md
浏览文件 @
7e3ee686
# 四、搜索 Github
搜索 GitHub 非常简单;很像谷歌搜索,你只需在屏幕顶部的搜索栏中键入你想要的内容。
![](
img/00021.gif
)
...
...
trans/github/05.md
浏览文件 @
7e3ee686
# 五、高级搜索
GitHub 的搜索引擎隐藏了搜索中的高级选项,但在搜索字符串中使用不同的结构提供了许多附加功能。您可以通过单击语言列表下方的高级搜索链接来浏览高级选项。
“高级选项”部分允许您查找特定用户和公司拥有的存储库,甚至将搜索限制在特定的存储库。您还可以按日期范围进行搜索,或将结果筛选为特定的编程语言。
...
...
trans/github/06.md
浏览文件 @
7e3ee686
# 六、其它搜索
虽然到目前为止,我们一直专注于存储库搜索,但是您也可以在 GitHub 中搜索其他信息。当 GitHub 搜索时,它也同时搜索代码、库和用户。当我用 C#语言搜索 Excel 时,我发现超过 1100 个存储库和超过 150000 行包含“Excel”一词的代码此外,还有超过 14,000 个问题(错误报告、增强请求等)。)和 9 个用户名中带有“Excel”的用户。
![](
img/00028.jpeg
)
...
...
trans/github/07.md
浏览文件 @
7e3ee686
# 七、浏览 Github
虽然搜索是 GitHub 的一个强大功能,但您也可以探索许多有趣的项目,并看到最新的趋势。在您的帐户图标下,下拉菜单并选择
**浏览**
。您将看到类似于以下内容的屏幕:
![](
img/00033.jpeg
)
...
...
trans/github/08.md
浏览文件 @
7e3ee686
问题是 GitHub 的协作部分,人们在这里交流项目活动。虽然 Git 和 GitHub 是强大的版本控制工具,但是通过问题和拉取请求提供的协作支持鼓励人们一起工作来产生伟大的软件项目。
# 八、工单的详细信息
在项目详细信息页面,您可以点击
**问题**
选项卡,并点击
**新问题**
按钮。
工单是 GitHub 的协作部分,人们在这里交流项目活动。虽然 Git 和 GitHub 是强大的版本控制工具,但是通过工单和拉取请求提供的协作支持鼓励人们一起工作来产生伟大的软件项目。
在项目详细信息页面,您可以点击
**工单**
选项卡,并点击
**新工单**
按钮。
![](
img/00038.jpeg
)
图 34:
问题
选项卡
图 34:
工单
选项卡
当您单击“新建
问题”按钮时,将出现以下屏幕,让您输入问题
详细信息。您可以使用标记语法(参见附录 1)来设置文本的样式。
当您单击“新建
工单”按钮时,将出现以下屏幕,让您输入工单
详细信息。您可以使用标记语法(参见附录 1)来设置文本的样式。
![](
img/00039.jpeg
)
图 35:写一个
问题
图 35:写一个
工单
您可以在正文中同时使用 Markdown 和
[
表情符号
](
http://www.emoji-cheat-sheet.com/
)
来格式化
问题描述。“预览”选项卡向您显示问题
的样子。
您可以在正文中同时使用 Markdown 和
[
表情符号
](
http://www.emoji-cheat-sheet.com/
)
来格式化
工单描述。“预览”选项卡向您显示工单
的样子。
![](
img/00040.jpeg
)
图 36:
问题
预览
图 36:
工单
预览
您还可以将文件附加到
问题上,以帮助存储库作者清楚地理解问题。任何查看存储库的人现在都会收到一封包含问题
内容的电子邮件。
您还可以将文件附加到
工单上,以帮助存储库作者清楚地理解工单。任何查看存储库的人现在都会收到一封包含工单
内容的电子邮件。
| !
[](
img/00007.jpeg
)
| 提示:请记住 GitHub 是国际性的——一定要尽可能清楚地表达你的
问题,因为来自世界各地的人可能正在审查这个问题
。 |
| !
[](
img/00007.jpeg
)
| 提示:请记住 GitHub 是国际性的——一定要尽可能清楚地表达你的
工单,因为来自世界各地的人可能正在审查这个工单
。 |
除了标记之外,您还可以使用@userName 语法来引用 GitHub 用户,使用#Issue 语法来引用另一个
问题或拉请求。这允许问题被交叉引用并与其他用户和问题
链接。
除了标记之外,您还可以使用@userName 语法来引用 GitHub 用户,使用#Issue 语法来引用另一个
工单或拉请求。这允许工单被交叉引用并与其他用户和工单
链接。
当您键入
问题时,GitHub 会识别@、#、和:字符,并搜索匹配项以使其更容易。例如,键入#会在存储库中调出其他问题
的列表:
当您键入
工单时,GitHub 会识别@、#、和:字符,并搜索匹配项以使其更容易。例如,键入#会在存储库中调出其他工单
的列表:
![](
img/00041.jpeg
)
图 37:编辑窗口中的
问题
列表
图 37:编辑窗口中的
工单
列表
:(冒号)将显示一个支持表情符号的列表,而@符号将显示一个与存储库和
问题
相关的用户列表。
:(冒号)将显示一个支持表情符号的列表,而@符号将显示一个与存储库和
工单
相关的用户列表。
当存储库所有者看到
问题时,他们将能够开始处理该问题。这允许他们对问题进行分类,将其分配给某个人,将其标记为已关闭,并对问题
进行评论。
当存储库所有者看到
工单时,他们将能够开始处理该工单。这允许他们对工单进行分类,将其分配给某个人,将其标记为已关闭,并对工单
进行评论。
![](
img/00042.jpeg
)
图 38:所有者视图
通常,审查
问题
的人会首先给它分配一个标签,例如 bug 或增强。
通常,审查
工单
的人会首先给它分配一个标签,例如 bug 或增强。
![](
img/00043.jpeg
)
图 39:标记
问题
图 39:标记
工单
图 39 中显示的七个项目是 GitHub 提供的默认标签。点击
**标签**
按钮,可以从
问题
列表中添加新标签。
图 39 中显示的七个项目是 GitHub 提供的默认标签。点击
**标签**
按钮,可以从
工单
列表中添加新标签。
![](
img/00044.jpeg
)
图 40:
问题
列表
图 40:
工单
列表
这将显示一个屏幕,允许您编辑标签,删除您不想要的标签,并添加任何新标签。当您添加新标签时,GitHub 会询问标签名称,并有一个颜色选择器让您选择用于此
问题
的颜色。
这将显示一个屏幕,允许您编辑标签,删除您不想要的标签,并添加任何新标签。当您添加新标签时,GitHub 会询问标签名称,并有一个颜色选择器让您选择用于此
工单
的颜色。
![](
img/00045.jpeg
)
图 41:新
问题
图 41:新
工单
添加新标签后,您可以将该标签用于所有新
问题和现有问题
。
添加新标签后,您可以将该标签用于所有新
工单和现有工单
。
如果您有许多
问题
,您可能希望将它们分组为里程碑。里程碑可以是您想要的任何东西,例如:
如果您有许多
工单
,您可能希望将它们分组为里程碑。里程碑可以是您想要的任何东西,例如:
*
冲刺——未来两周要解决的
问题
*
冲刺——未来两周要解决的
工单
*
测试版–为下一个主要版本而努力
*
特定客户–特定客户的
问题
*
特定客户–特定客户的
工单
您可以像创建标签一样创建里程碑。里程碑还将允许您选择一个到期日来帮助跟踪。
...
...
@@ -70,7 +72,7 @@
图 42:里程碑屏幕
“受理人”按钮允许您指定一个人来处理此
问题
。它应该是所有者或任何合作者。当您(所有者)查看存储库时,可以从“设置”菜单添加合作者。
“受理人”按钮允许您指定一个人来处理此
工单
。它应该是所有者或任何合作者。当您(所有者)查看存储库时,可以从“设置”菜单添加合作者。
![](
img/00047.jpeg
)
...
...
@@ -78,15 +80,15 @@
合作者可以分配任务给他们。您可以查看协作者列表,并通过查找用户名、电子邮件地址或全名来添加新的协作者。您可以使用 X 按钮从项目中移除合作者。合作者也可以对你的项目进行推送。
当您处理
问题时,添加标签、受托人等。,GitHub 将显示问题
列表中的所有信息
当您处理
工单时,添加标签、受托人等。,GitHub 将显示工单
列表中的所有信息
![](
img/00048.jpeg
)
图 44:
问题
列表
图 44:
工单
列表
您可以使用顶部的各种选项(作者、标签、里程碑和受理人)来过滤
问题列表。您也可以使用搜索时使用的相同选项对列表进行排序。GitHub 使跟踪问题
变得既简单又强大。
您可以使用顶部的各种选项(作者、标签、里程碑和受理人)来过滤
工单列表。您也可以使用搜索时使用的相同选项对列表进行排序。GitHub 使跟踪工单
变得既简单又强大。
当您向存储库提交时,您可以通过提交消息关闭
问题。GitHub 认为以下单词表示问题正在解决。您应该在关键字后加上#问题
编号。
当您向存储库提交时,您可以通过提交消息关闭
工单。GitHub 认为以下单词表示工单正在解决。您应该在关键字后加上#工单
编号。
*
关闭
*
关
...
...
@@ -98,10 +100,10 @@
*
解决
*
断然的
当 GitHub 看到提交消息中的模式时,它将自动关闭该
问题。您也可以在一条提交消息中关闭多个问题。例如,以下提交消息将自动关闭问题
#2。
当 GitHub 看到提交消息中的模式时,它将自动关闭该
工单。您也可以在一条提交消息中关闭多个工单。例如,以下提交消息将自动关闭工单
#2。
![](
img/00049.gif
)
图 45:在提交消息中关闭一个
问题
图 45:在提交消息中关闭一个
工单
GitHub 的问题跟踪和协作特性使其作为跟踪开发进度和工作的工具非常有用。这是一个简单而强大的学习系统,对于多人、多里程碑的项目管理非常有用。
\ No newline at end of file
GitHub 的工单跟踪和协作特性使其作为跟踪开发进度和工作的工具非常有用。这是一个简单而强大的学习系统,对于多人、多里程碑的项目管理非常有用。
\ No newline at end of file
trans/github/09.md
浏览文件 @
7e3ee686
# 九、查看项目
当显示搜索结果时,存储库列表中包含了大量信息。这些信息可以让你了解这个项目有多受欢迎,工作有多积极。
以下示例来自对使用 HTML 画布的 JavaScript 代码的搜索。three.js 是一个 JavaScript 库,可以让你在 HTML 5 Canvas 上做 3D 绘图和动画。它被设计成使用简单,但却是一个非常强大的三维工作库。
...
...
trans/github/10.md
浏览文件 @
7e3ee686
# 十、获取代码
您已经搜索了 GitHub,查看了所有结果,并找到了一个应该有所帮助的存储库。下一步是下载代码。如果您只是计划使用代码,而没有协作和贡献来使代码变得更好,您可以将代码下载到您的本地机器上。
抓取整个存储库最简单的方法就是点击菜单栏上的
**下载 ZIP**
按钮。使用这种方法,您将只下载源文件和其他文件(没有存储库历史或详细信息)。
...
...
trans/github/11.md
浏览文件 @
7e3ee686
# 十一、合作
在前面的章节中,我们重点讨论了搜索 GitHub 和下载项目文件。在接下来的几章中,我们将关注协作、如何创建分叉以及如何处理拉请求。
在本书的早期,我们创建了一些处理日期的 SQL 代码的存储库。其中一个脚本(假期列表)将创建给定年份的假期列表。法国程序员吉纳维芙喜欢这个剧本,但她想在法国度假时修改它,而不仅仅是美国度假。她决定提交一个问题,建议不同国家的人去度假,而不是简单地下载脚本并修改它供自己使用。
...
...
trans/github/12.md
浏览文件 @
7e3ee686
# 十二、拉取请求
在协作过程中的某个时候,一个贡献者可能已经很好地完成并测试了代码,她觉得代码可以添加到主分支中。吉纳维芙决定通过点击
**拉取请求**
按钮来创建拉取请求。
![](
img/00087.jpeg
)
...
...
trans/github/13.md
浏览文件 @
7e3ee686
# 十三、总结
Git 是一个强大的分布式版本控制工具,GitHub 是一个在网络上存储您的存储库的好方法。凭借其版本控制能力,它可以成为任何程序员或开发人员处理需要跟踪更改的文件的便捷工具。然而,GitHub 真正的魅力在于它的问题跟踪和协作工具,以支持开源软件的精神。
您可以简单地将 GitHub 作为一个庞大的代码库来帮助您的开发工作,或者您也可以通过参与和协作那些让您感兴趣的项目来成为开源社区的活跃成员。
...
...
trans/github/14.md
浏览文件 @
7e3ee686
# 十四、附录 1:Github Markdown
大多数输入 GitHub 的文本都可以利用标记语法来格式化文本。标记文本比同等的 HTML 更容易阅读和编写,但是可以在 GitHub 网站中显示为格式良好的 HTML。
任何输入到标记窗口的文本都被视为一个段落。每一个空行开始一个新的段落。只需输入即可写出全部内容,GitHub 内的 Markdown 引擎会在显示 HTML 结果时决定在哪里添加
...
...
trans/github/15.md
浏览文件 @
7e3ee686
# 十五、附录 2:Emoji
除了使用 Markdown,您还可以在 GitHub 文本框中添加表情符号。表情符号是在文档正文中显示的迷你图片,而不是文本。表情符号名称由冒号分隔。如果您在文本窗口中键入一个冒号,GitHub 将显示可用的表情符号,以冒号后的字母开头:
![](
img/00092.jpeg
)
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录