Commits

Samuel Martin committed 1fe390e

Ajout du fichier decorator.txt 'les vues'

  • Participants
  • Parent commits bbc0d8b

Comments (0)

Files changed (2)

       
     * **Avancé :**
       :doc:`Managers <topics/db/managers>` (fr) |
-      :doc:`SQL brut <topics/db/sql>` |
-      :doc:`Transactions <topics/db/transactions>` |
-      :doc:`Aggrégation <topics/db/aggregation>` |
-      :doc:`Champs personnalités <howto/custom-model-fields>` |
-      :doc:`Base de données multiples <topics/db/multi-db>`
+      :doc:`SQL brut <topics/db/sql>` (en) |
+      :doc:`Transactions <topics/db/transactions>` (en) |
+      :doc:`Aggrégation <topics/db/aggregation>` (en) |
+      :doc:`Champs personnalités <howto/custom-model-fields>` (en) |
+      :doc:`Base de données multiples <topics/db/multi-db>` (en)
       
     * **Autres :**
       :doc:`Bases de données supportées <ref/databases>` (fr) |
-      :doc:`Anciennes base de données <howto/legacy-databases>` |
+      :doc:`Anciennes base de données <howto/legacy-databases>` (en) |
       :doc:`Données initiales <howto/initial-data>` (fr) |
       :doc:`Optimisation des accès base de données <topics/db/optimization>` (fr)
 
 =============
 
     * **Pour les designers :**
-      :doc:`Vue d'ensemble de la syntaxe <topics/templates>` |
-      :doc:`Balises et filtres <ref/templates/builtins>`
+      :doc:`Vue d'ensemble de la syntaxe <topics/templates>` (en)|
+      :doc:`Balises et filtres <ref/templates/builtins>` (en)
             
     * **Pour les programmeurs :**      
-      :doc:`API des template <ref/templates/api>` |
-      :doc:`Balises et filtres personnalisés <howto/custom-template-tags>`
+      :doc:`API des template <ref/templates/api>` (en) |
+      :doc:`Balises et filtres personnalisés <howto/custom-template-tags>` (en)
 
 Les vues
 ========
 
     * **Les bases :**
-      :doc:`URLconfs <topics/http/urls>` |
-      :doc:`Fonctions <topics/http/views>` |
-      :doc:`Raccourcis <topics/http/shortcuts>` |
-      :doc:`Décorateurs <topics/http/decorators>`
+      :doc:`URLconfs <topics/http/urls>` (en)|
+      :doc:`Fonctions <topics/http/views>` (en)|
+      :doc:`Raccourcis <topics/http/shortcuts>`(en) |
+      :doc:`Décorateurs <topics/http/decorators>` (en)
       
     * **Référence :**
       :doc:`Objets de requête/réponse <ref/request-response>` (fr) |
-      :doc:`Object de template-réponse <ref/template-response>`
+      :doc:`Object de template-réponse <ref/template-response>` (en)
       
     * **Upload de fichiers :**
       :doc:`Vue d'ensemble <topics/http/file-uploads>` (fr) |
       :doc:`Stockage personnalisé <howto/custom-file-storage>` (fr)      
       
     * **Vues génériques :**
-      :doc:`Vue d'ensemble <topics/class-based-views>` |
-      :doc:`Vues génériques de référence <ref/class-based-views>`
+      :doc:`Vue d'ensemble <topics/class-based-views>` (en) |
+      :doc:`Vues génériques de référence <ref/class-based-views>` (en)
       
     * **Avancé :**
-      :doc:`Générer du CSV <howto/outputting-csv>` |
-      :doc:`Générer du PDF <howto/outputting-pdf>`
+      :doc:`Générer du CSV <howto/outputting-csv>` (en) |
+      :doc:`Générer du PDF <howto/outputting-pdf>` (en)
       
     * **Middleware :**
-      :doc:`Vue d'ensemble des middlewares <topics/http/middleware>` |
+      :doc:`Vue d'ensemble des middlewares <topics/http/middleware>` (en) |
       :doc:`Classes de middleware de référence <ref/middleware>` (fr)
 
 
 ===========
 
    * **Les bases :**
