Changeset 342

Timestamp:

08/27/08 09:50:15 (2 years ago)

Author:

anhj

Message:

Update : authentication.txt r8506, django-admin.txt r8548, generic-views.txt r8506, middleware.txt r8506, sessions.txt r8506, templates.txt r8557

Files:

• docs/trunk/authentication.txt (modified) (3 diffs)
• docs/trunk/django-admin.txt (modified) (2 diffs)
• docs/trunk/generic_views.txt (modified) (20 diffs)
• docs/trunk/middleware.txt (modified) (6 diffs)
• docs/trunk/sessions.txt (modified) (4 diffs)
• docs/trunk/templates.txt (modified) (7 diffs)

docs/trunk/authentication.txt

@@ -452 +452 @@
-authentifié.
-
+**Nouveau dans la version de développement de Django** : Quand vous appellez
+``logout()``, les données de sessions de la requête courante sont complÚtement
+effacées. C'est pour empêcher une autre personne d'utiliser le même navigateur
+web pour se connecter et avoir accÚs aux données de la session de l'utilisateur
+précédent. Si vous voulez placer dans la session une information qui doit rester
+disponible aprÚs la déconnexion, faites-le *aprÚs* avoir appelé
+``django.contrib.auth.logout()``.
+
-Limiter l'accÚs aux utilisateurs authentifiés
----------------------------------------------
@@ -551 +559 @@
-
-    * ``form`` : Un objet ``Form`` représentant le formulaire
-newform
-
+formulaire
+Wrapper
-    * ``next`` : L'URL vers laquelle rediriger si l'authentification est un
-      succÚs. Peut également contenir une chaîne de requête.
@@ -592 +600 @@
-    {% endblock %}
-
-newforms: ../new
+formulaires: ../
-.. _documentation sites: ../sites/
-

docs/trunk/django-admin.txt

@@ -80 +80 @@
-Sous-commandes disponibles
-==========================
-
-adminindex <application application ...>
-----------------------------------------
-
-Affiche les fragments de codes du template de l'index de la page
-d'administration pour les applications passées en paramÚtre.
-
-Utilisez les fragments de code du template de l'index de la page d'administration
-si vous voulez personnaliser l'apparence de votre page d'administration. Voir
-`tutorial 2`_ pour des informations plus détaillées.
-
-.. _tutorial 2: ../tutorial02/
-
-cleanup
@@ -431 +419 @@
-    django-admin.py makemessages --all
-
+--extension
+~~~~~~~~~~~
+
+Utilisez l'option ``--extension`` ou ``-e`` pour spécifier une liste d'extensions de
+fichiers à examiner (la valeur par défaut est ".html").
+
+Exemple::
+
+    django-admin.py makemessages --locale=de --extension xhtml
+
+Séparez des valeurs multiples par des virgules, ou utilisez -e ou --extension
+plusieurs fois : ::
+
+    django-admin.py makemessages --locale=de --extension=html,txt --extension xml
+
---locale
-~~~~~~~~

docs/trunk/generic_views.txt

