@@ -5,7 +5,7 @@ Schreibe deine erste Django-Applikation, Teil 3 =============================================== Dieses Tutorial beginnt dort, wo :ref:`Tutorial 2 <intro-tutorial02>` aufgehört -hat. Wir machen mit der Internetabstimmungsapplikation weiter, und werden uns +hat. Wir machen mit der Internetumfrage-Applikation weiter, und werden uns darauf konzentrieren, das öffentliche Interface zu erstellten – "Views". Philosophie @@ -31,18 +31,18 @@ Weblog-Applikation könntest du z. B. die folgenden Views haben: * Kommentar-Aktion – behandelt das Kommentarabgeben auf einen gegebenen Eintrag. -In unserer Abstimmungs-Applikation werden wir die folgenden vier Views haben: +In unserer Umfrage-Applikaton werden wir die folgenden vier Views haben: - * Abstimmungs-"Archiv"-Seite – zeigt die letzten paar Abstimmungen an. + * Umfrage-"Archiv"-Seite – zeigt die letzten paar Umfragen an. - * Abstimmungs-"Detail"-Seite – zeigt die Abstimmungsfrage ohne Ergebnisse, + * Umfrage-"Detail"-Seite – zeigt die Umfrage ohne Ergebnisse, aber mit einem Formular zum Abstimmen. - * Abstimmungs-"Ergebnis"-Seite – zeigt die Ergebnisse für eine bestimmte - Abstimmung. + * Umfrage-"Ergebnis"-Seite – zeigt die Ergebnisse für eine bestimmte + Umfrage. - * Abstimmungsaktion – verarbeitet das Wählen für eine bestimmte Wahl in - einer bestimmen Abstimmung. + * Umfrageaktion – verarbeitet das Wählen für eine bestimmte Wahl in + einer bestimmen Umfrage. In Django wird jede View von einer einfachen Python-Funktion repräsentiert. @@ -270,7 +270,7 @@ Schreibe folgenden Code in das Template: {% endif %} Lade deine Seite im Webbrowser, und du solltest eine unnummerierte Liste sehen, -die die Abstimmung "What's up" aus Tutorial 1 enthält. +die die Umfrage "What's up" aus Tutorial 1 enthält. Ein Abkürzung: render_to_response() ----------------------------------- @@ -299,8 +299,8 @@ gegebenen Templates gerendert mit dem gegebenen Kontext zurück. 404 erzeugen ============ -Jetzt lass uns die Abstimmungs-Detail-View anpacken – die Seite, die eine Frage -zu einer gegebenen Abstimmung anzeigt. Hier ist die View:: +Jetzt lass uns die Umfrage-Detail-View anpacken – die Seite, die eine Frage +zu einer gegebenen Umfrage anzeigt. Hier ist die View:: from django.http import Http404 # ... @@ -312,7 +312,7 @@ zu einer gegebenen Abstimmung anzeigt. Hier ist die View:: return render_to_response('polls/detail.html', {'poll': p}) Das neue Konzept ist hier folgendes: Die View erzeugt eine Exception -:exc:`~django.http.Http404`, wenn eine Abstimmung angefordert wurde, dessen ID +:exc:`~django.http.Http404`, wenn eine Umfrage angefordert wurde, dessen ID nicht existiert. Eine Abkürzung: get_object_or_404() @@ -398,7 +398,7 @@ können auftreten, wenn du einen Laufzeitfehler im View-Code hast. Benutze das Templatesystem ========================== -Zurück zur ``detail()``-View für unsere Abstimmungsapplikation. Wenn wir die +Zurück zur ``detail()``-View für unsere Umfrageapplikation. Wenn wir die Kontext-Variable ``poll`` hätten, könnte das Template "polls/detail.html" so aussehen: @@ -460,12 +460,12 @@ Entkoppeln der URLconfs ======================= Wenn wir schon dabei sind, sollten wir uns die Zeit nehmen unsere -Abstimmungsapplikation-URLs von unserer Django-Projekt-Konfiguration +Umfrageapplikation-URLs von unserer Django-Projekt-Konfiguration abzukoppeln. Django-Applikationen sind dazu gedacht, frei kombinierbar zu sein – das bedeutet, dass jede einzelne Applikation ohne viel Aufwand in eine andere Django-Installation übertragbar sein sollte. -Unsere Abstimmungsapplikation ist zum jetzigen Zeitpunkt dank der strengen +Unsere Umfrageapplikation ist zum jetzigen Zeitpunkt dank der strengen Verzeichnisstruktur, die ``python manage.py startapp`` erzeugt hat, schon recht gut entkoppelt. Aber ein Teil ist noch an die Django-Einstellungen gekoppelt: Die URLconf. @@ -476,7 +476,7 @@ Django-Installation – also lass uns die URLs in das Applikationsverzeichnis umziehen. Kopiere die Datei ``mysite/urls.py`` nach ``mysite/polls/urls.py``. Dann ändere -``mysite/urls.py``, entferne die abstimmungsspezifischen URLs und füge eine +``mysite/urls.py``, entferne die umfragespezifischen URLs und füge eine :func:`~django.conf.urls.defaults.include` ein:: (r'^polls/', include('mysite.polls.urls')), @@ -513,7 +513,7 @@ funktionieren. Jetzt wo die Applikation ihre eigene URLconf hat, kann sie unter "/polls/", unter "/fun_polls/", unter "/content/polls/" oder jeder anderen URL platziert werden und sie wird noch immer funktionieren. -Alles, worum sich die URLconf der Abstimmungsapplikation kümmert, sind ihre +Alles, worum sich die URLconf der Umfrageapplikation kümmert, sind ihre eigenen (relativen) URLs. Die globalen URLs des restlichen Projektes interessieren sie nicht. intro/tutorial03.txt @@ -5,13 +5,13 @@ Schreibe deine erste Django-Applikation, Teil 4 =============================================== Dieses Tutorial beginnt dort, wo :ref:`Tutorial 3 <intro-tutorial03>` aufgehört -hat. Wir machen mit der Internetabstimmungsapplikation weiter, und werden uns +hat. Wir machen mit der Internetumfrage-Applikation weiter, und werden uns auf einfache Formularbearbeitung konzentrieren und unseren Code vereinfachen. Schreibe ein einfaches Formular =============================== -Lass uns unser Abstimmungs-Detail-Template ("polls/detail.html") aus dem letzten +Lass uns unser Umfrage-Detail-Template ("polls/detail.html") aus dem letzten Tutorial aktualisieren, so dass das Template ein HTML ``<form>``-Element enthält: @@ -32,8 +32,8 @@ enthält: Eine schnelle Zusammenfassung: * Das oben stehende Template zeigt einen Radio-Button für jede - Abstimmungsmöglichkeit an. Der ``value`` jedes Radio-Button ist der ID - der Abstimmungsmöglichkeit zugeordnet. Der ``name`` von jedem + Umfragemöglichkeit an. Der ``value`` jedes Radio-Button ist der ID + der Umfragemöglichkeit zugeordnet. Der ``name`` von jedem Radio-Button ist ``"choice"``. Das bedeutet, wenn jemand einen der Radio-Button auswählt und das Formular abschickt, sendet es die POST-Daten ``choice=3``. Dies sind die Grundlagen von Formularen. @@ -52,7 +52,7 @@ Eine schnelle Zusammenfassung: Jetzt lass uns eine Django-View erstellen, die die abgeschickten Daten verarbeitet und etwas damit macht. Erinnere dich daran, in :ref:`Tutorial 3 <intro-tutorial03>` haben wir eine URLconf für die -Abstimmungsapplikation erstellt, die diese Zeile enthält:: +Umfrageapplikation erstellt, die diese Zeile enthält:: (r'^(?P<poll_id>\d+)/vote/$', 'mysite.polls.views.vote'), @@ -101,7 +101,7 @@ behandelt haben: * ``request.POST['choice']`` wird einen :exc:`KeyError` erzeugen, wenn ``choice`` nicht in den POST-Daten enthalten ist. Der oben stehende Code - prüft auf :exc:`KeyError` und zeigt das Abstimmungsformular mit einer + prüft auf :exc:`KeyError` und zeigt das Umfrageformular mit einer Fehlermeldung, dass ``choice`` nicht angegeben wurde, wieder an. * Nachdem die Anzahl von choice erhöht wurde, gibt der Code ein @@ -172,7 +172,7 @@ Benutze Generic Views: Weniger Code ist besser Die Views ``detail()`` (aus :ref:`Tutorial 3 <intro-tutorial03>`) und ``result()`` sind sehr einfach – und, wie oben erwähnt, redundant. Die View -``index()`` (ebenfalls aus Tutorial 3), die eine Liste von Abstimmungen anzeigt, +``index()`` (ebenfalls aus Tutorial 3), die eine Liste von Umfragen anzeigt, ist sehr ähnlich. Diese Views repräsentieren einen üblichen üblichen Fall von grundlegender @@ -184,7 +184,7 @@ zurückzugeben. Weil dies so üblich ist, bietet Django eine Abkürzung, das Sys Generic Views abstrahieren übliche Muster bis zu dem Punkt, wo du noch nicht einmal Python-Code schreiben musst, um eine Applikation zu schreiben. -Lass und unsere Abstimmungsapplikation konvertieren, so dass sie das System der +Lass und unsere Umfrageapplikation konvertieren, so dass sie das System der Generic Views benutzt, damit wir eine Menge von unserem eigenen Code löschen können. Wir müssen nur einige wenige Schritte für die Konvertierung machen. @@ -266,7 +266,7 @@ In ähnlicher Weise benutzt die Gerneric View Weil wir mehr als einen Eintrag in der URLconf haben, der :func:`~django.views.generic.list_detail.object_detail` für die -Abstimmungsapplikation benutzt, definieren wir einen Templatename für die +Umfrageapplikation benutzt, definieren wir einen Templatename für die Ergebnis-View manuell: ``template_name='polls/results.html'``. Ansonsten würden beide Views das selbe Template benutzen. Beachte bitte, dass wir ``dict()`` benutzen, um ein verändertes @@ -305,7 +305,7 @@ werden, damit sie mit den neuen Kontext-Variablen übereinstimmt. Im Aufruf ``poll`` in ``object`` um. Die letzte Sache, die wir noch korrigieren müssen, ist die URL-Behandlung, die -eine Benutzung von Generic Views berücksichtigen muss. In der Abstimmungs-View +eine Benutzung von Generic Views berücksichtigen muss. In der Umfrage-View oben, haben wir die Funktion :func:`~django.core.urlresolvers.reverse` benutzt, um das harte kodieren unserer URLs zu vermeiden. Jetzt, wo wir auf Generic Views umgestellt haben, müssen wir den Aufruf @@ -316,7 +316,7 @@ können den Namen verwenden, den wir vergeben haben:: return HttpResponseRedirect(reverse('poll_results', args=(p.id,))) -Starte den Server und benutze unsere neue Abstimmungsapplikations, die auf +Starte den Server und benutze unsere neue Umfrageapplikations, die auf Generic Views basiert. Für vollständige Details über Generic Views, siehe die :ref:`Dokumentation für intro/tutorial04.txt e12df1179ad05330b15b0d684c98d5cbc0575e54 Stefan Imhoff stefan@imhoff.name http://github.com/zerok/django-docs-de/commit/2b18a5ea9d8e939e2eb2ea4ef6c1c5001e6a3bab 2b18a5ea9d8e939e2eb2ea4ef6c1c5001e6a3bab 2009-03-04T11:09:51-08:00 2009-03-04T11:09:51-08:00 Vereinheitlichung der Übersetzung für "poll" -> Umfrage Umfrage ist hier passender, da eine Abstimmung nahe legt, man hätte Einfluss auf eine Entscheidung; gemeint ist hier wohl aber eher eine Umfrage. 04b6928a67c8847a655088aeb027f89412604071 Stefan Imhoff stefan@imhoff.name