-      :doc:`Vue d'ensemble <topics/forms/index>` |
+      :doc:`Vue d'ensemble <topics/forms/index>` (en) |
       :doc:`API des formulaires <ref/forms/api>` (fr) |
       :doc:`Champs <ref/forms/fields>` (fr) |
-      :doc:`Widgets <ref/forms/widgets>`
+      :doc:`Widgets <ref/forms/widgets>` (en)
       
    * **Avancé :**
-      :doc:`Formulaires de modèles <topics/forms/modelforms>` |
-      :doc:`Intégration de média <topics/forms/media>` |
-      :doc:`Formsets <topics/forms/formsets>` |
-      :doc:`Personnaliser la validation <ref/forms/validation>`
+      :doc:`Formulaires de modèles <topics/forms/modelforms>` (en) |
+      :doc:`Intégration de média <topics/forms/media>` (en) |
+      :doc:`Formsets <topics/forms/formsets>` (en) |
+      :doc:`Personnaliser la validation <ref/forms/validation>` (en)
       
    * **Extras:**
-      :doc:`Prévisualisation <ref/contrib/formtools/form-preview>` |
-      :doc:`Wizards <ref/contrib/formtools/form-wizard>`
+      :doc:`Prévisualisation <ref/contrib/formtools/form-preview>` (en) |
+      :doc:`Wizards <ref/contrib/formtools/form-wizard>` (en)
 
 
 Le processus de développement
       :doc:`Liste complète des paramètres <ref/settings>` (fr)
       
     * **Exceptions:**
-      :doc:`Vue d'ensemble <ref/exceptions>`
+      :doc:`Vue d'ensemble <ref/exceptions>` (en)
       
     * **django-admin.py et manage.py:**
-      :doc:`Vue d'ensemble <ref/django-admin>` |
-      :doc:`Ajouter des commandes personnalisées <howto/custom-management-commands>`
+      :doc:`Vue d'ensemble <ref/django-admin>` (en) |
+      :doc:`Ajouter des commandes personnalisées <howto/custom-management-commands>` (en)
       
-    * **Tester :**  :doc:`Vue d'ensemble <topics/testing>`
+    * **Tester :**  :doc:`Vue d'ensemble <topics/testing>` (en)
 
     * **Déploiement :**      
-      :doc:`Vue d'ensemble <howto/deployment/index>` |
-      :doc:`Apache/mod_wsgi <howto/deployment/modwsgi>` |
-      :doc:`Apache/mod_python <howto/deployment/modpython>` |
+      :doc:`Vue d'ensemble <howto/deployment/index>` (en)|
+      :doc:`Apache/mod_wsgi <howto/deployment/modwsgi>` (en)|
+      :doc:`Apache/mod_python <howto/deployment/modpython>` (en)|
       :doc:`FastCGI/SCGI/AJP <howto/deployment/fastcgi>` |
       :doc:`Authentification avec Apache <howto/apache-auth>` (fr) |
-      :doc:`Fichiers statiques <howto/static-files>` (en) |
-      :doc:`Pister les errreurs par e-mail <howto/error-reporting>`
+      :doc:`Fichiers statiques <howto/static-files>` (fr) |
+      :doc:`Pister les errreurs par e-mail <howto/error-reporting>` (en)
 
 
 Autres fonctionnalités
 ======================
     
-    * :doc:`Interface d'administration <ref/contrib/admin/index>` | :doc:`Actions d'administration <ref/contrib/admin/actions>` | :doc:`Générateur de documentation d'administration<ref/contrib/admin/admindocs>`
-    * :doc:`Authentification <topics/auth>`
-    * :doc:`Système de cache <topics/cache>`
-    * :doc:`Traitement conditionnel du contenu <topics/conditional-view-processing>`
+    * :doc:`Interface d'administration <ref/contrib/admin/index>` | :doc:`Actions d'administration <ref/contrib/admin/actions>` (en)| :doc:`Générateur de documentation d'administration<ref/contrib/admin/admindocs>` (en)
+    * :doc:`Authentification <topics/auth>` (en)
+    * :doc:`Système de cache <topics/cache>` (en)
+    * :doc:`Traitement conditionnel du contenu <topics/conditional-view-processing>` (en)
     * :doc:`Commentaires <ref/contrib/comments/index>` | :doc:`Modération <ref/contrib/comments/moderation>` | :doc:`Commentaires personnalisés <ref/contrib/comments/custom>`
