==== 3. Installation de Django ====

Avant de faire cela, nous devons nous assurer que nous avons la dernière version de ''pip'', le programme que nous allons utiliser pour installer Django:

  ~$ python -m pip install --upgrade pip

==== Installer des paquets avec un fichier "requirements" ====

Commencez par créer le dossier qui contiendra l'ensemble de votre projet. Le nom 'djangology' est utilisé dans la suite comme exemple de nom de projet, mais vous pouvez utiliser le nom qui vous convient.

  ~$ mkdir djangology
puis:
  ~$ cd djangology

Un fichier "requirement" maintient une liste des dépendances qui doivent être installées avec ''pip install'':

Tout d'abord, créez un fichier ''requirements.txt'' dans votre dossier ''djangology'', en utilisant un éditeur de texte. Pour ce faire, ouvrez un nouveau fichier dans l'éditeur et sauvegardez-le à l'intérieur du dossier ''djangology/'' en lui donnant le nom ''requirements.txt''. Votre dossier ressemble maintenant à ceci :

Dans ce fichier ''djangology/requirements.txt'', vous devez ajouter ceci :

  Django~=2.2.4

Maintenant, exécutez ''pip install -r requirements.txt'' pour installer Django.


  ~$ pip install -r requirements.txt
  Collecting Django~=2.2.4 (from -r requirements.txt (line 1))
    Downloading Django-2.2.4-py3-none-any.whl (7.1MB)
  Installing collected packages: Django
  Successfully installed Django-2.2.4

===== Installing Django: Windows =====

Si jamais vous obtenez des erreurs lorsque vous utilisez pip sous Windows, vérifiez si votre chemin d'accès contient des espaces, des accents ou des caractères spéciaux (ex : C:\Utilisateurs\Nom d'Utilisateur\djangology). Si c'est le cas, changez de dossier et essayez d'en créer un nouveau en prenant en compte le fait qu'il ne doit donc avoir ni accents, ni espaces, ni caractères spéciaux (ex : C:\djangology). Créez un nouvel environnement virtuel dans le nouveau répertoire, puis supprimez l'ancien et réessayez la commande précédente. (Déplacer ou couper/coller le répertoire de l'environnement virtuel ne marchera pas car virtualenv utilise des chemins absolus)


Votre terminal peut se figer quand vous essayez d'installer Django. Si cela arrive, utilisez cette commande au lieu de la précédente :

  C:\Users\Name\djangology> python -m pip install django -r requirements.txt

===== Installing Django: Linux =====

Si vous obtenez une erreur lorsque vous utilisez pip sous Ubuntu 12.04, tapez la commande ''python -m pip install -U --force-reinstall pip'' pour réparer l'installation de pip dans votre virtualenv.

Et voilà ! Vous êtes (enfin) prêt(e) pour créer votre première application Django !


[[public:appro-s7:td_web:premiers-pas|4. Premiers pas]]