Différences

Ci-dessous, les différences entre deux révisions de la page.

--- technique:adminserv:sites:school [2022/04/15 20:43] – crozatst
+++ technique:adminserv:sites:school [2022/04/16 12:06] (Version actuelle) – [! Section obsolète : site en cours de migration vers le service librecours.net] crozatst
@@ Ligne 1: / Ligne 1: @@
+{{indexmenu_n>30}}
+# School (school.picasoft.net)
+# ! Section obsolète : site en cours de migration vers le site librecours.net
+School est organisé de manière un peu spéciale. Il ne peut pas être généré en un coup.
+Sur l'atelier `picasoft-optim`, on trouvera la structure complète du site sous le dossier `school`, c'est-à-dire les différents onglets (FDS, Init, Run...)
+Sous `school.website`, on retrouve justement ces onglets, dont le contenu est détaillé dans `co` ou `api`. Mais ce contenu n'est jamais qu'une collection de liens vers des modules distants.
+Ces modules sont visibles dans le sous-dossier `modules`, par exemple :
+{{ :technique:adminserv:sites:scenari_school_modules.png |}}
+## Mise à jour des onglets ou des liens
+Supposons que l'API Init s'enrichisse d'un nouveau module. Il faut le référencer sur la page. Pour ce faire, on ajoute un nouveau module distant (clic droit sur `modules` → nouvel item) :
+{{ :technique:adminserv:sites:scenari_optim_distant_new.png |}}
+Et on ajoute le lien. Mais que faire si ce module doit également être publié sur School ? Voir la section suivante dans ce cas. On ajoutera un lien vers `school.picasoft.net/modules/<nom_de_votre_module>`, en attendant sa publication à cette adresse.
+<bootnote>Cette façon de faire est valable pour toute modification qui concerne le contenu des onglets (nouveau lien, ajout d'une section, etc).</bootnote>
+Une fois ceci fait, vous pouvez générer et télécharger l'archive du site (à partir de `school.website`), puis [[technique:adminserv:sites:update_from_archive|mettre à jour les fichiers sur le serveur web]].
+## Modifier un module
+C'est là que l'organisation de school est un peu étrange : il existe des modules accessibles dans l'arborescence `school.picasoft.net/modules` qui ne font pas du tout partie du dossier `school` de l'atelier `picasoft-optim`.
+En fait, ces modules peuvent venir de n'importe où :
+* Ils sont générés et téléversés sur le serveurs web de `school`, dans le dossier `/var/www/html/modules`
+* Ils sont ensuite référencés en tant que modules distants sur le "vrai" site `school`, celui de `picasoft-optim`
+<bootnote critical>
+Ne jamais supprimer le contenu de `/var/www/html` du conteneur de `school` ! En effet, la collection de modules dans `modules` est faite à la main, comme expliqué ci-dessus. 25 modules = 25 générations, 25 transferts, 25 copies...
+</bootnote>
+La plupart des modules hébergés sur School sont situés dans l'atelier `picasoft-opale`.
+Il suffit de les mettre à jour, de les générer, de les télécharger, puis de les [[technique:adminserv:sites:update_from_archive|mettre à jour les fichiers sur le serveur web]].
+<bootnote warning>
+Ces modules seront à transférer dans le dossier `/var/www/html/modules/<nom_du_module>` ! Les transférer dans `/var/www/html` écraserait la racine du site.
+</bootnote>