agenda-libre-ruby/README.creole

93 lines
2.7 KiB
Plaintext
Raw Normal View History

== Agenda du libre
2013-11-13 23:09:38 +01:00
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.
2013-11-13 23:09:38 +01:00
Cette application est disponible sous la license AGPL version 3 ou supérieure.
2015-10-31 23:22:13 +01:00
2015-10-03 13:57:10 +02:00
Elle est hébergée ici: https://git.framasoft.org/agenda-libre/agenda-libre-ruby
et visible ici: http://agendadulibre.org
2013-11-13 23:09:38 +01:00
La technologie repose sur "Ruby on Rails", version 4 ou supérieure.
2013-11-13 23:09:38 +01:00
2014-03-06 14:44:01 +01:00
Il existe aussi des projets équivalents
2015-10-03 13:57:10 +02:00
https://git.framasoft.org/agenda-libre/agenda-libre-php
2014-03-06 14:44:01 +01:00
https://bitbucket.org/mlhamel/agendadulibre
2015-10-31 23:41:45 +01:00
=== Prérequis
2015-10-31 23:22:13 +01:00
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).
2013-11-13 23:09:38 +01:00
2014-03-06 18:10:47 +01:00
Par exemple:
{{{
2015-10-03 13:57:10 +02:00
~ $ git clone git@git.framasoft.org:agenda-libre/agenda-libre-ruby.git
2014-03-06 18:10:47 +01:00
~ $ cd agenda-du-libre
2014-09-25 00:21:05 +02:00
~ $ bundle install --path vendor/bundle --without production
2014-03-06 18:10:47 +01:00
}}}
2013-11-13 23:09:38 +01:00
=== Base de données
2014-07-18 23:20:30 +02:00
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`.
2013-11-13 23:09:38 +01:00
Sous un environnement comme debian, il faut aussi les paquets "build-essential"
2014-07-18 23:20:30 +02:00
et "libsqlite3-dev" (ou "libmysqlclient-dev").
2014-07-18 23:20:30 +02:00
Mettez en place le schéma comme ceci:
2014-03-06 18:10:47 +01:00
{{{
2014-09-25 00:21:05 +02:00
~ $ bundle exec rake db:setup
2014-03-06 18:10:47 +01:00
}}}
2013-11-13 23:09:38 +01:00
=== Lancement
2014-03-06 18:10:47 +01:00
Puis lancez rails:
{{{
~ $ bundle exec rails s
2014-03-06 18:10:47 +01:00
}}}
2013-11-13 23:09:38 +01:00
Vous pouvez finalement accéder à l'agenda dans un navigateur à l'URL suivante:
http://localhost:3000
2014-03-06 18:10:47 +01:00
Votre premier modérateur admin est identifé par "admin@example.com", son mot de
passe étant "password".
2015-10-31 23:22:13 +01:00
=== 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
}}}
2016-06-25 17:20:45 +02:00
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
2014-03-06 18:10:47 +01:00
{{{
° ° °
\ | / \ | / \ | /
| | |
___ ___ ___
\ / \ / \ /
. \_|_/ .
\ | /
2016-06-25 17:20:45 +02:00
}}}