From: Lunar Date: Sun, 26 May 2013 12:58:59 +0000 (+0200) Subject: Ajout d'une documentation sur comment modifier le site web X-Git-Url: https://nos-oignons.net/gitweb/website.git/commitdiff_plain/aab1862abc0b80b379818cc122482bb9caf9227e Ajout d'une documentation sur comment modifier le site web --- diff --git a/README b/README new file mode 100644 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 ».