Documentation de Django¶

Premiers pas¶

Django ou la programmation sont nouveaux pour vous ? C’est le bon endroit pour démarrer !

• From scratch: Overview | Installation

• Tutorial: Part 1: Requests and responses | Part 2: Models and the admin site | Part 3: Views and templates | Part 4: Forms and generic views | Part 5: Testing | Part 6: Static files | Part 7: Customizing the admin site | Part 8: Adding third-party packages

• Advanced Tutorials: How to write reusable apps | Writing your first contribution to Django

Obtenir de l’aide¶

Des problèmes ? Nous aimerions vous aider !

• Try the FAQ – it’s got answers to many common questions.

• Looking for specific information? Try the Index, Index du module or the detailed table of contents.

• Not found anything? See FAQ : Obtenir de l’aide for information on getting support and asking questions to the community.

• Signalez des anomalies de Django dans notre système de tickets (en anglais).

Organisation de la documentation¶

Django possède une documentation abondante. Un aperçu général de la façon dont elle est structurée peut aider à trouver ce que l’on cherche :

• Les tutoriels vous conduisent par la main à travers une série d’étapes en vue de la création d’une application Web. Commencez par là si vous débutez avec Django ou avec le développement d’applications Web. Consultez également les « Premiers pas ».

• Les guides thématiques abordent des thèmes et concepts clés d’un point de vue général et fournissent des informations et explications détaillées sur les éléments fondamentaux.

• Les guides de référence contiennent des références techniques pour les API et autres aspects de la machinerie Django. Ils présentent son fonctionnement et la manière de l’exploiter en partant du principe que les concepts clés de base sont maîtrisés.

• Les guides pratiques sont des marches à suivre. Vous êtes guidé pas-à-pas dans la résolution de problèmes et de scénarios classiques. Les connaissances requises sont plus élevées que pour les tutoriels et le fonctionnement de base de Django doit être compris.

La couche des modèles¶

Django présente une couche d’abstraction (les « modèles ») pour structurer et manipuler les données de votre application Web. Pour en savoir plus, voyez ci-dessous :

• Models: Introduction to models | Field types | Indexes | Meta options | Model class

• QuerySets: Making queries | QuerySet method reference | Lookup expressions

• Model instances: Instance methods | Accessing related objects

• Migrations: Introduction to Migrations | Operations reference | SchemaEditor | Writing migrations

• Advanced: Managers | Raw SQL | Transactions | Aggregation | Search | Custom fields | Multiple databases | Custom lookups | Query Expressions | Conditional Expressions | Database Functions

• Other: Supported databases | Legacy databases | Providing initial data | Optimize database access | PostgreSQL specific features

La couche des vues¶

Django possède le concept des « vues » qui englobe la logique responsable du traitement des requêtes des utilisateurs et le renvoi des réponses. Trouvez tout ce qu’il faut savoir sur les vues au travers des liens ci-dessous :

• The basics: URLconfs | View functions | Shortcuts | Decorators | Asynchronous Support

• Reference: Built-in Views | Request/response objects | TemplateResponse objects

• File uploads: Overview | File objects | Storage API | Managing files | Custom storage

• Class-based views: Overview | Built-in display views | Built-in editing views | Using mixins | API reference | Flattened index

• Advanced: Generating CSV | Generating PDF

• Middleware: Overview | Built-in middleware classes

La couche des gabarits¶

La couche des gabarits fournit une syntaxe adaptée aux concepteurs Web pour le rendu des informations à présenter aux utilisateurs. Pour apprendre comment les concepteurs Web peuvent utiliser cette syntaxe et comment elle peut être étendue par les programmeurs, lisez :

• The basics: Overview

• For designers: Language overview | Built-in tags and filters | Humanization

• For programmers: Template API | Custom tags and filters | Custom template backend

Formulaires¶

Django fournit un cadre applicatif riche pour faciliter la création de formulaires et la manipulation des données de formulaires.

• The basics: Overview | Form API | Built-in fields | Built-in widgets

• Advanced: Forms for models | Integrating media | Formsets | Customizing validation

Le processus de développement¶

Apprendre comment différents composants et outils peuvent vous aider à développer et à tester les applications Django :

• Settings: Overview | Full list of settings

• Applications: Overview

• Exceptions: Overview

• django-admin and manage.py: Overview | Adding custom commands

• Testing: Introduction | Writing and running tests | Included testing tools | Advanced topics

• Deployment: Overview | WSGI servers | ASGI servers | Deploying static files | Tracking code errors by email | Deployment checklist

L’administration¶

Trouvez tout ce qu’il faut savoir sur l’interface d’administration automatique, l’une des fonctionnalités les plus populaires de Django :

• Admin site

• Admin actions

• Admin documentation generator

Sécurité¶

La sécurité est un sujet d’importance capitale dans le développement d’applications Web et Django offre plusieurs outils et mécanismes de protection :

• Security overview

• Disclosed security issues in Django

• Clickjacking protection

• Cross Site Request Forgery protection

• Cryptographic signing

• Intergiciel de sécurité

• Content Security Policy

Internationalisation et régionalisation¶

Django contient un cadre applicatif robuste pour gérer l’internationalisation et la régionalisation dans le développement d’applications multilingues et pour différentes régions du monde :

• Overview | Internationalization | Localization | Localized web UI formatting and form input

• Fuseaux horaires

Performance et optimisations¶

Il existe une variété de techniques et d’outils pour aider à rendre votre code plus performant, plus rapide et moins gourmand en ressources système.

• Performance and optimization overview

Cadre applicatif géographique¶

GeoDjango intends to be a world-class geographic web framework. Its goal is to make it as easy as possible to build GIS web applications and harness the power of spatially enabled data.

Outils d’usage courant pour les applications Web¶

Django fournit plusieurs outils fréquemment utilisés dans le développement d’applications Web :

• Authentication: Overview | Using the authentication system | Password management | Customizing authentication | API Reference

• Caching

• Logging

• Tasks framework

• Sending emails

• Syndication feeds (RSS/Atom)

• Pagination

• Messages framework

• Serialization

• Sessions

• Sitemaps

• Static files management

• Data validation

Autres fonctionnalités essentielles¶

En savoir plus sur quelques autres fonctionnalités essentielles de l’infrastructure Django :

• Conditional content processing

• Content types and generic relations

• Flatpages

• Redirects

• Signals

• System check framework

• The sites framework

• Unicode in Django

Le projet libre Django¶

En savoir plus sur le processus de développement du projet Django lui-même et sur la manière d’y contribuer :

• Community: Contributing to Django | The release process | Team organization | The Django source code repository | Security policies | Mailing lists and Forum

• Design philosophies: Overview

• Documentation: About this documentation

• Third-party distributions: Overview

• Django over time: API stability | Release notes and upgrading instructions | Deprecation Timeline