Utilisateur:Aloyxcf - Historique des versions

Aloyxcf le 18 avril 2024 à 13:17

2024-04-18T13:17:18Z

← Version précédente	Version du 18 avril 2024 à 13:17
Ligne 1 :	Ligne 1 :
		''Cuisiner(...)'' est ce qui m'occupe en cette deuxième année de master, avec http://zeste.ee/.
		Un aperçu du projet est visible ici : https://www.aliceneron.eu/cuisiner/

Aloyxcf : Page blanchie

2022-12-19T17:46:47Z

Page blanchie

← Version précédente		Version du 19 décembre 2022 à 17:46
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''~~

Aloyxcf : /* Installer Nodejs ou s'assurer qu'il est à jour */

2022-10-21T14:53:11Z

Installer Nodejs ou s'assurer qu'il est à jour

← Version précédente		Version du 21 octobre 2022 à 14:53
Ligne 50 :		Ligne 50 :
	<pre>$ sudo npm cache clean -f</pre>		<pre>$ sudo npm cache clean -f</pre>
	Installer n qui est le gestionnaire de version de node		Installer n qui est le gestionnaire de version de node
	<pre>npm install -g n</pre>		<pre>sudo npm install -g n</pre>
	Ensuite installer la dernière version de node :		Ensuite installer la dernière version de node :
	<pre>sudo n stable</pre>		<pre>sudo n stable</pre>

Aloyxcf : /* Installer Nodejs ou s'assurer qu'il est à jour */

2022-10-21T14:48:53Z

Installer Nodejs ou s'assurer qu'il est à jour

← Version précédente		Version du 21 octobre 2022 à 14:48
Ligne 44 :		Ligne 44 :
	<pre>node -v</pre>		<pre>node -v</pre>
	Pour l'installer :		Pour l'installer :
	<pre>sudo apt install ~~node~~</pre>		<pre>sudo apt install nodejs</pre>

	Pour mettre à jour node sous Linux :		Pour mettre à jour node sous Linux :

Aloyxcf : /* Installer Nodejs ou s'assurer qu'il est à jour */

2022-10-21T14:46:00Z

Installer Nodejs ou s'assurer qu'il est à jour

← Version précédente		Version du 21 octobre 2022 à 14:46
Ligne 43 :		Ligne 43 :
	Pour vérifier la version de node :		Pour vérifier la version de node :
	<pre>node -v</pre>		<pre>node -v</pre>
			Pour l'installer :
			<pre>sudo apt install node</pre>

	Pour mettre à jour node sous Linux :		Pour mettre à jour node sous Linux :
	vider le cache de NPM (= Node Package Manager)		vider le cache de NPM (= Node Package Manager)
Ligne 50 :		Ligne 53 :
	Ensuite installer la dernière version de node :		Ensuite installer la dernière version de node :
	<pre>sudo n stable</pre>		<pre>sudo n stable</pre>
	Rappel : les commandes commençent par sudo (superUser Do) car on est dans la racine		Rappel : les commandes commençent par sudo (superUser Do) car on est dans la racine

	==== Cloner etherpad ====		==== Cloner etherpad ====
	Choisis un dossier dans lequel cloner etherpad puis :		Choisis un dossier dans lequel cloner etherpad puis :

Aloyxcf : /* Installer les autres dépendances */

2022-10-21T14:40:22Z

Installer les autres dépendances

← Version précédente		Version du 21 octobre 2022 à 14:40
Ligne 29 :		Ligne 29 :
	Puis		Puis
	<pre># cd /srv/octomode</pre>		<pre># cd /srv/octomode</pre>
	~~Enfin, il faut changer les droits de propriété des dépendancesinstallées (pour les accorder à l'utilisateur·ice octomode) :~~
	~~<pre># chown -R octomode:octomode .venv</pre>~~
	Tu peux maintenant construire l'environnement avec la commande :		Tu peux maintenant construire l'environnement avec la commande :
	<pre>make setup</pre>		<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 ===		=== Et maintenant, Etherpad ===

Aloyxcf : /* Cloner le code sur sa machine */

2022-10-21T14:34:20Z

Cloner le code sur sa machine

← Version précédente		Version du 21 octobre 2022 à 14:34
Ligne 11 :		Ligne 11 :
	puis se placer en super utilisateur·ice <pre>$ sudo su</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>		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 ====		==== Créer un·e utilisateur·ice octomode ====

Aloyxcf : /* Rentrer l'url du pad */

2022-10-20T14:49:14Z

Rentrer l'url du pad

← Version précédente		Version du 20 octobre 2022 à 14:49
Ligne 72 :		Ligne 72 :
	=== Rentrer l'url du pad ===		=== Rentrer l'url du pad ===
	Comme l'adresse de l'instance est http://127.0.0.1:9001 par défaut :		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>		<pre>export OCTOMODE_PAD_URL=http://127.0.0.1:9001/p</pre>

	=== Rentrer l'api de l'url ===		=== Rentrer l'api de l'url ===
	<pre>export OCTOMODE_PAD_API_URL=http://127.0.0.1:9001/api/1.2.14</pre>		<pre>export OCTOMODE_PAD_API_URL=http://127.0.0.1:9001/api/1.2.14</pre>

Aloyxcf : Page créée avec « == 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... »

2022-10-20T14:40:07Z

Page créée avec « == 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... »

Nouvelle page

== 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>

==== 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>
Enfin, il faut changer les droits de propriété des dépendancesinstallées (pour les accorder à l'utilisateur·ice octomode) :
<pre># chown -R octomode:octomode .venv</pre>
Tu peux maintenant construire l'environnement avec la commande :
<pre>make setup</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 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>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''

Utilisateur:Aloyxcf - Historique des versions

Aloyxcf le 18 avril 2024 à 13:17

Aloyxcf : Page blanchie

Aloyxcf : /* Installer Nodejs ou s'assurer qu'il est à jour */

Aloyxcf : /* Installer Nodejs ou s'assurer qu'il est à jour */

Aloyxcf : /* Installer Nodejs ou s'assurer qu'il est à jour */

Aloyxcf : /* Installer les autres dépendances */

Aloyxcf : /* Cloner le code sur sa machine */

Aloyxcf : /* Rentrer l'url du pad */

Aloyxcf : Page créée avec « == 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... »

Aloyxcf : Page blanchie

Aloyxcf : /* Installer Nodejs ou s'assurer qu'il est à jour */

Aloyxcf : /* Installer Nodejs ou s'assurer qu'il est à jour */

Aloyxcf : /* Installer Nodejs ou s'assurer qu'il est à jour */

Aloyxcf : /* Installer les autres dépendances */

Aloyxcf : /* Cloner le code sur sa machine */

Aloyxcf : /* Rentrer l'url du pad */

Aloyxcf : Page créée avec « == 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... »