Si vous avez bien lu la précédente section, vous savez donc que le contenu se trouve dans le répertoire sites/monsite/pages
Le contenu est une collection de répertoires et de pages au format markdown.
Le contenu de la page d'accueil se situe à la racine du répertoire pages. On le nomme généralement home.md
Ensuite, on peut créer autant de répertoires et de sous-répertoires que l'on souhaite.
Je vous invite à étudier le contenu du site "example" (sites/example/pages). Parfois un exemple vaut mieux qu'un long discours.
Voici l'exemple de la structure de mon site (un peu simplifiée) :
pages
|
|____ blog
| |
| |___ article-a
| | |
| | |____ page.md
| |
| |___ article-b
| |
| |____ page.md
|
|____ mes-projets
| |
| |____ page.md
|
|____ mes-prestations
| |
| |____ page.md
|
|
|____ me-suivre
| |
| |____ page.md
|
|
|____ on-parle-de-mon-travail
| |
| |____ page.md
|
|
|____ fruga
| |
| |____ doc
| |
| |____ fr
| |
| |____ introduction
| | |
| | |____ page.md
| |
| |____ commencer
| | |
| | |____ page.md
| |
| |____ indexdocfr.md
|____ mentions-legales
| |
| |____ page.md
|
|
|____ politique-de-confidentialite
| |
| |____ page.md
|
|
|_____ home.mdLes répertoires
Ce sont les répertoires qui vont permettre de créer la structure du site.
Par défaut, ils vont même définir automatiquement l'URL d'accès à la ressource (nous verrons qu'il est possible de surcharger ce comportement). Par exemple, l'accès à la ressource "commencer" au bout de la branche "fruga" se fera par l'URL contenant /fruga/doc/fr/commencer/
Il est aussi possible de les précéder d'un compteur. Par exemple "01.introduction", "02.commencer". Ce compteur n'apparaitra pas dans l'URL mais permettra de réaliser un classement manuel sur une page de listing par exemple. C'est d'ailleurs ce qui est réalisé sur la page indexdocfr.md que vous pouvez voir ici.
Les fichiers markdown
Les fichiers markdown doivent se terminer par l'extension .md et se situent au sein des répertoires. On ne peut aujourd'hui n'avoir qu'un seul fichier .md par répertoire.
Vous avez probablement remarqué qu'ils n'ont pas toujours le même nom. On peut voir dans mon exemple home.md, page.md, indexdocfr.md.
Ce nom permettra de faire un lien avec le thème. En effet, il sera possible d'avoir des modèles de pages différents.
Par exemple, toutes les pages de mon blog, les pages d'informations de mon site, ont le format "page". Si vous regardez https://yoandemacedo.com/mes-projets/ ou https://yoandemacedo.com/blog/pourquoi-site-statique/, vous verrez qu'elles ont la même structure.
La page affichant les différentes sections de la documentation fruga aura le format "indexdocfr".
La page d'accueil aura le format "home".
Nous verrons dans une prochaine section comment fonctionne les thèmes.
Passons maintenant au contenu de la page markdown.
La page d'accueil de mon site, home.md, commence comme ceci :
---
title: 'Yoan De Macedo'
---
Passionné par le web depuis mes débuts sur la toile avec mon modem 33.6k, j'en ai fait mon métier.La première section, délimitée par 3 tirets puis suivie d'un saut de ligne, c'est l'en-tête du fichier.
La seconde section, c'est le contenu de la page. Ce contenu pourra utiliser du markdown.
Différents mots clés peuvent être utilisés dans la première section. Ils pourront ensuite être utilisés dans le thème.
Une liste préfinie existe (elle est amenée à évoluer) :
Nous verrons dans la section thème comment les utiliser.
Arrêtons nous sur le mot clé "slug". Je vous expliquais précédemment comment l'URL d'accès à une page est générée via le chemin menant à celle-ci (à l'aide des noms de répertoires).
Il est possible de surcharger celle-ci et de ne pas utiliser forcément le nom du répertoire.
Si dans la section en-tête de la page indexdocfr.md, j'ajoute :
slug: 'frenchy' alors la page ne sera plus accessible via l'URL contenant /fruga/doc/fr/commencer/ mais /fruga/doc/frenchy/commencer/
Vous pouvez aussi ajouter d'autres mots clés comme vous le souhaitez et les utiliser dans le thème.
Si vous connaissez mal le format markdown, vous aurez des infos très intéressantes ici : https://www.markdownguide.org/basic-syntax/