zola/docs/content/documentation/templates/pages-sections.md

144 lines
4.8 KiB
Markdown
Raw Normal View History

+++
title = "Sections and Pages"
weight = 20
+++
Templates for pages and sections are very similar.
## Page variables
2018-10-18 21:09:32 +00:00
Zola will try to load the `templates/page.html` template, the `page.html` template of the theme if one is used
or render the built-in template (a blank page).
Whichever template you decide to render, you will get a `page` variable in your template
with the following fields:
```ts
// The HTML output of the Markdown content
content: String;
title: String?;
description: String?;
date: String?;
// `updated` will be the same as `date` if `date` is specified but `updated` is not in front-matter
updated: String?;
slug: String;
path: String;
2017-11-01 13:53:28 +00:00
draft: Bool;
2017-10-31 15:41:31 +00:00
// the path, split on '/'
components: Array<String>;
permalink: String;
summary: String?;
taxonomies: HashMap<String, Array<String>>;
extra: HashMap<String, Any>;
toc: Array<Header>,
// Naive word count, will not work for languages without whitespace
word_count: Number;
// Based on https://help.medium.com/hc/en-us/articles/214991667-Read-time
reading_time: Number;
2018-07-29 20:53:42 +00:00
// `earlier` and `later` are only populated if the section variable `sort_by` is set to `date`
// and only set when rendering the page itself
2018-07-29 20:53:42 +00:00
earlier: Page?;
later: Page?;
// `heavier` and `lighter` are only populated if the section variable `sort_by` is set to `weight`
// and only set when rendering the page itself
2018-07-29 20:53:42 +00:00
heavier: Page?;
lighter: Page?;
// Year/month/day is only set if the page has a date and month/day are 1-indexed
year: Number?;
month: Number?;
day: Number?;
2018-06-25 17:13:21 +00:00
// Paths of colocated assets, relative to the content directory
assets: Array<String>;
// The relative paths of the parent sections until the index onef for use with the `get_section` Tera function
// The first item is the index section and the last one is the parent section
// This is filled after rendering a page content so it will be empty in shortcodes
ancestors: Array<String>;
// The relative path from the `content` directory to the markdown file
relative_path: String;
// The language for the page if there is one. Default to the config `default_language`
lang: String;
2019-01-04 19:31:31 +00:00
// Information about all the available languages for that content
translations: Array<TranslatedContent>;
```
## Section variables
2018-10-18 21:09:32 +00:00
By default, Zola will try to load `templates/index.html` for `content/_index.md`
and `templates/section.html` for other `_index.md` files. If there isn't
one, it will render the built-in template (a blank page).
Whichever template you decide to render, you will get a `section` variable in your template
with the following fields:
```ts
// The HTML output of the Markdown content
content: String;
title: String?;
description: String?;
path: String;
2017-10-31 15:41:31 +00:00
// the path, split on '/'
components: Array<String>;
permalink: String;
extra: HashMap<String, Any>;
// Pages directly in this section, sorted if asked
2019-12-26 12:55:54 +00:00
pages: Array<Page>;
// Direct subsections to this section, sorted by subsections weight
// This only contains the path to use in the `get_section` Tera function to get
// the actual section object if you need it
subsections: Array<String>;
toc: Array<Header>,
// Unicode word count
word_count: Number;
// Based on https://help.medium.com/hc/en-us/articles/214991667-Read-time
reading_time: Number;
2018-08-10 13:59:03 +00:00
// Paths of colocated assets, relative to the content directory
assets: Array<String>;
// The relative paths of the parent sections until the index onef for use with the `get_section` Tera function
// The first item is the index section and the last one is the parent section
// This is filled after rendering a page content so it will be empty in shortcodes
ancestors: Array<String>;
// The relative path from the `content` directory to the markdown file
relative_path: String;
// The language for the section if there is one. Default to the config `default_language`
lang: String;
2019-01-04 19:31:31 +00:00
// Information about all the available languages for that content
translations: Array<TranslatedContent>;
```
## Table of contents
Both page and section templates have a `toc` variable that corresponds to an array of `Header`.
A `Header` has the following fields:
```ts
2017-10-01 03:51:43 +00:00
// The hX level
level: 1 | 2 | 3 | 4 | 5 | 6;
2017-10-01 03:51:43 +00:00
// The generated slug id
id: String;
2017-10-01 03:51:43 +00:00
// The text of the header
title: String;
2017-10-01 03:51:43 +00:00
// A link pointing directly to the header, using the inserted anchor
permalink: String;
2017-10-01 03:51:43 +00:00
// All lower level headers below this header
children: Array<Header>;
```
2019-01-04 19:31:31 +00:00
## Translated content
Both pages and sections have a `translations` field that corresponds to an array of `TranslatedContent`. If your
site is not using multiple languages, this will always be an empty array.
`TranslatedContent` has the following fields:
2019-01-04 19:31:31 +00:00
```ts
// The language code for that content, empty if it is the default language
lang: String?;
// The title of that content if there is one
title: String?;
// A permalink to that content
permalink: String;
// The path to the markdown file; useful for retrieving the full page through
// the `get_page` function.
path: String;
2019-01-04 19:31:31 +00:00
```