GitHub与Markdown（学习笔记）

一、学前提问：

1.GitHub用翻墙吗？

访问 GitHub 不用翻墙，只是可能访问速度稍慢些。

2.英语差学得会吗？

GitHub 虽然都是英文，但是,对英语水平的要求不是那么高，都是些简单的单词，遇到不会的查一下。

二、进入学习：

1.注册账号（Sign Up）

官网：https://github.com/

没啥好说的，需要填用户名、邮箱、密码。

用户名就是你以后常用的用户名了，也建议你各大社交账号都用一样的用户名，这样识别度较高，而且这个用户名以后在 GitHub 搭建博客的时候，默认给你生成的博客地址就是 http://username.github.io 。

填好用户名、邮箱、密码紧接着到这一步：

这个是什么意思呢？

GitHub 有两种：

一种是公开，这种是免费的，就是你创建的项目是开放的，所有人都能看得到；

另一种是私有，这种是收费的，这种一般是很多企业在使用 GitHub 的私有仓库在托管自己的项目，这也是 GitHub 的一种盈利模式对于个人你就直接默认选择公开的就行了。

Timeline，这部分你可以理解成微博，就是你关注的一些人的活动会出现在这里。

三、GitHub主页

点击 Your profile 菜单进入到你的个人 GitHub 主页。

我的账号刚建立没多久，内容不丰富。下图来自于网络：

四、设置你的GitHub

点击Settings 菜单：

设置基本信息：

五、GitHub基本概念

>>> 图片来自GitHub截图：

了解一些 GitHub 的基本概念，这些概念是经常会接触并遇到的。

1）Repository（仓库）

你想在 GitHub 上开源一个项目，那就必须要新建一个 Repository ，如果你开源的项目多了，你就拥有了多个 Repositories 。

2）Issue（问题）

比如，开源了一个项目，别人发现你的项目中有bug，或者哪些地方做的不够好，他就可以给你提个 Issue ，即问题，提的问题多了，也就是 Issues ，然后你看到了这些问题就可以去逐个修复，修复ok了就可以一个个的 Close 掉。

3）Star（星星）

给项目点赞（在 GitHub 上的点赞远比微博、知乎点赞难的多，如果你有一个项目获得100个star都算很不容易了！）

4）Fork

比如，你开源了一个项目，别人想在你这个项目的基础上做些改进，然后应用到自己的项目中，这个时候他就可以 Fork 你的项目，这个时候他的 GitHub 主页上就多了一个项目，只不过这个项目是基于你的项目基础（本质是在原有项目的基础上新建了一个分支，回忆前面Git内容），他就可以随心所欲的去改进，但是丝毫不会影响原有项目的代码与结构。

5）Pull Request（发起请求）

这个其实是基于 Fork 的，还是上面那个例子，如果别人在你基础上做了改进，后来觉得改进的很不错，应该要把这些改进让更多的人收益，于是就想把自己的改进合并到原有项目里，这个时候他就可以发起一个 Pull Request（简称PR） ，原有项目创建人就可以收到这个请求，这个时候他会仔细review你的代码，并且测试觉得OK了，就会接受你的PR，这个时候你做的改进原有项目就会拥有了。

6）Watch（观察）

如果你 Watch 了某个项目，那么以后只要这个项目有任何更新，你都会第一时间收到关于这个项目的通知提醒。

7）Gist

有些时候你没有项目可以开源，只是单纯的想分享一些代码片段，那这个时候 Gist 就派上用场了！

六、创建自己的项目

我的Git篇有提到的。

如下图：

创建一个项目需要填写如上的几部分：

项目名、项目描述与简单的介绍，你不付费没法选择私有的，所以接着只能选择 public 的，之后勾选「Initialize this repository with a README」，这样你就拥有了你的第一个 GitHub 项目：

可以看到这个项目只包含了一个 README.md 文件，但是它已经是一个完整的 Git 仓库了，你可以通过对它进行一些操作，如watch、star、fork，还可以 clone 或者下载下来。

** README.md 介绍：

GitHub 上所有关于项目的详细介绍以及 Wiki 都是基于 Markdown 的，甚至之后在 GitHub 上搭建博客，写博客也是如此，所以如果还不懂 Markdown 语法的，建议先去学习下。

七、Markdown学习

百度百科：Markdown是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。

Markdown具有一系列衍生版本，用于扩展Markdown的功能（如表格、脚注、内嵌HTML等等），Markdown增强版中比较有名的有Markdown Extra、MultiMarkdown、 Maruku等。这些衍生版本要么基于工具，如Pandoc；要么基于网站，如GitHub和Wikipedia，在语法上基本兼容，但在一些语法和渲染效果上有改动。

世界上最流行的博客平台WordPress和大型CMS如Joomla、Drupal都能很好的支持Markdown。完全采用Markdown编辑器的博客平台有Ghost和Typecho。

用于编写说明文档，并且以“README.md”的文件名保存在软件的目录下面。

 

**学习之旅：

 

Markdown在线编辑器学习：

 

https://www.mdeditor.com/