view piecrust/resources/helptopics/routes_routes_config.txt @ 1195:ae9387338db1 draft default tip

admin: add option to publish immediately
author Ludovic Chabant <ludovic@chabant.com>
date Fri, 30 Dec 2022 16:48:04 -0800
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`.