-    * :doc:`Content types <ref/contrib/contenttypes>`
-    * :doc:`Protection contre les CSRF (Cross Site Request Forgery) <ref/contrib/csrf>`
-    * :doc:`Parcours des données <ref/contrib/databrowse>`
-    * :doc:`Envoi d'emails <topics/email>`
-    * :doc:`Pages HTML statiques <ref/contrib/flatpages>`
-    * :doc:`Géolocalisation Django <ref/contrib/gis/index>`
-    * :doc:`Filtres Humanize <ref/contrib/humanize>`
-    * :doc:`Internationalisation <topics/i18n/index>`
-    * :doc:`Jython<howto/jython>`
-    * :doc:`"Particularités locales" <ref/contrib/localflavor>`
-    * :doc:`Logging <topics/logging>`
-    * :doc:`Messages <ref/contrib/messages>`
-    * :doc:`Pagination <topics/pagination>`
-    * :doc:`Redirections <ref/contrib/redirects>`
-    * :doc:`Sérialisation <topics/serialization>`
-    * :doc:`Sessions <topics/http/sessions>`
-    * :doc:`Signals <topics/signals>`
-    * :doc:`Sitemaps <ref/contrib/sitemaps>`
+    * :doc:`Content types <ref/contrib/contenttypes>` (en)
+    * :doc:`Protection contre les CSRF (Cross Site Request Forgery) <ref/contrib/csrf>` (fr)
+    * :doc:`Parcours des données <ref/contrib/databrowse>` (en)
+    * :doc:`Envoi d'emails <topics/email>` (en)
+    * :doc:`Pages HTML statiques <ref/contrib/flatpages>` (en)
+    * :doc:`Géolocalisation Django <ref/contrib/gis/index>` (en)
+    * :doc:`Filtres Humanize <ref/contrib/humanize>` (fr)
+    * :doc:`Internationalisation <topics/i18n/index>` (fr)
+    * :doc:`Jython<howto/jython>` (en)
+    * :doc:`"Particularités locales" <ref/contrib/localflavor>` (en)
+    * :doc:`Logging <topics/logging>` (en)
+    * :doc:`Messages <ref/contrib/messages>` (en)
+    * :doc:`Pagination <topics/pagination>` (en)
+    * :doc:`Redirections <ref/contrib/redirects>` (fr)
+    * :doc:`Sérialisation <topics/serialization>` (en)
+    * :doc:`Sessions <topics/http/sessions>` (en)
+    * :doc:`Signals <topics/signals>` (en)
+    * :doc:`Sitemaps <ref/contrib/sitemaps>` (en)
     * :doc:`Sites <ref/contrib/sites>`
-    * :doc:`Fichiers statiques <ref/contrib/staticfiles>`
-    * :doc:`Fils de syndication (RSS/Atom) <ref/contrib/syndication>`
-    * :doc:`Unicode dans Django <ref/unicode>`
-    * :doc:`Aide au design web <ref/contrib/webdesign>`
-    * :doc:`Validateurs <ref/validators>`
-    * Vue générique (Obsolète) :doc:`Vue d'ensemble<topics/generic-views>` | :doc:`Vue générique<ref/generic-views>` | :doc:`Guide de migration<topics/generic-views-migration>`
+    * :doc:`Fichiers statiques <ref/contrib/staticfiles>` (en)
+    * :doc:`Fils de syndication (RSS/Atom) <ref/contrib/syndication>` (fr)
+    * :doc:`Unicode dans Django <ref/unicode>` (fr)
+    * :doc:`Aide au design web <ref/contrib/webdesign>` (fr)
+    * :doc:`Validateurs <ref/validators>` (fr)
+    * Vue générique (Obsolète) :doc:`Vue d'ensemble<topics/generic-views>` (fr) | :doc:`Vue générique<ref/generic-views>` (en) | :doc:`Guide de migration<topics/generic-views-migration>` (en)
 
 
 
 ================
 
     * **Communauté :**
