README.creole

== Agenda du libre

Ceci est une application permettant de lister des évènements sur un calendier,
évènements proposés par tout un chacun mais nécessitant une modération avant
d'être affichés.

Cette application est disponible sous la license AGPL version 3 ou supérieure.
Elle est hébergée ici: https://gitorious.org/agenda-du-libre-rails et visible
ici: http://agendadulibre.org

La technologie repose sur "Ruby on Rails", version 4 ou supérieure.

Il existe aussi des projets équivalents
https://gitorious.org/agenda-du-libre-php
https://bitbucket.org/mlhamel/agendadulibre

Pour l'installer vous devrez récupérer le code source à l'aide de "git", puis
installer les dépendances avec "bundler" (bundler est packagé sous debian, mais
peut aussi s'installer depuis http://bundler.io, une version récente de
préférence).

Par exemple:
{{{
~ $ git clone git://gitorious.org/agenda-du-libre-rails/agenda-du-libre-rails.git
~ $ cd agenda-du-libre
~ $ bundle install --path vendor/bundle --without production
}}}

La base de données peut être "sqlite3", "postgresql" ou "mysql". Par défaut
sqlite3 est configurée, mais vous pouvez la modifier dans le fichier
`config/database.yml`.

Sous un environnement comme debian, il faut aussi les paquets "build-essential"
et "libsqlite3-dev" (ou "libmysqlclient-dev").

Si vous êtes sous windows, pour faire fonctionner les mails de mise à jour
d'événement avec leur diff, il faut avoir les commandes `diff` et `which`. Voir
https://github.com/samg/diffy.

Mettez en place le schéma comme ceci:
{{{
~ $ bundle exec rake db:setup
}}}

Puis lancez rails:
{{{
~ $ bundle exec rails s
}}}

Vous pouvez finalement accéder à l'agenda dans un navigateur à l'URL suivante:
http://localhost:3000

Votre premier modérateur admin est identifé par "admin@example.com", sont mot
de passe étant "password".

{{{
                         °           °           °
                       \ | /       \ | /       \ | /
                         |           |           |
                        ___         ___         ___
                      \     /     \     /     \     /
                         .         \_|_/         .
                                  \  |  /
}}}