Taxonomy / Term Pages

Taxonomy Parameter

Front Matter The list of taxonomies is displayed using the pages shortcode. By default the output is grouped by the first letter of each term but you can overwrite any parameter of the pages shortcode in the pages front matter.

​
+++
[params]
  [params.pages]
    display = 'cards'
    groupby = ' '
+++
---
params:
  pages:
    display: cards
    groupby: ' '
---
{
   "params": {
      "pages": {
         "display": "cards",
         "groupby": " "
      }
   }
}

For example in this docs the Categories taxonomy does not show a grouped list like in the default (compare to the Tags taxonomy) but some neat cards.

Term Parameter

Front Matter The list of pages of a term is displayed using the pages shortcode. You can overwrite any parameter of the pages shortcode in the pages front matter. Use a cascade configuration on your taxonomy page to inherit parameter down to every term page.

​
+++
[[cascade]]
  [cascade.params]
    [cascade.params.pages]
      breadcrumb = false
      description = true
+++
---
cascade:
- params:
    pages:
      breadcrumb: false
      description: true
---
{
   "cascade": [
      {
         "params": {
            "pages": {
               "breadcrumb": false,
               "description": true
            }
         }
      }
   ]
}

For example in this docs the term pages of the Categories taxonomy do not show their breadcrumbs like in the default but the description of the page.

Note

Before the pages shortcode existed, these parameters were set in the children front matter. It is still honored as long as the deprecated children shortcode exists.