Comment arrêter de configurer des wikis et commencer à écrire de la documentation

Une histoire familière : votre équipe ou vous-même avez besoin d'une base de connaissances. Vous ouvrez Wiki.js, Outline, ou, Dieu vous garde, Confluence. Une heure plus tard, vous vous retrouvez profondément immergé dans la configuration de PostgreSQL, Redis, du stockage S3 et d'un fichier Docker Compose de trois cents lignes. À ce stade, l'envie de noter quelques idées intelligentes a généralement disparu.

Récemment, je suis tombé sur LeafWiki. L'auteur du projet partage visiblement cette douleur. C'est un wiki auto-hébergé sans fioritures qui fonctionne sur le principe du « télécharger et exécuter ». Pas de dépendances lourdes, juste un seul binaire Go et un dossier de données.

Sous le capot

LeafWiki ne cherche pas à réinventer la roue. Il repose sur trois choses simples : Go pour le backend, React pour l'interface et SQLite pour les métadonnées. Le meilleur dans tout ça — le contenu réel des pages est stocké dans de simples fichiers Markdown sur le disque.

Cela signifie que si le serveur plante soudainement ou que vous décidez de passer à un autre outil, vos données ne se transformeront pas en citrouille coincée dans une base de données propriétaire. Vous pouvez l'ouvrir avec n'importe quel éditeur de texte ou même Obsidian.

Ce qui la rend efficace en pratique

Je vois souvent des outils qui se disent « simples » mais qui nécessitent en réalité une administration complète. LeafWiki est plus honnête à ce sujet.

Une structure arborescente plutôt que le chaos

De nombreux outils modernes de prise de notes penchent vers des listes « plates » avec des tags. Ici, vous obtenez une structure arborescente classique. Vous définissez vous-même la hiérarchie et, surtout, vous pouvez trier manuellement les pages dans les sections. C'est critique pour les documents d'onboarding ou les procédures où l'ordre de lecture compte.

Un éditeur qui ne gêne pas

Il est livré avec un éditeur Markdown intégré avec prévisualisation en direct. Il prend en charge les tableaux, les listes de tâches, les notes de bas de page et même les diagrammes Mermaid avec les formules mathématiques KaTeX. Il y a l'auto-complétion pour les liens internes — commencez à taper le nom d'une autre page, et le wiki insère automatiquement le lien correct.

Liens intelligents

Le système suit les liens retour. Sur chaque page, vous pouvez voir ce qui la référence. Si vous renommez ou déplacez une page, LeafWiki peut automatiquement mettre à jour les liens dans les autres documents (cette fonctionnalité doit être activée avec un flag --enable-link-refactor).

Sauvegarde pour les paranoïaques

Au-delà de la simple copie du dossier de données, les versions récentes ont ajouté la prise en charge expérimentale de la sauvegarde Git. Le wiki poussera automatiquement les modifications vers votre dépôt distant selon un calendrier.

Pour qui ce n'est pas

Soyons clair dès le départ : ce n'est pas un remplacement de Notion. Il n'y a pas d'édition collaborative en temps réel où vous voyez les curseurs de vos collègues. Pas non plus de workflows complexes d'approbation de publication. Si vous avez besoin que dix personnes modifient simultanément le même paragraphe — continuez à chercher.

De plus, LeafWiki ne prend pas encore en charge le contrôle d'accès granulaire au niveau des branches individuelles de l'arborescence. Les rôles existent (admin, éditeur, lecteur), mais ils s'appliquent à l'ensemble du wiki.

Comment démarrer

Si vous avez Docker installé, le lancement prend environ trente secondes.

docker run -p 8080:8080 \
    -v ~/leafwiki-data:/app/data \
    ghcr.io/perber/leafwiki:latest \
    --jwt-secret=super-secret-key \
    --admin-password=your-password \
    --allow-insecure=true

Le flag --allow-insecure=true est nécessaire si vous exécutez le projet en local sans HTTPS. Si vous prévoyez de l'exposer à l'extérieur via Nginx ou un autre proxy, il vaut mieux supprimer ce flag.

Au fait, pour les enthousiastes du minimalisme, il existe un installateur prêt à l'emploi pour Linux qui enregistre LeafWiki en tant que service système :

sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/perber/leafwiki/main/install.sh)"

Travailler depuis les appareils mobiles

L'interface est responsive. Éditer du texte depuis un téléphone est un plaisir douteux, mais lire de la documentation en déplacement ou corriger rapidement une faute de frappe est parfaitement faisable.

LeafWiki vous gagne par sa prévisibilité. C'est un excellent choix pour :

• Un journal technique personnel ou une base de connaissances.
• La documentation d'un petit projet.
• Les runbooks internes pour les admins ou les ingénieurs DevOps.

Si vous êtes fatigué de lutter contre les moteurs de wiki lourds et que vous voulez simplement écrire du Markdown qui s'organise proprement — essayez ce projet. Il compte actuellement moins de mille étoiles sur GitHub, mais il a définitivement le potentiel pour devenir « cet outil simple » que vous cherchiez.