Documentation de Django¶
Tout ce que vous devez savoir sur Django.
Obtenir de l’aide¶
Des problèmes ? Nous aimerions vous aider !
- Essayez la FAQ – elle contient des réponses à de nombreuses questions courantes.
- En recherche d’informations spécifiques ? Essayez Index, Index du module ou la table des matières détaillée.
- Recherchez des informations dans les archives de la liste de diffusion anglophone django-users ou soumettez une question.
- Posez une question dans le canal IRC #django (en anglais) ou recherchez dans les journaux IRC pour savoir si la question a déjà été posée.
- 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 » ci-dessous.
- 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.
Premiers pas¶
Django ou la programmation sont nouveaux pour vous ? C’est le bon endroit pour démarrer !
- Pour commencer : Aperçu | Installation
- Tutoriel : 1ère partie : requêtes et réponses | 2ème partie : les modèles et le site d’administration | 3ème partie : vues et gabarits | 4ème partie : formulaires et vues génériques | 5ème partie : tests | 6ème partie : fichiers statiques | 7ème partie : personnalisation du site d’administration
- Tutoriels avancés : Comment écrire des applications réutilisables | Écriture de votre premier correctif pour Django
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 :
- Modèles : Introduction aux modèles | Les types de champs | Index | Les options Meta | La classe Model
- QuerySets : Création de requêtes | Référence des méthodes QuerySet | Expressions de recherche
- Instances des modèles : Méthodes des instances | Accès aux objets liés
- Migrations : Introduction aux migrations | Référence des opérations | Édition de schéma | Écriture de migrations
- Avancé : Managers | SQL brut | Transactions | Aggrégation | Recherche | Champs personnalisés | Base de données multiples | Expressions de recherche personnalisées | Expressions de requêtes | Expressions conditionelles | Fonctions de base de données
- Autre : Bases de données prises en charge | Bases de données existantes | Données initiales | Optimisation des accès aux bases de données | Fonctionnalités spécifiques à PostgreSQL
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 :
- Les bases : URLconfs | Les fonctions Vue | Raccourcis | Décorateurs
- Référence : Vues incluses | Les objets requête-réponse | Les objets TemplateResponse
- Téléchargement de fichiers : Aperçu | Les objets fichiers | L’API de stockage | Gestion des fichiers | Stockage personnalisé
- Vues fondées sur les classes : Aperçu | Vues d’affichages incluses | Vues d’édition incluses | Utilisation des mixins | Référence de l’API | Sommaire général
- Avancé : Production de CSV | Production de PDF
- Middleware : Aperçu | Classes middleware incluses
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 :
- Les bases : Aperçu
- Pour les concepteurs : Aperçu du langage | Balises et filtres inclus | Humanisation
- Pour les programmeurs : L’API des gabarits | Balises et filtres personnalisés
Formulaires¶
Django fournit un cadre applicatif riche pour faciliter la création de formulaires et la manipulation des données de formulaires.
- Les bases : Aperçu | L’API des formulaires | Champs inclus | Composants inclus
- Avancé: Formulaires pour modèles | Intégration de médias | Jeux de formulaires | Personnalisation de la validation
Le processus de développement¶
Apprendre comment différents composants et outils peuvent vous aider à développer et à tester les applications Django :
- Paramètres : Aperçu | Liste complète des paramètres (settings)
- Applications : Aperçu
- Exceptions : Aperçu
- django-admin et manage.py: Aperçu | Ajout de commandes personnalisées
- Tests : Introduction | Écriture et exécution des tests | Outils de recherche inclus | Sujets avancés
- Déploiment : Aperçu | Serveurs WSGI | Déploiement des fichiers statiques | Suivi des erreurs de code par courriel
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 :
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 :
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 :
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.
Compatibilité Python¶
Django vise à être compatible avec plusieurs versions et adaptations de Python :
Cadre applicatif géographique¶
GeoDjango se veut un cadre applicatif Web géographique de classe mondiale. Son but est de faciliter au maximum la création d’application Web GIS et l’exploitation du potentiel de données géolocalisées.
Outils d’usage courant pour les applications Web¶
Django fournit plusieurs outils fréquemment utilisés dans le développement d’applications Web :
- Authentification : Aperçu | Utilisation du système d’authentification | Gestion des mots de passe | Personnalisation de l’authentification | Référence de l’API
- Gestion des caches
- Journalisation
- Envoi de courriels
- Flux de syndication (RSS/Atom)
- Pagination
- Infrastructure de messages
- Sérialisation
- Sessions
- Sitemaps
- Gestion de fichiers statiques
- Validation de données
Autres fonctionnalités essentielles¶
En savoir plus sur quelques autres fonctionnalités essentielles de l’infrastructure 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 :
- Communauté : Comment s’impliquer | Le processus de publication | Structure des équipes | Le dépôt du code source de Django | La politique de sécurité | Les listes de diffusion
- Philosophie conceptuelle : Aperçu
- Documentation: À propos de cette documentation
- Distribution par des tierces-parties : Aperçu
- Évolution de Django: Stabilité de l’API | Notes de publication et instructions de mises à jour | Processus d’obsolescence