Comment créer une page statique

Pour créer une page statique, créez un nouveau fichier .md dans le dossier public/pages. Seule l'extension du fichier est importante, vous pouvez le nommer comme vous voulez.

Les pages statiques sont rédigées au format Markdown, tout comme ce fichier. Pour un résumé de la syntaxe, vous pouvez consulter ce site.

Pour être considérée valide, toute page doit commencer par un entête au format suivant :

---
title: Titre de la page
path: url-de-la-page
---

Paramètre	Description
`title`	Titre de la page affiché dans l'onglet du navigateur. Le titre principal de la page peut être géré séparément en ajoutant un tag `#` dans le contenu du fichier.
`path`	URL de la page. Veuillez faire attention de ne pas utiliser un URL déjà existant dans l'application, ou la page d'origine ne sera plus accessible.

Tout fichier ne commençant pas par cet entête ne sera pas visible sur le site. Vous pouvez également masquer une page en ajoutant un double underscore au debut du nom de fichier. (par exemple, en renommant ce fichier en __exemple.md)

Mise en cache des pages

Par défaut, les pages sont chargées et converties au lancement du serveur. Si vous ajoutez, supprimez ou modifiez des pages, ces changements n'apparaîtront pas tant que le serveur n'est pas redémarré.

Vous pouvez éviter un redémarrage en passant l'option settings.refreshStaticPages à true dans le fichier hx.config.json. Pensez à ne pas laisser cette option activée, ou le serveur rechargera les pages à chaque chargement de l'application, ce qui peut la ralentir.