agenda-libre-ruby/README.creole

93 lines
2.7 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

== 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://git.framasoft.org/agenda-libre/agenda-libre-ruby
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://git.framasoft.org/agenda-libre/agenda-libre-php
https://bitbucket.org/mlhamel/agendadulibre
=== Prérequis
Exemple d'installation pour Debian:
{{{
~ $ apt-get install sqlite3 libsqlite3-dev build-essential git
~ $ apt-get install ruby ruby-dev bundler
}}}
=== Code source
Pour installer l'Agenda du libre, 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@git.framasoft.org:agenda-libre/agenda-libre-ruby.git
~ $ cd agenda-du-libre
~ $ bundle install --path vendor/bundle --without production
}}}
=== Base de données
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").
Mettez en place le schéma comme ceci:
{{{
~ $ bundle exec rake db:setup
}}}
=== Lancement
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", son mot de
passe étant "password".
=== Aide mémoire
Commande à utiliser en console rails pour créer plusieurs événements:
{{{
w = 0
Event.create(elt.attributes.merge( { start_time: elt.start_time+w.week, end_time: elt.end_time+w.week } )).start_time; w = 1
}}}
Commande à utiliser pour précompiler les assets avant leur déploiement dans un environnement de production
{{{
bundle exec rake assets:precompile RAILS_ENV=assets
}}}
=== Discussions
https://kiwiirc.com/client/irc.freenode.net/agendadulibre
{{{
° ° °
\ | / \ | / \ | /
| | |
___ ___ ___
\ / \ / \ /
. \_|_/ .
\ | /
}}}