不积跬步，无以至千里
不积小流，无以成江海
前言
博主今年大三，现就读于西安一所211高校，是一个对未来迷茫的考验党。
之前也折腾过一个博客，那时是用wordpress搭建的，还花了钱买了服务器（腾讯云学生价120/年），但是一直没动手写文章，因为觉得麻烦，不如去学点新东西，新技术（比如近些年来的，机器学习深度学习之类的），古人说的好：术业有专攻，盲目追求技术的后果就是什么都会一点，什么都不会，于是索性就想着再弄一个不花钱的博客，来记录自己的学习历程和心得，毕竟没有过目不忘的脑子，只能靠多巩固来弥补技术间隙性的遗忘。
正文
本篇文章采用Github Pages+jekyll快速搭建个人博客
1.注册+登录你的github
首先，你得拥有一个github账号，如果没有，赶紧去注册一个吧! Github
sign up 注册一个账号
sign in 登录你的账号
2.Fork(拉取)我的博客模板
登录github账号后，进入我的仓库中,点击Fork，就可拉取到我的博客模板到自己的仓库中
3.修改repository(仓库)名
在第2步的基础上，点击setting
修改repository name 为: 你的github名.github.io
例如我的github账号是：cfhyxxj，则我的这个repository name 应改为： cfhyxxj.github.io
接着点击Rename即可
4.检查上述步骤是否成功
在浏览器上输入网址：你的github名.github.io
会出现如下图所示的博客界面，不过还得修改下，才能改成你自己的博客
整个网站的架构
├── _config.yml
├── _drafts
| ├── begin-with-the-crazy-ideas.textile
| └── on-simplicity-in-technology.markdown
├── _includes
| ├── footer.html
| └── header.html
├── _layouts
| ├── default.html
| └── post.html
├── _posts
| ├── 2007-10-29-why-every-programmer-should-play-nethack.textile
| └── 2009-04-26-barcamp-boston-4-roundup.textile
├── _data
| └── members.yml
├── _site
├── img
└── index.html
其中重要的就是这几个文件：
- _config.yml 全局配置文件
- _posts 存放博客文章的文件夹
- img 存放个人博客网站上少量的图片(博客文章里插入的是图片外链，图片放置在图床，加快了博客加载速度，后面还会提到)
- 想自己设计界面，可以看这里jekyll文档
修改全局配置
在你的仓库里，找到_config.yml文件，双击打开
然后对此文件进行修改(可对照下面设置和网站页面改)
网站设置
# Site settings
title: charryglomc #这个标题会显示在左上角(返回主页)和header图片中间字体
SEOTitle: 春风化雨的博客 #这个标题显示在浏览器标签页上
header-img: img/post-bg-desk.jpg #主页上部图片
email: 798577670@qq.com
description: ""
keyword: "春风化雨的博客, cfhyxxj"
url: "http://cfhyxxj.github.io" # your host, for absolute URL
baseurl: "" # for example, '/blog' if your blog hosted on 'host/blog'
github_repo: "https://github.com/cfhyxxj/cfhyxxj.github.io.git" # you code repository
侧边栏
# Sidebar settings
sidebar: true # true为有侧边栏
sidebar-about-description: "花开堪折直须折,莫待无花空折枝" #侧边栏描述
sidebar-avatar: /img/zz.png #本领想用二柱子头像的，但是觉得并不合适
修改个人介绍
在about.html文件里，可对照着改
社交账号
# SNS settings
RSS: false
# weibo_username:
#zhihu_username:
github_username: cfhyxxj #不填就注释掉，博主只想要star，hhh
#facebook_username:
#jianshu_username:
#twitter_username:
评论系统
我推荐用gitalk评论插件，gitalk是由github账号登录，接下来改一下下面的参数就好了
# Gitalk
gitalk:
enable: true #是否开启Gitalk评论
clientID: xxxxxxxxxxxxxxx #生成的clientID
clientSecret: xxxxxxxxxxxxxx #生成的clientSecret
repo: cfhyxxj.github.io #改为自己的仓库名称
owner: cfhyxxj #改为自己的github用户名
admin: cfhyxxj #同上
distractionFreeMode: true #是否启用类似FB的阴影遮罩
获取clientID和clientSecret
首先申请一个Github Application，如下照着改为自己的就行了
登录后，往下滑，就可看到自己的clientID和clientSecret
网站统计
集成了 Baidu Analytics 和 Google Analytics，到各个网站注册拿到track_id替换下面的就可以了
# Analytics settings
# Baidu Analytics
ba_track_id: xxxxxxxxxxxxxxxxxxxxxxxx
# Google Analytics
ga_track_id: 'xxxxxxxxx' # Format: UA-xxxxxx-xx
ga_domain: auto
好友
friends: [
{
title: "简书·BY",
href: "http://www.jianshu.com/u/e71990ada2fd"
},{
title: "Apple",
href: "https://apple.com"
},{
title: "Apple Developer",
href: "https://developer.apple.com/"
}
] #如不想用可用#注释掉，但要一行一行注释
标签
# Featured Tags
featured-tags: true # 是否使用首页标签
featured-condition-size: 0 # 相同标签数量大于这个数，才会出现在首页
提交保存
将网页拉到底部，提交所有的修改
购买域名
很幸运还是学生，买域名有优惠，跑题了，hhh
我买的阿里的域名.top，一年9RMB，是不是觉得特别便宜呢？
可用淘宝或支付宝登录，然后搜索栏搜索域名，输入你想设定的域名，看有没有，然后购买
买了之后要进行域名解析
ping ip
在这之前要在cmd命令行里ping一下 你的github账号.github.io的ip地址
例如我的：
ping cfhyxxj.github.io
(可能有不同，最好自己ping一下，这个ip地址应该是最新美国Github Pages服务器的地址)
域名解析
进入阿里云控制台，双击域名，进入域名控制台，双击解析
添加两条记录解析
记录类型两条都为A
主机记录一个为@，一个为www
记录值为刚才ping的ip地址
修改CNAME
修改仓库下的CNAME文件内容，改为自己刚注册的域名
测试
在浏览器输入域名，直接成功跳转到自己的博客，大功告成！
写文章
要写文章首先要学习一下markdown语法，可以看下markdown基本语法
另外安利一个mardown神器：typora，界面简洁，写下即可渲染。 typora下载链接
博客文章最后是以.md文件的形式保存，.md标题是由下图框框内的yaml自动决定的，也就是你写博客前面要照着如下写
title，subtitle，date，author，header-img，tags全部由自己设定，最后传文章显示到博客上
传文章
将文章上传到自己的博客，可以下载github-desktop,也可以通过git命令的方式传，
这里我采用github-desktop传文章
1.将仓库中的项目下载到本地 (Clone Github Project to Local Repository)
首先，你不想每次进入github网站对你的项目文件编辑修改，你可以把它们下载到你的本地磁盘上，然后对项目文件的每一次修改都会被记录下来，可以通过github-desktop同步修改到你的远程仓库上(即本地修改同步到远程仓库)
点击加号
选择clone，你可以看到你在github上存放的（尚未下载到本地的）项目列表。选中一个想要下载到本地的项目，选择clone Repository，然后选择本地路径以存放项目文件夹。
项目文件夹可以随意更换位置，不信你可以试试，hhh
2.在本地仓库更新网页端的改变 （pull)
假如你是和你的合作者一起完成一个项目，他又新提交了一个新文件改变到该项目，你很感兴趣，想要同步到本地，你可以这样做：在网站上点击【Repository】-【Pull】，接着，你就可以看到本地仓库里出现了合作者提交的新文件。
3. 在本地提交新的代码版本到仓库 (push local changes to remote repository)
修改本地仓库文件后，打开github-desktop，点击changes，有时候可能没有(博主第一次就是这样，一直试了好多次)，那就切换github-desktop界面，直到它出现changes
然后填下(Summary)标题和注释(Description)就提交(Commit)
commit后，你会发现你的项目历史结点上多了一个新的环，代表你的上一次commit记录,如下图
你可以提交一次，然后点击Sync同步到你的远程仓库，也可以提交多次后迭代，再同步
同步后，前面的环消失了
4. 创建新的分支 (creating new branch)
比如，你和朋友一起翻译一本书，你负责翻译成英文，你朋友负责翻译成日文，那么你们也可以分别在两个分支上操作，但这两个分支都属于这本书的翻译项目
简而言之，所有分支同属一个项目，但每个分支可以互相独立，互不干扰，而有需要时，任意两个分支也可以合并。
创建新的分支
新的分支publish到远程仓库
pull request
为什么要pull request？
很多情况下，很多人是fork(拉取)别人的项目，然后自己进行改进，但是你对别人的项目是没有改动权力的，但是如果你觉得自己的改进非常棒，想贡献自己的代码并成为原项目的contributor之一，于是你就需要发起一个pull request，通过审核，请求原项目的负责人将你的代码合并的原项目中
jekyll博客本地调试
github远程提交有延迟，不适合博客进行调试，所以我们需要用到jekyll本地调试
第一次安装有三个步骤
1. 安装Ruby
进入Ruby下载链接，根据自己的机型下载对应版本
博主第一次下载的是最新的，没成功，翻墙下载卡到一半不动了，所以还是果断下了以前的版本
安装过程中，这两个勾上(默认是没有勾上)
安装完后测试是否安装成功，命令行输入：ruby -v
2. DevKit下载
还是在那个网站,拉到下面，下载DevKit
在你保存DevKit的文件夹里打开命令行
例如我保存在D:/DevKit,我先进入这个文件夹，然后按住shift，点击鼠标右键即可打开命令行
然后输入ruby dk.rb init，自动在文件夹中生成config.yml文件
用记事本打开这个文件，在文件末尾行添加Ruby文件夹地址，例如我的是C:/Ruby23-x64,然后保存退出
3. 安装jekyll
以下命令都是在命令行里输入
gem是ruby自带的
先测试gem是否安装完毕：gem -v
然后利用gem安装jekyll：gem install jekyll
测试jekyll是否安装完毕：jekyll -v
进入你的本地仓库 xxx.github.io这个文件夹中，打开命令行输入jekyll serve，一般会提示出现下面的Error，即是缺少jekyll-paginate
直接在命令行里输入命令：gem install jekyll-paginate
然后再进入你的本地仓库 xxx.github.io这个文件夹中，打开命令行里输入jekyll serve，你的博客就运行在本地4000端口上，复制这个网址在浏览器，你的每一次改动，博客都会动态变化，当所有改动完后，一次性性提交所有的changes即可
