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

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

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

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 !

4. Premiers pas