Hexo Quick Guide

Posted on Edited on In , Views: Word count in article: 228 Reading time ≈ 1 mins.

Short reference for my Hexo/NexT workflow.

Official Site: https://hexo.io/
Version: 8.1.0

Workflow

With Git deployment

1
2
3
4
5
6
7
$ hexo new "My New Article"
# Edit source/_posts/My-New-Article.md
$ hexo clean
$ hexo generate
$ git add -A
$ git commit -m <msg>
$ git push

Maintenance

Update outdated npm packages. With npm-check-updates, run the following under the blog directory (./):

1
2
$ ncu -u
$ npm install

Configuration

Site config is stored in ./_config.yml

Theme

Configuration

Configuration priority (from high to low):

  • theme_config in site’s primary configuration file
  • _config.[theme].yml file
  • _config.yml file under the theme directory

NexT

GitHub
Documentation
Version: 8.27.0

Configuration

NexT theme config is stored in ./_config.next.yml & node_modules/hexo-theme-next/_config.yml

Code Highlight Theme

NexT Highlight Theme Preview

Legacy Repositories

Usage

Tag Plugins

Referencing images or other assets using normal markdown syntax and relative paths may lead to incorrect display on archive or index pages. Plugins have been created by the community to address this issue in Hexo 2.

Include Code

Warning

include_code only works with .js files in Hexo 8.1.0, seems like a bug

1
{% include_code [title] [lang:language] [from:line] [to:line] path/to/file %}

Include Posts

1
{% post_link filename [title] [escape] %}

Include Assets

1
2
3
{% asset_path filename %}
{% asset_img [class names] slug [width] [height] [title text [alt text]] %}
{% asset_link filename [title] [escape] %}