Ajout d'une documentation sur comment modifier le site web

diff --git a/README b/README
new file mode 100644 (file)
index 0000000..44cdc40
--- /dev/null
+++ b/README
@@ -0,0 +1,51 @@
+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]: http://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 versino orginiale 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 ».