接下来：学习 Sourcetree 和 Bitbucket

As our new Bitbucket space station administrator, you need to be organized. When you make files for your space station, you’ll want to keep them in one place and shareable with teammates, no matter where they are in the universe. With Bitbucket, that means adding everything to a repository. Let’s create one!

最初，您在 Bitbucket 中创建的存储库是空的，不包含任何代码。没关系，因为您马上就要开始添加一些文件。这个 Bitbucket 存储库将成为您的文件的中心存储库，这表示如果您授予其他人权限，他们就可以访问该存储库。您也可以将该存储库复制到您的本地系统，这样一来，您可以从一个存储库更新它，然后将这些更改传输到另一个存储库。

Do the following to create your repository:

1. 在 Bitbucket 中，单击全局侧边栏中的 + 图标，然后选择存储库。Bitbucket 将显示创建新的存储库页面。花一些时间查看对话框中的内容。除存储库类型之外，您在此页面上输入的任何内容都可以在以后更改。
   

2. 在名称字段中输入 BitbucketStationSupplies。Bitbucket 将在存储库的 URL 中使用此名称。例如，如果用户 the_best 有一个名为 awesome_repo 的存储库，该存储库的 URL 是 https://bitbucket.org/the_best/awesome_repo。

3. 对于其他选项，除非您需要更改它们，否则保持不变：

   • 访问级别 — 保持这是一个私有存储库框处于选中状态。私有存储库只对您和具有访问权限的人可见。如果取消选中此框，任何人都可以看到您的存储库。

   • 包括 README？— 如果您最近才创建您的帐户，此选项默认是一个教程 README。在此教程中，选择任一个是选项，这样您就可以开始一个文件。

4. 对于版本控制系统，您可以选择 Git 或 Mercurial。如果您不确定要使用哪一个，就选择 Git。

5. 单击创建存储库。Bitbucket 将创建您的存储库，并显示它的源页面。

花些时间了解一下您刚刚创建的存储库。要查看可用的快捷方式，请按键盘上的 ? 键。

单击全局侧边栏中的 +，可以进行针对存储库的常见操作。浏览导航侧边栏中的链接，查看每个链接后面的内容，包括存储库设置，您可以在其中更新存储库的详细信息和其他设置。单击侧边栏中的提交。如果您包括了 README，您可以在该页面上看到一项提交。

您的存储库是私有的，并且您还没有邀请任何人访问该存储库，因此目前能够创建或编辑存储库内容的人只有您，您是该存储库的负责人。

现在，您有了一个地方可以添加和共享空间站文件，您需要通过一种方法从本地系统访问它。要进行设置，需要将 Bitbucket 存储库复制到您的系统。Sourcetree 将复制存储库称为“克隆”存储库。克隆存储库时，您在 Bitbucket Server 和您的本地系统之间建立了一个连接。

使用 Sourcetree 将存储库克隆到您的本地系统，无需使用命令行。

1. 随着您更多地使用 Bitbucket，您可能会用到多个存储库。因此，最好创建一个包含所有这些存储库的目录。首先在您的本地系统中创建一个目录，叫作 repos。

2. 在 Bitbucket 中，转到您的 BitbucketStationSupplies 存储库。

3. 单击右上角的“克隆”按钮。Bitbucket 将显示“克隆此存储库”对话框。 

4. 在克隆此存储库对话框中，单击在 Sourcetree 中克隆。

5. 在克隆新存储库对话框中，将目标路径更新为 <本地目录>/repos/bitbucketstationsupplies。 此目标路径是指您刚刚为存储库的文件夹创建的目录。名称字段与存储库的文件夹名称字段保持一致。

6. 单击克隆按钮。

Congratulations! You've cloned your repository to your local system.

通过本地系统上的存储库，您可以开始列出空间站所需的所有物资。为此，让我们为您的物资创建一个文件。

您进行这部分操作时，根据您使用的是 Git 还是 Mercurial 存储库，图片看起来可能略有不同。

1. 在 Sourcetree 中双击 bitbucketstationsupplies 存储库，注意没有任何内容从您的本地存储库提交到远程存储库。
   

2. 使用文本编辑器添加以下三行：
   space ice
cream nerf
darts telescope light shield

