Hexo

一个把markdown文件渲染成静态网页的框架。
可以作为博客、网页展示、文档等。
运行于Node.js（javascript独立于浏览器外的运行环境）。
官网：https://hexo.io/

安装

Node.js (Node.js 版本需不低于 10.13，建议使用 Node.js 12.0 及以上版本)
Git(hexo初始化的模板需要从github上down)

$ npm install -g hexo-cli

建站

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

新建完成后，指定文件夹的目录如下：
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

_config.yml配置

替代配置文件

hexo server --config custom.yml

不需要渲染的文件夹

在source下面新建一个文件夹html

_config.yml配置如下
忽略渲染html文件夹

skip_render:
  - "html/**"

重新编译发布

$ hexo generate
$ hexo deploy

发现多了个html结构

常用命令

新建一篇文章。如果没有设置 layout 的话，默认使用_config.yml中的 default_layout参数代替。

hexo new [layout] <title>

生成静态文件

$ hexo generate
$ hexo generate --watch  #监测文件变化

发表草稿

$ hexo publish [layout] <filename>

启动服务器

hexo server

部署到Git

安装hexo-deployer-git

npm install hexo-deployer-git --save

修改配置

deploy:
  type: git
  repo: <repository url>
  branch: [branch]

部署网站

hexo deploy

主题安装

下载fluid主题
https://github.com/fluid-dev/hexo-theme-fluid/releases/tag/v1.8.10
在themes文件夹中解压，文件夹重命名为fluid,主题相关配置去themes\fluid下面的配置文件修改。

激活主题，修改_config.yml配置文件

theme: fluid

常见问题

err: YAMLException: can not read a block mapping entry; a multiline key may not be an implicit key at line 4, column 1
文章中title、date、tags等标签：后面一定要有空格。不然hexo g的时候会报错。