|
|
| Ligne 1 : |
Ligne 1 : |
| − | == OCTOMODE ==
| |
| − | Octomode, développé par Varia, permet depuis une écriture collaborative via des pads en markdown de générer des fichiers en html et pdf.
| |
| − | Lien vers le git du projet : https://git.vvvvvvaria.org/varia/octomode
| |
| | | | |
| − | === Installation d'Octomode ===
| |
| − | L'installation est un peu laborieuse. Le Readme affiché sur le git est différent du fichier d'installation contenu dans le dossier octomode une fois téléchargé. Ce wiki est un mélange des deux.
| |
| − |
| |
| − | ==== Cloner le code sur sa machine ====
| |
| − | * Il est conseillé de cloner octomode dans un dossier root car il faut rentrer à un moment donné la clé de l'api de l'etherpad (mieux de ne pas partager en public)
| |
| − | Pour cela, il faut se placer à la racine puis aller dans le dossier serveur <pre>$ cd /srv/</pre>
| |
| − | puis se placer en super utilisateur·ice <pre>$ sudo su</pre>
| |
| − | et cloner le code <pre># git clone https://git.vvvvvvaria.org/varia/octomode.git</pre>
| |
| − | <!> Il faut déjà avoir git sur sa machine
| |
| − |
| |
| − | ==== Créer un·e utilisateur·ice octomode ====
| |
| − | L'idée est de pouvoir restreindre l'accès de ce·tte utilisateur·ice au reste du serveur.
| |
| − | <pre># useradd --system --no-create-home --shell=/sbin/nologin octomode</pre>
| |
| − | Donner l'accès d'écriture et de lecture et de propriété au dossier /srv/octomode à l'utilisateur·ice otctomode :
| |
| − | <pre># chown -R octomode:octomode /srv/octomode</pre><pre># chmod -R u+rw /srv/octomode</pre>
| |
| − |
| |
| − | ==== Installer les dépendances si elles ne sont pas déjà installées ====
| |
| − | Pour fonctionner, octomode a besoin de python3 et de pandoc (logiciel de convertisseur de documents). Si ils ne sont pas installés :
| |
| − | <pre>$ sudo apt install python3-venv pandoc</pre>
| |
| − |
| |
| − | ==== Installer les autres dépendances ====
| |
| − | Ces dépendances vont permettre d'utiliser un "environnement virtuel" (venv) -> Un environnement virtuel est un outil qui permet de séparer les dépendances requises par différents projets en créant pour eux des environnements virtuels python isolés.
| |
| − | Pour cela, se placer dans le dossier octomode
| |
| − | <pre># cd /srv/octomode</pre>
| |
| − | Puis
| |
| − | <pre># cd /srv/octomode</pre>
| |
| − | Tu peux maintenant construire l'environnement avec la commande :
| |
| − | <pre>make setup</pre>
| |
| − | Enfin, il faut changer les droits de propriété des dépendances installées (pour les accorder à l'utilisateur·ice octomode) :
| |
| − | <pre># chown -R octomode:octomode .venv</pre>
| |
| − |
| |
| − | === Et maintenant, Etherpad ===
| |
| − | Octomode fonctionne avec une instance Etherpad. Pour cela on peut en installer une sur sa machine (c'est mieux d'en installer une sur un serveur). Je te conseille d''''ouvrir un autre terminal''', pour garder celui d'octomode ouvert et te simplifier la suite.
| |
| − |
| |
| − | ==== Installer Etherpad ====
| |
| − | Voici le readme d'etherpad : https://github.com/ether/etherpad-lite#installation
| |
| − | ==== Installer Nodejs ou s'assurer qu'il est à jour ====
| |
| − | '''D'abord assures-toi d'avoir une version de Node supérieure ou égale à 12.17.0''' (c'est en gras car si ce n'est pas le cas ça ne peut pas fonctionner et que ça m'a pris un peu trop de temps que voir que ça venait juste d'un problème de mise à jour). Aufait, Nodejs est un environnement javascript.
| |
| − | Pour vérifier la version de node :
| |
| − | <pre>node -v</pre>
| |
| − | Pour l'installer :
| |
| − | <pre>sudo apt install nodejs</pre>
| |
| − |
| |
| − | Pour mettre à jour node sous Linux :
| |
| − | vider le cache de NPM (= Node Package Manager)
| |
| − | <pre>$ sudo npm cache clean -f</pre>
| |
| − | Installer n qui est le gestionnaire de version de node
| |
| − | <pre>sudo npm install -g n</pre>
| |
| − | Ensuite installer la dernière version de node :
| |
| − | <pre>sudo n stable</pre>
| |
| − | Rappel : les commandes commençent par sudo (superUser Do) car on est dans la racine
| |
| − |
| |
| − | ==== Cloner etherpad ====
| |
| − | Choisis un dossier dans lequel cloner etherpad puis :
| |
| − | <pre>git clone --branch master https://github.com/ether/etherpad-lite.git</pre>
| |
| − | ==== Lance etherpad ====
| |
| − | Positionnne toi dans le dossier etherpad :
| |
| − | <pre> cd etherpad-lite</pre>
| |
| − | Puis lance :
| |
| − | <pre>src/bin/run.sh</pre>
| |
| − | et ouvre l'adresse http://127.0.0.1:9001 dans ton navigateur (firefox c'est mieux pour octomode)
| |
| − | Tadam, normalement tu peux créer un nouveau pad.
| |
| − |
| |
| − | === Configurer l'environnement d'octomode ===
| |
| − | Reviens sur le terminal de l'installation d'octomode.
| |
| − | Pour fonctionner, octomode a besoin :
| |
| − | * d'un port qui est par défaut 5001
| |
| − | * de l'url pour aller chercher le pad
| |
| − | * de l'api du pad
| |
| − | * et de la clé de l'api
| |
| − |
| |
| − | Les données par défaut étant celles de varia, il faut les reconfigurer avec celles de ton instance.
| |
| − | === Rentrer l'url du pad ===
| |
| − | Comme l'adresse de l'instance est http://127.0.0.1:9001 par défaut :
| |
| − | <pre>export OCTOMODE_PAD_URL=http://127.0.0.1:9001/p</pre>
| |
| − |
| |
| − | === Rentrer l'api de l'url ===
| |
| − | <pre>export OCTOMODE_PAD_API_URL=http://127.0.0.1:9001/api/1.2.14</pre>
| |
| − | === Obtenir la clé de l'api ===
| |
| − | Pour obtenir la clé de l'api, il faut être dans le dossier etherpad-lite -> '''d'où l'utilité de garder deux terminaux ouverts'''
| |
| − | <pre> cd etherpad-lite</pre>
| |
| − | et ouvrir le fichier APIKEY.txt
| |
| − | <pre>cat APIKEY.txt</pre>
| |
| − | Ensuite, copier la série de chiffres contenue dans le fichier texte puis retourne dans le terminal où tu lances octomode et :
| |
| − | <pre>export OCTOMODE_PAD_API_KEY=collelaclé</pre>
| |
| − | === Lancer octomode ===
| |
| − | Maintenant il n'y a plus qu'à lancer l'application :
| |
| − | <pre>make run</pre>
| |
| − | Elle s'ouvre au port 5001 -> http://localhost:5001
| |
| − |
| |
| − |
| |
| − | ''Désolée pour les fautes''
| |
