利用Hexo在Github上部署个人博客

前言

本篇仅记录如何利用Hexo在Github上部署个人博客。注重快速建站，欢迎讨论交流。

环境准备

1. Node.js下载安装。一种javascript的运行环境，能够使得javascript脱离浏览器运行。

2. Git下载安装。一个免费的开源分布式版本控制系统。

3. 安装Hexo，Windows下使用Git Bash 运行：

npm install -g hexo-cli

4. 创建并且初始化：

   & mkdir <folder>
   $ hexo init <folder>
   $ cd <folder>
   $ npm install
   

5. 启动服务器，当前目录下：

   hexo server # 缩写hexo s

6. 本地测试浏览：

   http://localhost:4000/

本地搭建

1. 修改博客模板，模板在 <folder>/scaffolds/post.md

   title: {{ title }}
   date: {{ date }}
   tags:
   -tag01 # 名字随便写，但注意所有冒号后面加 空格
   -tag02
   categories: categories01 # 冒号后面空格不能少
   

2. 创建博客，可直接在 <folder>/source/post 目录下创建md文件，或者：

   hexo new post <title>

3. 撰写博客，利用Markdown来写博客，语法自行百度。

4. 发布测试，预览本地博客:

   hexo clean && hexo generate # generate the static file 最后github拿到也是静态文件
   hexo server # run hexo in local environment 缩写：hexo s -p 4000
   

云端部署

1. 创建Github账号并且创建仓库：<Github账号名称>.github.io

2. 安装git插件推送博客至GithubPages（Github本身也支持page，不仅仅托管代码哦！）

   npm install hexo-deployer-git --save

3. 添加SSH key。

   • 创建一个SSH key

     ssh-keygen -t rsa -C "邮箱地址"

   • 在用户主目录，Windows隐藏目录.ssh下关于rsa的pub文件，复制粘贴到github的settings下新建SSH key

   • 测试是否连接

     ssh -T git@github.com

4. 修改本地博客目录下 _config.yml

   # Deployment
   ## Docs: https://hexo.io/docs/deployment.html
   deploy:
     type: git
     repo: git@github.com:<Github账号名称>/<Github账号名称>.github.io.git #刚创建完给出的SSH链接
     branch: master
   

5. 生产静态文件并且推送至Github即可：

   hexo g

   hexo d

小结

Hexo作为开源的博客框架，一键部署，支持Markdown语法，最重要的是主题插件众多。更换主题只需要git开源主题到目录下themes，在博客目录的配置文件指定就可以。

参考链接：

https://hexo.io/zh-cn/docs/index.html

https://www.simon96.online/