README

   1 Comment modifier le site web de Nos oignons ?
   2 =============================================
   3
   4 Le site web de Nos oignons est généré grâce à [Ikiwiki].
   5
   6 C'est un site multi-lingue. La langue principale est le français. Certaines
   7 pages sont traduites en anglais.
   8
   9 [Ikiwiki]: https://ikiwiki.info/
  10
  11 Construire une version locale
  12 -----------------------------
  13
  14 Pour voir le résultat de ses modifications avant de les envoyer sur le serveur,
  15 on peut compiler une version du site sur son propre ordinateur.
  16
  17 Pour cela, il faut lancer dans la racine du dépôt Git :
  18
  19     ikiwiki -setup ikiwiki.setup -rebuild -verbose
  20
  21 Le résultat se trouve dans le répertoire `dest`, au même niveau que le
  22 répertoire avec les sources du site.
  23
  24 Mettre à jour une page traduisible
  25 ----------------------------------
  26
  27 Lorsqu'on modifie une page traduisible, il faut d'abord faire la modification
  28 du fichier originale (en général en Markdown ou en HTML).
  29
  30 Une fois le changement sur la version originale poussé dans le dépôt, Ikiwiki
  31 va se charger de mettre à jour les fichiers de traduction (PO). Il faut donc
  32 rapatrier les nouvelles versions.
  33
  34 On peut alors mettre à jour les fichiers PO (typiquement en traduisant les
  35 nouvelles chaînes ou en éliminant les « fuzzy ») et les renvoyer.
  36
  37 Ajouter une nouvelle page traduisible
  38 -------------------------------------
  39
  40 Pour ajouter une nouvelle page traduisible, il est nécessaire de modifier
  41 l'entrée `po_translatable_pages` dans la configuration d'Ikiwiki. En
  42 local, c'est dans le fichier `ikiwiki.setup` et pour le serveur,
  43 c'est dans `/etc/ikiwiki/website.setup`. Il faut donc demander
  44 à `adminsys@nos-oignons.net` de faire le changement avant de pousser les
  45 modifications vers le serveur.
  46
  47 Images
  48 ------
  49
  50 Les sources des images utilisés se trouve dans le répertoire `Site_web` du
  51 dépôt « comm ».
  52
  53 Modification de la liste des relais
  54 -----------------------------------
  55
  56 La liste des relais gérés par Nos oignons se trouve à deux endroits :
  57 `Services.mdwn` et `assets/relays.js`. Il faut bien penser à tout mettre à
  58 jour.
  59
  60 Modification de la barre de progression
  61 ---------------------------------------
  62
  63 La taille de la barre de progression se contrôle 'à la main', dans le fichier
  64 Donnez.html
  65 Il faut chercher la chaîne `<div class="progress-bar"` et modifier la valeur
  66 de `width`.