The tags
and categories
provided in the pages’ YAML headers allow accessing the pages through the listing pages (for the respective tag, category). Templates for those listing pages are provided in the source code /_templates
directory.
_categories.md
and _categories-date-sorted.md
_tags
and _tags-date-sorted.md
Those templates can be copied in the source /tags
or /categories
directories, and be renamed to reflect the tag or category they should serve (e.g. “news.md”).
The script is just a helper for
_config.yml
or template changesIt loads the _config.yml
file to determine which tags, categories are needed and creates the appropriate listing pages from the templates (see above and the header page). The script also creates the collections
directories if missing (e.g. /pages/_doc/
from the collections.doc
entry in _config.yml
.
As listed above, two types of templates exist - one with alphabetic sorting (standard), and one for time sorted tags and categories. Alphabetical sorting is standard; the time sorted can be selected in the configuration file:
# The categories-date-sorted parameter determines the selection of a
# time sorted, year labeled listing template for those categories.
categories-date-sorted:
- news
- minutes
# As above, for tags:
tags-date-sorted:
- press