hexo-auto-front-matter

Generate hexo front-matter for every post automatically.

As a Hexo user, you must be troubled with front matter setting for each post. With this plugin, you don't need to set title, date, categories, tags, cover one by one. hexo-auto-front-matter generates static post front-matter automatically based on directory/folder name, date of now and customized configuration.

Features

• Fully integrated all the functions of hexo-auto-category.
• Automatically generate front-matter title from filename when it's empty.
• Automatically generate front-matter date from now when it's empty.
• Automatically append all categories to tags when the tags field is empty.
• Automatically generate front-matter cover image path from the customized list by choose deepest nested category.
• Flexible control: every sub module has independent swith.
• Support keep original front-matter order or sort by customized order list.

Installation

npm install hexo-auto-front-matter --save

Configuration

You can configure this plugin in Hexo _config.yml

# https://github.com/RayKr/hexo-auto-front-matter
auto_front_matter:
  enable: true
  # Whether to keep the original front-matter order
  # `order` is a list, which is empty by default. In this case, the updated front-matter field keeps the order in the original text.
  # When order is not empty, front-matter will be sort by the order, support less or more than the real nums of original post front-matter.
  order:
    # - title
    # - date
    # - categories
    # - tags
    # - cover
    # - description

  # Auto add title from filename
  auto_title:
    enable: true
    # Use `mode` to control Write only if title is empty, or overwrite allways.
    # 1: auto add title only empty (default) 
    # 2: overwrite allways
    mode: 1

  # Auto add date of now if empty
  auto_date:
    enable: true
  
  # Logic same as auto_category
  # https://github.com/xu-song/hexo-auto-category
  auto_categories:
    enable: true
    multiple: false
    depth:

  # Auto append categories list to tags when tags is empty
  auto_tags:
    enable: true

  # Auto add cover image path from `per_category` list
  auto_cover:
    enable: true
    # define per category's cover image path
    # It will choose the deepest category match when exist nested categories.
    per_category:
      # - Hexo: /img/xxxx.png

Build & preview

hexo clean && hexo g && hexo s

Demo

All the front-matter in 天澄拾光 are generated automatically by hexo-auto-front-matter.

Thanks

• hexo-auto-category
• hexo-front-matter