Hexo备忘

点击 文档 & 故障排除 & GitHub 了解更多

一、常用

1. 文章

①新建文章

1

$ hexo new "My New Post"

详情：Writing

②文章封面

配置headimg

1

headimg: 图片url

③置顶文章

配置pin

1

pin: true

④参考资料

1
2
3

references:
 - title: 某篇文章
  url: https://

2. 网站

①本地预览网站

1
2

$ hexo server
$ hexo s

详细：Server

②生成静态网站

1
2

$ hexo generate
$ hexo g

详细：Generating

③网站部署到服务器

1
2

$ hexo deploy
$ hexo d

详细：Deployment

④生成部署二合一

1

$ hexo g -d

二、备忘

1. 默认配置文件地址

1

blog\node_modules\hexo-theme-volantis\

2. 改动

1
2

logo: # choose [img] or [icon + title]
img: ...

1
2

sidebar:
  position: left # left right

关于出现报错ERROR Script load failed:什么什么什么.js Error: Cannot find module 'xxxx' 示例：报错Error: Cannot find module hexo-util“ 执行命令npm install hexo-util --save

1

npm install xxxx --save

3. markdown使用

参考官方文档

问题

1. hexo自带md解析器不解析扩展语法（注释等）

解决：

​ 参考文献

• hexo-renderer-pandoc 插件

Hexo 默认的渲染器为 marked (hexo-renderer-marked)，仅支持 md 的基本规范。Pandoc 也可以实现在 gitlab 自动部署，查看.gitlab-ci.yml文件设置。

本地 hexo 博客的搭建：

1. 安装 pandoc

2. 卸载 hexo-renderer-marked，安装 hexo-renderer-pandoc

   1 2	npm un hexo-renderer-marked --save npm install hexo-renderer-pandoc --save

由于 hexo-renderer-pandoc 更新加入了 template 设置，需要在站点配置文件 ~/blog/_config.yml 中加入默认配置（issues）。

考虑到图片块解析错误，建议添加 -implicit_figures 选项。

1
2
3
4
5
6
7
8
9

pandoc:
  pandoc_path: C:\Users\Asuka\AppData\Local\Pandoc\pandoc.exe
  filters:
  extra:
  template:
  meta:
  mathEngine:
  extensions:
    - '-implicit_figures'

• volantis启用 MathJax

  页面配置 front-matter

1
2
3
4
5
6

---
title: 渲染公式（MathJax）
date: 2020-02-23
plugins:
  - mathjax
---