/index.md`). #### sortby L’ordre des pages dans une _Section_ peut être modifié. Valeurs disponibles : - `date`: plus récentes en premier - `title`: ordre alphabétique - `weight`: plus léger en premier _Exemple :_ ```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 La [configuration globale de pagination](4-Configuration.md#pages-pagination) est utilisée par défaut, mais vous pouvez la modifier pour une _Section_ donnée. _Exemple :_ ```yaml --- pagination: max: 5 path: "page" pagination: false --- ``` #### cascade Toutes les variables de `cascade` sont ajoutées au front matter de toutes les _sous-pages_. _Exemple :_ ```yaml --- cascade: banner: image.jpg --- ``` :::info Les variables existantes ne sont pas écrasées. ::: #### circular Définissez `circular` à `true` pour activer la navigation circulaire avec [_page._](3-Templates.md#page-prev-next). _Exemple :_ ```yaml --- circular: true --- ``` ### Page d'accueil Comme une autre section, la _Page d'accueil_ prend en charge la configuration `sortby` et `pagination`. #### pagesfrom Définissez un nom de _Section_ valide dans `pagesfrom` pour utiliser la collection de pages de cette _Section_ dans la _Page d'accueil_. _Exemple :_ ```yaml --- pagesfrom: blog --- ``` ### excluded Définissez `excluded` à `true` pour masquer une page des pages de liste (c.-à-d. : _Home page_, _Section_, _Sitemap_, etc.). _Exemple :_ ```yaml --- excluded: true --- ``` :::info `excluded` est différent de [`published`](#predefined-variables) : une page exclue est publiée, mais masquée des pages de liste. ::: :::warning Depuis la version 8.49.0, l’ancienne variable `exclude` a été remplacée par `excluded`. ::: ## Multilingue Si vos pages sont disponibles en plusieurs [langues](4-Configuration.md#languages), il existe 2 façons différentes de le définir : ### Via le nom de fichier C’est la méthode la plus courante pour traduire une page depuis la [langue](4-Configuration.md#language) principale vers une autre langue. Il suffit de dupliquer la page de référence et de lui ajouter en suffixe le `code` de la langue cible (ex. : `fr`). _Exemple :_ ```plaintext ├─ about.md # the reference page └─ about.fr.md # the french version (`fr`) ``` :::tip Vous pouvez changer l’URL de la page traduite avec la variable `slug` dans le front matter. Par exemple : ```yml --- slug: a-propos --- # about.md -> /about/ # about.fr.md -> /fr/a-propos/ ``` ::: ### Via le front matter Si vous souhaitez créer une page dans une langue autre que la langue principale, sans qu’elle soit la traduction d’une page existante, vous pouvez utiliser la variable `language` dans son front matter. _Exemple :_ ```yml --- language: fr --- ``` ### Lier les pages traduites Chaque page traduite référence les pages dans les autres langues. Cette collection de pages est disponible dans les [templates](3-Templates.md#page) via la variable suivante : ```twig {{ page.translations }} ``` :::info La variable `langref` est fournie par défaut, mais vous pouvez la modifier dans le front matter : ```yml --- langref: my-page-ref --- ``` ::: ## Contenu dynamique Avec cette fonctionnalité **_expérimentale_**, vous pouvez utiliser des **[variables](3-Templates.md#variables)** et des **shortcodes** dans le [body](#body). :::important Pour cela, vous devez inclure un template spécifique : ```twig {{ include(page.content_template) }} ``` (au lieu de `{{ page.content }}`) ::: ### Afficher des variables Les variables du front matter peuvent être utilisées dans le body avec la syntaxe de template `{{ page.variable }}`. _Exemple :_ ```twig -- var: 'value' --- The value of `var` is {{ page.var }}. ``` > Experimental ### Shortcodes Les shortcodes sont des helpers pour créer du contenu dynamique. > Experimental #### Shortcodes intégrés 2 shortcodes sont disponibles par défaut : ##### YouTube ```twig {{ shortcode.youtube(id) }} ``` - `id`: ID de la vidéo YouTube _Exemple :_ ```twig {{ shortcode.youtube('NaB8JBfE7DY') }} ``` ##### GitHub Gist ```twig {{ shortcode.gist(user, id) }} ``` - `user`: nom d’utilisateur GitHub - `id`: ID du Gist _Exemple :_ ```twig {{ shortcode.gist('ArnaudLigny', 'fbe791e05b93951ffc1f6abda8ee88f0') }} ``` #### Shortcode personnalisé Un shortcode est une [macro Twig](https://twig.symfony.com/doc/tags/macro.html) que vous devez ajouter dans un template nommé `shortcodes.twig`. _Exemple :_ `shortcodes.twig`: ```twig {% extends 'extended/macros.twig' %} {% block macros %} {# the "foo" shortcode #} {% macro foo(bar = 'bar') %} {{ bar }} {% endmacro %} {% endblock %} ```