Ajouter des pages

Où placer les fichiers

Ajoutez des fichiers .html ou .md dans le dossier www. La page ne contient que le contenu : la source indique de ne pas y mettre les balises de structure du document. Le texte publié a perdu ces noms de balises.

Le premier fichier d’un dossier doit s’appeler index.md ou index.html. L’un des deux doit être présent pour que le dossier soit considéré comme publiable.

Markdown et liens

Une page Markdown commence par un titre, puis le contenu, y compris un lien. Les URL vers d’autres pages se donnent sans l’extension .html, par exemple /home/link.

Titre

Le premier bloc de titre, s’il est présent, devient le titre de la page, sauf s’il est déjà fixé par une balise spéciale. Sans titre, le nom du fichier est utilisé. Les noms exacts des balises ont été retirés du texte publié.

CSS

Un fichier .css du même nom, par exemple index.css pour index.md, est rendu avec la page.

Balises spéciales

La source en décrit quatre effets, sans que le libellé des balises survive dans le Markdown publié :

1. faire rendre la page en Jinja ;
2. ajouter un titre personnalisé ;
3. ne pas afficher le fil d’Ariane ;
4. activer le cache, si la page utilise Jinja.

Point d’attention

Sans index.md ni index.html, le dossier n’est pas un dossier de pages valide. L’ordre d’affichage se règle à part, dans Ordre des pages.