Comment installer HedgeDoc sur Saplo (édition collaborative de documents Markdown en direct)

Prendre des notes de réunion à une seule personne pendant que le reste de l'équipe attend ou ajoute des commentaires dans le chat à côté est plus lent que d'écrire le même document ensemble en direct. Notion et Dropbox Paper peuvent le faire, mais au prix d'un compte dans le cloud d'un tiers et d'un abonnement qui augmente avec le nombre de personnes dans l'équipe. HedgeDoc est un éditeur Markdown open source où plusieurs personnes travaillent sur le même document en même temps, voient les curseurs des autres et les modifications en temps réel, et tu peux l'héberger sur ta propre Box. Voici, étape par étape, comment installer HedgeDoc sur Saplo.

Pourquoi HedgeDoc plutôt que Notion ou Dropbox Paper

Les outils payants de collaboration documentaire ont deux caractéristiques qui posent particulièrement problème aux petites équipes et aux freelances :

• Le prix augmente avec le nombre d'utilisateurs - le forfait gratuit est généralement suffisant pour une seule personne, mais l'ajout de chaque collaborateur supplémentaire à l'équipe dans Notion ou un outil similaire représente une ligne distincte sur la facture chaque mois.
• Le contenu des documents est stocké sur un serveur tiers - les notes de réunion, les plans de projet et les brouillons de texte sont entre les mains d'une entreprise externe, pas les tiennes.

HedgeDoc fonctionne comme un conteneur Docker avec son propre conteneur PostgreSQL sur ta Box. Ainsi, le contenu de tous les documents et l'historique des modifications restent sur ton infrastructure, sans frais par personne et sans limite du nombre de documents.

HedgeDoc, Trilium et Wiki.js/BookStack : trois niches différentes de prise de notes dans le catalogue Saplo

Le catalogue Saplo contient déjà Trilium Notes, Wiki.js et BookStack. La question naturelle est donc de savoir en quoi HedgeDoc en diffère. La réponse réside dans l'objectif de chacun de ces outils :

• Trilium Notes est un carnet de notes personnel - une base de données hiérarchique de notes et de connaissances, construite par un seul utilisateur sur une longue période, sans insister sur l'édition en direct par plusieurs personnes à la fois.
• Wiki.js et BookStack sont des wikis d'entreprise avec des versions de pages, une structure de catégories et des autorisations - idéaux pour la documentation qui a une structure fixe et un historique des changements, mais pas pour un brouillon collaboratif rapide en direct.
• HedgeDoc se concentre exclusivement sur l'édition simultanée et en direct d'un seul document Markdown - tu vois les curseurs des autres participants et leurs modifications en temps réel, sans la structure d'une base de connaissances complète ni un système d'autorisations comme dans un wiki d'entreprise.

Si tu construis une base de connaissances personnelle, essaie Trilium. Si l'équipe a besoin d'une documentation structurée avec un historique des versions, choisis Wiki.js ou BookStack. Si tu as besoin de prendre des notes de réunion ou de rédiger un brouillon de texte en direct, ici, maintenant, avec quelqu'un, HedgeDoc est le mieux adapté.

Prérequis

Pour installer HedgeDoc sur Saplo, tu auras besoin de :

