view piecrust/resources/helptopics/routes_routes_config.txt @ 1144:9f3e702a8a69

bake: Give unique source specs to each taxonomy or blog archive page. This prevents caching issues in some situations, leading to one tag page reusing the data from a previous tag page.
author Ludovic Chabant <ludovic@chabant.com>
date Tue, 05 Jun 2018 22:05:46 -0700
parents 6462c4a87532
children
line wrap: on
line source

Routes are specified in the `site/routes` configuration section of your website. This should be a list, where each item is a mapping with the following entries:

url: The URL pattern for the route.
source: The name of the source this route is for.
func (optional): The name of a templating function you can use to generate URLs for this route.

The URL pattern typically includes placeholders for information obtained by the source, like a blog post's date and slug. For example:

site:
  routes:
    - url: /myblog/%year%/%month%/%slug%
      source: posts

To know which placeholders are available, see `chef help routes_params`.