3. 将文件另存为 supplies.txt，保存到本地系统的 bitbucketstationsupplies 目录。supplies.txt文件现在显示在 Sourcetree 中，因为您在本地存储库中创建了它。
   

4. 现在，您需要在将更改提交到正式的历史记录之前，准备这些更快的快照。在 supplies.txt文件的选项菜单中，选择暂存文件（适用于 Git cunck）或添加文件（适用于 Mercurial 存储库）。
   
   

5. 单击顶部的提交按钮以提交文件。

6. 在消息框中，输入“Initial commit”。
   

7. 单击框下面的提交按钮。您的新文件现在已经提交到项目历史记录中。
   
   到目前为止，您所做的一切都在本地系统中，对您的 Bitbucket 存储库是不可见的，直到您将这些更改推送到远程 Bitbucket 存储库为止。

8. 在 Sourcetree 中，单击推送按钮以推送您提交的更改。使用推送，您可以将一项或多项提交移到另一个存储库，这是一种发布贡献的简便方法。
   

9. 在显示的对话框中，您要进行的下一步操作取决于您使用的是 Git 还是 Mercurial：

   • Git – 在推送？列，选择主分支，以表明您要将该分支推送到原点，并单击确定。
     

   • Mercurial – 所有操作都是自动的，您只需单击确定。

10. 转到您在 Bitbucket 中的 BitbucketStationSupplies。

    • 如果您单击侧边栏中的提交，您将看到您在存储库中的提交。Bitbucket 将您刚才的所有操作组合到该提交中并显示给您。

    • 如果您单击侧边栏中的源，您将在存储库中看到您的文件，也就是您刚添加的 supplies.txt 文件。
      

作为空间站管理员，您的下一个活动是提交新的物资申请。我们来建立一个系统，为我们的 Bitbucket 空间站获取物资。只需再多了解一下 Bitbucket 和 Sourcetree，就能在未来几年中支持我们的太空探索！

要添加您的耗材申请文件，请执行以下操作：

1. 从您在 Bitbucket 中的 BitbucketStationSupplies，单击源打开源目录。注意，您的目录中只有一个文件 supplies.txt。
   

   • A. 源页面：单击此链接以打开此页面。

   • B. 分支选择：选择您要查看的分支。 

   • C. 更多选项按钮：单击以打开包含更多选项（例如“添加文件”）的菜单。

   • D. 源文件区域：查看 Bitbucket 中的文件目录。 

2. 在源页面中，单击右上角的更多选项按钮，然后从菜单中选择添加文件。只有您已经向存储库中添加了至少一个文件时，更多选项按钮才显示。这时将打开用来创建新文件的页面，如下图所示。
   

   • A. 新文件的分支：如果您要向其他分支添加文件，更改此选项。

   • B. 新文件区域：在这里为您的新文件添加内容。

3. 在文件名字段中输入 supplyrequest。

4. 从语法模式列表中选择 HTML。  

5. 在文本区域添加以下 HTML 代码：<p>We are requesting additional supplies. Please send us the following:</p>
<ul>
<li>space ice cream</li>
<li>nerf darts</li>
<li>telescope light shield</li>
</ul>

6. 单击提交。提交消息字段将显示消息：supplyrequest created online with Bitbucket。

7. 单击消息字段下面的提交。

现在，您在 Bitbucket 中有一个新文件！您将看到包含提交的详细信息的页面，在该页面中您可以看到您刚刚进行的更改： 

如果您要查看到目前为止已经做出的提交的列表，单击侧边栏中的提交。

现在，我们需要将耗材申请送到您的本地系统。过程很简单，基本上就是让 supplies.txt 文件进入 Bitbucket 的推送过程的反向过程。

To pull the file into your local repository, do the following:

1. 在 Sourcetree 中打开您的存储库，单击拉取按钮。
   
   弹出的窗口告诉您，您正在将 Bitbucket 的文件合并到您的本地存储库。
   

2. 单击这个框中的确定。Sourcetree 会更新显示合并后的文件的描述。
   

3. Navigate to your repository folder on your local system and you'll see the file you just added.

非常好！现在，您已经完成了 Bitbucket 与您的本地系统之间的基本 DVCS 工作流（克隆、添加、提交、推送和拉取）。

