Django 2.1.x Documentation

语言	格式	评分
英语	.epub	3
摘要
文档主要介绍了Django的内部结构和相关文档的编写规范。内容涵盖Django的不同版本（包括2.2、2.1、1.11等）、贡献指南、邮件列表、组织结构、安全政策、发布流程以及已移除的功能。文档还提到了如何参与Django的贡献，包括报告问题、编写代码和文档等。此外，文档详细说明了Django的安全策略和发布过程，包括支持的版本和弃用功能的时间表。最后，文档提供了如何预览和测试更改的指导，并介绍了Django的其他改进和新功能。
AI总结
### Django 2.1.x 文档总结 #### 1. 版本说明 - 受影响版本：Django 2.2、2.1 和 1.11（均为补丁版本）。 - Python 兼容性：Django 2.1 支持 Python 3.5、3.6 和 3.7，而 Django 2.0 是最后一个支持 Python 3.4 的版本。 #### 2. Django 内部开发 - 贡献指南：包括如何贡献代码、报告问题、编写文档和本地化 Django。 - 开发流程：涉及代码提交、邮件列表（如 Django-developers、Django-i18n 等）以及项目组织结构。 - 安全政策：包括安全问题的报告和披露流程。 #### 3. 新功能 - Model “view” 权限：新增了模型的默认权限 `view`，允许用户在 admin 中仅查看模型数据。此功能向后兼容，无需修改现有权限设置。 - jQuery 升级：从 2.2.3 升级到 3.3.1。 - GeoDjango 更新：新增对 SpatiaLite 的支持，以及新的地理聚合和查询方法（如 `collect`、`geojson` 和 `snap_to_grid`）。 #### 4. 改进与优化 - 缓存中间件：将 `CacheMiddleware` 拆分为两个独立中间件，分别处理插入和读取缓存。 - URL 命名空间：允许在同一 Django URL 配置中多次包含同一组 URL，支持可变的命名前缀。 - CSRF 保护：将 CSRF 保护中间件拆分为两个独立中间件，提供更细粒度的控制。 #### 5. 移除的弃用功能 - 移除了 `form_for_model` 和 `form_for_instance` 等已弃用的功能。 - 移除了 `DEFAULT_CONTENT_TYPE` 设置和 `HttpRequest.xreadlines()` 方法。 - 移除了 `django.shortcuts.render_to_response()` 和 `django.db.backends.postgresql_psycopg2` 模块。 #### 6. 已知问题 - 在 `InlineModelAdmin.has_add_permission()` 中未传递 `obj` 参数会导致崩溃。 #### 7. 文档编写 - 新功能需在文档中记录，例如在 `docs/topics/http/shortcuts.txt` 中添加 `make_toast()` 函数，并更新发布说明（如 `docs/releases/2.2.txt`）。 #### 8. 版本发布流程 - 发布 cadence：Django 采用定期发布策略。 - 弃用政策：遵循 Django 的弃用政策，已弃用的功能将在未来版本中逐步移除。 #### 9. 其他改进 - 视图处理：增强了对 ETag 和 Last-Modified HTTP 头的条件视图处理支持，提升性能和减少带宽消耗。 - 模板和视图：改进了 `reverse()` 和 `{% url %}` 模板标签，支持 admin URL 的反向解析。 #### 10. 已知问题 - admin 中的批量删除操作存在潜在问题。 --- 总结：Django 2.1 版本在功能、性能和安全性方面均有显著提升，同时对部分旧功能进行了移除或改进，建议用户在升级时注意兼容性问题。