Django 2.0.x Documentation

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

摘要

文档主要内容涵盖Django 2.0.x及1.11.x版本的发布说明，包括新功能、向后不兼容的更改和已弃用的功能。详细介绍了如何生成本地HTML文档，以及文档版本和更新策略。同时，文档提到了Django的社区贡献指南、安全政策、版本发布流程以及弃用时间表，其中部分功能如django.db.backends.postgresql_psycopg2和django.shortcuts.render_to_response()将在未来版本中移除。

AI总结

以下是对文档内容的简要总结，重点突出核心观点和关键信息：

---

### Django文档总结

#### **1. 基础概念**
- **Template（模板）**：用于抽象数据的呈现与数据本身，详见[模板文档](#template)。
- **View（视图）**：负责渲染页面的功能。

#### **2. 发布说明**
- **发布版本**：文档包含Django 2.0.x及1.11.x系列的发布说明，详细说明了每个版本的新功能和向后不兼容的更改。
- **Django 2.0.x**：从2.0到2.0.13的补丁版本发布说明。
- **Django 1.11.x**：从1.11到1.11.22的补丁版本发布说明。
- **升级指南**：升级时需检查所有版本之间的向后不兼容更改和已废弃的功能。

#### **3. 废弃时间表**
- **Django 3.0**：
- 移除`django.db.backends.postgresql_psycopg2`模块、`render_to_response()`函数、`DEFAULT_CONTENT_TYPE`设置、`HttpRequest.xreadlines()`方法等。
- 移除`Field.from_db_value()`和`Expression.convert_value()`的上下文支持。
- **Django 2.1**：
- 移除`contrib.auth.views`中的多个视图函数，如`login()`和`logout()`。
- 移除`extra_context`参数、`setup_databases()`函数、`string_concat()`函数等。
- **Django 2.0**：
- 移除上下文参数支持。

#### **4. 本地文档编译**
- 使用Sphinx将文档从纯文本转换为HTML：
- 安装Sphinx：`pip install sphinx`。
- 使用Makefile生成HTML文档：`make html`（需安装GNU Make，Windows可用`make.bat`）。
- 输出路径：`docs/_build/html`。

#### **5. 版本差异**
- 主干（trunk）版本的文档包含最新的功能和更改，且会实时更新。
- 离线文档针对特定版本进行调整，确保内容与版本对应。

#### **6. 新功能与改进**
- **Django 2.0**：
- 简化的URL路由语法：引入`path()`函数，支持更简洁的URL配置。
- 移动设备友好的Admin界面： Admin界面现已响应式设计，支持所有主要移动设备。
- Window表达式：支持在查询中添加OVER子句。
- 其他改进：如`ModelAdmin.autocomplete_fields`、`ForeignKey`和`ManyToManyField`的Select2搜索小部件等。

- **Django 1.2**：
- 支持单个实例中的多数据库连接。
- 提供模型验证（如表单验证）。
- 改进CSRF保护、用户消息框架、对象级权限等。
- 新增电子邮件后端自定义、智能模板标签等功能。

#### **7. 技术细节**
- **Python兼容性**：
- Django 2.0支持Python 3.4-3.7，建议使用最新版本。
- Django 1.11 LTS支持Python 2.7，但2.0将是最后支持Python 3.4的版本。
- **第三方库支持**：建议第三方应用作者在Django 2.0发布后放弃对1.11之前版本的支持。

---

以上是文档的核心内容和关键信息的总结，重点覆盖了版本发布说明、弃用时间表、文档编译方法、版本差异及主要新功能。