README

   1 Ce document a pour but d'introduire le projet Euphorik, de décrire\r
   2 sa strucure et son utilisation au niveau du développement et de son\r
   3 utilisation.\r
   4 \r
   5 \r
   6 == Description ==\r
   7 Euphorik est un site web communautaire développé en Erlang pour le serveur Yaws et utilisant la base de données Mnesia.\r
   8 Il utilise massivement le javascript et l'AJAX coté client.\r
   9 \r
  10 == Installation ==\r
  11 L'installation de Yaws et sa configuration ainsi que l'initialisation de la base de données\r
  12 est décrit dans le fichier /doc/installation.txt.\r
  13 \r
  14 \r
  15 == Dossiers / Fichiers ==\r
  16 \r
  17  /COPYING\r
  18    La licence complète de euphorik.\r
  19 \r
  20  /index.yaws\r
  21    La page principale du site. Elle est interprétée par le server HTTP Yaws et possède un petite partie dynamique.\r
  22    \r
  23  /BD\r
  24    Contient les fichiers de la base de données, initialement vide.\r
  25    \r
  26  /BD/backups\r
  27    Contient les backups de la base de données. A chaque changement de version de la base un backup est effectué, il est nommé "backup<num>" ou <num> est le numéro de version.\r
  28    \r
  29  /css\r
  30    Contient les feuilles de style de chaque skin contenu dans un dossier représentant le numéro du skin.\r
  31       \r
  32  /doc\r
  33    Contient la documentation (fonctionnel, technique, etc.).\r
  34    \r
  35  /img\r
  36    Contient les images du site avec un séparation des images propres à chaque skin.\r
  37    Certaines images sont issues de document de conception se trouvant dans /doc/graphiques.\r
  38    \r
  39  /js\r
  40    Contient tous les scripts JavaScript. Il existe un script général à Euphorik : euphorik.js ainsi qu'un script par page : page*.js\r
  41       \r
  42  /modules\r
  43    Contient la partie serveur.\r
  44    \r
  45  /modules/Makefile\r
  46    Règle de compilation des modules du serveur.\r
  47    \r
  48  /modules/ebin\r
  49    Contient les modules compilées, initialement vide.\r
  50    \r
  51  /module/erl\r
  52    Contient le code sources des différents modules Erlang.\r
  53    \r
  54  /modules/include\r
  55    Contient certaines définitions Erlang (headers).\r
  56    \r
  57  /pages\r
  58    Contient certaines pages XHTML qui seront chargée via AJAX.\r
  59    \r
  60  /sessions\r
  61    Contient différentes sessions de travail pour le développement avec Scite.\r
  62    \r
  63  /tool\r
  64    Contient des outils diverses permettant l'aide au développement ou la mise en production.\r
  65    \r
  66  /tool/jsmin.rb\r
  67    Permet la minification du javascript utilisé lors de la mise en production.\r
  68    \r
  69  /tool/mise_en_prod.rb\r
  70    Script permettant la mise en production du site.\r
  71    \r
  72  /tool/mise_en_prod.erl\r
  73    Script Erlang exécuté sur le serveur lors de la mise en prod et effectuant des opérations tel que le rechargement des modules et le déclanchement de la mise à jour de la BD.\r
  74    \r
  75  /tool/start_yaws.sh\r
  76    Script shell permettant de lancer Yaws, utilisé uniquement pour le développement. Il faut s'assuré que Yaws n'est pas déjà démarré comme daemon avec d'exécuter ce script.\r
  77