-      :doc:`Comment participer <internals/contributing>` |
-      :doc:`Le processus de sortie <internals/release-process>` |
-      :doc:`Equipe de contributeurs <internals/committers>` |
-      :doc:`Dépôt du code source de Django <internals/svn>`
+      :doc:`Comment participer <internals/contributing>` (en)|
+      :doc:`Le processus de sortie <internals/release-process>` (en) |
+      :doc:`Equipe de contributeurs <internals/committers>` (en)|
+      :doc:`Dépôt du code source de Django <internals/svn>` (en)
       
     * **Philosophies de développement :**
-      :doc:`Vue d'ensemble de la philosophie <misc/design-philosophies>`
+      :doc:`Vue d'ensemble de la philosophie <misc/design-philosophies>` (en)
       
     * **Documentation :**
-      :doc:`À propos de la documentation <internals/documentation>`
+      :doc:`À propos de la documentation <internals/documentation>` (en)
       
     * **Distributions tierces :**
-      :doc:`Vue d'ensemble des distributions tierces <misc/distributions>`
+      :doc:`Vue d'ensemble des distributions tierces <misc/distributions>` (fr)
       
     * **Django au fil du temps :**
-      :doc:`Stabilité de l'API <misc/api-stability>` |
-      :doc:`Archives des notes de versions <releases/index>` |
-      :doc:`Historique des obsolescences <internals/deprecation>`
+      :doc:`Stabilité de l'API <misc/api-stability>` (fr) |
+      :doc:`Archives des notes de versions <releases/index>` (en)|
+      :doc:`Historique des obsolescences <internals/deprecation>` (en)
 
 
 

File topics/http/decorators.txt

+===============
+View decorators
+===============
+
+.. module:: django.views.decorators.http
+
+Django provides several decorators that can be applied to views to support
+various HTTP features.
+
+Allowed HTTP methods
+====================
+
+The following decorators in :mod:`django.views.decorators.http` can be used to
+restrict access to views based on the request method.
+
+.. function:: require_http_methods(request_method_list)
+
+This decorator is used to ensure that a view only accepts particular request
+methods. Usage::
+
+    from django.views.decorators.http import require_http_methods
+
+    @require_http_methods(["GET", "POST"])
+    def my_view(request):
+        # I can assume now that only GET or POST requests make it this far
+        # ...
+        pass
+
+Note that request methods should be in uppercase.
+
+.. function:: require_GET()
+
+Decorator to require that a view only accept the GET method.
+
+.. function:: require_POST()
+
+Decorator to require that a view only accept the POST method.
+
+Conditional view processing
+===========================
+
+The following decorators in :mod:`django.views.decorators.http` can be used to
+control caching behavior on particular views.
+
+.. function:: condition(etag_func=None, last_modified_func=None)
+
+.. function:: etag(etag_func)
+
+.. function:: last_modified(last_modified_func)
+
+These decorators can be used to generate ``ETag`` and ``Last-Modified``
+headers; see
+:doc:`conditional view processing </topics/conditional-view-processing>`.
+
+.. module:: django.views.decorators.gzip
+
+GZip compression
+================
+
+The decorators in :mod:`django.views.decorators.gzip` control content
+compression on a per-view basis.
+
+.. function:: gzip_page()
+
+This decorator compresses content if the browser allows gzip compression.
+It sets the ``Vary`` header accordingly, so that caches will base their
+storage on the ``Accept-Encoding`` header.
+
+.. module:: django.views.decorators.vary
+
+Vary headers
+============
+
+The decorators in :mod:`django.views.decorators.vary` can be used to control
+caching based on specific request headers.
+
+.. function:: vary_on_cookie(func)
+
+.. function:: vary_on_headers(*headers)
+
+The ``Vary`` header defines which request headers a cache mechanism should take
+into account when building its cache key.
+
+See :ref:`using vary headers <using-vary-headers>`.