Django 1.10.x Documentation

• 语言: 英语
• 格式: .pdf
• 来源: media.readthedocs.org

摘要

该文档是Django 1.10.x版本的官方文档，涵盖Django框架的核心组件和使用指南。文档内容包括模型层、视图层、模板层、表单、开发流程、管理后台、安全、国际化与本地化、性能优化、Python兼容性、地理框架、常见Web应用工具及其他核心功能。此外，文档还提供了快速入门指南、编写第一个Django应用的教程、如何安装Django、模型与数据库、处理HTTP请求等实用内容。文档还介绍了Django 1.0版本的新特性，如重构的管理后台、通用关系支持、INSERT/UPDATE区分、缓存中间件拆分等。文档最后说明了Django源代码仓库的结构，包括主分支、稳定分支和标签的使用。

AI总结

Django 1.10.x 文档涵盖了该版本的核心功能和开发指南。文档结构清晰，分为入门、使用、以及参考等部分。

**核心内容与关键信息：**

1. **入门指南**：提供了从零开始的教程，包括快速安装指南和编写第一个 Django 应用的七个步骤，以及如何编写可复用的应用和第一个补丁。

2. **使用 Django**：详细说明了模型与数据库、HTTP 请求处理、表单、视图、模板、管理后台、安全、国际化、性能优化和 Python 兼容性等核心模块。

3. **主要新特性与改进**：
* **表单**：`ChoiceField` 现在可以接受一个返回可迭代选项的可调用对象。
* **通用视图**：`MultipleObjectMixin` 支持通过 `ordering` 属性指定排序；`get_object()` 方法支持通过主键和 slug 联合查询；`ModelFormMixin` 的 `success_url` 支持 Python 的 `str.format()` 语法。
* **国际化**：`FORMAT_MODULE_PATH` 现在可以是一个路径列表，允许从多个可重用应用中导入格式模块。
* **管理命令**：新增了 `dumpdata --output`、`makemessages --exclude`、`compilemessages --exclude` 和 `makemigrations --name` 等选项；`inspectdb` 现在能输出 `Meta.unique_together` 并支持 MySQL 和 PostgreSQL 的 AutoField 自省。
* **日志**：`AdminEmailHandler` 新增了 `send_mail()` 方法，便于子类化。

4. **版本历史与重大变更**：
* **1.0 版本**：是 Django 发展的重要里程碑，包含了重构的管理后台、全新的表单库、对 Jython 的支持、以及缓存中间件的拆分。
* **1.0.1 版本**：作为 1.0 系列的首次错误修复版本，包含超过 200 个修复，如对 Oracle 数据库的支持改进、表单集和唯一性约束的修复等。
* **向后不兼容变更**：文档提供了从 0.96 到 1.0 版本的数据库后端 API 变更对照表，并指出了一系列已移除的废弃特性。

5. **源码仓库**：Django 使用 Git 进行版本控制，主分支 (`master`) 用于开发下一个版本，`stable/A.B.x` 分支用于发布准备和错误修复。