2.9 KiB
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 libsals2-dev libxml2-dev libldap2-dev libssl-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