# Django 5.2.8 documentation

# Django 文档

你所需要知道的关于 Django 的一切。

## 快速入门

你是刚学 Django 或是初学编程？ 这就是你开始学习的地方！

- 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

## 获取帮助

遇到问题？我们可以帮你！

- Try the FAQ -- it's got answers to many common questions.

- Looking for specific information? Try the Index, Module Index or the detailed table of contents.

- Not found anything? See FAQ：获取帮助 for information on getting support and asking questions to the community.

- 在我们的 ticket tracker 报告关于 Django 的 Bug。

## 这份文档是如何组织的

Django 有丰富的文档。一份高度概述的文档会告诉你在哪里找到特定的东西：

- 教程 通过一系列的步骤来带领你创建一个网页应用程序。如果你是 Django 或网页应用开发的新手，可以从这里开始。也可以看一下 “ 快速入门 ”。

- 专题指南 在相当高的层次上介绍关键主题和概念，并提供有用的背景信息和解释。

- 参考指南 包含 API 和 Django 各个工作机制方面的技术参考。它们介绍了 Django 是如何工作，如何被使用的。不过，你得先对关键字的概念有一定理解。

- 操作指南 是一份目录。它们以排列好的关键问题和用例的方式指导你。它们比教程更加深入，且需要你先了解一些关于 Django 是如何工作的知识。

## 模型层

Django 提供了一个抽象的模型（“models”）层，用于结构化和操作你的网页应用程序的数据。阅读下面内容了解更多：

- 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

## 视图层

Django 具有 “视图” 的概念，负责处理用户的请求并返回响应。通过以下链接查找所有你需要知道的有关视图的信息：

- 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

## 模板层

模板层提供了一个对设计者友好的语法用于渲染向用户呈现的信息。学习如何使用语法（面向设计者）以及如何扩展（面向程序员）：

- The basics: Overview

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

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

## 表单

Django 提供了一个丰富的框架来帮助创建表单和处理表单数据。

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

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

## 开发进程

学习众多的组件及工具，来帮助你开发和测试 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

## 管理

找到所有你想知道的，关于自动化管理界面的知识，Django 最受欢迎的特性之一：

- Admin site

- Admin actions

- Admin documentation generator

## 安全

安全是网络应用程序开发中最重要的一个话题，Django 提供了多种保护工具和机制。

- Security overview

- Disclosed security issues in Django

- Clickjacking protection

- Cross Site Request Forgery protection

- Cryptographic signing

- 安全中间件

- Content Security Policy

## 国际化和本地化

Django 提供了一个强大的国际化和本地化的框架, 以帮助您在多语言和世界各地区进行应用程序的开发：

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

- 时区

## 性能和优化

有各种各样的技术和工具，可以帮助你的代码的运行更高效，更快和使用更少的系统资源.

- Performance and optimization overview

## 地理框架

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.

## 常见的网络应用工具

Django 提供了网络应用程序开发中普遍需要的多种工具：

- 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

## 其它核心功能

了解更多 Django 框架的其他核心功能 :

- Conditional content processing

- Content types and generic relations

- Flatpages

- Redirects

- Signals

- System check framework

- The sites framework

- Unicode in Django

## Django 开源项目

了解 Django 项目本身的开发进程以及你如何为 Django 做贡献：

- 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