初次在 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 按钮,完成仓库的创建。
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