手把手教你搭建GitHub个人博客网站
1 本地环境
macOS10.14.14
node.js@6.14.4 git@1.9.2 hexo@6.4.0
1.1 安装Node.js
node -v
1.2 安装配置Git
查看git是否安装成功
git --version
2 GitHub操作
2.1 创建仓库
新建一个名为你的用户名.github.io的仓库，这里，我的github用户名是Wasabi1234，那么就新建Wasabi1234.github.io的仓库,必须是你的用户名，其它名称无效，将来你的网站访问地址就是 http://Wasabi1234.github.io
每一个github账户最多只能创建一个这样可以直接使用域名访问的仓库。
2.2 注册绑定域名
不绑定域名也是可以的，就用默认的 xxx.github.io 来访问; 但你肯定想更个性一点，就得拥有一个属于自己的域名
首先你要注册一个域名，推荐阿里云,暖暖的很贴心~
2.3 配置SSH key
你提交代码肯定要拥有你的github权限才可以，但是直接使用用户名和密码太不安全了，所以我们使用ssh key来解决本地和服务器的连接问题。
- 检查本机已存在的ssh密钥
$ cd ~/. ssh
如果提示：No such file or directory 说明你是第一次使用git
- 生成ssh key
ssh-keygen -t rsa -C "邮件地址"- 然后连续3次回车，最终会生成一个文件在用户目录下
- 打开用户目录
- 找到
.ssh\id_rsa.pub文件
- 使用强大的VS Code打开并copy里面的内容
- 打开你的github主页，进入个人设置
- SSH and GPG keys 然后点击New SSH key
- 将刚复制的内容粘贴到key那里，title随便填，Add!
2.4 测试是否成功
$ ssh -T git@github.com
看到这个信息说明SSH已配置成功！
2.5 配置签名
在博客blog目录下，其中的name和email替换成你自己的用户名和邮箱
是你的github用户名，非昵称! 填写你的github注册邮箱
$ git config --global user.name "Wasabi1234"
$ git config --global user.email ""sss2855845850@gmail.com"设置全局的签名，每次提交的时候都会有对应签名
3 优雅地使用Hexo
3.1 Hexo简介
Hexo是一个简单、快速、强大的基于 Github Pages 的博客发布工具，支持Markdown格式，有众多优秀插件和主题。
3.2 原理
由于github pages存放的都是静态文件，博客存放的不只是文章内容，还有文章列表、分类、标签、翻页等动态内容，假如每次写完一篇文章都要手动更新博文目录和相关链接信息，相信谁都会疯掉，所以hexo所做的就是将这些md文件都放在本地，每次写完文章后调用写好的命令来批量完成相关页面的生成，然后再将有改动的页面提交到github。
3.3 注意事项
Hexo不同版本差别比较大，网上很多文章的配置信息都是基于2.x的，所以注意不要被误导； hexo有2种_config.yml文件，一个是根目录下的全局的_config.yml，一个是各个theme下的；
3.4 安装Hexo
在你认为合适的地方创个文件夹，我是在D盘建了一个blog文件夹。然后通过命令行进入到该文件夹里面
$ npm install -g hexo-cli
安装位置
soft ▸ usr ▸ local ▸ lib ▸ node_modules3.5 初始化
在电脑的某个地方新建一个名为hexo的文件夹（名字可以随便取），比如我的是/Volumes/doc/hexo，由于这个文件夹将来就作为你存放代码的地方，所以最好不要随便放。
$ cd /f/Workspaces/hexo/
$ hexo inithexo会自动下载一些文件到这个目录，包括node_modules
$ hexo g # 生成
- 启动服务
$ hexo s
执行以上命令之后，hexo就会在public文件夹生成相关html文件，这些文件将来都是要提交到github去的
hexo s是开启本地预览服务
- 打开浏览器访问 http://localhost:4000 即可看到内容
3.6 修改主题
默认主题丑到反人类，替换一个好看点的主题
首先下载这个主题：
$ git clone https://github.com/wizardforcel/hexo-theme-landfarz.git themes/landfarz
- 下载后的主题都在这里
- 修改
_config.yml中的theme landscape改为theme: landfarz
- 然后重新执行hexo g来重新生成
3.7 备份
在上传代码到github之前，一定要记得先把你以前所有代码下载下来（虽然github有版本管理，但备份一下总是好的），因为从hexo提交代码时会把你以前的所有代码都删掉。
3.8 部署
如果你一切都配置好了，发布上传很容易，一句hexo d就搞定，当然关键还是你要把所有东西配置好。
- 首先，ssh key肯定要配置好。
- 其次，配置_config.yml中有关deploy的部分：
正确写法：
deploy:
type: git
repository: git@github.com:liuxianan/liuxianan.github.io.git
branch: master错误写法：
deploy:
type: github
repository: https://github.com/liuxianan/liuxianan.github.io.git
branch: master后面一种写法是hexo2.x的写法，现在已经不行了
- 无论是哪种写法,此时直接执行hexo d会报如下错误：
- 还需要安装一个插件
sudo npm install hexo-deployer-git --save
根据警告再安装即可
发现又有警告,MD!
好了,终于没有警告了!
输入hexo d就会将本次有改动的代码全部提交，没有改动的不会
3.9 保留README.md等文件
提交之后网页上一看，发现以前其它代码都没了，此时不要慌，一些非md文件可以把他们放到source文件夹下，这里的所有文件都会原样复制（除了md文件）到public目录的：
由于hexo默认会把所有md文件都转换成html，包括README.md，所有需要每次生成之后、上传之前，手动将README.md复制到public目录，并删除README.html。
3.10 常用hexo命令
常见命令
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy #部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本缩写：
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy组合命令：
hexo s -g #生成并本地预览
hexo d -g #生成并上传3.11 _config.yml
这里面都是一些全局配置，每个参数的意思都比较简单明了，所以就不作详细介绍了。
需要特别注意的地方是，冒号后面必须有一个空格，否则可能会出问题。
4 写博客
4.1 新建博客
定位到我们的hexo根目录，执行命令：
hexo会帮我们在_posts下生成相关md文件：
我们只需要打开这个文件就可以开始写博客了，默认生成如下内容：
当然你也可以直接自己新建md文件，用这个命令的好处是帮我们自动生成了时间。
一般完整格式如下：
---
title: postName #文章页面上的显示名称，一般是中文
date: 2019-07-11 19:11:33 #文章生成时间，一般不改，当然也可以任意修改
categories: 默认分类 #分类
tags: [tag1,tag2,tag3] #文章标签，可空，多标签请用格式，注意:后面有个空格
description: 附加一段文章摘要，字数最好在140字以内，会出现在meta的description里面
---
正文那么hexo new page 'postName'命令和hexo new 'postName'有什么区别呢？
最终部署时生成一个index.html，但是它不会作为文章出现在博文目录
4.2 撰写工具
可以用typora来进行博客的编写或者用CSDN的编辑器也是很不错的选择，用VScode的Markdown-toc插件来为我们的文章自动生成目录。
5 优雅地使用Hexo的next主题
5.1 安装
$ git clone https://github.com/iissnan/hexo-theme-next themes/next
5.2 启用
与所有 Hexo 主题启用的模式一样。 当 克隆/下载 完成后，打开站点配置文件， 找到 theme 字段，并将其值更改为 next。
5.3 验证主题
首先启动 Hexo 本地站点，并开启调试模式（即加上 --debug）
hexo s --debug在服务启动的过程，注意观察命令行输出是否有任何异常信息，如果你碰到问题，这些信息将帮助他人更好的定位错误。 当命令行输出中提示出：
INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop. 此时即可使用浏览器访问 http://localhost:4000，检查站点是否正确运行。
5.4 配置
在 Hexo 中有两份主要的配置文件，其名称都是 _config.yml。 其中，一份位于站点根目录下，主要包含 Hexo 本身的配置；另一份位于主题目录下，这份配置由主题作者提供，主要用于配置主题相关的选项。
为了描述方便，在以下说明中，将前者称为 站点配置文件， 后者称为 主题配置文件。 你可以访问 Hexo 的文档 了解如何安装 Hexo病进行 站点配置文件的配置 简单的设置可以参考： NEXT中文文档 NEXT主题详细配置