From ae2530bd75a52428535e1b519768d34b371939b0 Mon Sep 17 00:00:00 2001
From: Bastien Lacoste <bastien.lacoste@a-lec.org>
Date: Mon, 2 May 2022 21:58:41 +0200
Subject: [PATCH] ':' avant les paragraphes

---
 INSTALL.md | 43 ++++++++++++++++++++-----------------------
 1 file changed, 20 insertions(+), 23 deletions(-)

diff --git a/INSTALL.md b/INSTALL.md
index d5bca34..d05c358 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -21,7 +21,7 @@ On vérifie que l'on peut se connecter en IP avec vérification du mot de passe
 host    all             all             127.0.0.0/24            md5
 ```
 
-On crée l'utilisateur <UTILISATEUR> avec le mot de passe <MOTDEPASSE>, et la base <BDD>
+On crée l'utilisateur <UTILISATEUR> avec le mot de passe <MOTDEPASSE>, et la base <BDD> : 
 ```
 # su - postgres
 $ createuser <UTILISATEUR>
@@ -35,7 +35,7 @@ $ psql <BDD>
 Installer Etherpad-lite
 =====================
 
-Ajouter l'utilisateur etherpad
+Ajouter l'utilisateur etherpad : 
 ```
 # adduser etherpad
 # su - etherpad && cd
@@ -72,16 +72,15 @@ Commenter la BDD par défaut :
 */
 ```
 
-Décommentez la section postgres et compléter avec les secrets 
-
+Décommentez la section postgres et compléter avec les secrets :
 ```
   "dbType" : "postgres",
   "dbSettings" : {
-    "user":     "<UTILISATEUR>",
+    "user":     "etherpad",
     "host":     "localhost",
       "port":     5432,
       "password": "<MOTDEPASSE>",
-    "database": "<BDD>",
+    "database": "etherpad",
     "charset":  "utf8mb4"
   },
 ```
@@ -125,7 +124,7 @@ Placer la favicon dans le dossier parent et la référencer :
   "favicon": "../pad.chalec.org.svg",
 ```
 
-Ajouter le skin Chalec qui est basé sur le skin par défaut
+Ajouter le skin Chalec qui est basé sur le skin par défaut : 
 ```
 $ cp -r conf/etherpad-lite/skins/chalec src/static/skins 
 ```
@@ -169,7 +168,7 @@ systemd
 Tester le démarrer du service etherpad-lite : 
 `$ src/bin/run.sh`
 
-Vérifier que le démarrage se passe sans encombres. Puis intérrompre le processus avec un
+Vérifier que le démarrage se passe sans encombres. Puis intérrompre le processus avec un :
 CTRL-C
 
 
@@ -178,7 +177,7 @@ Installer screen :
 # apt install screen
 ```
 
-Copier le fichier suivant dans un fichier run.sh
+Copier le fichier suivant dans un fichier run.sh :
 ```
 #!/bin/sh
 
@@ -216,8 +215,7 @@ Le rendre exécutable :
 Configuration du cron : 
 `$ crontab -e`
 
-et insérer les lignes suivantes dans le fichier 
-
+et insérer les lignes suivantes dans le fichier :
 ```
 @reboot /home/etherpad/run.sh > /dev/null
 * * * * * /home/etherpad/checkrestart.sh
@@ -228,15 +226,14 @@ Installation du proxy nginx
 ==================
 Restore html content into /var/www
 
-Installer nginx et préparer le dossier de logs
+Installer nginx et préparer le dossier de logs :
 ```
 # apt install nginx
 # mkdir /var/log/nginx/pad.chalec.org
 # chown www-data:www-data /var/log/nginx/pad.chalec.org
 ```
 
-
-Enregistrer le fichier de configuration de site nginx a cet emplacement /etc/nginx/sites-available/etherpad et faire un lien symbolique dans  /etc/nginx/sites-available/etherpad
+Enregistrer le fichier de configuration de site nginx a cet emplacement /etc/nginx/sites-available/etherpad et faire un lien symbolique dans  /etc/nginx/sites-available/etherpad : 
 
 ```
 # cd /etc/nginx/sites-enabled
@@ -244,10 +241,10 @@ Enregistrer le fichier de configuration de site nginx a cet emplacement /etc/ngi
 ```
 
 
-Démarrer le service nginx
+Démarrer le service nginx : 
 `# systemctl enable --now nginx`
 
-Ouvrir les ports du firewall
+Ouvrir les ports du firewall : 
 `# ufw allow proto tcp port 80,443`
 
 Vérifier que le service répond en se rendant aux addresses suivantes : 
@@ -281,13 +278,13 @@ Pour supporter l'export au format ODT, il faut installer libreoffice :
 # apt install libreoffice-nogui
 ```
 
-Puis configurer le chemin du binaire
+Puis configurer le chemin du binaire : 
 ```
   "soffice": "/usr/bin/soffice",
 ```
 
 Ajouter le module de table des matières "table_of_contents" et configurer pour le
-désactiver par défaut : 
+désactiver par défaut (bug upstream, configuration non prise en compte, cf. #1): 
 ```
     "ep_toc": {
 	"disable_by_default": true
@@ -331,13 +328,13 @@ des pads jusqu'à 20Mo :
 Chalec infos
 ============
 
-Intaller Java
+Intaller Java : 
 `# apt install openjdk-jre-headless`
 
-Ajouter l'utilisateur statoolinfos
+Ajouter l'utilisateur statoolinfos : 
 `# adduser statoolinfos`
 
-Ajouter statoolinfos au group admin pour qu'il puisse lire les logs
+Ajouter statoolinfos au group admin pour qu'il puisse lire les logs : 
 ```
 # adduser statoolinfos admin
 # su - statoolinfos
@@ -352,14 +349,14 @@ Décompresser dans /home/statool-<version>
 Faire un lien généric pour avoir un nom de dossier invariant "statoolinfos":
 `$ ln -s statoolinfos-<verion> statoolinfos`
 
-Restaurer la configuration statoolinfos
+Restaurer la configuration statoolinfos : 
 - /var/www/html/.well-known/statoolinfos)
 
 Exécuter la commande suivante pour vérifier que tout se passe bien :
 ` /home/statoolinfos/statoolinfos/statoolinfos.sh probe -full /hhome/statoolinfos/statoolinfos/conf/pad.chalec.org.conf `
 
 
-On configure le cron quotidien
+On configure le cron quotidien : 
 `$ crontab -e`
 
 `45 5 * * * /home/statoolinfos/statoolinfos/statoolinfos.sh probe -previousday /home/statoolinfos/statoolinfos/conf/pad.chalec.org.conf >> /home/statoolinfos/statoolinfos.log`