Explications dans le README

This commit is contained in:
vincent 2022-09-25 16:21:42 +02:00
parent 4f9f86a32b
commit 125d5031a5
1 changed files with 15 additions and 0 deletions

View File

@ -17,3 +17,18 @@ aws s3 sync ./public s3://guide.deuxfleurs.fr
```bash
zola serve
```
#### Classement mixte
Pour le sommaire à gauche de l'écran, le souhait est apparu de pouvoir classer pages et sections entre elles sans distinction. C'est normalement impossible car Zola tient deux listes distinctes : d'un côté une liste des pages classées entre elles, et de l'autre une liste des sections classées entre elles. Et une fois les classements faits par Zola, il est impossible d'accéder aux poids attribués aux pages et sections.
Pour contourner cette limitation, on utilise une variable `weight_custom`. Si l'on veut classer des pages et sections entre elles, on doit pour chacune la définir dans une section `extra`, comme ceci :
```
+++
title = "titre de l'article"
description = "description de l'article"
[extra]
weight_custom = 4
+++
```
Pour les sections, cette variable doit être définie dans son fichier `_index.md`. Si **et seulement si** toutes les pages et sous-sections d'une section ont cette variable, alors le classement mélangé s'opère pour le contenu de cette section (et les variables classiques `weight` sont ignorées si elles existent).