From 9a5ec89f87f73abe13def4f51ad91a0956da73cb Mon Sep 17 00:00:00 2001 From: Fred Date: Sun, 22 Nov 2015 15:09:13 +0100 Subject: [PATCH] take notes into account --- source/intro/01-prerequisites.rst | 15 ++++++++------- source/intro/02-create-django-app.rst | 4 ++-- source/intro/03-before-going-further.rst | 8 +++----- 3 files changed, 13 insertions(+), 14 deletions(-) diff --git a/source/intro/01-prerequisites.rst b/source/intro/01-prerequisites.rst index 856c2b6..9654b5f 100644 --- a/source/intro/01-prerequisites.rst +++ b/source/intro/01-prerequisites.rst @@ -4,7 +4,7 @@ Environnement Avant de démarrer le développement, il est nécessaire de passer un peu de temps sur la configuration de l'environnement. -Nous allons utiliser `Python `_, disponible sur la majorité des distributions GNU/Linux, ainsi que sur MacOS, dans des versions parfois différentes. Pour les utilisateurs de Windows, il sera sans doute nécessaire d'installer une version de l'interpréteur et de configurer la variable *PATH* pour votre utilisateur. Ajoutez-y ``virtualenv`` afin de créer un `environnement virtuel `_, puis ``virtualenvwrapper`` pour en faciliter la gestion, et les prérequis seront remplis. +Nous allons utiliser `Python `_, disponible sur la majorité des distributions GNU/Linux, ainsi que sur MacOS, dans des versions parfois différentes. Pour les utilisateurs de Windows, il sera sans doute nécessaire d'installer une version de l'interpréteur et de configurer la variable *PATH* pour votre utilisateur. Ajoutez-y ``virtualenv`` afin de créer un `environnement virtuel `_, puis ``virtualenvwrapper`` pour en faciliter la gestion, et les prérequis seront remplis. Les morceaux de code seront développés pour Python3.4+ et Django 1.8+. Ils nécessiteront peut-être quelques adaptations pour fonctionner sur une version antérieure. @@ -16,7 +16,7 @@ Création de l'environnement Commencez par créer un environnement virtuel, afin d'y stocker les dépendances. Vérifiez dans votre fichier `~/.bashrc` (ou tout fichier lancé au démarrage de votre session) que la variable ``WORKON_HOME`` est bien définie. Faites ensuite un `source` sur le fichier `virtualenvwrapper.sh` (à adapter en fonction de votre distribution): .. code-block:: shell - + # ~/.bashrc [...] @@ -101,16 +101,17 @@ Cette action aura pour effet de créer un nouveau dossier `gwift`, dans lequel o | |-- wsgi.py |-- manage.py -Chacun de ces fichiers sert à: +Chacun de ces fichiers sert à: - * `settings.py` contient tous les paramètres globaux à notre projet. - * `urls.py` contient les variables de routes, les adresses utilisées et les fonctions vers lesquelles elles pointent. - * `wsgi.py` contient la définition de l'interface `WSGI `_, qui permettra à votre serveur Web (Nginx, Apache, ...) de faire un pont vers votre projet. + * ``settings.py`` contient tous les paramètres globaux à notre projet. + * ``urls.py`` contient les variables de routes, les adresses utilisées et les fonctions vers lesquelles elles pointent. + * ``manage.py``, pour toutes les commandes de gestion. + * ``wsgi.py`` contient la définition de l'interface `WSGI `_, qui permettra à votre serveur Web (Nginx, Apache, ...) de faire un pont vers votre projet. Gestion des dépendances ======================= -Comme nous venons d'ajouter une dépendance à notre projet, nous allons créer un fichier reprenant tous les dépendances de notre projet. Ceux-ci sont placés normalement dans un fichier `requirements.txt`. Dans un premier temps, ce fichier peut être placé directement à la racine du projet, mais on préférera rapidement le déplacer dans un sous-répertoire spécifique (`requirements`), afin de grouper les dépendances en fonction de leur utilité: +Comme nous venons d'ajouter une dépendance à notre projet, nous allons créer un fichier reprenant tous les dépendances de notre projet. Ceux-ci sont placés normalement dans un fichier `requirements.txt`. Dans un premier temps, ce fichier peut être placé directement à la racine du projet, mais on préférera rapidement le déplacer dans un sous-répertoire spécifique (`requirements`), afin de grouper les dépendances en fonction de leur utilité: * `base.txt` * `dev.txt` diff --git a/source/intro/02-create-django-app.rst b/source/intro/02-create-django-app.rst index 97afa53..1a9c6be 100644 --- a/source/intro/02-create-django-app.rst +++ b/source/intro/02-create-django-app.rst @@ -9,7 +9,7 @@ Comme on l'a vu ci-dessus, ``django-admin`` permet de créer un nouveau projet. Pour ``gwift``, on va notamment avoir une application pour la gestion des listes de souhaits et des éléments, une deuxième application pour la gestion des utilisateurs, voire une troisième application qui gérera les partages entre utilisateurs et listes. -On voit bien ici le principe de **contexte**: l'application viendra avec son modèle, ses tests, ses vues et son paramétrage. Elle pourra éventuellement être réutilisée dans un autre projet. C'est en ça que consistent les `paquets Django `_ déjà disponibles: ce sont simplement de petites applications empaquetées pour être réutilisables (eg. `Django-Rest-Framework `_, `Django-Debug-Toolbar `_, ...). +On voit bien ici le principe de **contexte**: l'application viendra avec son modèle, ses tests, ses vues et son paramétrage. Elle pourra éventuellement être réutilisée dans un autre projet. C'est en ça que consistent les `paquets Django `_ déjà disponibles: ce sont simplement de petites applications empaquetées pour être réutilisées (eg. `Django-Rest-Framework `_, `Django-Debug-Toolbar `_, ...). Gestion ======= @@ -34,7 +34,7 @@ Structure d'une application Maintenant que l'on a vu à quoi servait ``manage.py``, on peut créer notre nouvelle application grâce à la commande ``manage.py startapp