WikiDocs - Le wiki ultra-léger sans base de données

par Korben -

Ah, la documentation, ce truc infâme que tout le monde déteste écrire mais adore avoir sous la main quand ça coince. Quoi de mieux que de l’écrire en mode collaboratif, bien sûr mais si vous en avez assez des usines à gaz type MediaWiki qui demandent un doctorat en administration système pour être installées, j’ai une super nouvelle pour vous. Cela s’appelle WikiDocs et c’est un outil qui va simplifier votre façon de gérer la documentation.

Né de la frustration d’un développeur italien, Manuel Zavatta, qui cherchait une solution simple pour créer une base de connaissances partagée avec ses collègues, WikiDocs répond à un besoin concret : avoir un wiki léger mais puissant, sans les complications habituelles des solutions existantes. Face aux wikis traditionnels soit trop complexes, soit bourrés de fonctionnalités superflues, soit à l’interface dépassée, il a décidé de créer sa propre solution.

C’est un wiki tellement simple à installer qu’il ne nécessite même pas de base de données. Un système où vos pages sont stockées dans de simples fichiers texte, avec la puissance du Markdown pour les mettre en forme. Et cerise sur la partition, un éditeur WYSIWYG (What You See Is What You Get) qui vous évite de devoir apprendre par cœur la syntaxe Markdown si ce n’est pas votre tasse de thé.

L’installation est d’une simplicité déconcertante. Pas besoin de configurer MySQL, PostgreSQL ou je ne sais quel système de base de données. Tout est stocké dans des fichiers texte, ce qui signifie que vous pouvez sauvegarder votre wiki aussi facilement que vous copieriez des photos de vacances. Et pour les adeptes de Docker, c’est encore plus simple avec une image prête à l’emploi :

docker run -d -p 80:80 zavy86/wikidocs

Une fois installé, vous découvrez un système étonnamment complet. L’éditeur WYSIWYG est une vraie perle qui vous permet de formater vos textes sans vous soucier de la syntaxe. Vous voulez quand même utiliser du Markdown pur ? Aucun problème, c’est possible aussi ! Le système gère même les formules mathématiques avec KaTeX pour les scientifiques qui sommeillent en vous.

L’organisation du contenu est particulièrement bien pensée. Le système de namespaces vous permet de structurer votre contenu comme bon vous semble. Vous pouvez créer des catégories, des sous-catégories, tout ça de manière intuitive. Le menu de navigation se génère automatiquement en fonction de votre structure de fichiers, plus besoin de maintenir manuellement une table des matières !


La gestion des versions est également sympa puisque chaque modification est conservée dans un historique, permettant de revenir en arrière si nécessaire. C’est comme un petit Git intégré à votre wiki, sans la complexité habituelle des systèmes de contrôle de version.

Pour les développeurs qui aiment personnaliser leurs outils, WikiDocs vous permet de créer votre propre fichier CSS pour adapter l’apparence à votre charte graphique. Le système inclut même un mode sombre natif, parce qu’en 2024, c’est devenu indispensable !

Question sécurité, WikiDocs fait les choses bien. Vous pouvez définir des pages publiques et privées, gérer les droits d’accès, et tout est compatible avec les standards modernes de sécurité web. Le système de configuration par fichier .htaccess (ou équivalent pour Nginx) vous permet de verrouiller l’accès aux fichiers sensibles.

Voici quelques fonctionnalités qui méritent d’être mentionnées :

  • Support complet de la syntaxe Markdown avec extensions
  • Coloration syntaxique pour le code
  • Upload d’images avec support du copier-coller depuis le presse-papier
  • Gestion des pièces jointes
  • Génération automatique d’index et de sitemap
  • Support multilingue intégré
  • API REST pour l’intégration avec d’autres outils

Le projet connaît un succès croissant : plus de 250 étoiles sur GitHub, près de 30 000 téléchargements sur Docker Hub, et une communauté active qui contribue régulièrement avec des traductions et des améliorations. Bref, c’est encore un bel exemple de projet open source qui grandit grâce à sa communauté.

Voilà, j’ai fait le tour ! Alors si vous cherchez un système de wiki qui allie simplicité d’utilisation et richesse fonctionnelle, WikiDocs mérite vraiment votre attention. C’est idéal pour les équipes qui veulent se concentrer sur la documentation plutôt que sur la maintenance d’un système complexe en plus d’être totalement gratuit et open source !

Pour aller plus loin et tester par vous-même : WikiDocs et un grand merci à Lorenper pour le partage !

Source