forked from varia/varia.website
many many many Varia's websites, work in progress: https://many.vvvvvvaria.org
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
mb@mb
04c2824180
|
7 years ago | |
|---|---|---|
| .. | ||
| README.md | 7 years ago | |
| __init__.py | 7 years ago | |
| category_meta.py | 7 years ago | |
README.md
Category Metadata
A plugin to read metadata for each category from an index file in that category's directory.
For this plugin to work properly, your articles should not have a Category: tag in their metadata; instead, they should be stored in (subdirectories of) per-category directories. Each per-category directory must have a file named 'index.ext' at its top level, where .ext is any extension that will be picked up by an article reader. The metadata of that article becomes the metadata for the category, copied over verbatim, with three special cases:
- The category's name is set to the article's title.
- The category's slug is set to the name of the parent directory of the index.ext file.
- The text of the article is stored as category.description.
You can use this, for example, to control the slug used for each category independently of its name, or to add a description at the top of each category page.