@@ -90 +90 @@
---------------------------------------------------
-
-
+
+
-
-Affiche le template donné, en lui passant la variable de template 
-``{{ params }}``, qui est un dictionnaire des paramÚtres capturés dans l'URL.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-**Exemple :**
@@ -125 +131 @@
--------------------------------------------
-
-
+
+
-
-Redirige vers une URL donnée.
@@ -134 +141 @@
-Si l'URL donnée est ``None``, Django renverra ``HttpResponseGone`` (410).
-
-
-
-
-
+
+
+
+
+
+
-
-**Exemple :**
@@ -163 +172 @@
--------------------------------------------------
-
-
+
+
-
-Une page d'index qui affiche les "derniers" objets, classés par date. Les
@@ -169 +179 @@
-positionnez la variable ``allow_future`` Ã  ``True``.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-Si ``template_name`` n'est pas précisé, la vue utilisera le template 
@@ -229 +252 @@
-      est ``apps/blog/models.py``, ce serait ``blog``.
-
-
+
+
-
-En plus de ``extra_context``, le contexte du template sera :
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-.. _documentation de RequestContext: ../templates_python/#subclassing-context-requestcontext
@@ -252 +278 @@
-------------------------------------------------
-
-
+
+
-
-Une page d'archive annuelle, montrant tous les mois avec des objets
@@ -259 +286 @@
-si vous positionnez ``allow_future`` Ã  ``True``.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-Si ``template_name`` n'est pas précisé, la vue utilisera le template 
-``<app_label>/<model_name>_archive_year.html`` par défaut.
-
-
+
+
-
-En plus de ``extra_context``, le contexte du template sera :
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-``django.views.generic.date_based.archive_month``
--------------------------------------------------
-
-
+
+
-
-Une page d'archive mensuelle affichant tous les objets pour un mois donné.
@@ -346 +393 @@
-si vous positionnez ``allow_future`` Ã  ``True``.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-Si ``template_name`` n'est pas précisé, la vue utilisera le template 
-``<app_label>/<model_name>_archive_month.html`` par défaut.
-
-
+
+
-
-En plus de ``extra_context``, le contexte du template sera :
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-.. _documentation de strftime: http://www.python.org/doc/current/lib/module-time.html#l2h-1941
@@ -433 +501 @@
-------------------------------------------------
-
-
+
+
-
-Une page d'archive hebdomadaire affichant tous les objets pour une semaine
@@ -440 +509 @@
-si vous positionnez ``allow_future`` Ã  ``True``.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-Si ``template_name`` n'est pas précisé, la vue utilisera le template 
-``<app_label>/<model_name>_archive_week.html`` par défaut.
-
-
+
+
-
-En plus de ``extra_context``, le contexte du template sera :
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
-
-``django.views.generic.date_based.archive_day``
------------------------------------------------
-
-
+
+
-
-Une page d'archive quotidienne affichant tous les objets pour un jour
@@ -519 +607 @@
-si vous positionnez ``allow_future`` Ã  ``True``.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-Si ``template_name`` n'est pas précisé, la vue utilisera le template 
-``<app_label>/<model_name>_archive_day.html`` par défaut.
-
-
+
+
-
-En plus de ``extra_context``, le contexte du template sera :
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-``django.views.generic.date_based.archive_today``
--------------------------------------------------
-
-
+
+
-
-Une page d'archive quotidienne affichant tous les objets pour *aujourd'hui*.
@@ -618 +730 @@
--------------------------------------------------
-
-
+
+
-
-Une page pour afficher un objet individuel. 
@@ -624 +737 @@
-sauf si vous positionnez ``allow_future`` Ã  ``True``.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-Si ``template_name`` n'est pas précisé, la vue utilisera le template 
-``<app_label>/<model_name>_detail.html`` par défaut.
-
-
+
+
-
-En plus de ``extra_context``, le contexte du template sera :
-
-
-
-
-
+
+
+
+
+
-
-Vues génériques liste/détail
@@ -723 +855 @@
-------------------------------------------------
-
-
+
+
-
-Une page affichant une liste d'objets.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-Si ``template_name`` n'est pas précisé, la vue utilisera le template 
-``<app_label>/<model_name>_list.html`` par défaut.
-
-
+
+
-
-En plus de ``extra_context``, le contexte du template sera :
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
-
-Si les résultats sont paginés, le contexte contiendra ces variables
-supplémentaires :
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
-
-Notes sur la pagination
@@ -876 +992 @@
---------------------------------------------------
-
-
+
+
-
-Une page représentant un seul objet.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-Si ``template_name`` n'est pas précisé, la vue utilisera le template 
-``<app_label>/<model_name>_detail.html`` par défaut.
-
-
+
+
-
-En plus de ``extra_context``, le contexte du template sera :
-
-
-
-
-
+
+
+
+
+
-
-Vues génériques de création/mise à jour/effacement
@@ -947 +1076 @@
-**Modifié dans la version de développement de Django**
-
-newform
-
-newforms: ../new
+formulaire
+
+formulaires: ../
-
-``django.views.generic.create_update.create_object``
-----------------------------------------------------
-
-
+
+
-
-Une page affichant un formulaire de création pour un objet, avec
@@ -960 +1090 @@
-s'il y en a, et la sauvegarde de l'objet.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-Si ``template_name`` n'est pas précisé, la vue utilisera le template 
-``<app_label>/<model_name>_form.html`` par défaut.
-
-
+
+
-
-En plus de ``extra_context``, le contexte du template sera :
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-.. _systÚme d'authentification: ../authentication/
-newforms/modelforms
-newforms: ../new
+modelforms/
+formulaires: ../
-
-``django.views.generic.create_update.update_object``
-----------------------------------------------------
-
-
+
+
-
-Une page affichant un formulaire d'édition pour un objet existant, avec
@@ -1045 +1186 @@
-manipulateurs automatiques fournis avec les modÚles Django.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-Si ``template_name`` n'est pas précisé, la vue utilisera le template 
-``<app_label>/<model_name>_form.html`` par défaut.
-
-
+
+
-
-En plus de ``extra_context``, le contexte du template sera :
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-``django.views.generic.create_update.delete_object``
-----------------------------------------------------
-
-
+
+
-
-Une vue qui affiche une page de confirmation et efface un objet existant.
@@ -1143 +1296 @@
-contenir un formulaire qui utilise POST vers la même URL.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-Si ``template_name`` n'est pas précisé, la vue utilisera le template 
-``<app_label>/<model_name>_confirm_delete.html`` par défaut.
-
-
+
+
-
-En plus de ``extra_context``, le contexte du template sera :
-
-
-
-
-
-
+
+
+
+
+
+

