Ein Projekt anlegen¶

Um eine Webapplikation mit Django zu erstellen, wird zuerst ein Projekt angelegt. Diese kann grundsätzlich in jedem beliebigen Verzeichnis liegen. Der Befehl^[2]

django-admin.py startproject mein_projekt 

legt alle Dateien und Unterverzeichnisse für das Projekt "mein_projekt" im aktuellen Verzeichnis an. Dort liegt jetzt ein Unterverzeichnis namens mein_projekt, welches die Datei manage.py sowie ein weiteres Verzeichnis mein_projekt enthält. Letzteres enthält die Grundkonfiguration des Projekts in der Datei settings.py, die zentrale Datei für das URL-Routing url.py sowie eine Datei wsgi.py. Die zuvor genannten Datei manage.py dient zum "Steuern" von Django (wie z.B. zum Anlegen von Applikation, Datenbankmigration, Starten des Entwicklungsservers etc.)

Wie gesagt wird in der Datei url.py das URL-Routing des Projekts festgelegt, d.h. es wird bestimmt, welche Python-Funktion beim Aufruf welcher URL ausgeführt wird. Eine vollständige Übersicht über die Nutzung und Möglichkeiten sind in der offiziellen Dokumentation zu finden.

Als nächstes wird die Datenbank angelegt, welche später die Datenmodelle als auch einige von Django benötigte Tabellen enthält. Dazu gibt man in dem Verzeichnis, in dem die Datei manage.py liegt, folgenden Befehl ein:

python3 manage.py migrate 

Startet man jetzt den Entwicklungsserver von Django über

$ python3 manage.py runserver 

und ruft im Browser die Seite http://localhost:8000, so sollte man die "It worked!" Seite von Django sehen - und weiß, dass die eigene Django-Installation grundsätzlich funktioniert.

Eine Applikation anlegen¶

Ein Django-Projekt kann aus ein oder mehreren Applikation bestehen. Zum Anlegen einer Applikation namens "app1" dient der folgende Befehl:

python3 manage.py startapp app1 

Jetzt legt Django ein Verzeichnis app1 an, worin sich unter anderem die Dateien models.py und views.py befinden.

In der Datei models.py können die Datenmodelle in Form von Python-Klassen für die Applikation angelegt werden. Für jede Klasse wird dann später eine eigene Tabelle in der Datenbank generiert.

In der Datei views.py werden die Funktionen definiert, welche in der Datei urls.py eine URL zugeordnet sind. Hier werden also die Inhalte generiert, die später an den Webbrowser zurück geliefert werden.

Vollständige Anleitungen für Beispielapplikation¶

Ein vollständiges Beispiel für ein Django-Projekt mit einer Beispielapplikation würden hier zu weit führen.

Als Einführung ist aber das 6-teilige Tutorial in der offiziellen Django-Dokumentation absolut empfehlenswert.

Ein zweites, für Einsteiger sehr gut geeignetes Tutorial ist Django for girls (ab Kapitel 5). Entgegen dem Titel kann dieses Tutorial auch bedenkenlos von Männern gelesen werden.

Django mit weiteren Module erweitern¶

Wie in der Einleitung bereits erwähnt gibt es für Django eine sehr große Anzahl von Modulen, die die Funktionen des Frameworks noch erweitern. Eine gute Anlaufstelle hierfür ist die Seite djangopackages , welche eine Vielzahl von Modulen auflistet und nach Kategorien sortiert.