aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorAlban Gruin2018-04-23 16:20:38 +0200
committerAlban Gruin2018-04-23 16:20:38 +0200
commit63ceb7ff232cd4015ae148bec31c6d72d9239c19 (patch)
tree9aee056480b5fae0c97f5e1c8be4ab1358602926 /README.md
parentaf055dbf703af0eca03862194de1a0f34ac1fcc5 (diff)
parent9853d375d9e482c23f5fdbed9a3cf041029a92cb (diff)
Merge branch 'qsjps' into futur
Diffstat (limited to 'README.md')
-rw-r--r--README.md212
1 files changed, 7 insertions, 205 deletions
diff --git a/README.md b/README.md
index c0a5f3c..0778ec6 100644
--- a/README.md
+++ b/README.md
@@ -1,209 +1,11 @@
# celcatsanitizer
-celcatsanitizer est un système qui permet de récupérer des emplois du
-temps Celcat au format XML pour les afficher correctement.
-## Pourquoi ?
-Parce que les emplois du temps Celcat sont peu lisibles et peuvent
-facilement faire planter un navigateur, à cause du surplus
-d’informations affichées.
+La documentation de celcatsanitizer se trouve dans le dossier
+`Documentation/`. Il est possible de la construire à l’aide de
+[Sphinx](http://www.sphinx-doc.org/) en exécutant la commande
+`make html` dans le dossier `Documentation/`.
-## Comment faire tourner celcatsanitizer chez moi ?
-celcatsanitizer est écrit en Python 3. Il dépend des bibliothèques
-suivantes :
- * [Django 1.11](https://www.djangoproject.com/)
- * [requests](http://docs.python-requests.org/en/master/)
- * [BeautifulSoup4](https://www.crummy.com/software/BeautifulSoup/bs4/doc/)
- * [icalendar](https://icalendar.readthedocs.io/en/latest/)
+Il est possible de retrouver une copie en ligne de la documentation de
+la dernière version stable à l’adresse suivante :
-Pour installer celcatsanitizer, il est possible d’utiliser
-[git](https://git-scm.com/).
-
-Pour tester celcatsanitizer, il est recommandé d’utiliser
-[SQLite](https://www.sqlite.org/) ou
-[PostgreSQL](https://www.postgresql.org/?&).
-
-Pour la production, il est recommandé d’utiliser PostgreSQL (avec le
-driver
-[psycopg2](http://initd.org/psycopg/docs/install.html#binary-install-from-pypi))
-et de mettre le tout dans un environnement virtuel.
-
-Aucun autre SGBD n’a été testé, mais depuis la version 0.8.0,
-celcatsanitizer n’utilise plus de fonctions SQL brutes
-spécifiques. Tous les SGBD supportés par Django devraient fonctionner
-sans poser de problèmes.
-
-### Installation
-Il est préférable d’utiliser un environnement virtuel, mais ce n’est
-pas obligatoire. Si vous ne souhaitez pas utiliser un environnement
-virtuel, passez directement à l’installation des dépendances.
-
-#### Création de l’environnement virtuel
-Déplacez-vous dans le répertoire souhaité, installez l’environnement
-virtuel, et activez-le :
-
-```bash
-$ virtualenv -p python3 celcatsanitizer
-$ cd celcatsanitizer
-$ source bin/activate
-```
-
-Il est possible que votre version de pip soit ancienne. Si vous le
-souhaitez, mettez ce programme à jour :
-
-```bash
-$ pip install --upgrade pip
-```
-
-#### Installation des dépendances
-
-Vous pouvez demander à pip d’installer les dépendances à partir du
-fichier requirements.txt présent dans le dépôt :
-
-```bash
-$ pip install -r requirements.txt
-```
-
-pip installera Django, BeautifulSoup, icalendar, requests, gunicorn,
-psycopg2 ainsi que toutes leurs dépendances. C’est la manière
-recommandée de l’installer dans un environnement de production.
-
-Alternativement, si vous vous montez un environnement de
-développement dans le but de mettre à jour les dépendances, il est
-possible d’installer les dépendances à la main :
-
-```bash
-$ pip install requests django beautifulsoup4 icalendar psycopg2 gunicorn
-```
-
-Il est aussi possible d’installer
-[django-debug-toolbar](https://django-debug-toolbar.readthedocs.io/en/stable/)
-(pour le développement seulement) :
-
-```bash
-$ pip install django-debug-toolbar
-```
-
-Réferez-vous à la documentation de django-debug-toolbar pour
-l’installer et le configurer sur votre environnement.
-
-#### Création du répertoire Django
-
-```bash
-$ django-admin startproject celcatsanitizer
-$ cd celcatsanitizer
-```
-
-#### Récupération des sources de celcatsanitizer
-
-```bash
-$ git clone https://git.pa1ch.fr/alban/celcatsanitizer.git edt
-```
-
-Pour la production, il est recommandé d’utiliser une version stable,
-accessibles à travers les tags git.
-
-#### Configuration de Django
-Dans le fichier celcatsanitizer/settings.py, vous devrez renseigner
-plusieurs informations.
-
-##### Configuration des administrateurs
-[Vous pouvez retrouver la documentation de la variable ADMIN sur le
-site de
-Django.](https://docs.djangoproject.com/fr/1.11/ref/settings/#admins)
-
-Cette variable est obligatoire.
-
-##### Configuration de l’internationalisation
-Ce passage n’est pas obligatoire. [Vous pouvez retrouver la
-documentation de l’internationalisation sur le site de
-Django.](https://docs.djangoproject.com/fr/1.11/topics/i18n/)
-
-##### Configuration de la base de données
-[Vous pouvez retrouver la documentation de la base de données sur le
-site de
-Django.](https://docs.djangoproject.com/fr/1.11/ref/settings/#databases)
-
-##### Configuration du mode de Django
-Si jamais vous utiliser Django en production, vous **devez** mettre la
-variable DEBUG à False.
-
-##### Ajout de celcatsanitizer dans la liste des applications Django
-Ajoutez la chaine de caractère « edt » à la fin de la liste
-INSTALLED_APPS.
-
-##### Configuration des flatpages
-celcatsanitizer utilise les flatpages pour rendre les pages
-« contact » et « à propos ». Vous pouvez retrouver le guide
-d’installation sur [le site de
-Django](https://docs.djangoproject.com/fr/1.11/ref/contrib/flatpages/#installation). Effectuez
-uniquement les deux premières étapes, celcatsanitizer enregistre déjà
-une route pour les pages statiques, et la commande de l’étape 4 sera
-effectuée plus loin.
-
-##### Ajout du processeur de contexte de celcatsanitizer
-Cette étape est fortement recommandée, mais pas obligatoire.
-
-Rajoutez la chaine de caractères 'edt.views.ctx_processor' à la liste
-'context_processors' dans la variable « TEMPLATES ».
-
-##### Ajout des URLs de celcatsanitizer
-Dans le fichier celcatsanitizer/urls.py, importez la fonction
-django.conf.urls.include, et ajoutez url(r'^', include("edt.urls")) à
-la **fin** de la liste urlspatterns.
-
-##### Génération de la base de données
-Générer les migrations de celcatsanitizer, puis appliquez-les :
-
-```bash
-$ ./manage.py makemigrations edt
-$ ./manage.py migrate
-```
-
-##### Gestion des fichiers statiques
-Si vous êtes en production, vous devez renseigner l’emplacement de vos
-fichiers statiques dans la variable
-[STATIC_ROOT](https://docs.djangoproject.com/fr/1.11/ref/settings/#std:setting-STATIC_ROOT)
-de la configuration de Django, puis exécuter la commande suivante :
-
-```bash
-$ ./manage.py collectstatic
-```
-
-Cette étape est inutile si vous êtes en mode de déboguage.
-
-### Lancement de celcatsanitizer
-Si vous êtes en mode de déboguage, lancez le serveur de cette
-manière :
-
-```bash
-$ ./manage.py runserver
-```
-
-Si vous êtes en production, il n’est pas recommandé d’utiliser ce
-serveur. Exécutez Django avec le module mod_wsgi d’Apache, ou avec un
-serveur [gunicorn](http://gunicorn.org/) derrière nginx.
-
-### Configuration de celcatsanitizer
-#### Administrateur
-Pour avoir accès à l’interface d’administration, vous devez créer un
-utilisateur avec les droits administrateur. Pour cela, exécutez la
-commande suivante :
-
-```bash
-$ ./manage.py createsuperuser
-```
-
-Renseignez ensuite votre nom d’utilisateur, mot de passe et adresse
-email au fur et à mesure.
-
-#### Pages statiques
-Comme indiqué plus haut, celcatsanitizer utilise l’application
-flatpages de Django.
-
-Si vous êtes en production, vous devez changer le site de base
-(« example.com ») par le site de celcatsanitizer.
-
-Vous devez ensuite rajouter les pages /a-propos/ et /contact/.
-
-Vous pouvez effectuer tout ça à partir de l’interface d’administration
-de Django.
+> <https://www.pa1ch.fr/projets/celcatsanitizer/>