docs/trunk/middleware.txt

@@ -107 +107 @@
-la compression du contenu de la réponse soit la derniÚre chose qui arrive (avant
-l'envoi de celle-ci). Les contenus de moins de 200 octets, les réponses dont le
-s
+S
-IE) et les réponses dont le header ``Content-Encoding`` est déjà spécifié ne
-seront pas compressés.
@@ -196 +196 @@
-une simple classe Python qui définit une ou plus des méthodes suivantes :
-
-
-
+
+----
-
-Interface: ``process_request(self, request)``
@@ -212 +212 @@
-appelé sur chaque réponse.
-
-
-
+
+----
-
-Interface: ``process_view(self, request, view_func, view_args, view_kwargs)``
@@ -234 +234 @@
-
-
-
-
+
+----
-
-Interface: ``process_response(self, request, response)``
@@ -246 +246 @@
-complÚtement nouveau.
-
-
-
+
+----
-
-Interface: ``process_exception(self, request, exception)``
@@ -260 +260 @@
-relais.
-
+``__init__``
+------------
+
+La plupart des classes de middleware n'ont pas besoin d'initialisation, parce que ces classes sont essentiellement des conteneurs pour les méthodes ``process_*``. Si vous avez besoin d'un état global, vous pouvez utiliser ``__init__`` pour le mettre en place. Gardez toutefois à l'esprit ces difficultés :
+
+    * Django initialise votre middleware sans arguments, donc vous ne pouvez
+      définir un ``__init__`` qui requiert des arguments.
+
+    * Au contraire des méthodes ``process_*`` qui sont appelées une fois par 
+      requête, ``__init__`` ne sera appelé qu'une seule fois, quand le serveur
+      web démarre.
+
+Marquer un middleware comme inutilisé
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Il est parfois utile de déterminer lors de l'exécution si un middleware doit être utilisé. Dans ce cas, la méthode ``__init__`` de votre middleware peut lever l'exception ``django.core.exceptions.MiddlewareNotUsed``. Django enlÚvera alors ce middleware du traitement de l'ensemble des middlewares.
+
-Indications
------------

