Équivalent à "Read the docs"

Bonjour,

Afin de faire une base de documentation sur un réseau local, je me demandais si vous connaissez un équivalent à "Read the docs" dont les caractéristiques seraient :

• léger (genre un truc en PHP sur base MySQL)
• doc rédigée 100% à la main (c'est pas pour une documentation de code ni de projet)
• rédaction en markdown
• interface très simple : menu arborescent, zone de recherche et c'est tout.

Alors OK, un WordPress peut faire l'affaire, mais j'aimerais vraiment un truc hyper léger.

un gitbook ?

L'idée y est, mais je voudrais si possible ne pas dépendre d'un service web.

Ce qui est fou, c'est que c'est un truc qui se développe en une journée max, il doit bien y'en avoir avant moi qui ont pensé à ce truc… !

L'idée y est, mais je voudrais si possible ne pas dépendre d'un service web.

Tu peux l’héberger chez toi il me semble : https://github.com/GitbookIO

Si tu te relaxe sur le coté "markdown", tu peux utiliser sphinx qui est en fait la base de ReadTheDocs. Ça te fournit depuis tes sources du html donc tu n'as meme pas besoin de langages coté serveur.

ReadTheDocs propose d'utiliser MkDocs pour faire des docs en markdown.

Enfin sache qu'il doit être possible d'utiliser markdown directement avec sphinx mais ça demande de lui ajouter le parseur.

Le problème, c'est que j'aimerais éviter au maximum d'installer Python, npm et cie.

Mais je reconnais, je suis difficile !

Bin en fait ça dépend. Que ce soit MkDocs ou Sphinx, ça génère du html. Tu a le processus de build qui utilise Python mais une fois construit, tu n'a pas plus besoin de python.

Je doute que Python seul utilisé uniquement pour le build puis accès à la doc de manière statique soit plus lourd qu'un PHP+MySql.

Dans le même ordre d'idée Pandoc peut te générer, depuis le markdown, du html. Avec un template (qu'il peut gérer aussi), tu peux avoir ton doc facile.

Wikitten ? Pas sûr que sa convienne, je ne sais pas si tu souhaites rédiger directement sur le site.

Sinon tu peux partir sur un format wiki, par exemple avec DokuWiki

Effectivement, un wiki peut faire l'affaire, mais je veux presque un truc encore plus simple…

Doku Wiki, c'est déjà super simple, y'a même pas de base de données.

Effectivement. Je n'exclus pas cette solution

Je tente vite fait un petit truc à la main, je verrai si ça peut être exploitable et partagé.

Note : à mon avis t'emmerdes pas avec une base de données, si ? T'as vraiment un gros besoin d'indexation derrière ? Avec un système de fichiers plats t'as un import / export tout prêt, t'es pas dépendant d'une config/install (pour redistribuer c'est pas négligeable).

Quitte à "brancher" par-dessus un moteur d'indexation par la suite ? Ca peut-être un design intéressant. Bon courage en tout cas j'espère que ça donnera un résultat sympa !

En fait, je veux un bon système de recherche. C'est vraiment le nerf de guerre, Une base de connaissances avec un moteur de recherche foireux, ça sert à rien.

Je pensais à la base à la recherche fulltext de MySQL, qui donne des résultats par trop mal. Mais effectivement, je ne sait pas trop sur quoi me baser. Tu as quelques pistes intéressantes ?

Je connais que le monde Java dans ce domaine là, je voudrais pas te donner une piste pour laquelle le binding PHP est foireux :\

Même si c'est pas fait pour ça essaye Jekyll, à la base c'est pour générer des blogs à partir de fichiers Markdown, mais c'est hautement customisable(et simple), et au final tu peux en faire ce que tu veux. http://jekyllrb.com

Ok, j'y jette un oeil. Toute proposition est bonne à prendre, merci !

Sinon un autre moteur de blog statique que j'utilise pour mon blog : Pelican.

J'ai jamais travaillé avec FULLTEXT de MySQL, mais récemment j'ai mis en place un truc en PHP qui passe par un bête exec('grep') avec les bons paramètres.

Ça permet de stocker les documents au format MarkDown, et d'avoir un cache en HTML pour les performances. Je songe d'ailleurs à garder une version texte pure pour une recherche plus précise.

Au final : pas de BDD, que des fichiers lisibles et utilisation des fonctionnalités de l'OS (principal inconvénient du coup : aucune idée du résultat sur Windows). Du coup ça permet un export super simple (un bon vieux zip du dossier principal et le tour est joué) et aucune configuration ou presque.

Oui, ça pourrait aussi faire, j'y ai pensé au grep, mais je ne voudrais pas me conditionner trop à l'environnement Unix.

Autre chose je souhaite quand même un système de catégories léger (genre Informatique - Comptabilité - Expéditions - Sécurité - etc.) et j'ai peur de me compliquer la tâche en travaillant en No SQL (comment facilement stocker mes catégories ? Dans des dossiers ?)

Enfin de toute façon j'expérimente, mon projet est tellement léger que je peux facilement changer de direction (actuellement j'ai presque fini et je dois avoir à tout casser 1k de lignes de code).

Mais merci pour vos retours, ça permet de découvrir plein de choses

Tu sais que NoSQL = Not Only SQL ? Du coup tu peux faire des requêtes (souvent basiques), par exemple avec MongoDB.

Sinon tu peux utiliser un système de dossiers, ou tout bêtement lire un JSON à chaque fichier MD qui contient les métadonnées (ou encore plus bête, les stocker dans un commentaire en début de fichier).