Recherche de site Web

Etherpad : un éditeur de documents collaboratif en temps réel

Etherpad Lite est un outil d’édition de documents gratuit basé sur le Web qui permet à des groupes d’utilisateurs de travailler en collaboration sur un document en temps réel, à l’instar d’un éditeur multijoueur qui s’exécute dans un navigateur Web.

Etherpad permet aux auteurs d’éditer simultanément, de voir les modifications des autres en temps réel, avec la possibilité d’afficher le texte de chaque auteur dans leurs propres couleurs.

Caractéristiques clés d’Etherpad

  • Plusieurs utilisateurs peuvent modifier un document simultanément tout en affichant les modifications en temps réel.
  • Une boîte de discussion dans la barre latérale permet aux auteurs de communiquer pendant l’édition, améliorant ainsi la collaboration.
  • Il est construit avec JavaScript à la fois côté serveur et côté client, ce qui permet aux développeurs de maintenir et d’ajouter facilement de nouvelles fonctionnalités.
  • Une API HTTP bien documentée permet d’accéder à toutes les données, ce qui facilite leur intégration dans d’autres applications.
  • Il prend en charge l’importation et l’exportation de documents dans différents formats (HTML, Open Document, Microsoft Word, PDF et texte brut) et propose des traductions pour s’adapter aux langues locales.
  • La fonction « curseur temporel » permet aux utilisateurs d’explorer l’historique des révisions de documents.

Pour votre référence, vous pouvez consulter une démo d’Etherpad Lite sur le lien : Regarder la démo d’EtherPad

Dans ce tutoriel, nous allons passer en revue l’installation et la configuration d’Etherpad Lite sur les distributions basées sur RHEL et Debian.

Étape 1 : Installer les bibliothèques et les packages de développement

Tout d’abord, nous devons installer quelques bibliothèques et outils de développement requis en exécutant les commandes suivantes, soit en tant que root, soit en ajoutant sudo au début de chaque commande.

Sur les distributions basées sur RHEL :

sudo yum install gzip git curl python3 openssl-devel && yum groupinstall "Development Tools"

Sur les distributions basées sur Debian :

sudo apt install gzip git curl python3 libssl-dev pkg-config build-essential

Étape 2 : Installez Node.js

Vous devez télécharger et installer la dernière version stable de Node.js en exécutant les commandes suivantes.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 23
node -v
npm -v

Étape 3 : Téléchargez et installez Etherpad Lite

Créez un utilisateur distinct appelé « etherpad » pour exécuter l’application Etherpad indépendamment.

sudo useradd --create-home etherpad

Passez à l’utilisateur « etherpad » et téléchargez la dernière version stable d’Etherpad Lite à l’aide du référentiel Git.

su - etherpad
cd /home/etherpad
git clone https://github.com/ether/etherpad-lite.git

Allez dans le répertoire Etherpad Lite et exécutez le script run.sh :

cd etherpad-lite/bin
./run.sh

Vous devriez voir une sortie indiquant qu’Etherpad est en cours d’exécution et accessible à http://0.0.0.0:9001/.

Étape 4 : Accéder et créer de nouveaux pads dans Etherpad Lite

Ouvrez votre navigateur Web et accédez à http://localhost:9001 ou http://your-ip-address:9001.

Pour créer un nouveau document, entrez un nom pour le bloc. Par exemple, la création d’un Pad nommé « tecmint » vous donnera l’URL http://your-ip-address:9001/p/tecmint. Vous pouvez partager cette URL avec des collaborateurs, qui peuvent rejoindre la session de modification en temps réel.

Étape 5 : Utilisation d’Etherpad Lite avec le backend MySQL

Par défaut, Etherpad stocke les documents dans une base de données de fichiers plats. Pour de meilleures performances, il est recommandé d’utiliser MySQL comme backend.

Sur les systèmes basés sur RHEL :

sudo yum install mysql-server
sudo systemctl start mysqld
sudo systemctl enable mysqld

Sur les systèmes basés sur Debian :

sudo apt install mysql-server
sudo systemctl start mysql
sudo systemctl enable mysql

Connectez-vous au shell MySQL et créez la base de données Etherpad :

mysql -u root -p
CREATE USER 'etherpad'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON etherpad_lite.* TO 'etherpad'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Revenez à l’utilisateur « etherpad » et modifiez le fichier settings.json :

su - etherpad
cd /home/etherpad/etherpad-lite
cp settings.json.template settings.json
nano settings.json

Mettez à jour la configuration de la base de données :

"dbType": "mysql",
"dbSettings": {
  "user": "etherpad",
  "host": "localhost",
  "password": "your-password",
  "database": "etherpad_lite"
},

Installez maintenant les dépendances et exécutez à nouveau Etherpad pour initialiser le backend MySQL :

./bin/installDeps.sh
./bin/run.sh

Enfin, gardez à l’esprit que l’application Etherpad terminera son processus lorsque vous fermerez la session du terminal. Vous pouvez utiliser le service systemd pour gérer plus facilement l’application Etherpad, notamment en la démarrant, en l’arrêtant et en lui permettant de s’exécuter au démarrage.

Étape 6 : Créer un fichier de service Etherpad Systemd

Maintenant, connectez-vous en tant qu’utilisateur sudo normal et créez un nouveau fichier de service dans le répertoire systemd :

sudo nano /etc/systemd/system/etherpad.service

Ajoutez le contenu suivant au fichier de service :

[Unit]
Description=Etherpad Lite
After=network.target

[Service]
Type=simple
User=etherpad
WorkingDirectory=/home/etherpad/etherpad-lite
ExecStart=/usr/bin/node /home/etherpad/etherpad-lite/node/node server.js
Restart=on-failure

[Install]
WantedBy=multi-user.target

Assurez-vous d’ajuster le chemin ExecStart si votre installation Node.js se trouve à un autre emplacement.

Après avoir créé le fichier de service, vous devez recharger systemd pour reconnaître le nouveau service :

sudo systemctl daemon-reload

Vous pouvez maintenant démarrer le service Etherpad et l’activer pour qu’il démarre au démarrage :

sudo systemctl start etherpad
sudo systemctl enable etherpad
sudo systemctl status etherpad

Si tout est correctement configuré, vous pouvez accéder à Etherpad en accédant à http://your-ip-address:9001 dans votre navigateur Web.

Conclusion

Vous avez installé et configuré Etherpad Lite pour utiliser MySQL comme base de données principale. Il y a beaucoup plus à explorer et à améliorer dans votre installation Etherpad, comme la configuration d’un accès sécurisé via HTTPS/SSL.

Pour plus d’informations sur les configurations supplémentaires, visitez le wiki officiel d’Etherpad Lite.

Articles connexes: