zthxxx / hexo-directory-category

Automatically add category to Hexo article according to the article file directory.
MIT License
43 stars 4 forks source link
categories category directory hexo hexo-plugin plugin

hexo-directory-category

Build Status Coverage Status NPM Version npm downloads GitHub release

Automatically add front-matter categories to Hexo article according to the article file directory.

Directory is means relative form article file path to Hexo source _posts folder.

Features

Install

$ cd <your-hexo-site>
$ npm install --save hexo-directory-category

Options

You can configure this plugin in site _config.yml.

auto_dir_categorize:
    enable: true  # options:true, false; default is true
    force: false # options:true, false; default is false

Example

1. enable: true, force: false

# file: ./_posts/Linux/Vim/note/test.md
...
categories: [CS, Usage]
tags: [...]

# After hexo generate, it will nothing Conversion. categories: [CS, Usage]
# file: ./_posts/Linux/Vim/note/test.md
...
# categories: [...]
tags: [...]

# After hexo generate, it will convert to categories: [Linux, Vim, note]

2. enable: true, force: true

# file: ./_posts/Linux/Vim/note/test.md
...
categories: [CS, Usage]
tags: [...]

# After hexo generate, it also will convert to categories: [Linux, Vim, note]

License

MIT LICENSE