docs/trunk/sessions.txt

@@ -72 +72 @@
-
-    Vous ne devriez probablement utiliser des sessions basées sur le cache que
-memcached. La mémoire locale et les backends
-de cache simples ne conservent
-de bons
+Memcached. Le backend de cache en mémoire
+locale ne conserve
+un bon
-    utilisant le systÚme de fichiers ou la base de données que d'avoir des
-    backends de cache en base de données ou en fichier.
@@ -86 +86 @@
-écrire.
-
-Il implément
+Un objet session possÚd
-
-    * ``__getitem__(key)``
@@ -115 +115 @@
-    * ``setdefault()`` (**Nouveau dans la version de développement de Django**)
-
+    * ``clear()`` (**Nouveau dans la version de développement de Django**)
+
-Il possÚde aussi ces méthodes :
+
+    * ``flush()``
+
+      **Nouveau dans la version de développement de Django**
+
+      Efface les données de la session courante de la base de données et 
+      régénÚre la valeur de la clé de session qui est renvoyée à l'utilisateur
+      dans un cookie. A utiliser si vous voulez vous assurer que les
+      données de la session précédente ne peuvent pas être accessible à 
+      nouveau à partir du navigateur de l'utilisateur (par exemple, la 
+      méthode ``django.contrib.auth.logout()`` l'utilise).
-
-    * ``set_test_cookie()``
@@ -235 +248 @@
-            pass
-        return HttpResponse("Vous êtes déconnecté.")
+
+La fonction standard ``django.contrib.auth.logout()`` en fait un peu plus, pour prévenir d'éventuelles fuites de données. Elle appelle ``request.session.flush()``. Nous utilisons cet exemple comme une démonstration de l'utilisation des objets session, pas comme une implémentation complÚte de ``logout()``.
-
-Mise en place de cookies de test

docs/trunk/templates.txt

@@ -550 +550 @@
-variable et objet disponible pour un template donné.
-
+.. _loading-custom-template-libraries:
+
-Tags personnalisés et bibliothÚques de filtres
-==============================================
@@ -739 +741 @@
-**Nouveau dans la version de développement de Django**
-Si vous devez boucler sur une liste de listes, vous pouvez récupérer les valeurs
-un ensemble de variables nommé
+des variables individuell
-votre contexte contient une liste de coordonnées (x,y) appelées ``points``, vous
-pourriez utiliser ceci pour afficher la liste des points::
@@ -869 +871 @@
-            {% endifchanged %}
-        {% endfor %}
+
+Le tag ``ifchanged`` a aussi une clause {% else %} optionnelle qui sera affichée si la valeur n'a pas changé : ::
+
+    {% for match in matches %} 
+        <div style="background-color:
+            {% ifchanged match.ballot_id %}
+                {% cycle red,blue %}  
+            {% else %}         
+                grey                       
+            {% endifchanged %}
+        ">{{ match }}</div>               
+    {% endfor %}
-
-ifequal
@@ -1184 +1198 @@
-Ã  ceci::
-
-
+project_name.app_name.
-
-Si l'URLconf de cette application est incluse dans celle du projet dans un
@@ -1194 +1208 @@
-façon::
-
-
+project_name.app_name.
-
-Le tag de template affichera la chaîne ``/clients/client/123/``.
@@ -1570 +1584 @@
-    {{ value|linebreaks }}
-
-\nest mon prénom``, le résultat sera ``<p>Joe
+l\nest mon prénom``, le résultat sera ``<p>Joel
-
-linebreaksbr
@@ -1610 +1624 @@
-    {{ value|make_list }}
-
-"``, le résultat sera la liste ``[u'J', u'o', u'e
+l"``, le résultat sera la liste ``[u'J', u'o', u'e', u'l
-
-phone2numeric