Services/Wiki.md
... ...
@@ -35,13 +35,33 @@ Quelques pages modèles : [Gollum]()/[Smeagol](/Serveurs/Smeagol), [Sites Clubs]
35 35
36 36
# Configuration
37 37
38
-:warning: La configuration fait l'objet d'un versionnage sur le [dépôt git](lien vers le dépôt git associé).
38
+Techniquement, gollum est fait pour gérer en même temps plusieurs wiki. Aussi il y a une configuration globale, et une configuration spécifique au wiki.
39 39
40
-On peut modifier le service avec cette configuration, les détails sont sur la [doc de Gollum](https://github.com/gollum/gollum/wiki). Il y a deux fichiers, `custom.css` et `custom.js` qui permettent d'injecter du *css* et du *js* pour améliorer l'aspect du site.
40
+Actuellement, le seul wiki géré est celui Général, mais cela peut-être étendu simplement.
41
+
42
+## Globale
43
+
44
+:warning: La configuration fait l'objet d'un versionnage sur le [dépôt git](https://git.resel.fr/resel/gollum-forks).
45
+
46
+La configuration principale est directement dans le fichier *unit* de Gollum, passant directement les arguments au lancement. Dans `/etc/systemd/system/gollum.service`. Extrait intéressant :
47
+```bash
48
+ExecStart=/usr/local/bin/bundle exec bin/gollum --show-all --emoji --adapter rugged "/home/wiki/general.wiki" --css
49
+```
50
+Il est précisé au lancement d'utiliser les emojis, l'interface git `rugged` qui est meilleure que celle par défaut au niveau de la gestion de l'utf-8, l'emplacement du dossier wiki (c'est ici qu'il faut indiquer de nouveaux chemins pour gérer plus de Wikis), et le switch `css` indique à Gollum d'injecter une feuille de style customisée par projet.
41 51
42 52
Pour soucis de préserver un versionnage propre du code, modifier la configuration sur le dépôt.
43 53
44
-Aller voir les [détails de mise en place de Gollum sur Sméagol](/Serveurs/Smeagol) pour voir comment est installé le service et comment *puller* des modifications.
54
+Allez voir les [détails de mise en place de Gollum sur Sméagol](/Serveurs/Smeagol) pour voir comment est installé le service et comment *puller* des modifications.
55
+
56
+## Par wiki
57
+
58
+:warning: Ces fichiers de customisation sont directement versionné sur le [dépôt du wiki](https://git.resel.fr/resel/general.wiki).
59
+
60
+Comme indiqué, on peut utiliser les switches `css` ou `js` pour indiquer à Gollum de charger, respectivement, une feuille de style, ou un ensemble de script, customisés, pour un wiki.
61
+
62
+Gollum va chercher dans le dossier du wiki un fichier `custom.css` et un fichier `custom.js` si les switches sont activés, et les charge.
63
+
64
+Ça permet de customiser l'apparence de Gollum.
45 65
46 66
47 67
# Lien utiles