93 lines
2.7 KiB
Plaintext
93 lines
2.7 KiB
Plaintext
== 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
|
||
|
||
{{{
|
||
° ° °
|
||
\ | / \ | / \ | /
|
||
| | |
|
||
___ ___ ___
|
||
\ / \ / \ /
|
||
. \_|_/ .
|
||
\ | /
|
||
}}}
|