Changeset 342 for docs/trunk

Show
Ignore:
Timestamp:
08/27/08 09:50:15 (4 months 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:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • docs/trunk/authentication.txt

    r339 r342  
    452452authentifié. 
    453453 
     454**Nouveau dans la version de développement de Django** : Quand vous appellez 
     455``logout()``, les données de sessions de la requête courante sont complÚtement 
     456effacées. C'est pour empêcher une autre personne d'utiliser le même navigateur 
     457web pour se connecter et avoir accÚs aux données de la session de l'utilisateur 
     458précédent. Si vous voulez placer dans la session une information qui doit rester 
     459disponible aprÚs la déconnexion, faites-le *aprÚs* avoir appelé 
     460``django.contrib.auth.logout()``. 
     461 
    454462Limiter l'accÚs aux utilisateurs authentifiés 
    455463--------------------------------------------- 
     
    551559 
    552560    * ``form`` : Un objet ``Form`` représentant le formulaire 
    553       d'authentification. Voir la `documentation des newforms`_ pour en savoir 
    554       plus sur les objets ``Form``. 
     561      d'authentification. Voir la `documentation des formulaires`_ pour en savoir 
     562      plus sur les objets ``FormWrapper``. 
    555563    * ``next`` : L'URL vers laquelle rediriger si l'authentification est un 
    556564      succÚs. Peut également contenir une chaîne de requête. 
     
    592600    {% endblock %} 
    593601 
    594 .. _documentation des newforms: ../newforms/ 
     602.. _documentation des formulaires: ../forms/ 
    595603.. _documentation sites: ../sites/ 
    596604 
  • docs/trunk/django-admin.txt

    r339 r342  
    8080Sous-commandes disponibles 
    8181========================== 
    82  
    83 adminindex <application application ...> 
    84 ---------------------------------------- 
    85  
    86 Affiche les fragments de codes du template de l'index de la page 
    87 d'administration pour les applications passées en paramÚtre. 
    88  
    89 Utilisez les fragments de code du template de l'index de la page d'administration 
    90 si vous voulez personnaliser l'apparence de votre page d'administration. Voir 
    91 `tutorial 2`_ pour des informations plus détaillées. 
    92  
    93 .. _tutorial 2: ../tutorial02/ 
    9482 
    9583cleanup 
     
    431419    django-admin.py makemessages --all 
    432420 
     421--extension 
     422~~~~~~~~~~~ 
     423 
     424Utilisez l'option ``--extension`` ou ``-e`` pour spécifier une liste d'extensions de 
     425fichiers à examiner (la valeur par défaut est ".html"). 
     426 
     427Exemple:: 
     428 
     429    django-admin.py makemessages --locale=de --extension xhtml 
     430 
     431Séparez des valeurs multiples par des virgules, ou utilisez -e ou --extension 
     432plusieurs fois : :: 
     433 
     434    django-admin.py makemessages --locale=de --extension=html,txt --extension xml 
     435 
    433436--locale 
    434437~~~~~~~~ 
  • docs/trunk/generic_views.txt

    r339 r342  
    9090-------------------------------------------------- 
    9191 
    92 **Description :** 
     92Description 
     93~~~~~~~~~~~ 
    9394 
    9495Affiche le template donné, en lui passant la variable de template  
    9596``{{ params }}``, qui est un dictionnaire des paramÚtres capturés dans l'URL. 
    9697 
    97 **ParamÚtres requis :** 
    98  
    99     * ``template``: Le nom complet du template à utiliser. 
    100  
    101 **ParamÚtres optionnels :** 
    102  
    103     * ``extra_context``: un dictionnaire de valeurs à ajouter au contexte du 
    104       template. Par défaut, c'est un dictionnaire vide. Si une valeur du 
    105       dictionnaire est appelable (callable), la vue générique l'appellera 
    106       juste avant le rendu du template. 
    107  
    108     * ``mimetype``: le type MIME à utiliser pour le document résultant. La 
    109       valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. 
     98ParamÚtres requis 
     99~~~~~~~~~~~~~~~~~ 
     100 
     101``template`` 
     102    Le nom complet du template à utiliser. 
     103 
     104ParamÚtres optionnels 
     105~~~~~~~~~~~~~~~~~~~~~ 
     106 
     107``extra_context`` 
     108    Un dictionnaire de valeurs à ajouter au contexte du 
     109    template. Par défaut, c'est un dictionnaire vide. Si une valeur du 
     110    dictionnaire est appelable (callable), la vue générique l'appellera 
     111    juste avant le rendu du template. 
     112 
     113``mimetype`` 
     114    Le type MIME à utiliser pour le document résultant. La 
     115    valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. 
    110116 
    111117**Exemple :** 
     
    125131------------------------------------------- 
    126132 
    127 **Description :** 
     133Description 
     134~~~~~~~~~~~ 
    128135 
    129136Redirige vers une URL donnée. 
     
    134141Si l'URL donnée est ``None``, Django renverra ``HttpResponseGone`` (410). 
    135142 
    136 **ParamÚtres requis :** 
    137  
    138     * ``url``: l'URL vers laquelle rediriger, sous la forme d'une chaîne de 
    139       caractÚres, ou la valeur ``None`` pour lever une erreur HTTP 410 (Gone). 
     143ParamÚtres requis 
     144~~~~~~~~~~~~~~~~~ 
     145 
     146``url`` 
     147    L'URL vers laquelle rediriger, sous la forme d'une chaîne de 
     148    caractÚres, ou la valeur ``None`` pour lever une erreur HTTP 410 (Gone). 
    140149 
    141150**Exemple :** 
     
    163172------------------------------------------------- 
    164173 
    165 **Description :** 
     174Description 
     175~~~~~~~~~~~ 
    166176 
    167177Une page d'index qui affiche les "derniers" objets, classés par date. Les 
     
    169179positionnez la variable ``allow_future`` à ``True``. 
    170180 
    171 **ParamÚtres requis :** 
    172  
    173     * ``queryset``: un ``QuerySet`` d'objets pour lesquels la page sera 
    174       utilisée. 
    175  
    176     * ``date_field``: le nom du champ ``DateField`` ou ``DateTimeField`` dans 
    177       le modÚle du ``QuerySet`` que la page basée sur les dates doit utiliser 
    178       pour déterminer quels objets seront affichés. 
    179  
    180 **ParamÚtres optionnels :** 
    181  
    182     * ``num_latest``: le nombre d'objets à envoyer au contexte du template. La 
    183       valeur par défaut est 15. 
    184  
    185     * ``template_name``: le nom complet du template à utiliser pour rendre la 
    186       page. Cela permet de passer outre le nom du template par défaut (voir 
    187       ci-dessous). 
    188  
    189     * ``template_loader``: le chargeur de template à utiliser pour charger le 
    190       template. Par défaut, c'est ``django.template.loader``. 
    191  
    192     * ``extra_context``: un dictionnaire de valeurs à ajouter au contexte du 
    193       template. Par défaut, c'est un dictionnaire vide. Si une valeur du 
    194       dictionnaire est appelable (callable), la vue générique l'appellera 
    195       juste avant le rendu du template. 
    196  
    197     * ``allow_empty``: Une valeur booléenne qui indique s'il faut afficher la 
    198       page si aucun objet n'est disponible. Si la valeur est ``False`` et 
    199       qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu 
    200       d'envoyer une page vide. La valeur par défaut est ``True``. 
    201  
    202     * ``context_processors``: une liste de processeurs de contexte de template 
    203       à appliquer au template de la vue. Voir la `documentation de 
    204       RequestContext`_. 
    205  
    206     * ``mimetype``: le type MIME à utiliser pour le document résultant. La 
    207       valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. 
    208  
    209     * ``allow_future``: une valeur booléenne indiquant s'il faut inclure les 
    210       objets "futurs" sur la page, où futur signifie des objets pour lesquels 
    211       le champ spécifié dans ``date_field`` est plus grand que la date et 
    212       l'heure courantes. La valeur par défaut est ``False``. 
    213  
    214     * **Nouveau dans la version de développement de Django :**  
    215       ``template_object_name``: désigne le nom de la variable de template à  
    216       utiliser dans le contexte du template. La valeur par défaut est  
    217       ``'latest'``. 
    218  
    219 **Nom du template :** 
     181ParamÚtres requis 
     182~~~~~~~~~~~~~~~~~ 
     183 
     184``queryset`` 
     185    Un ``QuerySet`` d'objets pour lesquels la page sera 
     186    utilisée. 
     187 
     188``date_field`` 
     189    Le nom du champ ``DateField`` ou ``DateTimeField`` dans 
     190    le modÚle du ``QuerySet`` que la page basée sur les dates doit utiliser 
     191    pour déterminer quels objets seront affichés. 
     192 
     193ParamÚtres optionnels 
     194~~~~~~~~~~~~~~~~~~~~~ 
     195 
     196``num_latest`` 
     197    Le nombre d'objets à envoyer au contexte du template. La 
     198    valeur par défaut est 15. 
     199 
     200``template_name`` 
     201    Le nom complet du template à utiliser pour rendre la 
     202    page. Cela permet de passer outre le nom du template par défaut (voir 
     203    ci-dessous). 
     204 
     205``template_loader`` 
     206    Le chargeur de template à utiliser pour charger le 
     207    template. Par défaut, c'est ``django.template.loader``. 
     208 
     209``extra_context`` 
     210    Un dictionnaire de valeurs à ajouter au contexte du 
     211    template. Par défaut, c'est un dictionnaire vide. Si une valeur du 
     212    dictionnaire est appelable (callable), la vue générique l'appellera 
     213    juste avant le rendu du template. 
     214 
     215``allow_empty`` 
     216    Une valeur booléenne qui indique s'il faut afficher la 
     217    page si aucun objet n'est disponible. Si la valeur est ``False`` et 
     218    qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu 
     219    d'envoyer une page vide. La valeur par défaut est ``True``. 
     220 
     221``context_processors`` 
     222    Une liste de processeurs de contexte de template 
     223    à appliquer au template de la vue. Voir la `documentation de 
     224    RequestContext`_. 
     225 
     226``mimetype`` 
     227    Le type MIME à utiliser pour le document résultant. La 
     228    valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. 
     229 
     230``allow_future`` 
     231    Une valeur booléenne indiquant s'il faut inclure les 
     232    objets "futurs" sur la page, où futur signifie des objets pour lesquels 
     233    le champ spécifié dans ``date_field`` est plus grand que la date et 
     234    l'heure courantes. La valeur par défaut est ``False``. 
     235 
     236``template_object_name`` (**Nouveau dans la version de développement de Django**) 
     237    Désigne le nom de la variable de template à  
     238    utiliser dans le contexte du template. La valeur par défaut est  
     239    ``'latest'``. 
     240 
     241Nom du template 
     242~~~~~~~~~~~~~~~ 
    220243 
    221244Si ``template_name`` n'est pas précisé, la vue utilisera le template  
     
    229252      est ``apps/blog/models.py``, ce serait ``blog``. 
    230253 
    231 **Contexte du template :** 
     254Contexte du template 
     255~~~~~~~~~~~~~~~~~~~~ 
    232256 
    233257En plus de ``extra_context``, le contexte du template sera : 
    234258 
    235     * ``date_list``: une liste d'objets ``datetime.date`` représentant toutes 
    236       les années pour lesquelles le ` queryset`` renverra des objets, triée en 
    237       descendant. C'est équivalent à ``queryset.dates(date_field, 
    238       'year')[::-1]``. 
    239  
    240     * ``latest``: les ``num_latest`` objets du systÚme, triés en ordre 
    241       descendant sur ``date_field``. Par exemple, si ``num_latest`` vaut 10, 
    242       ``latest`` sera la liste des 10 objets les plus récents du ``queryset``. 
    243  
    244       **Nouveau dans la version de développement de Django :** le nom de 
    245       cette variable dépend du paramÚtre ``template_object_name``, qui est 
    246       ``'latest'`` par défaut. Si ``template_object_name`` est ``'foo'``, 
    247       le nom de cette variable sera ``'foo'``. 
     259``date_list`` 
     260    Une liste d'objets ``datetime.date`` représentant toutes 
     261    les années pour lesquelles le ` queryset`` renverra des objets, triée en 
     262    descendant. C'est équivalent à ``queryset.dates(date_field, 
     263    'year')[::-1]``. 
     264 
     265``latest`` 
     266    Les ``num_latest`` objets du systÚme, triés en ordre 
     267    descendant sur ``date_field``. Par exemple, si ``num_latest`` vaut 10, 
     268    ``latest`` sera la liste des 10 objets les plus récents du ``queryset``. 
     269 
     270    **Nouveau dans la version de développement de Django :** le nom de 
     271    cette variable dépend du paramÚtre ``template_object_name``, qui est 
     272    ``'latest'`` par défaut. Si ``template_object_name`` est ``'foo'``, 
     273    le nom de cette variable sera ``'foo'``. 
    248274 
    249275.. _documentation de RequestContext: ../templates_python/#subclassing-context-requestcontext 
     
    252278------------------------------------------------ 
    253279 
    254 **Description :** 
     280Description 
     281~~~~~~~~~~~ 
    255282 
    256283Une page d'archive annuelle, montrant tous les mois avec des objets 
     
    259286si vous positionnez ``allow_future`` à ``True``. 
    260287 
    261 **ParamÚtres requis :** 
    262  
    263     * ``year``: l'année de l'archive sur 4 chiffres. 
    264  
    265     * ``queryset``: un ``QuerySet`` d'objets à renvoyer dans l'archive. 
    266  
    267     * ``date_field``: le nom du champ ``DateField`` ou ``DateTimeField`` dans 
    268       le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer 
    269       les objets à renvoyer dans la page. 
    270  
    271 **ParamÚtres optionnels :** 
    272  
    273     * ``template_name``: le nom complet du template à utiliser pour rendre la 
    274       page. Cela permet de passer outre le nom du template par défaut (voir 
    275       ci-dessous). 
    276  
    277     * ``template_loader``: le chargeur de template à utiliser pour charger le 
    278       template. Par défaut, c'est ``django.template.loader``. 
    279  
    280     * ``extra_context``: un dictionnaire de valeurs à ajouter au contexte du 
    281       template. Par défaut, c'est un dictionnaire vide. Si une valeur du 
    282       dictionnaire est appelable (callable), la vue générique l'appellera 
    283       juste avant le rendu du template. 
    284  
    285     * ``allow_empty``: Une valeur booléenne qui indique s'il faut afficher la 
    286       page si aucun objet n'est disponible. Si la valeur est ``False`` et 
    287       qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu 
    288       d'envoyer une page vide. La valeur par défaut est ``True``. 
    289  
    290     * ``context_processors``: une liste de processeurs de contexte de template 
    291       à appliquer au template de la vue. Voir la `documentation de 
    292       RequestContext`_. 
    293  
    294     * ``template_object_name``:  indique le nom de la variable de template à 
    295       utiliser dans le contexte du template. Par défaut, c'est ``object``. La 
    296       vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour 
    297       déterminer le nom de la variable. 
    298  
    299     * ``make_object_list``: un booléen indiquant s'il faut retrouver la 
    300       totalité de la liste des objets pour cette année et la passer au 
    301       template. Si ``True``, la liste d'objets sera passée au template sous le 
    302       nom de ``object_list``. (Le nom ``object_list`` peut être différent, 
    303       voir les précisions sur ``object_list`` dans la section "Contexte du 
    304       template" ci-dessous). La valeur par défaut est ``False``. 
    305  
    306     * ``mimetype``: le type MIME à utiliser pour le document résultant. La 
    307       valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. 
    308  
    309     * ``allow_future``: une valeur booléenne indiquant s'il faut inclure les 
    310       objets "futurs" sur la page, où futur signifie des objets pour lesquels 
    311       le champ spécifié dans ``date_field`` est plus grand que la date et 
    312       l'heure courantes. La valeur par défaut est ``False``. 
    313  
    314 **Nom du template :** 
     288ParamÚtres requis 
     289~~~~~~~~~~~~~~~~~ 
     290 
     291``year`` 
     292    L'année de l'archive sur 4 chiffres. 
     293 
     294``queryset`` 
     295    Un ``QuerySet`` d'objets à renvoyer dans l'archive. 
     296 
     297``date_field`` 
     298    Le nom du champ ``DateField`` ou ``DateTimeField`` dans 
     299    le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer 
     300    les objets à renvoyer dans la page. 
     301 
     302ParamÚtres optionnels 
     303~~~~~~~~~~~~~~~~~~~~~ 
     304 
     305``template_name`` 
     306    Le nom complet du template à utiliser pour rendre la 
     307    page. Cela permet de passer outre le nom du template par défaut (voir 
     308    ci-dessous). 
     309 
     310``template_loader`` 
     311    Le chargeur de template à utiliser pour charger le 
     312    template. Par défaut, c'est ``django.template.loader``. 
     313 
     314``extra_context`` 
     315    Un dictionnaire de valeurs à ajouter au contexte du 
     316    template. Par défaut, c'est un dictionnaire vide. Si une valeur du 
     317    dictionnaire est appelable (callable), la vue générique l'appellera 
     318    juste avant le rendu du template. 
     319 
     320``allow_empty`` 
     321    Une valeur booléenne qui indique s'il faut afficher la 
     322    page si aucun objet n'est disponible. Si la valeur est ``False`` et 
     323    qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu 
     324    d'envoyer une page vide. La valeur par défaut est ``True``. 
     325 
     326``context_processors`` 
     327    Une liste de processeurs de contexte de template 
     328    à appliquer au template de la vue. Voir la `documentation de 
     329    RequestContext`_. 
     330 
     331``template_object_name`` 
     332    Indique le nom de la variable de template à 
     333    utiliser dans le contexte du template. Par défaut, c'est ``object``. La 
     334    vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour 
     335    déterminer le nom de la variable. 
     336 
     337``make_object_list`` 
     338    Un booléen indiquant s'il faut retrouver la 
     339    totalité de la liste des objets pour cette année et la passer au 
     340    template. Si ``True``, la liste d'objets sera passée au template sous le 
     341    nom de ``object_list``. (Le nom ``object_list`` peut être différent, 
     342    voir les précisions sur ``object_list`` dans la section "Contexte du 
     343    template" ci-dessous). La valeur par défaut est ``False``. 
     344 
     345``mimetype`` 
     346    Le type MIME à utiliser pour le document résultant. La 
     347    valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. 
     348 
     349``allow_future`` 
     350    Une valeur booléenne indiquant s'il faut inclure les 
     351    objets "futurs" sur la page, où futur signifie des objets pour lesquels 
     352    le champ spécifié dans ``date_field`` est plus grand que la date et 
     353    l'heure courantes. La valeur par défaut est ``False``. 
     354 
     355Nom du template 
     356~~~~~~~~~~~~~~~ 
    315357 
    316358Si ``template_name`` n'est pas précisé, la vue utilisera le template  
    317359``<app_label>/<model_name>_archive_year.html`` par défaut. 
    318360 
    319 **Contexte du template :** 
     361Contexte du template 
     362~~~~~~~~~~~~~~~~~~~~ 
    320363 
    321364En plus de ``extra_context``, le contexte du template sera : 
    322365 
    323     * ``date_list``: une liste d'objets ``datetime.date`` représentant tous 
    324       les mois pour lesquels le ``queryset`` a renvoyé des objets pour l'année 
    325       considérée, dans l'ordre ascendant. 
    326  
    327     * ``year``: l'année considérée, sous forme d'une chaîne de 4 chiffres. 
    328  
    329     * ``object_list``: si le paramÚtre ``make_object_list`` vaut ``True``, 
    330       renverra une liste des objets disponibles pour l'année considérée, triée 
    331       sur le champ date. Le nom de cette variable dépend du paramÚtre 
    332       ``template_object_name``, qui est ``object`` par défaut. Si 
    333       ``template_object_name`` est ``foo``, le nom de la variable sera 
    334       ``foo_list``. 
    335  
    336       Si ``make_object_list`` vaut ``False``, ``object_list`` sera passé au 
    337       template comme une liste vide. 
     366``date_list`` 
     367    Une liste d'objets ``datetime.date`` représentant tous 
     368    les mois pour lesquels le ``queryset`` a renvoyé des objets pour l'année 
     369    considérée, dans l'ordre ascendant. 
     370 
     371``year`` 
     372    L'année considérée, sous forme d'une chaîne de 4 chiffres. 
     373 
     374``object_list`` 
     375    Si le paramÚtre ``make_object_list`` vaut ``True``, 
     376    renverra une liste des objets disponibles pour l'année considérée, triée 
     377    sur le champ date. Le nom de cette variable dépend du paramÚtre 
     378    ``template_object_name``, qui est ``object`` par défaut. Si 
     379    ``template_object_name`` est ``foo``, le nom de la variable sera 
     380    ``foo_list``. 
     381 
     382    Si ``make_object_list`` vaut ``False``, ``object_list`` sera passé au 
     383    template comme une liste vide. 
    338384 
    339385``django.views.generic.date_based.archive_month`` 
    340386------------------------------------------------- 
    341387 
    342 **Description :** 
     388Description 
     389~~~~~~~~~~~ 
    343390 
    344391Une page d'archive mensuelle affichant tous les objets pour un mois donné. 
     
    346393si vous positionnez ``allow_future`` à ``True``. 
    347394 
    348 **ParamÚtres requis :** 
    349  
    350     * ``year``: l'année pour laquelle l'archive est recherchée (une chaîne de 
    351       4 chiffres). 
    352  
    353     * ``month``: le mois pour lequel l'archive est recherchée, au format indiqué 
    354       par le paramÚtre ``month_format``. 
    355  
    356     * ``queryset``: un ``QuerySet`` d'objets à renvoyer dans l'archive. 
    357  
    358     * ``date_field``: le nom du champ ``DateField`` ou ``DateTimeField`` dans 
    359       le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer 
    360       les objets à renvoyer dans la page. 
    361  
    362 **ParamÚtres optionnels :** 
    363  
    364     * ``month_format``: une chaîne de format qui indique celui qui doit être 
    365       utilisé par le paramÚtre ``month``. Doit utiliser la syntaxe acceptée 
    366       par la fonction Python ``time.strftime``. (Voir la `documentation de 
    367       strftime`_). La valeur par défaut est ``"%b"``, qui est le nom du mois 
    368       abrégé sur trois lettres. Pour utiliser le numéro du mois, utilisez 
    369       ``"%m"``. 
    370  
    371     * ``template_name``: le nom complet du template à utiliser pour rendre la 
    372       page. Cela permet de passer outre le nom du template par défaut (voir 
    373       ci-dessous). 
    374  
    375     * ``template_loader``: le chargeur de template à utiliser pour charger le 
    376       template. Par défaut, c'est ``django.template.loader``. 
    377  
    378     * ``extra_context``: un dictionnaire de valeurs à ajouter au contexte du 
    379       template. Par défaut, c'est un dictionnaire vide. Si une valeur du 
    380       dictionnaire est appelable (callable), la vue générique l'appellera 
    381       juste avant le rendu du template. 
    382  
    383     * ``allow_empty``: Une valeur booléenne qui indique s'il faut afficher la 
    384       page si aucun objet n'est disponible. Si la valeur est ``False`` et 
    385       qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu 
    386       d'envoyer une page vide. La valeur par défaut est ``False``. 
    387  
    388     * ``context_processors``: une liste de processeurs de contexte de template 
    389       à appliquer au template de la vue. Voir la `documentation de 
    390       RequestContext`_. 
    391  
    392     * ``template_object_name``:  indique le nom de la variable de template à 
    393       utiliser dans le contexte du template. Par défaut, c'est ``object``. La 
    394       vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour 
    395       déterminer le nom de la variable. 
    396  
    397     * ``mimetype``: le type MIME à utiliser pour le document résultant. La 
    398       valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. 
    399  
    400     * ``allow_future``: une valeur booléenne indiquant s'il faut inclure les 
    401       objets "futurs" sur la page, où futur signifie des objets pour lesquels 
    402       le champ spécifié dans ``date_field`` est plus grand que la date et 
    403       l'heure courantes. La valeur par défaut est ``False``. 
    404  
    405 **Nom du template :** 
     395ParamÚtres requis 
     396~~~~~~~~~~~~~~~~~ 
     397 
     398``year`` 
     399    L'année pour laquelle l'archive est recherchée (une chaîne de 
     400    4 chiffres). 
     401 
     402``month`` 
     403    Le mois pour lequel l'archive est recherchée, au format indiqué 
     404    par le paramÚtre ``month_format``. 
     405 
     406``queryset`` 
     407   Un ``QuerySet`` d'objets à renvoyer dans l'archive. 
     408 
     409``date_field`` 
     410    Le nom du champ ``DateField`` ou ``DateTimeField`` dans 
     411    le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer 
     412    les objets à renvoyer dans la page. 
     413 
     414ParamÚtres optionnels 
     415~~~~~~~~~~~~~~~~~~~~~ 
     416 
     417``month_format`` 
     418    Une chaîne de format qui indique celui qui doit être 
     419    utilisé par le paramÚtre ``month``. Doit utiliser la syntaxe acceptée 
     420    par la fonction Python ``time.strftime``. (Voir la `documentation de 
     421    strftime`_). La valeur par défaut est ``"%b"``, qui est le nom du mois 
     422    abrégé sur trois lettres. Pour utiliser le numéro du mois, utilisez 
     423    ``"%m"``. 
     424 
     425``template_name`` 
     426    Le nom complet du template à utiliser pour rendre la 
     427    page. Cela permet de passer outre le nom du template par défaut (voir 
     428    ci-dessous). 
     429 
     430``template_loader`` 
     431    Le chargeur de template à utiliser pour charger le 
     432    template. Par défaut, c'est ``django.template.loader``. 
     433 
     434``extra_context`` 
     435    Un dictionnaire de valeurs à ajouter au contexte du 
     436    template. Par défaut, c'est un dictionnaire vide. Si une valeur du 
     437    dictionnaire est appelable (callable), la vue générique l'appellera 
     438    juste avant le rendu du template. 
     439 
     440``allow_empty`` 
     441    Une valeur booléenne qui indique s'il faut afficher la 
     442    page si aucun objet n'est disponible. Si la valeur est ``False`` et 
     443    qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu 
     444    d'envoyer une page vide. La valeur par défaut est ``False``. 
     445 
     446``context_processors`` 
     447    Une liste de processeurs de contexte de template 
     448    à appliquer au template de la vue. Voir la `documentation de 
     449    RequestContext`_. 
     450 
     451``template_object_name`` 
     452    Indique le nom de la variable de template à 
     453    utiliser dans le contexte du template. Par défaut, c'est ``object``. La 
     454    vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour 
     455    déterminer le nom de la variable. 
     456 
     457``mimetype`` 
     458    Le type MIME à utiliser pour le document résultant. La 
     459    valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. 
     460 
     461``allow_future`` 
     462    Une valeur booléenne indiquant s'il faut inclure les 
     463    objets "futurs" sur la page, où futur signifie des objets pour lesquels 
     464    le champ spécifié dans ``date_field`` est plus grand que la date et 
     465    l'heure courantes. La valeur par défaut est ``False``. 
     466 
     467Nom du template 
     468~~~~~~~~~~~~~~~ 
    406469 
    407470Si ``template_name`` n'est pas précisé, la vue utilisera le template  
    408471``<app_label>/<model_name>_archive_month.html`` par défaut. 
    409472 
    410 **Contexte du template :** 
     473Contexte du template 
     474~~~~~~~~~~~~~~~~~~~~ 
    411475 
    412476En plus de ``extra_context``, le contexte du template sera : 
    413477 
    414     * ``month``: un objet ``datetime.date`` représentant le mois considéré. 
    415  
    416     * ``next_month``: un objet ``datetime.date`` représentant le premier jour 
    417       du mois suivant le mois considéré. Si le mois suivant est dans le futur, 
    418       la valeur sera ``None``. 
    419  
    420     * ``previous_month``: un objet ``datetime.date`` représentant le premier 
    421       jour du mois précédent. A l'inverse de ``next_month``, ne vaudra jamais 
    422       ``None``. 
    423  
    424     * ``object_list``: une liste d'objets disponibles pour le mois considéré. 
    425       Le nom de cette variable dépend du paramÚtre 
    426       ``template_object_name``, qui est ``object`` par défaut. Si 
    427       ``template_object_name`` est ``foo``, le nom de la variable sera 
    428       ``foo_list``. 
     478``month`` 
     479    Un objet ``datetime.date`` représentant le mois considéré. 
     480 
     481``next_month`` 
     482    Un objet ``datetime.date`` représentant le premier jour 
     483    du mois suivant le mois considéré. Si le mois suivant est dans le futur, 
     484    la valeur sera ``None``. 
     485 
     486``previous_month`` 
     487    Un objet ``datetime.date`` représentant le premier 
     488    jour du mois précédent. A l'inverse de ``next_month``, ne vaudra jamais 
     489    ``None``. 
     490 
     491``object_list`` 
     492    Une liste d'objets disponibles pour le mois considéré. 
     493    Le nom de cette variable dépend du paramÚtre 
     494    ``template_object_name``, qui est ``object`` par défaut. Si 
     495    ``template_object_name`` est ``foo``, le nom de la variable sera 
     496    ``foo_list``. 
    429497 
    430498.. _documentation de strftime: http://www.python.org/doc/current/lib/module-time.html#l2h-1941 
     
    433501------------------------------------------------ 
    434502 
    435 **Description :** 
     503Description 
     504~~~~~~~~~~~ 
    436505 
    437506Une page d'archive hebdomadaire affichant tous les objets pour une semaine 
     
    440509si vous positionnez ``allow_future`` à ``True``. 
    441510 
    442 **ParamÚtres requis :** 
    443  
    444     * ``year``: l'année pour laquelle l'archive est recherchée (une chaîne de 
    445       4 chiffres). 
    446  
    447     * ``week``: la semaine pour laquelle l'archive est recherchée (une 
    448       chaîne). Les semaines commencent le dimanche. 
    449  
    450     * ``queryset``: un ``QuerySet`` d'objets à renvoyer dans l'archive. 
    451  
    452     * ``date_field``: le nom du champ ``DateField`` ou ``DateTimeField`` dans  
    453       le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer 
    454       les objets à renvoyer dans la page. 
    455  
    456 **ParamÚtres optionnels :** 
    457  
    458     * ``template_name``: le nom complet du template à utiliser pour rendre la 
    459       page. Cela permet de passer outre le nom du template par défaut (voir 
    460       ci-dessous). 
    461  
    462     * ``template_loader``: le chargeur de template à utiliser pour charger le 
    463       template. Par défaut, c'est ``django.template.loader``. 
    464  
    465     * ``extra_context``: un dictionnaire de valeurs à ajouter au contexte du 
    466       template. Par défaut, c'est un dictionnaire vide. Si une valeur du 
    467       dictionnaire est appelable (callable), la vue générique l'appellera 
    468       juste avant le rendu du template. 
    469  
    470     * ``allow_empty``: Une valeur booléenne qui indique s'il faut afficher la 
    471       page si aucun objet n'est disponible. Si la valeur est ``False`` et 
    472       qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu 
    473       d'envoyer une page vide. La valeur par défaut est ``False``. 
    474  
    475     * ``context_processors``: une liste de processeurs de contexte de template 
    476       à appliquer au template de la vue. Voir la `documentation de 
    477       RequestContext`_. 
    478  
    479     * ``template_object_name``:  indique le nom de la variable de template à 
    480       utiliser dans le contexte du template. Par défaut, c'est ``object``. La 
    481       vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour 
    482       déterminer le nom de la variable. 
    483  
    484     * ``mimetype``: le type MIME à utiliser pour le document résultant. La 
    485       valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. 
    486  
    487     * ``allow_future``: une valeur booléenne indiquant s'il faut inclure les 
    488       objets "futurs" sur la page, où futur signifie des objets pour lesquels 
    489       le champ spécifié dans ``date_field`` est plus grand que la date et 
    490       l'heure courantes. La valeur par défaut est ``False``. 
    491  
    492 **Nom du template :** 
     511ParamÚtres requis 
     512~~~~~~~~~~~~~~~~~ 
     513 
     514``year`` 
     515    L'année pour laquelle l'archive est recherchée (une chaîne de 
     516    4 chiffres). 
     517 
     518``week`` 
     519    La semaine pour laquelle l'archive est recherchée (une 
     520    chaîne). Les semaines commencent le dimanche. 
     521 
     522``queryset`` 
     523    Un ``QuerySet`` d'objets à renvoyer dans l'archive. 
     524 
     525``date_field`` 
     526    Le nom du champ ``DateField`` ou ``DateTimeField`` dans  
     527    le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer 
     528    les objets à renvoyer dans la page. 
     529 
     530ParamÚtres optionnels 
     531~~~~~~~~~~~~~~~~~~~~~ 
     532 
     533``template_name`` 
     534    Le nom complet du template à utiliser pour rendre la 
     535    page. Cela permet de passer outre le nom du template par défaut (voir 
     536    ci-dessous). 
     537 
     538``template_loader`` 
     539    Le chargeur de template à utiliser pour charger le 
     540    template. Par défaut, c'est ``django.template.loader``. 
     541 
     542``extra_context`` 
     543    Un dictionnaire de valeurs à ajouter au contexte du 
     544    template. Par défaut, c'est un dictionnaire vide. Si une valeur du 
     545    dictionnaire est appelable (callable), la vue générique l'appellera 
     546    juste avant le rendu du template. 
     547 
     548``allow_empty`` 
     549    Une valeur booléenne qui indique s'il faut afficher la 
     550    page si aucun objet n'est disponible. Si la valeur est ``False`` et 
     551    qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu 
     552    d'envoyer une page vide. La valeur par défaut est ``False``. 
     553 
     554``context_processors`` 
     555    Une liste de processeurs de contexte de template 
     556    à appliquer au template de la vue. Voir la `documentation de 
     557    RequestContext`_. 
     558 
     559``template_object_name`` 
     560    Indique le nom de la variable de template à 
     561    utiliser dans le contexte du template. Par défaut, c'est ``object``. La 
     562    vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour 
     563    déterminer le nom de la variable. 
     564 
     565``mimetype`` 
     566    Le type MIME à utiliser pour le document résultant. La 
     567    valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. 
     568 
     569``allow_future`` 
     570    Une valeur booléenne indiquant s'il faut inclure les 
     571    objets "futurs" sur la page, où futur signifie des objets pour lesquels 
     572    le champ spécifié dans ``date_field`` est plus grand que la date et 
     573    l'heure courantes. La valeur par défaut est ``False``. 
     574 
     575Nom du template 
     576~~~~~~~~~~~~~~~ 
    493577 
    494578Si ``template_name`` n'est pas précisé, la vue utilisera le template  
    495579``<app_label>/<model_name>_archive_week.html`` par défaut. 
    496580 
    497 **Contexte du template :** 
     581Contexte du template 
     582~~~~~~~~~~~~~~~~~~~~ 
    498583 
    499584En plus de ``extra_context``, le contexte du template sera : 
    500585 
    501     * ``week``: un objet ``datetime.date`` représentant le premier jour de la 
    502       semaine considérée. 
    503  
    504     * ``object_list``: une liste d'objets disponibles pour la semaine 
    505       considérée. Le nom de cette variable dépend du paramÚtre 
    506       ``template_object_name``, qui est ``object`` par défaut. Si 
    507       ``template_object_name`` est ``foo``, le nom de la variable sera 
    508       ``foo_list``. 
     586``week`` 
     587    Un objet ``datetime.date`` représentant le premier jour de la 
     588    semaine considérée. 
     589 
     590``object_list`` 
     591    Une liste d'objets disponibles pour la semaine 
     592    considérée. Le nom de cette variable dépend du paramÚtre 
     593    ``template_object_name``, qui est ``object`` par défaut. Si 
     594    ``template_object_name`` est ``foo``, le nom de la variable sera 
     595    ``foo_list``. 
    509596 
    510597``django.views.generic.date_based.archive_day`` 
    511598----------------------------------------------- 
    512599 
    513 **Description :** 
     600Description 
     601~~~~~~~~~~~ 
    514602 
    515603Une page d'archive quotidienne affichant tous les objets pour un jour 
     
    519607si vous positionnez ``allow_future`` à ``True``. 
    520608 
    521 **ParamÚtres requis :** 
    522  
    523     * ``year``: l'année pour laquelle l'archive est recherchée (une chaîne de 
    524       4 chiffres). 
    525  
    526     * ``month``: le mois pour lequel l'archive est recherchée, au format indiqué 
    527       par le paramÚtre ``month_format``. 
    528  
    529     * ``day``: le jour pour lequel l'archive est recherchée, au format indiqué 
    530       par le paramÚtre ``day_format``. 
    531  
    532     * ``queryset``: un ``QuerySet`` d'objets à renvoyer dans l'archive. 
    533  
    534     * ``date_field``: le nom du champ ``DateField`` ou ``DateTimeField`` dans 
    535       le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer 
    536       les objets à renvoyer dans la page. 
    537  
    538 **ParamÚtres optionnels :** 
    539  
    540     * ``month_format``: une chaîne de format qui indique celui qui doit être 
    541       utilisé par le paramÚtre ``month``. Doit utiliser la syntaxe acceptée 
    542       par la fonction Python ``time.strftime``. (Voir la `documentation de 
    543       strftime`_). La valeur par défaut est ``"%b"``, qui est le nom du mois 
    544       abrégé sur trois lettres. Pour utiliser le numéro du mois, utilisez 
    545       ``"%m"``. 
    546  
    547     * ``day_format``: comme ``month_format``, mais pour le paramÚtre ``day``. 
    548       La valeur par défaut est ``"%d"`` (quantiÚme du jour du mois, 01-31). 
    549  
    550     * ``template_name``: le nom complet du template à utiliser pour rendre la 
    551       page. Cela permet de passer outre le nom du template par défaut (voir 
    552       ci-dessous). 
    553  
    554     * ``template_loader``: le chargeur de template à utiliser pour charger le 
    555       template. Par défaut, c'est ``django.template.loader``. 
    556  
    557     * ``extra_context``: un dictionnaire de valeurs à ajouter au contexte du 
    558       template. Par défaut, c'est un dictionnaire vide. Si une valeur du 
    559       dictionnaire est appelable (callable), la vue générique l'appellera 
    560       juste avant le rendu du template. 
    561  
    562     * ``allow_empty``: Une valeur booléenne qui indique s'il faut afficher la 
    563       page si aucun objet n'est disponible. Si la valeur est ``False`` et 
    564       qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu 
    565       d'envoyer une page vide. La valeur par défaut est ``False``. 
    566  
    567     * ``context_processors``: une liste de processeurs de contexte de template 
    568       à appliquer au template de la vue. Voir la `documentation de 
    569       RequestContext`_. 
    570  
    571     * ``template_object_name``:  indique le nom de la variable de template à 
    572       utiliser dans le contexte du template. Par défaut, c'est ``object``. La 
    573       vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour 
    574       déterminer le nom de la variable. 
    575  
    576     * ``mimetype``: le type MIME à utiliser pour le document résultant. La 
    577       valeur par défaut est celle du rÚglage ``DEFAULT_CONTENT_TYPE``. 
    578  
    579     * ``allow_future``: une valeur booléenne indiquant s'il faut inclure les 
    580       objets "futurs" sur la page, où futur signifie des objets pour lesquels 
    581       le champ spécifié dans ``date_field`` est plus grand que la date et 
    582       l'heure courantes. La valeur par défaut est ``False``. 
    583  
    584 **Nom du template :** 
     609ParamÚtres requis 
     610~~~~~~~~~~~~~~~~~ 
     611 
     612``year`` 
     613    L'année pour laquelle l'archive est recherchée (une chaîne de 
     614    4 chiffres). 
     615 
     616``month`` 
     617    Le mois pour lequel l'archive est recherchée, au format indiqué 
     618    par le paramÚtre ``month_format``. 
     619 
     620``day`` 
     621    Le jour pour lequel l'archive est recherchée, au format indiqué 
     622    par le paramÚtre ``day_format``. 
     623 
     624``queryset`` 
     625    Un ``QuerySet`` d'objets à renvoyer dans l'archive. 
     626 
     627``date_field`` 
     628    Le nom du champ ``DateField`` ou ``DateTimeField`` dans 
     629    le modÚle de ``QuerySet`` que l'archive doit utiliser pour déterminer 
     630    les objets à renvoyer dans la page. 
     631 
     632ParamÚtres optionnels 
     633~~~~~~~~~~~~~~~~~~~~~ 
     634 
     635``month_format`` 
     636    Une chaîne de format qui indique celui qui doit être 
     637    utilisé par le paramÚtre ``month``. Doit utiliser la syntaxe acceptée 
     638    par la fonction Python ``time.strftime``. (Voir la `documentation de 
     639    strftime`_). La valeur par défaut est ``"%b"``, qui est le nom du mois 
     640    abrégé sur trois lettres. Pour utiliser le numéro du mois, utilisez 
     641    ``"%m"``. 
     642 
     643``day_format`` 
     644    Comme ``month_format``, mais pour le paramÚtre ``day``. 
     645    La valeur par défaut est ``"%d"`` (quantiÚme du jour du mois, 01-31). 
     646 
     647``template_name`` 
     648    Le nom complet du template à utiliser pour rendre la 
     649    page. Cela permet de passer outre le nom du template par défaut (voir 
     650    ci-dessous). 
     651 
     652``template_loader`` 
     653    Le chargeur de template à utiliser pour charger le 
     654    template. Par défaut, c'est ``django.template.loader``. 
     655 
     656``extra_context`` 
     657    Un dictionnaire de valeurs à ajouter au contexte du 
     658    template. Par défaut, c'est un dictionnaire vide. Si une valeur du 
     659    dictionnaire est appelable (callable), la vue générique l'appellera 
     660    juste avant le rendu du template. 
     661 
     662``allow_empty`` 
     663    Une valeur booléenne qui indique s'il faut afficher la 
     664    page si aucun objet n'est disponible. Si la valeur est ``False`` et 
     665    qu'aucun objet n'est disponible, la vue enverra une erreur 404 au lieu 
     666    d'envoyer une page vide. La valeur par défaut est ``False``. 
     667 
     668``context_processors`` 
     669    Une liste de processeurs de contexte de template 
     670    à appliquer au template de la vue. Voir la `documentation de 
     671    RequestContext`_. 
     672 
     673``template_object_name`` 
     674    Indique le nom de la variable de template à 
     675    utiliser dans le contexte du template. Par défaut, c'est ``object``. La 
     676    vue ajoutera le suffixe ``'_list'`` à la valeur de ce paramÚtre pour 
     677    déterminer le nom de la variable. 
     678 
     679``mimetype`` 
     680    Le type MIME à utiliser pour le document résultant. La 
     681    valeur par défaut est celle du rÚglage ``DEFAULT_CONTENT_TYPE``. 
     682 
     683``allow_future`` 
     684    Une valeur booléenne indiquant s'il faut inclure les 
     685    objets "futurs" sur la page, où futur signifie des objets pour lesquels 
     686    le champ spécifié dans ``date_field`` est plus grand que la date et 
     687    l'heure courantes. La valeur par défaut est ``False``. 
     688 
     689Nom du template 
     690~~~~~~~~~~~~~~~ 
    585691 
    586692Si ``template_name`` n'est pas précisé, la vue utilisera le template  
    587693``<app_label>/<model_name>_archive_day.html`` par défaut. 
    588694 
    589 **Contexte du template :** 
     695Contexte du template 
     696~~~~~~~~~~~~~~~~~~~~ 
    590697 
    591698En plus de ``extra_context``, le contexte du template sera : 
    592699 
    593     * ``day``: un objet ``datetime.date`` représentant le jour considéré. 
    594  
    595     * ``next_day``: un objet ``datetime.date`` représentant le jour suivant. 
    596       Si le jour suivant est dans le futur, vaudra ``None``. 
    597  
    598     * ``previous_day``: un objet ``datetime.date`` représentant le jour 
    599       précédent. Contrairement à ``next_day``, ne vaudra jamais ``None``. 
    600  
    601     * ``object_list``: une liste d'objets disponibles pour le jour considéré. 
    602       Le nom de cette variable dépend du paramÚtre 
    603       ``template_object_name``, qui est ``object`` par défaut. Si 
    604       ``template_object_name`` est ``foo``, le nom de la variable sera 
    605       ``foo_list``. 
     700``day`` 
     701    Un objet ``datetime.date`` représentant le jour considéré. 
     702 
     703``next_day`` 
     704    Un objet ``datetime.date`` représentant le jour suivant. 
     705    Si le jour suivant est dans le futur, vaudra ``None``. 
     706 
     707``previous_day`` 
     708    Un objet ``datetime.date`` représentant le jour 
     709    précédent. Contrairement à ``next_day``, ne vaudra jamais ``None``. 
     710 
     711``object_list`` 
     712    Une liste d'objets disponibles pour le jour considéré. 
     713    Le nom de cette variable dépend du paramÚtre 
     714    ``template_object_name``, qui est ``object`` par défaut. Si 
     715    ``template_object_name`` est ``foo``, le nom de la variable sera 
     716    ``foo_list``. 
    606717 
    607718``django.views.generic.date_based.archive_today`` 
    608719------------------------------------------------- 
    609720 
    610 **Description :** 
     721Description 
     722~~~~~~~~~~~ 
    611723 
    612724Une page d'archive quotidienne affichant tous les objets pour *aujourd'hui*. 
     
    618730------------------------------------------------- 
    619731 
    620 **Description :** 
     732Description 
     733~~~~~~~~~~~ 
    621734 
    622735Une page pour afficher un objet individuel.  
     
    624737sauf si vous positionnez ``allow_future`` à ``True``. 
    625738 
    626 **ParamÚtres requis :** 
    627  
    628     * ``year``: l'année de l'objet (une chaîne de 4 chiffres). 
    629  
    630     * ``month``: le mois de l'objet, au format indiqué 
    631       par le paramÚtre ``month_format``. 
    632  
    633     * ``day``: le jour de l'objet, au format indiqué 
    634       par le paramÚtre ``day_format``. 
    635  
    636     * ``queryset``: un ``QuerySet`` de l'objet à renvoyer dans l'archive. 
    637  
    638     * ``date_field``: le nom du champ ``DateField`` ou ``DateTimeField`` dans 
    639       le modÚle de ``QuerySet`` que la vue générique doit utiliser pour 
    640       déterminer l'objet à renvoyer en fonction de ``year``, ``month`` et 
    641       ``day``. 
    642  
    643     * Soit ``object_id``, soit (``slug`` *et* ``slug_field``) sont requis. 
    644  
    645       Si ``object_id`` est fourni, ce doit être la valeur du champ de clé 
    646       primaire pour l'objet affiché sur la page. 
    647  
    648       Sinon, ``slug`` doit être le slug de l'objet choisi, et ``slug_field`` 
    649       doit être le nom du champ slug dans le modÚle de ``QuerySet``. La valeur 
    650       par défaut de ``slug_field`` est ``'slug'``. 
    651  
    652 **ParamÚtres optionnels :** 
    653  
    654     * ``month_format``: une chaîne de format qui indique celui qui doit être 
    655       utilisé par le paramÚtre ``month``. Doit utiliser la syntaxe acceptée 
    656       par la fonction Python ``time.strftime``. (Voir la `documentation de 
    657       strftime`_). La valeur par défaut est ``"%b"``, qui est le nom du mois 
    658       abrégé sur trois lettres. Pour utiliser le numéro du mois, utilisez 
    659       ``"%m"``. 
    660  
    661     * ``day_format``: comme ``month_format``, mais pour le paramÚtre ``day``. 
    662       La valeur par défaut est ``"%d"`` (quantiÚme du jour du mois, 01-31). 
    663  
    664     * ``template_name``: le nom complet du template à utiliser pour rendre la 
    665       page. Cela permet de passer outre le nom du template par défaut (voir 
    666       ci-dessous). 
    667  
    668     * ``template_name_field``: le nom d'un champ de l'objet dont la valeur est 
    669       le nom du template à utiliser. Cela vous permet de stocker le nom du 
    670       template dans les données. En d'autres termes, si votre objet a un champ 
    671       appelé ``'the_template'`` qui contient la chaîne ``'foo.html'``, et si 
    672       vous positionnez ``template_name_field`` à la valeur ``'the_template'``, 
    673       la vue générique de votre objet utilisera le template ``'foo.html'``. 
    674  
    675       Ça fait un peu mal à la tête, mais c'est parfois utile. 
    676  
    677     * ``template_loader``: le chargeur de template à utiliser pour charger le 
    678       template. Par défaut, c'est ``django.template.loader``. 
    679  
    680     * ``extra_context``: un dictionnaire de valeurs à ajouter au contexte du 
    681       template. Par défaut, c'est un dictionnaire vide. Si une valeur du 
    682       dictionnaire est appelable (callable), la vue générique l'appellera 
    683       juste avant le rendu du template. 
    684  
    685     * ``context_processors``: une liste de processeurs de contexte de template 
    686       à appliquer au template de la vue. Voir la `documentation de 
    687       RequestContext`_. 
    688  
    689     * ``template_object_name``:  indique le nom de la variable de template à 
    690       utiliser dans le contexte du template. Par défaut, c'est ``object``. 
    691  
    692     * ``mimetype``: le type MIME à utiliser pour le document résultant. La 
    693       valeur par défaut est celle du réglage ``DEFAULT_CONTENT_TYPE``. 
    694  
    695     * ``allow_futur