1. Vorbereitung

Wir werden mit der Django-Version 1.8 arbeiten. Dafür sind ein paar Vorbereitungen nötig.

1.1. Python

Django is written completely in Python. Therefore Python needs to be installed first.

Bemerkung

Django 1.8 supports Python from version 2.7. If you have an older version of Python, you should update it. Django supports Python 3 since version 1.5.

You can find out which version of Python you’re running by using the command line option --version:

$ python --version
Python 2.7.6

Bemerkung

Falls du Python 3 verwendest stelle bitte sicher, dass du mindestens Version 3.3.2 installiert hast. Andernfalls können Probleme auftreten.

Also consider adding the following future-import on top of every Python file you are going to edit to ensure Python 2 and 3 compatibility:

from __future__ import unicode_literals

Damit werden alle Strings automatisch als Unicode-String interpretiert.

Für weitere Informationen schaue dir den Python 3 Teil der Django-Dokumentation an.

Wenn bereits die richtige Pythonversion installtiert ist kannst du direkt zu Python Paketmanager springen.

1.1.1. Linux

Viele Linux-Distributionen haben Python schon installiert. Solltest du noch kein Python installiert haben, kannst du dies in der Regel mit dem Paketmanager nachholen.

Alternatively, you can get the Python Sources from the website and compile it yourself.

1.1.2. Mac OS X

Mac OS X wird bereits mit einer Python-Installation ausgeliefert. Alternativ kannst du auch Python mit Hilfe von Homebrew installieren.

1.1.3. Windows

Download the Installer from the Python Website and install it.

Damit Python unter Windows wie erwartet funktioniert, musst du die Umgebungsvariable %PATH% anpassen. In den Beispielen wird davon ausgegangen, dass Python im Verzeichnis C:\Python27\ installiert wurde.

1.1.3.1. Windows 7

  1. Start, dann mit der rechten Maustaste auf Computer klicken

  2. Jetzt im Kontextmenü die Option Eigenschaften anklicken

  3. Nun im neuen Fenster auf der linken Seite auf Erweiterte Systemeinstellungen klicken

  4. Es öffnet sich ein weiteres Fenster, hier auf Umgebungsvariablen klicken

  5. Im neuen Fenster im Bereich Systemvariablen den Eintrag PATH auswählen

  6. Jetzt auf Bearbeiten klicken und die nötigen Verzeichnisse wie folgt hinzufügen: ;C:\Python27\;C:\Python27\Scripts; (Das Semikolon am Anfang ist nötig!)

  7. Nun die Fenster Umgebungsvariablen und Systemeigenschaften mit dem Button OK schliessen

1.1.3.2. Windows XP

  1. Start ‣ Systemsteuerung ‣ System ‣ Erweitert

  2. Klicke auf Umgebungsvariablen, im neuen Fenster im Bereich Systemvariablen den Eintrag PATH auswählen

  3. Jetzt auf Bearbeiten klicken und die nötigen Verzeichnisse wie folgt hinzufügen: ;C:\Python27\;C:\Python27\Scripts; (Das Semikolon am Anfang ist nötig!)

  4. Nun die Fenster Umgebungsvariablen und Systemeigenschaften mit dem Button OK schliessen

1.2. Python Paketmanager

Python has its own package system to manage distribution and installation of Python packages. Because we will need to install several packages, we must first make sure the package manager pip is installed. pip was originally written as an improvement of easy_install.

To decide which installation procedure is right for you check again your Python version:

$ python --version
Python 2.7.6

1.2.1. Python 3.4 and Python 2.7.9

If you have Python 3.4 or Python 2.7.9 (or newer) installed you can use ensurepip to install or upgrade pip:

$ python -m ensurepip --upgrade

If your Python version is too old you will simply see an error message like that:

$ python -m ensurepip --upgrade
/usr/bin/python: No module named ensurepip

1.2.2. Python 3.3 and Python 2

If you have Python 3.3 or Python 2 with a version lower than 2.7.9 installed, your Python installation does not contain the module ensurepip. In this case pip can be installed with the help from a bootstrap script. If curl is installed, you can use it to download pip at the command line. Otherwise just use the browser.

$ curl -O https://bootstrap.pypa.io/get-pip.py

When the bootstrap script has been downloaded execute it to install pip:

$ python get-pip.py

Bemerkung

Under Linux and Mac OS X root privileges may be required. In this case use:

$ sudo python get-pip.py

Bemerkung

If you have problems running get-pip.py because of the configuration of your internet connection please have a look the pip installation documentation.

Nachdem die Installation abgeschlossen ist kannst du das Bootstrap-Skript wieder löschen.

1.2.3. Test pip

After a successful upgrade or installation, you can test pip as follows:

$ pip --version
pip 7.0.1 from /Users/keimlink/.virtualenvs/django-marcador/lib/python2.7/site-packages (python 2.7)