diff --git a/trans/github/01.md b/trans/github/01.md index 6f9e907d6b772dcef03f6f779d1043c8e834104c..4c077f04135d909c27d67caa3bfe14023d8ee487 100644 --- a/trans/github/01.md +++ b/trans/github/01.md @@ -1,3 +1,5 @@ +# 一、Git 概览——一种信仰 + 虽然这本书侧重于 GitHub，但 Git 中的一些基本概念和术语将有助于您在学习 GitHub 时理解。 工作目录是计算机或网络共享上的一个文件夹。每个开发人员都有所有代码和相关文件的完整副本。您可以在工作目录中完成所有开发工作，并让 Git 管理该文件夹的版本控制方面。 diff --git a/trans/github/02.md b/trans/github/02.md index a9fe1b8aed856e497e5df9b7104ec69230fcbedf..5af8ac3a53b95a20810f8079ff817441d39a0a05 100644 --- a/trans/github/02.md +++ b/trans/github/02.md @@ -1,3 +1,5 @@ +# 二、起步 + 开始使用 GitHub 的最好方法是打开你的浏览器，直接跳进去。打开自己喜欢的浏览器，进入[https://github.com/](https://github.com/)打开 GitHub 主页面。您将看到类似于以下内容的屏幕: ![](img/00005.jpeg) diff --git a/trans/github/03.md b/trans/github/03.md index 16ebd43b4ea3490acc139493acf228e8578d5fcc..6f3ac720647819d041e5361784daeb041c4a64a3 100644 --- a/trans/github/03.md +++ b/trans/github/03.md @@ -1,3 +1,5 @@ +# 三、安装 Git + 为了将您自己的项目添加到 GitHub，您需要在您的计算机上创建一个本地存储库(只是一个文件夹)。然后，您将使用 Git 软件将该文件夹的内容复制到 GitHub 服务器。虽然这本书侧重于 GitHub，但是对 Git 的一些简单理解对于使用 GitHub 存储库是必要的。 | ![](img/00007.jpeg) | 提示:如果你有兴趣了解更多关于 Git 的知识，一定要下载 Ryan Hodson 的电子书《Git 简洁》。 | diff --git a/trans/github/04.md b/trans/github/04.md index a0acd343a7184916003fd9fee45073db7008e6a6..2ffb4a8ccdae8299a8099831b1385af1e338518d 100644 --- a/trans/github/04.md +++ b/trans/github/04.md @@ -1,3 +1,5 @@ +# 四、搜索 Github + 搜索 GitHub 非常简单；很像谷歌搜索，你只需在屏幕顶部的搜索栏中键入你想要的内容。 ![](img/00021.gif) diff --git a/trans/github/05.md b/trans/github/05.md index 231465b79a9e28bf72d24a46b334b103d2dcd8d9..6381b12f7967c1bc7bd6fd9a70f9d5b0014f8afa 100644 --- a/trans/github/05.md +++ b/trans/github/05.md @@ -1,3 +1,5 @@ +# 五、高级搜索 + GitHub 的搜索引擎隐藏了搜索中的高级选项，但在搜索字符串中使用不同的结构提供了许多附加功能。您可以通过单击语言列表下方的高级搜索链接来浏览高级选项。 “高级选项”部分允许您查找特定用户和公司拥有的存储库，甚至将搜索限制在特定的存储库。您还可以按日期范围进行搜索，或将结果筛选为特定的编程语言。 diff --git a/trans/github/06.md b/trans/github/06.md index 70fac77b339968dc721a870ada87dcac07ad1751..31e1506858180e6925ed8fa412717e59be5f5f8a 100644 --- a/trans/github/06.md +++ b/trans/github/06.md @@ -1,3 +1,5 @@ +# 六、其它搜索 + 虽然到目前为止，我们一直专注于存储库搜索，但是您也可以在 GitHub 中搜索其他信息。当 GitHub 搜索时，它也同时搜索代码、库和用户。当我用 C#语言搜索 Excel 时，我发现超过 1100 个存储库和超过 150000 行包含“Excel”一词的代码此外，还有超过 14，000 个问题(错误报告、增强请求等)。)和 9 个用户名中带有“Excel”的用户。 ![](img/00028.jpeg) diff --git a/trans/github/07.md b/trans/github/07.md index 3ef49ae3dac45de49f73e1e24f7508848d735431..462fcd45c088dc62e55f50cdcf0746247dca5e57 100644 --- a/trans/github/07.md +++ b/trans/github/07.md @@ -1,3 +1,5 @@ +# 七、浏览 Github + 虽然搜索是 GitHub 的一个强大功能，但您也可以探索许多有趣的项目，并看到最新的趋势。在您的帐户图标下，下拉菜单并选择**浏览**。您将看到类似于以下内容的屏幕: ![](img/00033.jpeg) diff --git a/trans/github/08.md b/trans/github/08.md index 6f7cf80dbfe92b91504e25ef07a6f71d6dec3de0..10693fdc3d2fd242c879a6154d380901ebe1c72b 100644 --- a/trans/github/08.md +++ b/trans/github/08.md @@ -1,68 +1,70 @@ -问题是 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 diff --git a/trans/github/09.md b/trans/github/09.md index 0bc4537bc9032aa4bb486165fa134062d26d14e5..e988d512d8c417cb10d38ceb42560ca72400f4e2 100644 --- a/trans/github/09.md +++ b/trans/github/09.md @@ -1,3 +1,5 @@ +# 九、查看项目 + 当显示搜索结果时，存储库列表中包含了大量信息。这些信息可以让你了解这个项目有多受欢迎，工作有多积极。 以下示例来自对使用 HTML 画布的 JavaScript 代码的搜索。three.js 是一个 JavaScript 库，可以让你在 HTML 5 Canvas 上做 3D 绘图和动画。它被设计成使用简单，但却是一个非常强大的三维工作库。 diff --git a/trans/github/10.md b/trans/github/10.md index c765315114088e027d745593716f69a6316be6b7..fb15d17942e2cde743f3ee9dcfd13a9916c7b5d6 100644 --- a/trans/github/10.md +++ b/trans/github/10.md @@ -1,3 +1,5 @@ +# 十、获取代码 + 您已经搜索了 GitHub，查看了所有结果，并找到了一个应该有所帮助的存储库。下一步是下载代码。如果您只是计划使用代码，而没有协作和贡献来使代码变得更好，您可以将代码下载到您的本地机器上。 抓取整个存储库最简单的方法就是点击菜单栏上的**下载 ZIP** 按钮。使用这种方法，您将只下载源文件和其他文件(没有存储库历史或详细信息)。 diff --git a/trans/github/11.md b/trans/github/11.md index 59ce77a0f395da7d056e3a3ef65b7e3db0f92649..43fa782259cc8b6883570e8b36c79cfad1de1715 100644 --- a/trans/github/11.md +++ b/trans/github/11.md @@ -1,3 +1,5 @@ +# 十一、合作 + 在前面的章节中，我们重点讨论了搜索 GitHub 和下载项目文件。在接下来的几章中，我们将关注协作、如何创建分叉以及如何处理拉请求。 在本书的早期，我们创建了一些处理日期的 SQL 代码的存储库。其中一个脚本(假期列表)将创建给定年份的假期列表。法国程序员吉纳维芙喜欢这个剧本，但她想在法国度假时修改它，而不仅仅是美国度假。她决定提交一个问题，建议不同国家的人去度假，而不是简单地下载脚本并修改它供自己使用。 diff --git a/trans/github/12.md b/trans/github/12.md index 882c2643e95d6e5e5556df4f86523c5304d8231d..112c391c8d026d8cb2b5072668d60fefb7bd050c 100644 --- a/trans/github/12.md +++ b/trans/github/12.md @@ -1,3 +1,5 @@ +# 十二、拉取请求 + 在协作过程中的某个时候，一个贡献者可能已经很好地完成并测试了代码，她觉得代码可以添加到主分支中。吉纳维芙决定通过点击**拉取请求**按钮来创建拉取请求。 ![](img/00087.jpeg) diff --git a/trans/github/13.md b/trans/github/13.md index 56eccb8d9661f1ef1a7d49bce31fd56279dabc41..b83e649a2001982c1fd8ef2b2d16f129f0a76e12 100644 --- a/trans/github/13.md +++ b/trans/github/13.md @@ -1,3 +1,5 @@ +# 十三、总结 + Git 是一个强大的分布式版本控制工具，GitHub 是一个在网络上存储您的存储库的好方法。凭借其版本控制能力，它可以成为任何程序员或开发人员处理需要跟踪更改的文件的便捷工具。然而，GitHub 真正的魅力在于它的问题跟踪和协作工具，以支持开源软件的精神。 您可以简单地将 GitHub 作为一个庞大的代码库来帮助您的开发工作，或者您也可以通过参与和协作那些让您感兴趣的项目来成为开源社区的活跃成员。 diff --git a/trans/github/14.md b/trans/github/14.md index d29057bf5be07b83af51b5a75be5932ea18d6413..393c38a851eab2b5b3fb105749ab07e192d60afb 100644 --- a/trans/github/14.md +++ b/trans/github/14.md @@ -1,3 +1,5 @@ +# 十四、附录 1：Github Markdown + 大多数输入 GitHub 的文本都可以利用标记语法来格式化文本。标记文本比同等的 HTML 更容易阅读和编写，但是可以在 GitHub 网站中显示为格式良好的 HTML。 任何输入到标记窗口的文本都被视为一个段落。每一个空行开始一个新的段落。只需输入即可写出全部内容，GitHub 内的 Markdown 引擎会在显示 HTML 结果时决定在哪里添加 diff --git a/trans/github/15.md b/trans/github/15.md index e0c99d7a0f244c654efb55f377a14e68b1af4c31..7a2453241867c15c894a1f833f06d5910de19158 100644 --- a/trans/github/15.md +++ b/trans/github/15.md @@ -1,3 +1,5 @@ +# 十五、附录 2：Emoji + 除了使用 Markdown，您还可以在 GitHub 文本框中添加表情符号。表情符号是在文档正文中显示的迷你图片，而不是文本。表情符号名称由冒号分隔。如果您在文本窗口中键入一个冒号，GitHub 将显示可用的表情符号，以冒号后的字母开头: ![](img/00092.jpeg)