5分钟使用Hexo搭建博客

背景

sphinx要用rst格式编写，感觉有些麻烦，正好看见用hexo编写博客，直接可以使用md格式，更方便快捷。（更新一下:我又用回sphinx了😂，大家想学hexo，可以看我这个简易版教材，再直接参考链接里面cloudy。想了解sphinx，点这)

两者区别是，hexo偏向blog,就和csdn很像，一篇一篇的书写，sphinx像写一本书，或者说一个主题相关的内容

操作

安装hexo

1. 全局安装hexo（命令行）

    $ npm install -g hexo-cli
   

2. 创建项目

   hexo init blog
   

3. 启动项目

   hexo s
   

添加内容

1. 按官网走

   hexo new "My New Post"
   hexo s
   
   

切换主题

1. 选择主题

2. 主题复制到本地

   git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia
   

3. 修改本地文件_congif.yml,大家可以直接看主题作者的readme.txt文档

   theme: yilia
   

4. 先清除缓存文件 (db.json) 和已生成的静态文件。再重新生成静态文件，最后部署

   hexo clean
   hexo g
   hexo s
   

上传到github并且发布

1. 安装插件帮忙推送到github

   npm install hexo-deployer-git --save
   

2. 修改_congif.yml

   deploy:
     type: git
     repo: https://github.com/xxxxxxxxx(github仓库地址)
     branch: master
   

3. 部署

   hexo clean
   hexo g
   hexo deploy
   

4. 打开github->setting->Github Pages->master，遇到问题了
   4.1 一直404
   等5分钟，还是没反应，就本地添加文件再次上传(hexo clean&&hexo deploy)

   4.2 页面出来了没有主题，报下面的错
   去_config.yml底下修改
   url: 你的github pages的链接
   root: /blog
   还有添加jsonContent的内容

   缺失模块。
   1、请确保node版本大于6.2
   2、在博客根目录（注意不是yilia根目录）执行以下命令：
   npm i hexo-generator-json-content --save
   
   3、在根目录_config.yml里添加配置：
   
     jsonContent:
       meta: false
       pages: false
       posts:
         title: true
         date: true
         path: true
         text: false
         raw: false
         content: false
         slug: false
         updated: false
         comments: false
         link: false
         permalink: false
         excerpt: false
         categories: false
         tags: true
   
   

5. 推荐想使用hexo的多看看这个文档，非常详细记录了你将遇到的坑cloudy

参考连接

[1]https://hexo.io/zh-cn/docs/commands.html
[2]https://zhuanlan.zhihu.com/p/98427357
[3]https://github.com/litten/hexo-theme-yilia
[4]https://www.jianshu.com/p/390f202c5b0e
[5]https://blog.csdn.net/qq_29347295/article/details/79005154
[6]cloudy