Générateurs de site

Un générateur de site statique transforme un dépôt de fichiers Markdown (et un fichier de configuration) en site web : pages HTML, menu de navigation, recherche, thème graphique.

Le résultat est un ensemble de fichiers statiques qui peut être publié sur n'importe quel hébergement web, en particulier avec GitHub Pages ou GitLab Pages (voir Publier un site statique).

Outils

• Jekyll qui est utilisé par défaut pour GitHub pages.
• MkDocs
  • Material for MkDocs
• Docsify
• github.com - Static Site Generators
• jamstack.org - Site Generators

Mise en garde

Ce site utilise mkdocs-material mais mkdocs 2.0 amène la création de zensical par les créateurs de mkdocs-material (son utilisation est à l'étude, c.f. issue #23).

Exemples

• mborne.github.io (sources) : ce site, généré avec Material for MkDocs et publié par GitHub Actions.
• docker-devbox (sources) : rendu par Jekyll avec un simple fichier _config.yml (thème jekyll-theme-slate), sans CI à écrire.
• cours-patron-conception - annexes (sources) : généré avec mborne/markdown-to-html, un générateur expérimental.