初次在 GitHub 建立仓库以及公开代码的流程 - 建立仓库

初次在 GitHub 建立仓库以及公开代码的流程 - 建立仓库

1. 创建仓库
        实际创建一个公开的仓库。点击右上角工具栏里的 New repository，创建新的仓库。

2. Repository name
        在 Repository name 栏中输入仓库的名称。这里我们输入 Hello-World。

3. Description
        Description 栏中可以设置仓库的说明。这一栏不是必需项，可以留空。

4. Public、Private
        选择 Public，创建公开仓库，仓库内的所有内容都会被公开。
        选择 Private 可以创建非公开仓库，用户可以设置访问权限，这项服务目前也是免费的。

5. Initialize this repository with a README
        在 Initialize this repository with a README 选项上打钩，随后 GitHub 会自动初始化仓库并设置 README 文件，让用户可以立刻 clone 这个仓库。如果想向 GitHub 添加手中已有的 Git 仓库，建议不要勾选，直接手动 push。

6. Add .gitignore
        该文件用来描述 Git 仓库中不需管理的文件与目录。下方左侧的下拉菜单非常方便，通过它可以在初始化时自动生成 .gitignore 文件。这个设定会帮我们把不需要在 Git 仓库中进行版本管理的文件记录在 .gitignore 文件中，省去了每次根据框架进行设置的麻烦。下拉菜单中包含了主要的语言及框架，选择今后将要使用的即可。

7. Add a license
        右侧的下拉菜单可以选择要添加的许可协议文件。如果这个仓库中包含的代码已经确定了许可协议，那么请在这里进行选择。随后将自动生成包含许可协议内容的 LICENSE 文件，用来表明该仓库内容的许可协议。
        输入选择都完成后，点击 Create repository 按钮，完成仓库的创建。

 

 

 

8. repository URL
https://github.com/用户名/Hello-World
https://github.com/ForeverStrongCheng/Hello-World

9. README.md
        README.md 在初始化时已经生成好了。README.md 文件的内容会自动显示在仓库的首页当中。因此，人们一般会在这个文件中标明本仓库所包含的软件的概要、使用流程、许可协议等信息。如果使用Markdown 语法进行描述，还可以添加标记，提高可读性。
        使用 GitHub 后，很多文档都需要用 Markdown 来书写。也就是说，全世界有大量程序员都在使用 Markdown，因此掌握这种语法已经成为程序员的标准技能之一。

 

References

(日) 大塚弘记 著, 支鹏浩, 刘斌 译. GitHub入门与实践[M]. 北京:人民邮电出版社, 2015. 1-255