Aller au contenu

Zensical remplace Mkdocs-Material

Mkdocs-Material non maintenu !

Remplacement par Zensical

Voir le site de Microlinux

Actualités de mi-septembre 2026

Le 5 novembre 2026, versions stables.

  • Zensical 0.1.0 marquera le début d’une ligne de versions stables.

  • Ce même jour, Studio sera lancé avec les éditions Free, Pro et Team.

  • Spark Community s’ouvrira aux particuliers.

  • Material for MkDocs bénéficiera d’une prolongation de six mois de sa fin de vie, la maintenance critique se poursuivant jusqu’au 5 mai 2027.

Statut actuel (rentrée 2026)

Attention : mise en production déconseillée !

Zensical est toujours en versionnage 0.0.x (dernière publication : 0.0.59, le 3 septembre 2026), classé "Alpha" sur PyPI. La documentation officielle est explicite à ce sujet : le projet suit un versionnement sémantique et utilise actuellement des versions 0.0.x (alpha / développement), en approche d'une version bêta, après quoi il passera au versionnage 0.x, puis à une version stable 1.0.

On est encore avant même l'étape bêta — la mise en production n'est donc pas recommandée pour l'instant.

Installation de zensical sous linux

Installation.

  • Dans le dossier de votre site :
python3 -m venv venv
source venv/bin/activate
pip install zensical

Mise à jour de zensical dans le dossier de votre site

Mise à jour.

  • Vérifiez que l'environnement virtuel du dossier de votre site est activé avant de faire la mise à jour du logiciel zensical :
source venv/bin/activate
  • Faire la mise à jour avec pip :
pip install --upgrade --force-reinstall zensical
  • Pour voir la version de zensical installée :
pip show zensical

Installation de zensical sous Windows 11

Créez un site internet statique simplement, sans base de données ni serveur PHP avec zensical :

Zensical est un générateur de site statique : vous écrivez votre contenu en Markdown (un format texte très simple) et il génère un site web complet — recherche intégrée, thème soigné, responsive — sans avoir besoin d'installer Apache, PHP ou une base de données.

Prérequis

  • Installer Python

Zensical est un paquet Python. Téléchargez et installez Python depuis python.org si ce n'est pas déjà fait. Lors de l'installation, cochez bien la case « Add python.exe to PATH ».

Installation de Zensical

  • Ouvrir une invite de commandes

Ouvrez PowerShell (ou l'invite de commandes) dans le dossier où vous voulez créer votre projet.

  • Créer un environnement virtuel Python

Cela isole Zensical du reste du système, sans rien perturber ailleurs.

python -m venv .venv
.venv\Scripts\activate
  • Installer Zensical
pip install zensical

⚠️ Si PowerShell refuse d'exécuter un script

Windows bloque par défaut l'exécution de certains scripts (comme celui d'activation ci-dessus). Si vous obtenez une erreur liée à la « stratégie d'exécution », lancez cette commande une seule fois :

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Elle n'affecte que votre compte utilisateur et autorise l'exécution des scripts locaux tout en restant prudente sur ceux téléchargés d'internet.

Créer son site

  • Générer la structure du projet

Toujours dans le même dossier :

zensical new .

Cela crée un dossier docs/ avec une première page, et un fichier zensical.toml pour la configuration du site (nom du site, etc.).

  • Prévisualiser en local

Lancez le serveur de prévisualisation intégré :

zensical serve

Puis ouvrez http://localhost:8000 dans votre navigateur. Le site se met à jour automatiquement à chaque modification d'un fichier.

  • Générer le site final

Une fois le contenu prêt :

zensical build

Le site complet (fichiers HTML autonomes) est généré dans un dossier site/, prêt à être déposé sur un hébergement.

💡 À retenir

Pas de base de données, pas de serveur à maintenir : une fois le site généré, il peut être hébergé n'importe où (hébergement mutualisé simple, GitHub Pages, etc.). L'essentiel du travail se résume à écrire du contenu en Markdown.