Je vous partage ici une approche que l’on m’a partagé récemment et qui mixe un peu de l’esprit de la solution Google Docs et de l’esprit de la solution « forge git ».
C’est une solution qui génère un site à partir d’HedgeDoc et Gitlab Pages.
- HedgeDoc est un outil libre en ligne d’édition de notes en markdown où tout le monde peut écrire en même temps dessus. Il permet de créer des Pad (un peu comme ceux de etherpad ou un peu comme des documents google).
Le site internet est ensuite généré à partir du contenu de ces pads. Exemple : Communs des tiers-lieux a été généré à partir de :
- plusieurs pads : Communs des tiers-lieux - HedgeDoc
- d’un générateur de site hébergé sur GitLab : communs-tiers-lieux / catalogue · GitLab
Avantages
- L’édition sur HedgeDoc est facile et on peut être plusieurs à écrire en même temps
- Les pads peuvent être configurés pour être totalement ouverts (pas de compte internet nécessaire) ou réservés
- Ils ont réussi à intégrer une boite de dialogue vers la messagerie Rocket.Chat pour discuter sur le contenu
- En bas de chaque contenu, il y a un lien direct vers chaque pad pour modifier en un clic le texte
Inconvénients
- Il faut un technicien au début pour mettre en place la mécanique et documenter le processus de collaboration mais il faut aussi un technicien pour réussir à faire évoluer l’organisation du contenu.
- Une instance HedgeDoc (outil libre) doit-être déployée quelque part pour l’utiliser.
- C’est encore un peu du bricolage à ce stade, mais l’idée est de pouvoir même se passer de CMS ou générateur type Jekyll et garder la facilité de hedgedoc… Pierre Trendel qui en est l’auteur va essayer de “généraliser la démarche” au délà de ce proto et vous pouvez le contacter aux coordonnées qu’il donne en bas du pad.
- Pas de moteur de recherche dans le contenu (un truc essentiel pour une documentation)
Avec Tim (membre d’IndieHosters comme @pierreok), ils vont essayer d’avancer aussi sur la possibilité de générer des jolis guide PDF à partir de ces guides collaboratifs en ligne grâce à https://pagedjs.org/