Générateur de site statique
• 320 mots • 1'36
Le générateur qui fabrique ce portfolio, écrit en Rust : Markdown, templates, coloration du code et serveur de développement.
Ce portfolio n'utilise ni Hugo ni Zola : il est généré par un outil que j'ai écrit moi-même en Rust. J'écris mes pages en Markdown, et une commande les transforme en un site HTML complet, prêt à être mis en ligne.

Fonctionnalités
- Markdown et frontmatter TOML : chaque page est un fichier
.mdavec ses informations (titre, date, description, langages, brouillon…). - Templates avec minijinja : un gabarit commun et des variantes pour les pages, les projets et les listes.
- URLs propres :
projets/tetris.mddevient/projets/tetris/. - Pages de liste automatiques : un nouveau projet apparaît dans la liste, trié par date, sans rien modifier d'autre. Les brouillons sont ignorés.
- Multilingue : la version anglaise se trouve dans
content/en/et chaque page renvoie vers sa traduction. - Coloration syntaxique des blocs de code avec syntect.
- Copie des fichiers statiques (CSS, images) dans le site généré.
Le serveur de développement
cargo run -- serve construit le site, le sert en local et le reconstruit à chaque
modification :
- un watcher (notify) surveille le contenu, les templates et les fichiers statiques ;
- les événements d'un même enregistrement sont regroupés, pour ne reconstruire qu'une seule fois ;
- le navigateur se recharge tout seul après chaque build ;
- une erreur (par exemple un frontmatter mal écrit) s'affiche dans le terminal sans arrêter le serveur, et l'ancienne version du site reste en ligne.
Choix techniques
- Compilation en deux passes : toutes les pages sont d'abord lues et analysées, puis rendues. C'est ce qui permet à une page de liste de connaître toutes les autres.
- Rendu en mémoire avant l'écriture : si un template plante, le dossier de sortie n'est pas touché.
- Serveur web avec Axum et Tokio, le build tournant dans un thread séparé pour ne pas bloquer le serveur.