Taxonomy Variable Value

``archive`` ``overview_page_variable_name`` ``archive``

``author`` ``overview_page_variable_name`` ``authors``

``category`` ``overview_page_variable_name`` ``categories``

``category`` ``overview_page_items_variable_name`` ``cat_items``

``category`` ``overview_page_hierarchy_variable_name`` ``cat_hierarchy``

``index`` ``overview_page_variable_name`` unavailable (None)

``page_index_folder`` ``overview_page_variable_name`` ``page_folder``

``section_index`` ``overview_page_variable_name`` ``sections``

``tag`` ``overview_page_variable_name`` ``tags``

``tag`` ``overview_page_items_variable_name`` ``items``

Templates and settings used by taxonomies

.. class:: table table-bordered table-striped

Taxonomy Has hierarchy List (one classification) template Index (one classification) template Overview (list of classifications) template Subcategories list template List is an index Show as list of subcategories

(default settings) no tagindex.tmpl tagindex.tmpl list.tmpl taxonomy_list.tmpl (does not exist) no no

``archive`` yes (0-3 levels) list_post.tmpl archiveindex.tmpl list.tmpl list.tmpl ``ARCHIVES_ARE_INDEXES`` ``not CREATE_FULL_ARCHIVES``

``author`` no author.tmpl authorindex.tmpl authors.tmpl n/a ``AUTHOR_PAGES_ARE_INDEXES`` no

``category`` yes tag.tmpl tagindex.tmpl tags.tmpl (with tags) n/a ``CATEGORY_PAGES_ARE_INDEXES`` n/a

``index`` no n/a index.tmpl n/a n/a yes no

``page_index_folder`` yes list.tmpl n/a n/a n/a no no

``section_index`` no list.tmpl sectionindex.tmpl n/a n/a ``POSTS_SECTIONS_ARE_INDEXES`` no

``tag`` no tag.tmpl tagindex.tmpl tags.tmpl (with categories) n/a ``TAG_PAGES_ARE_INDEXES`` no

Hierarchy-related variables are available if and only if ``has_hierarchy`` is True.

``<overview_page_items_variable_name>`` list List of items **(name, link)**

``<overview_page_items_variable_name + "_with_postcount">`` list List of items **(name, link, number of posts)**

``<overview_page_hierarchy_variable_name>`` list? List of hierarchies **(name, full name, path, link, indent levels, indent to change before, indent to change after)**

``<overview_page_hierarchy_variable_name + "_with_postcount">`` list? List of hierarchies, with added counts **(name, full name, path, link, indent levels, indent to change before, indent to change after, number of children, number of posts)**

Hierarchical lists

The indenting information can be used to render the items as a tree. The values have the following meanings:

* ``indent levels`` is a list of pairs ``(current_i, count_i)`` giving the current position (``0``, ..., ``count_i-1``) and maximum (``count_i``) in the hierarchy level ``i``;

* ``indent to change before`` is the difference of hierarchy levels between the previous and the current item; positive values indicate that the current item is indented further in and can be used to open HTML tags before the item;

* ``indent to change after`` is the difference of hierarchy levels between the current and the next item; negative values indicate that the current item is indented further in and can be used to close HTML tags after the item.

Example:

.. code:: text

See ``tags.tmpl`` in the base themes for examples on how to render a tree as nested unordered lists in HTML.

For more details about hierarchies, see `Hierarchical lists`_

subcategories_list_template = "taxonomy_list.tmpl"