Anonymous avatar Anonymous committed 7db313d

Ajout de la traduction de ref/contrib/index.txt

Comments (0)

Files changed (2)

 syntax:glob
 
+.DS_Store
+
 docs/_build/*
 docs/_ext/*.pyc

docs/ref/contrib/index.txt

+=============================
+.. _ref-contrib-index:
+
+============================
+Les greffons "django.contrib"
+=============================
+
+Django tient à suivre la `philosophie "livré avec piles"`_ de Python. Il
+est accompagné d'une multitude d'extra, d'outils optionnels qui résolvent
+les problèmes communs au développement web.
+
+Ce code se situe dans le répertoire ``django/contrib`` de la distribution Django. Voici
+un tour d'horizon des paquetages de ``contrib``:
+
+.. admonition:: Note
+
+    Pour la plupart de ces greffons -- plus spécifiquement, les greffons
+    incluant aussi bien des modèles que des tags de templates -- vous aurez
+    besoin d'ajouter le nom du paquetage (e.g., ``'django.contrib.admin'``)
+    dans votre paramètre de configuration ``INSTALLED_APPS`` et de re-exécuter
+    ``manage.py syncdb``.
+
+.. _philosophie "livré avec piles": http://docs.python.org/tut/node12.html#batteries-included
+
+.. toctree::
+   :maxdepth: 1
+
+   admin
+   auth
+   comments/index
+   contenttypes
+   csrf
+   databrowse
+   flatpages
+   formtools/index
+   humanize
+   localflavor
+   redirects
+   sitemaps
+   sites
+   syndication
+   webdesign
+
+admin
+=====
+
+L'interface d'administration automatique de Django. Pour plus d'informations,
+voir le :ref:`Tutoriel 2 <intro-tutorial02>` et la
+:ref:`documentation admin <ref-contrib-admin>`..
+
+Nécessite l'installation des greffons auth_ et contenttypes_.
+
+auth
+====
+
+Le framework d'authentication de Django.
+
+Voir :ref:`topics-auth`.
+
+comments
+========
+
+.. versionchanged:: 1.0
+   L'application de commentaires a été re-écrite. Voir
+   :ref:`ref-contrib-comments-upgrade` pour plus d'information sur les
+   modalités de mise à jour.
+
+Un système simple et pourtant flexible de commentaires.
+
+contenttypes
+============
+
+Un framework léger pour modifier les "types" de contenus, pour lequel chaque
+modèle Django installé est un type de contenu distinct.
+
+Voir la :ref:`documentation des contenttypes <ref-contrib-contenttypes>`.
+
+csrf
+====
+
+Un midleware pour se préserver des Cross Site Request Forgeries
+
+Voir la :ref:`documentation du csrf <ref-contrib-csrf>`.
+
+flatpages
+=========
+
+Un framework pour gérer du contenu HTML "à plat" simple en base de données.
+
+Voir la :ref:`documentation des flatpages <ref-contrib-flatpages>`.
+
+Nécessite l'installation du greffon sites_.
+
+formtools
+=========
+
+Un ensemble d'abstractions de haut niveau pour les formulaires Django
+(django.forms).
+
+django.contrib.formtools.preview
+--------------------------------
+
+Une abstration du workflow suivant:
+
+"Affiche un formulaire HTML, force une prévisualisation, puis fait quelque
+chose avec la soumission."
+
+Voir la :ref:`documentation sur la prévisualisation des formulaires <ref-contrib-formtools-form-preview>`.
+
+django.contrib.formtools.wizard
+--------------------------------
+
+Ventile un formulaire sur plusieurs pages Web.
+
+Voir la :ref:`documentation sur les wizard de formulaires <ref-contrib-formtools-form-wizard>`.
+
+humanize
+========
+
+Un ensemble de filtres de templates propres à Django, utiles pour ajouter une
+"touche humaine" aux données.
+
+Voir la :ref:`documentation humanize <ref-contrib-humanize>`.
+
+localflavor
+===========
+
+Une collection de fragments de code relatifs à Django, utiles seulement pour
+un pays ou une culture donnée. Par exemple, ``django.contrib.localflavor.us.forms``
+contient un ``USZipCodeField`` que vous pouvez utiliser pour valider les
+codes postaux U.S.
+
+Voir la :ref:`documentation de localflavor <ref-contrib-localflavor>`.
+
+markup
+======
+
+Une collection de filtres de templates qui implémente ces langages structurés
+communs :
+
+    * ``textile`` -- implémente `Textile`_
+    * ``markdown`` -- implémente `Markdown`_
+    * ``restructuredtext`` -- implémente `ReST (ReStructured Text)`_
+
+Dans chaque cas, le filtre s'attend à une entrée formatée en tant que chaîne
+de caractères et retourne une chaîne de caractères représentant le texte balisé.
+Par exemple, le filtre ``textile`` convertit le texte balisé dans le format
+Textile en HTML.
+
+Pour activer ces filtres, ajoutez ``'django.contrib.markup'`` dans votre
+paramètre de configuration ``INSTALLED_APPS``. Une fois cela effectué,
+utilisez ``{% load markup %}`` dans un template, et vous aurez accès à ces
+filtres. Pour plus d'information, lisez le code source dans 
+django/contrib/markup/templatetags/markup.py.
+
+.. _Textile: http://en.wikipedia.org/wiki/Textile_%28markup_language%29
+.. _Markdown: http://en.wikipedia.org/wiki/Markdown
+.. _ReST (ReStructured Text): http://en.wikipedia.org/wiki/ReStructuredText
+
+redirects
+=========
+
+Un framework pour gérer les redirections.
+
+Voir la :ref:`documentation sur les redirections <ref-contrib-redirects>`.
+
+sessions
+========
+
+Un framework pour sauvegarder des données dans des sessions anonymes.
+
+Voir la :ref:`documentation sur les sessions <topics-http-sessions>`.
+
+sites
+=====
+
+Un framework léger vous permettant de gérer plusieurs sites à partir d'une
+même base de données et d'une même installation de Django. Il vous apporte
+quelques outils pour permmettre d'associer des objets à un ou plusieurs sites.
+
+Voir la :ref:`documentation sur les sites <ref-contrib-sites>`.
+
+sitemaps
+========
+
+Un framework pour générer les fichiers XML de "sitemap" Google.
+
+Voir la :ref:`documentation sur les sitemaps <ref-contrib-sitemaps>`.
+
+syndication
+===========
+
+Un framework pour générer facilement des flux de syndication, en RSS et ATOM.
+
+Voir la :ref:`documentation sur la syndication <ref-contrib-syndication>`.
+
+webdesign
+=========
+
+Outils et assistants principalement orientés vers les *designers* Web plutôt que
+les *développeurs* Web.
+
+Voir la :ref:`documentation sur les assitants au design Web <ref-contrib-webdesign>`.
+
+Autres greffons
+===============
+
+Si vous avez une idée de fonctionnalité à inclure dans ``contrib``, faites le 
+nous savoir ! Codez la, et postez la sur la `liste de diffusion django-users`_.
+
+.. _liste de diffusion django-users: http://groups.google.com/group/django-users
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.