Django 5.0.x Documentation

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

摘要

文档详细介绍了Django 5.0的新功能、安装指南、开发流程、模型层、视图层、模板层以及表单、安全、国际化和本地化等内容。重点包括对异步支持的增强、时间区和本地化的改进，以及对旧功能的弃用。文档还提供了教程、参考指南和如何编写第一个Django应用的详细步骤，帮助开发者高效使用Django构建Web应用。

AI总结

# Django 5.0.x 文档总结

## 1. 版本信息
- **发布版本**：Django 5.0.2.dev20240126115907
- **发布日期**：2024年1月26日
- **文档语言**：HTML格式，使用reStructuredText编写，通过Sphinx工具转换为多种格式。

## 2. 主要功能与改进

### 2.1 新功能
1. **Facet Filters in the Admin**
- 管理界面的变更列表中新增了facet计数功能，支持通过UI切换显示/隐藏。
- 可通过`ModelAdmin.show_facets`属性自定义显示行为。

2. **简化表单模板渲染**
- 引入了`field group`和`field group templates`，简化了表单字段（标签、widget、帮助文本、错误信息）的渲染逻辑。

### 2.2 兼容性与移除
- **Python版本支持**：
- 支持Python 3.10、3.11、3.12，推荐使用最新版本。
- Django 4.2.x是最后一个支持Python 3.8和3.9的版本。

- **移除特性**：
- 移除了对Django 4.2之前版本的第三方库支持建议。
- 移除了`SERIALIZE`测试设置、`Django.utils.baseconv`和`Django.utils.datetime_safe`模块。
- 移除了`Django.contrib.gis.admin.GeoModelAdmin`和`OSMGeoAdmin`类，建议使用`ModelAdmin`和`GISModelAdmin`。

- **时区支持**：
- 默认启用`USE_TZ`，时间默认为`UTC`。
- `pytz`支持被移除，建议使用`zoneinfo`。

- **国际化**：
- 默认启用`USE_L10N`，日期和数字显示本地化。
- `{% localize %}`标签和`localize/unlocalize`过滤器仍有效。

- **其他移除**：
- `Django.contrib.postgres.aggregates.ArrayAgg`等聚合函数不再返回空列表，默认返回`None`。
- 移除了`is dst`参数在多个时间函数中的支持。

## 3. 文档结构
- **教程（Tutorials）**：
- 分步指导创建Web应用，适合新手。

- **主题指南（Topic Guides）**：
- 高层次解释概念，提供背景信息，避免重复基础内容。

- **参考指南（Reference Guides）**：
- 技术文档，详细描述API和内部机制，假设读者已掌握基础知识。

- **如何指南（How-to Guides）**：
- 解决常见问题的分步说明，适用于有一定经验的开发者。

## 4. 开发与贡献
- **文档编写**：
- 使用reStructuredText编写，通过Sphinx工具生成HTML、PDF等格式。
- 文档更新与代码同步，确保最新版本。

- **贡献指南**：
- 提供了从报告问题到提交补丁的完整流程，鼓励社区参与。

## 5. 差异与版本控制
- **文档版本**：
- 主分支文档包含最新功能，正式发布版本文档包含稳定内容。
- 使用`New in Django Development version`标记未发布新功能，`New in version X.Y`标记已发布版本。

## 6. 性能与优化
- **性能优化**：
- 提供了数据库优化、缓存机制等技术文档。

## 7. 其他工具与框架
- **地理框架**：
- 提供了与空间数据库的集成支持。
- **常见Web工具**：
- 包括文件上传、缓存、会话管理等功能。

## 8. 总结
Django 5.0版本在功能、性能和文档组织上均有较大改进，特别在表单渲染、时区支持和国际化方面表现突出。同时，移除了部分旧功能和模块，建议开发者及时更新代码以适应新版本要求。