Appendix 2: Page Configuration Reference

This is a list of the settings handled by PieCrust in a page’s configuration header.

  • blog: Alias of the source setting, to make it easier to remember when using the default content model.

  • cache_time: Specifies the value for the Cache-Time HTTP header when this page is served in CMS mode.

  • category: Specifies the optional category that the page is part of. This is not strictly speaking used by PieCrust itself, but is used by the default content model.

  • content_type: Specifies the value for the Content-Type HTTP header when this page is served in CMS mode.

  • date: Sets the date of the page. Note that some sources, like the blog posts sources, already set the date using the page’s filename.

  • format: Specifies what formatter to use to render this page. Defaults to site/default_format, which defaults to Markdown. For a list of valid formatter names, see the formatters reference.

  • items_per_page: Defines how many items to include per page when using the pagination data endpoint.

  • layout: Specifies what layout to use to render this page. Defaults to default.

  • posts_per_page: Alias of the items_per_page setting.

  • source: Defines what page source to use with the pagination data endpoint.

  • tags: An array of strings that represents labels the page is part of. This is not strictly speaking used by PieCrust itself, but is used by the default content model.

  • template_engine: Specifies the template engine to use to render this page. Defaults to site/default_template_engine, which defaults to Jinja2.

  • title: Defines the title of the page. This is not strictly speaking used by PieCrust itself, but is used by the default theme.

  • time: Sets the time of the page. This can be used to complement the date setting, whether it was set through the configuration header, or by the source.