KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#codex #developer-tools #typescript #ai-agents #claude-code #dsh #dsh-plugin #python #mcp #react #cli #macos

hexo-auto-category

★ 109 Open GitHub ↗

Generate categories automatically for each post in Hexo

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**[🛠️Installation](#installation)** |
**[⚙️Configuration](#configuration)** |
**[🌐Demo](#demo)** |
**[📖CN中文文档](https://blog.eson.org/pub/e2f6e239/)** |

# hexo-auto-category

[Hexo](hexo.io) plugin, which generates categories automatically from folder structure for each post.

## Installation

```sh
$ npm install hexo-auto-category --save
```

## Configuration

You can configure this plugin in Hexo `_config.yml`

```yml
# Generate categories from directory-tree
# Dependencies: https://github.com/xu-song/hexo-auto-category
# depth: the max_depth of directory-tree you want to generate, should > 0
# multiple: multiple category hierarchies
auto_category:
 enable: true
 multiple: false
 depth: 
```

build & preview
```sh
$ hexo clean && hexo g && hexo s
```

## Example

The generated categories for post `source/_post/web/framework/hexo.md` is as follows:

```yml
categories:
  - web
  - framework
```

If  you set `multiple: true`, the generated categories for post `source/_post/web/framework/hexo.md` is as follows:

```
categories:
  - - web
  - - framework
```

See more information about multiple category:

https://hexo.io/docs/front-matter.html#Categories-amp-Tags

## Demo

All the categories in [ESON's Blog](https://blog.eson.org/) are generated automatically by [`hexo-auto-category`](https://github.com/xu-song/hexo-auto-category).

## Background

As a Hexo user, you must be troubled with [front matter](https://hexo.io/zh-cn/docs/front-matter.html) setting for each post.
With this plugin, you don't need to set `categories` one by one.
`hexo-auto-category` generates static post `categories` automatically based on directory/folder name.

## Warning

Your original categories will be **overwriten**.

hexo-auto-category

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README