hexo+github建立博客基础知识
[github+hexo搭建自己的博客网站
内容参考博客园，如果有不明白的地方可以访问我的网站，啥都会查看
github提供的page，hexo提供的静态博客文档，这样可以搭建一个自己的一个博客网站。
使用github pages服务搭建博客的好处有：
- 全是静态文件，访问速度快；
- 免费方便，不用花一分钱就可以搭建一个自由的个人博客，不需要服务器不需要后台；
- 可以随意绑定自己的域名，不仔细看的话根本看不出来你的网站是基于github的；
- 数据绝对安全，基于github的版本管理，想恢复到哪个历史版本都行；
- 博客内容可以轻松打包、转移、发布到其它平台；
一、github相关设置*
1、在github上创建一个项目
注意：项目名称必须为自己 github的用户名.github.io
2、代码库的设置
开启gh-pages功能，点击界面右侧的Settings，你将会打开这个库的setting页面，向下拖动，直到看见GitHub Pages。
之前是需要：点击Automatic page generator，Github将会自动替你创建出一个gh-pages的页面。 如果你的配置没有问题，那么大约15分钟之后，yourname.github.io这个网址就可以正常访问了~ 如果yourname.github.io已经可以正常访问了，那么Github一侧的配置已经全部结束了。
现在不需要设置page generator。就可以访问https://saucxs.github.io/
二、安装hexo
1、全局安装hexo-cli指令
1 | npm install hexo-cli -g |
查看hexo版本
1 | hexo -v |
2、初始化hexo
1 | hexo init |
hexo会自动下载一些文件到这个目录，包括node_modules，目录结构如下图：
3、开始体验hexo
1 | hexo g |
生成静态文件到public文件夹，没有public文件夹就会自动创建，如果有了就会覆盖public内容。
public文件夹的内容是要提交到github上的。
4、开启本地服务
1 | hexo s |
hexo s是开启本地预览服务，打开浏览器访问 http://localhost:4000 即可看到内容，很多人会碰到浏览器一直在转圈但是就是加载不出来的问题，一般情况下是因为端口占用的缘故，因为4000这个端口太常见了，解决端口冲突问题。
三、如何将hexo与github page联系起来
分为3步：
1、配置SSH key
2、设置Git的user name和email
3、配置deployment
1、配置SSH key
如果你之前已经配置好git个人信息，请跳过这一个 步骤，直接来到
为什么要配置这个呢？因为你提交代码肯定要拥有你的github权限才可以，但是直接使用用户名和密码太不安全了，所以我们使用ssh key来解决本地和服务器的连接问题。
1 | $ cd ~/. ssh #检查本机已存在的ssh密钥 |
如果提示：No such file or directory 说明你是第一次使用git。
1 | ssh-keygen -t rsa -C "邮箱" |
然后连续3次回车，最终会生成一个文件在用户目录下，
打开用户目录，找到.ssh\id_rsa.pub文件，记事本打开并复制里面的内容，打开你的github主页，进入个人设置 -> SSH and GPG keys -> New SSH key：
刚复制的内容粘贴到key那里，title随便填，保存。
测试一下是否成功
1 | $ ssh -T git@github.com # 注意邮箱地址不用改 |
看到这个信息说明SSH已配置成功！
2、设置Git的user name和email
1 | $ git config --global user.name "liuxianan"// 你的github用户名，非昵称 |
设置这个是为了便与之后上传到github的page上。
3、设置deployment
配置_config.yml中有关deploy的部分：
正确写法：
1 | deploy: |
错误写法：
1 | deploy: |
后面一种写法是hexo2.x的写法，现在已经不行了，无论是哪种写法，此时直接执行hexo d的话一般会报如下错误：
1 | Deployer not found: github 或者 Deployer not found: git |
需要安装一个插件
1 | npm install hexo-deployer-git --save |
再次输入hexo d，就ok了。
自己的github的page，显示如下
同时，你的github上的项目，代码已经更新。
四、保留CNAME、README.md等文件
提交之后网页上一看，发现以前其它代码都没了，此时不要慌，一些非md文件可以把他们放到source文件夹下，这里的所有文件都会原样复制（除了md文件）到public目录。
由于hexo默认会把所有md文件都转换成html，包括README.md，所有需要每次生成之后、上传之前，手动将README.md复制到public目录，并删除README.html。
五、修改hexo的主题
在 Hexo 中有两份主要的配置文件，其名称都是 _config.yml。 其中，一份位于站点根目录下，主要包含 Hexo 本身的配置；另一份位于主题目录下，这份配置由主题作者提供，主要用于配置主题相关的选项。
为了描述方便，在以下说明中，将前者称为 站点配置文件， 后者称为 主题配置文件。
PS：需要特别注意的地方是，冒号后面必须有一个空格，否则可能会出问题。
举个栗子：
1. 安装 NexT
载主题
如果你熟悉 Git， 建议你使用 克隆最新版本 的方式，之后的更新可以通过 git pull 来快速更新， 而不用再次下载压缩包替换。
在终端窗口下，定位到 Hexo 站点目录下。使用 Git checkout 代码：
1 | git clone https://github.com/iissnan/hexo-theme-next themes/next |
2. 启用主题
与所有 Hexo 主题启用的模式一样。 当 克隆/下载 完成后，打开 站点配置文件， 找到 theme 字段，并将其值更改为 next。
启用 NexT 主题
1 | theme: next |
到此，NexT 主题安装完成。下一步我们将验证主题是否正确启用。在切换主题之后、验证之前， 我们最好使用 hexo clean 来清除 Hexo 的缓存。
1 | hexo clean |
1 | hexo s -g //生成静态文件，启动本地服务 |
六、 写博客
定位到我们的hexo根目录，执行命令：
1 | hexo new ‘HelloEveryone’ |
我们只需要打开这个文件就可以开始写博客了，默认生成如下内容
当然你也可以直接自己新建md文件，用这个命令的好处是帮我们自动生成了时间。
默认情况下，生成的博文目录会显示全部的文章内容，如何设置文章摘要的长度呢？
答案是在合适的位置加上<!--more-->即可
欢迎光临我的网站查看相关内容
