Hexo 简介和使用手册

概述

Hexo 是一个快速、简洁且高效的博客框架。它基于 NodeJs 开发,支持 MarkDown 等多种渲染引擎, 可以快速生成静态网页。
Hexo 也支持多种主题和插件。

安装

详细信息可另行参考 Hexo 官方手册

依赖

  • NodeJS (Node.js 版本需不低于 10.13,建议使用 Node.js 12.0 及以上版本)
  • Git

安装 Hexo

$ npm install -g hexo-cli

初始化项目

安装好 Hexo 后,需要使用 Hexo 的命令新建项目,生成项目文件夹,包括配置文件、脚本、辅助工具、模板、主题等。

1
2
3
$ hexo init <folder>
$ cd <folder>
$ npm install

配置

在 _config.yml 中配置 Markdown 属性,禁止将回车转换为 <br>:

1
2
3
4
...
markdown:
breaks: false
...

支持数学表达式

更换 Hexo 的 markdown 渲染引擎,hexo-renderer-kramed引擎是在默认的渲染引擎hexo-renderer-marked的基础上修改了一些 bug,两者比较接近,也比较轻量级。

1
2
$ npm uninstall hexo-renderer-marked --save  # 卸载原引擎
$ npm install hexo-renderer-kramed --save # 安装新引擎

生成和部署

1
2
3
$ hexo clean
$ hexo generate
$ hexo deploy