• Une Box avec Docker activé (le moteur l'active automatiquement lors de l'installation depuis le catalogue, la virtualisation imbriquée est requise et Saplo l'active par défaut),
• Un minimum de 1 Go de RAM libre sur la Box et 2 Go d'espace disque, soit un plan Box M (65 € par an) ou supérieur,
• Un nom de domaine ou un sous-domaine *.saploapp.pl inclus avec chaque plan, sur lequel l'éditeur sera hébergé,
• Tu n'as PAS besoin de créer une base de données séparée manuellement - HedgeDoc nécessite une base de données SQL, et le moteur installe un conteneur PostgreSQL dédié dans le même fichier docker-compose (la base de données partagée de Saplo ne prend en charge que MySQL/MariaDB).

Installation étape par étape

1. Dans ton panneau Saplo, accède au Catalogue d'applications et sélectionne HedgeDoc (catégorie "Business").
2. Indique un Box avec au minimum 1 Go de RAM disponible, sur lequel l'éditeur sera installé, ainsi que le domaine ou sous-domaine sous lequel il fonctionnera.
3. Confirme l'installation. Le moteur installe un conteneur à partir de l'image officielle quay.io/hedgedoc/hedgedoc avec un conteneur postgres:15-alpine dédié, génère un mot de passe aléatoire pour la base de données et un secret de session aléatoire, puis expose l'application uniquement sur le loopback du Box, connecté à Nginx, qui la sert sous le domaine spécifié avec un SSL gratuit. Seul le port 443 est exposé à l'extérieur, et non le port brut du conteneur.
4. Après docker compose up, le moteur vérifie également si le site HedgeDoc répond réellement en HTTP, car le premier démarrage du conteneur effectue des migrations de schéma de base de données et peut prendre plus de quelques secondes habituelles, donc le simple statut "conteneur en cours d'exécution" ne signifie pas encore que l'application est prête.
5. L'édition collaborative fonctionne via websocket sur le même domaine que l'application - elle ne nécessite aucune configuration client supplémentaire ni de port séparé.

Première configuration

HedgeDoc, contrairement à Directus ou Wiki.js, n'a pas de notion de compte administrateur. Chaque personne qui s'inscrit est un utilisateur ordinaire et ne voit que ses propres documents ainsi que ceux pour lesquels elle a reçu un lien.

1. Rends-toi à l'adresse du domaine, par exemple notatki.saploapp.pl, et crée le premier compte en utilisant l'assistant d'inscription lors de ta première visite sur le site.
2. Crée un nouveau document avec le bouton New note - tu obtiendras un lien d'édition unique que tu enverras à toute personne souhaitant collaborer sur le contenu.
3. Les collaborateurs ouvrent le même lien et voient immédiatement les curseurs et les modifications des autres en temps réel, sans avoir besoin de créer leur propre compte si le document a un accès ouvert à l'édition.
4. Tu peux exporter le document final en PDF, HTML ou un fichier Markdown brut depuis le menu du document, ou le partager en mode lecture seule avec un lien séparé.
5. L'historique des versions du document est consultable dans la vue Revision, ce qui te permet de revenir à un contenu antérieur sans avoir à copier manuellement les sauvegardes.

HedgeDoc sur Saplo vs Notion et Dropbox Paper

Questions fréquentes

HedgeDoc a-t-il besoin d'une base de données séparée ? Oui, contrairement à certaines applications du catalogue Saplo, HedgeDoc nécessite une base de données SQL. Le moteur déploie donc un conteneur PostgreSQL dédié dans le même docker-compose, et n'utilise pas la base de données Saplo partagée disponible uniquement pour MySQL/MariaDB.

En quoi HedgeDoc est-il différent de Trilium Notes, puisqu'ils sont tous deux dans le catalogue Saplo ? Trilium est un carnet de notes hiérarchique destiné à une seule personne et construit sur une longue période. HedgeDoc se concentre sur l'édition simultanée d'un seul document par plusieurs personnes en temps réel.

Faut-il créer un compte pour éditer un document en collaboration ? Non, si le document a un accès ouvert à l'édition, un simple lien suffit. Tu crées ton compte uniquement pour avoir une liste permanente de tes propres documents.

Est-il possible d'exporter un document terminé en dehors de HedgeDoc ? Oui, depuis le menu du document, tu peux exporter le contenu au format PDF, HTML ou en tant que fichier Markdown brut.

Si ton équipe rédige des notes et des brouillons ensemble, en temps réel, et cherche un éditeur simple sans abonnement par personne, écris-nous, nous t'aiderons à choisir la Box adaptée à ton équipe.