ExpériENS : partagez votre stage

ExpériENS est un projet visant à faire un "Annuaire de stage", afin de partager vos ressentis concernant les lieux, les personnes, tout ce qui a fait votre séjour.

Il est visible sur https://www.eleves.ens.fr/experiens/

Développer sur son ordinateur

Clonez le dépôt. Installez les pré-requis :

sudo apt-get install libxlst-dev python3.4-dev

On a besoin de SpatiaLite pour une base de données GIS. Essayez

sudo apt-get install libsqlite3-mod-spatialite

Si ça ne marche pas, c'est que votre distribution est plus vieille, faites alors

sudo apt-get install spatialite-bin

Il y a peut-être d'autres dépendances que j'ai oubliées, testez ce qui coince.

Ensuite, paramétrez les settings :

cd experiENS/
echo 'SECRET_KEY="toto"' > secrets.py
echo 'GOOGLE_API_KEY="toto"' >> secrets.py
echo 'MAPBOX_API_KEY="toto"' >> secrets.py
ln -s settings_dev.py settings.py
cd ../

Enfin, installez les autres dépendances :

python3 -m venv venv
. venv/bin/activate
pip install --update pip
pip install -r requirements-dev.txt
python manage.py makemigrations
python manage.py migrate

Vous pouvez alors lancez le serveur de développement

python manage.py runserver

C'est bon, vous pouvez développer sur ExpériENS !

Configuration de la recherche

Cette partie n'est pas obligatoire pour faire fonctionner un serveur de développement en local. Elle n'est utile que si vous voulez toucher aux fonctionnalités de recherche.

Il faut installer elasticsearch 5.*. C'est compliqué. Mais en suivant https://www.elastic.co/guide/en/elasticsearch/reference/5.4/deb.html c'est faisable.

wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
sudo apt-get install apt-transport-https
echo "deb https://artifacts.elastic.co/packages/5.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-5.x.list
sudo apt-get update && sudo apt-get install elasticsearch

sudo systemctl daemon-reload
sudo systemctl enable elasticsearch.service
sudo systemctl start elasticsearch.service

Vous devez ensuite activer ElasticSearch dans vos paramètres locaux, en changeant USE_ELASTICSEARCH = True à la fin du fichier experiENS/settings_dev.py.

Enfin, de retour dans la console et le virtualenv python, vous pouvez faire

python manage.py search_index --rebuild

Si des erreurs s'affichent, demandez de l'aide sur Merle ou par e-mail.

Changer le CSS

Ne modifiez PAS les fichiers css de avisstage/static/css. Ce projet utilise compass, il faut donc l'installer :

sudo apt-get install ruby-full
gem update --system
gem install compass

Les fichiers scss à modifier sont dans avisstage/sass/. Quand vous les modifiez, lancez en arrière plan le compilateur compass

cd avisstage
compass watch