/index.md`). #### sortby The order of pages in a _Section_ can be changed. Available values are: - `date`: more recent first - `title`: alphabetic order - `weight`: lightest first _Example:_ ```yaml --- sortby: title --- ``` **More options:** ```yaml --- sortby: variable: date # "date", "updated", "title" or "weight" desc_title: false # used with "date" or "updated" variable value to sort by desc title order if items have the same date reverse: false # reversed if true --- ``` #### pagination The global [pagination configuration](4-Configuration.md#pages-pagination) is used by default, but you can change it for a specific _Section_. _Example:_ ```yaml --- pagination: max: 5 path: "page" pagination: false --- ``` #### cascade Any variables in `cascade` are added to the front matter of all _sub pages_. _Example:_ ```yaml --- cascade: banner: image.jpg --- ``` :::info Existing variables are not overridden. ::: #### circular Set `circular` to `true` to enable circular navigation with [_page._](3-Templates.md#page-prev-next). _Example:_ ```yaml --- circular: true --- ``` ### Home page Like another section, _Home page_ support `sortby` and `pagination` configuration. #### pagesfrom Set a valid _Section_ name in `pagesfrom` to use pages collection from this _Section_ in _Home page_. _Example:_ ```yaml --- pagesfrom: blog --- ``` ### excluded Set `excluded` to `true` to hide a page from list pages (i.e.: _Home page_, _Section_, _Sitemap_, etc.). _Example:_ ```yaml --- excluded: true --- ``` :::info `excluded` is different from [`published`](#predefined-variables): an excluded page is published but hidden from list pages. ::: :::warning Since version 8.49.0, the previous `exclude` variable have been changed to `excluded`. ::: ## Multilingual If your pages are available in multiple [languages](4-Configuration.md#languages) there is 2 different ways to define it: ### Through file name This is the common way to translate a page from the main [language](4-Configuration.md#language) to another language. You just need to duplicate the reference page and suffix it with the target language `code` (e.g.: `fr`). _Example:_ ```plaintext ├─ about.md # the reference page └─ about.fr.md # the french version (`fr`) ``` :::tip You can change the URL of the translated page with the `slug` variable in the front matter. For example: ```yml --- slug: a-propos --- # about.md -> /about/ # about.fr.md -> /fr/a-propos/ ``` ::: ### Through front matter If you want to create a page in a language other than the main language, without it being a translation of an existing page, you can use the `language` variable in its front matter. _Example:_ ```yml --- language: fr --- ``` ### Link translated pages Each translated page reference the pages in others languages. Those pages collection is available in [templates](3-Templates.md#page) with the following variable: ```twig {{ page.translations }} ``` :::info The `langref` variable is provided by default, but you can change it in the front matter: ```yml --- langref: my-page-ref --- ``` ::: ## Dynamic content With this **_experimental_** feature you can use **[variables](3-Templates.md#variables)** and **shortcodes** in the [body](#body). :::important To do this you must include a specific template: ```twig {{ include(page.content_template) }} ``` (instead of `{{ page.content }}`) ::: ### Display variables Front matter variables can be use in the body with the template’s syntax `{{ page.variable }}`. _Example:_ ```twig -- var: 'value' --- The value of `var` is {{ page.var }}. ``` > Experimental ### Shortcodes Shortcodes are helpers to create dynamic content. > Experimental #### Built-in shortcodes 2 shortcodes are available by default: ##### YouTube ```twig {{ shortcode.youtube(id) }} ``` - `id`: YouTube video ID _Example:_ ```twig {{ shortcode.youtube('NaB8JBfE7DY') }} ``` ##### GitHub Gist ```twig {{ shortcode.gist(user, id) }} ``` - `user`: GitHub user name - `id`: Gist ID _Example:_ ```twig {{ shortcode.gist('ArnaudLigny', 'fbe791e05b93951ffc1f6abda8ee88f0') }} ``` #### Custom shortcode A shortcode is a [Twig macro](https://twig.symfony.com/doc/tags/macro.html) you must add in a template named `shortcodes.twig`. _Example:_ `shortcodes.twig`: ```twig {% extends 'extended/macros.twig' %} {% block macros %} {# the "foo" shortcode #} {% macro foo(bar = 'bar') %} {{ bar }} {% endmacro %} {% endblock %} ```