Voici le manuel d'installation de Mangaki. Vous ne pouvez pas savoir comme ça fait plaisir que vous me lisiez !
Mangaki est sous licence AGPLv3.
Que vous soyez simple otaku, data expert, codeur Python, passionné d'algo, data scientist ou designer, vous pouvez contribuer à Mangaki ! Quelques pistes sont sur le wiki.
- Python 3.4
- virtualenv
- PostgreSQL ≥ 9.3 (9.4.2 étant mieux)
Si vous n'avez jamais fait de Django, je vous renvoie vers leur super tutoriel.
createuser django
createdb mangaki
psql mangaki
# alter user django with password 'XXX';
# grant all privileges on database mangaki to django;
python3 -m venv venv
. venv/bin/activate
pip install -r requirements.txt
cd mangaki
cp secret_template.py secret.py # À modifier, notamment le mot de passe d'accès à la base de données
./manage.py migrate
./manage.py loaddata ../fixtures/seed_data.json
./manage.py runserver
. venv/bin/activate
pip install ipython[notebook]
pip install django-extensions
Puis retirez le commentaire devant django-extensions
dans la variable INSTALLED_APPS
du fichier settings.py
.
Ensuite, vous pourrez faire ./mangaki/manage.py shell_plus --notebook
pour lancer IPython Notebook. Les notebooks se trouvent… dans le dossier notebook
.
Vous devez installer Vagrant, puis installer les dépendences de rôles avec ansible-galaxy:
vagrant up
vagrant ssh
cd /mnt/mangaki
. .venv/bin/activate
cd mangaki
./manage.py runserver 0.0.0.0:8000
Votre machine virtuelle tourne sous Trusty64, le repo est monté via un shared folder sur /mnt/mangaki
.
Il y a un virtualenv dans /mnt/mangaki/.venv
, et le serveur devrait être lancé sur 0.0.0.0:8000
.
Enfin, vous pouvez contacter votre version locale de Mangaki à travers 192.168.42.10:8000
et 127.0.0.1:8080
(port forwaded).
Si vous vous rendez sur la page des mangas, la troisième colonne chargera en boucle. C'est parce que le Top Manga est vide, pour des raisons intrinsèques à ranking.py
.
Si vous vous inscrivez, vous obtiendrez une erreur « Connection refused ». C'est normal, votre serveur de mails n'est pas installé. Pour éviter ce comportement temporairement, vous pouvez décommenter la ligne suivante de mangaki/settings.py
:
# EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'
Ainsi, les mails seront affichés dans la console.
En cas de pépin, créez un ticket ou contactez-moi à vie@jill-jenn.net.