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.
23 lines
952 B
23 lines
952 B
7 years ago
|
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.
|