Comment modifier le site web de Nos oignons ?
=============================================

Le site web de Nos oignons est généré grâce à [Ikiwiki].

C'est un site multi-lingue. La langue principale est le français. Certaines
pages sont traduites en anglais.

[Ikiwiki]: https://ikiwiki.info/

Construire une version locale
-----------------------------

Pour voir le résultat de ses modifications avant de les envoyer sur le serveur,
on peut compiler une version du site sur son propre ordinateur.

Pour cela, il faut lancer dans la racine du dépôt Git :

    ikiwiki -setup ikiwiki.setup -rebuild -verbose

Le résultat se trouve dans le répertoire `dest`, au même niveau que le
répertoire avec les sources du site.

Mettre à jour une page traduisible
----------------------------------

Lorsqu'on modifie une page traduisible, il faut d'abord faire la modification
du fichier originale (en général en Markdown ou en HTML).

Une fois le changement sur la version originale poussé dans le dépôt, Ikiwiki
va se charger de mettre à jour les fichiers de traduction (PO). Il faut donc
rapatrier les nouvelles versions.

On peut alors mettre à jour les fichiers PO (typiquement en traduisant les
nouvelles chaînes ou en éliminant les « fuzzy ») et les renvoyer.

Ajouter une nouvelle page traduisible
-------------------------------------

Pour ajouter une nouvelle page traduisible, il est nécessaire de modifier
l'entrée `po_translatable_pages` dans la configuration d'Ikiwiki. En
local, c'est dans le fichier `ikiwiki.setup` et pour le serveur,
c'est dans `/etc/ikiwiki/website.setup`. Il faut donc demander
à `adminsys@nos-oignons.net` de faire le changement avant de pousser les
modifications vers le serveur.

Images
------

Les sources des images utilisés se trouve dans le répertoire `Site_web` du
dépôt « comm ».

Modification de la liste des relais
-----------------------------------

La liste des relais gérés par Nos oignons se trouve à deux endroits :
`Services.mdwn` et `assets/relays.js`. Il faut bien penser à tout mettre à
jour.

Modification de la barre de progression
---------------------------------------

La taille de la barre de progression se contrôle 'à la main', dans le fichier
Donnez.html
Il faut chercher la chaîne `<div class="progress-bar"` et modifier la valeur
de `width`.