阅读 Intergalactic Mall 杂志时，您看到空间站中急需的一对扬声器。它们非常大，音量够强，而且很柔软，即使失重也不会造成崩溃。唯一的问题是这种扬声器相当昂贵，您需要先获得批准，然后才能将其添加到物资清单中。

与此同时，创建一个功能分支，以便您在等待时可以将该物资更新到您的申请列表。然后，获得批准之后，您可以从该功能分支将申请合并到主分支。

当您以团队形式工作时，分支是最强大的。您可以通过自己的分支处理您负责的项目部分，从 Bitbucket 拉取更新，然后将您的所有工作成果合并到主分支中。我们的文档中详细介绍了为何您需要使用分支。

让我们创建一个分支，以便您在物资申请文件中列出扬声器。尽管 Git 和 Mercurial 的分支的工作方式不同，但在 Sourcetree 中您可以按相似的方式创建分支。

1. 在 Sourcetree 中，单击分支按钮。
   
2. 对于 Git 或 Mercurial 存储库，用来创建新分支的弹出窗口会有所不同。在新建分支或创建新分支字段中，为您的分支输入名称 wish-list。
   
   

3. 单击创建分支或确定。

4.  在 Sourcetree 中，单击在查找器中显示按钮。您系统上的目录将打开。

5. 在目录文件夹中，用文本编辑器打开 supplyrequest 文件。

6. 做出更改，向耗材列表中添加以下条目： 
   <li>anti-gravity speakers</li>

7. 保存该文件。

8. 在 Sourcetree 中打开视图，注意您的存储库现在已经有了未提交的更改。
   
   从现在开始，您所做的一切都与您添加了 supplyrequest 文件并最初提交它时所做的相同。

9. 如果您使用的是 Git 存储库，让 supplyrequest.txt文件做好提交准备，方法是从选项菜单中选择暂存文件。
   

10. 单击顶部的提交按钮以提交文件。

11. 在消息框中，输入“Adding an item for my wish list”。

12. 单击框下面的提交按钮。在 Sourcetree 中，您可以看到该文件已经更新到 wish-list 分支。
    

您的扬声器获得了批准！现在，可以使用您的 wish-list 条目更新主耗材清单。

1. 首先，您需要切换回主分支。在 Sourcetree 的左侧菜单项中，将鼠标悬停在分支标签的右侧，以便出现显示字样。
   
2. 出现显示字样后，单击它。在分支标题下，您将看到此存储库的两个分支，分别是主分支和 wish-list 分支。Git 存储库的主分支叫作 master。Mercurial 存储库的主分支叫作 default。
   

3. 双击功能分支（在这个示例中是 wish-list）以切换到该分支。

4. 单击合并按钮。
   

5. 在显示的弹出窗口中，确保 wish-list 分支上的提交是高亮显示的。这表示您要将此提交从此分支添加到主分支。
   

6. 如果您使用的是 Git 存储库，请在底部查看此选项：Create a commit even if merge resolved via fast-forward。
   

7. 单击确定。您已经使用 wish-list 条目更新了主分支中的 supplyrequest 文件。根据您使用的 Git 存储库还是 Mercurial 存储库，Sourcetree 看起来略有不同。
   

8. 如果您使用的是 Git 存储库，现在操作就完成了。如果您使用的是 Mercurial 存储库，您会发现您需要提交更改。单击上部的提交按钮。提交信息默认显示有关“合并”的描述。保留此信息，然后继续并单击提交。

1. 在 Sourcetree 中，单击推送按钮以推动您提交的更改。

2. 在显示的对话框中，单击确定按钮，将更改推送到您本地的存储库。

3. 单击 Bitbucket 存储库的概览页面，您会看到您的推送显示在最近的活动信息流中。

4. 单击提交，您可以在本地系统中看到该提交。请注意，该更改具有与您本地系统上相同的提交代码。
   

5. 单击源，然后单击 supplyrequest 文件。您可以看到文件最后的更改具有您刚刚推送的提交代码。

6. 单击文件历史记录，可以查看对该文件的已提交更改，如下图所示。

非常紧张！可能是吧。当然没法和进入太空相比。现在，您对 Bitbucket 有了更多了解，可以做好准备，更好地执行空间站的活动。休息一下，看看星星吧。

想要了解有关 Bitbucket 和 Sourcetree 的更多信息？您可以试试更新队友的存储库这个挑战。