Django 2.0.x Documentation

语言	格式	评分
英语	.pdf	3
摘要
文档主要介绍了如何为Django项目贡献文档，包括获取文档源代码、使用Sphinx构建文档以及文档的组织结构。文档还详细说明了Django 2.0.x版本中的新功能、弃用功能和更改事项，涵盖内容包括ORM改进、模板变量自动转义、GeoDjango支持、文件存储插件、Jython兼容性等。文档还提供了如何参与Django开发项目、代码仓库布局以及测试框架的更新等内容。
AI总结
# Django 2.0.x 文档总结 ## 1. 贡献文档 - 获取文档：Django的文档以HTML形式托管在[https://docs.djangoproject.com/](https://docs.djangoproject.com/)，但实际编辑为文本文件，位于源码仓库的`docs/`目录。 - 获取源码：通过源码仓库获取Django的开发版本，以获得最新的文档和代码。 - 使用Sphinx：文档基于Sphinx系统，需安装Sphinx（`pip install Sphinx`）并使用`make html`命令生成HTML文档。 ## 2. 文档组织结构 Django文档分为四类： - 教程（Tutorials）：引导读者完成具体任务，注重实用性。 - 主题指南（Topic Guides）：以较高层次解释概念，避免重复引用参考文档。 - 参考指南（Reference Guides）：提供技术API细节，不涉及基础解释。 - 如何指南（How-to Guides）：以结果为导向，指导读者完成具体操作步骤。 ## 3. 核心功能 - 内容处理：支持条件内容处理、内容类型和通用关系。 - 认证：支持身份验证后端，定义`supports_inactive_user`属性以处理非活跃用户。 - 信号（Signals）：用于在特定事件发生时触发回调。 - 系统检查框架（System Check Framework）：用于检查 Django 应用的健康状态。 - 站点框架（Sites Framework）：管理多个网站的配置。 - Unicode支持：Django在所有功能中均支持Unicode。 ## 4. 版本更新与弃用 - Django 1.16 版本： - 移除了`postgresql`数据库后端，推荐使用`postgresql_psycopg2`。 - 移除了`XMLField`，建议使用`TextField`替代。 - 移除了基于函数的测试运行器和`django.test.simple.run_tests()`。 - 移除了`views.feed()`视图和`feeds.Feed`类，推荐使用类基 getView。 - `django.contrib.auth.context_processors.auth`被移除，推荐使用新的认证处理器。 - 其他弃用：部分字段、方法和模块将逐步被淘汰，建议及时更新代码。 ## 5. 源码仓库 - 使用Git托管，需安装Git并熟悉其基本操作。 - 仓库地址：[https://github.com/django/django](https://github.com/django/django) ## 6. 发布说明 - 重大改进： - ORM：进行了大规模重构，提升了性能和兼容性。 - 模板系统：新增自动转义功能，支持`autoescape`标签。 - GeoDjango：新增地理信息系统支持。 - 文件存储：支持可插拔的文件存储后端。 - Jython兼容性：修复了与Jython的兼容性问题。 - 测试框架：新增多种测试功能，如`assertJSONNotEqual`和`FileResponse`。 - 其他功能： - 支持HTML5类型输入。 - 新增`earliest()`方法与`latest()`对称。 - 支持小时、分钟和秒的ORM查询。 - 新增`SuccessMessageMixin`和`MemcachedCache`的最新协议支持。 ## 7. 兼容性与注意事项 - 旧版本功能逐步淘汰，建议及时迁移。 - 测试数据库支持共享缓存（SQLite 3.7.13+）。 - 新增`django.db.models.ForeignKey.db_constraint`和`ManyToManyField.db_constraint`选项。 ## 8. 总结 Django 2.0版本在文档组织、核心功能、测试框架和兼容性方面均有重要更新。贡献者需熟悉Sphinx系统，并遵循文档编写规范。开发者应关注版本更新中的弃用功能，确保代码兼容性。