Zensical est un thème de documentation statique basé sur MkDocs, pensé pour créer des sites clairs, rapides et personnalisables. L’un de ses atouts les plus pratiques concerne la gestion des icônes.

Plus de 10 000 icônes incluses

Dès l’installation de Zensical, vous avez accès à plus de 10 000 icônes prêtes à l’emploi, utilisables aussi bien pour personnaliser le thème que directement dans vos pages Markdown.

Plusieurs jeux d’icônes intégrés

Zensical embarque nativement plusieurs collections:

• Lucide
• Material Design
• FontAwesome
• Octicons
• Simple Icons

Une syntaxe simple via shortcodes

Les icônes s’utilisent exactement comme des emojis, en insérant un shortcode entre deux-points dans le Markdown.

Par exemple:

:fontawesome-regular-face-laugh-wink:

Affiche directement l’icône correspondante. Il est aussi possible d’y associer des classes CSS personnalisées pour les styliser.

Ajouter des icônes sur les menus

Il suffit de mettre dans les entête les liens des icônes.

exemple:

---
title: Les fichiers 
description: La listes des fichiers
status: new 
icon: lucide/axe
---

Ajouter ses propres icônes

Pour utiliser des icônes personnalisées, il suffit d’étendre le thème en créant un dossier .icons dans le répertoire de personnalisation, puis d’y placer les fichiers .svg organisés en sous-dossiers.

Les icônes dans la configuration

Au-delà des pages de contenu, les icônes interviennent aussi dans la configuration du site : logo, favicon, boutons de bascule entre modes clair et sombre… Par exemple, les palettes de couleurs peuvent utiliser n’importe quelle icône disponible pour le bouton de bascule, comme lucide/sun ou lucide/moon.

Liens