Django CMS 3.9.x Documentation

语言	格式	评分
英语	.epub	3
摘要
文档介绍了Django CMS 3.9.x版本的使用、开发和贡献指南。内容包括如何构建和测试文档、使用Django CMS的基本指南、教程和高级开发指南。文档还详细说明了3.9.0版本的新功能和改进，如支持Django 3.2 LTS、新增功能和修复的bug。文档结构清晰，适合不同层次的用户，提供了丰富的参考和技术细节。
AI总结
### Django CMS 3.9.x 文档总结 #### 1. 贡献文档 - 文档重要性: 文档对项目的发展至关重要，尤其是吸引新贡献者和帮助老成员的重要工具。 - 文档要求: - 使用有效的 Sphinx 和 RestructuredText 格式，文件扩展名为 `.rst`。 - 代码不超过 100 字符/行。 - 使用简单易懂的英文，符合英国英语的拼写和标点规范。 - 假设读者熟悉 Python 和 Django，但不熟悉其他技术。 - 测试与提交: 提交前需运行 `make spelling` 和 `make html` 进行测试，确保文档无误。 #### 2. 文档结构 - 主要部分: - 教程: 从安装到创建自定义addon应用的分步指南。 - 如何操作: 进阶开发者使用的详细分步指南。 - 关键主题: 解释 CMS 的核心概念。 - 参考: 技术参考文档，包括 API、模型等。 - 使用指南: 面向用户的 CMS 使用指南，涵盖内容创建和编辑的基础知识。 - 文档markup: 主要遵循 Python 文档的分节标记规范。 #### 3. 版本兼容性 - Python/Django 兼容性: 提供了详细的兼容性表格，支持 LTS（长期支持）版本。 - 依赖管理: 查看 `setup.py` 或《升级说明与信息》获取更多依赖细节。 #### 4. 新功能与修复 - 3.9.0 版本更新: - 新增功能: - 支持 Django 3.2 LTS。 - 在“页面树”管理操作下拉模板中添加 `page changed_date`。 - 允许递归模板扩展占位符。 - 支持 Github Actions CI。 - 支持 `django-treebeard 4.5.1`。 - 提升 `cms list plugins` 命令的性能。 - 修复问题: - 修复了多数据库设置下的迁移问题。 - 修复了默认回显未使用空列表时的问题。 - 修复了前缀语言设置为 `False` 的重定向行为。 - 修复了移动页面时 `slug` 独特性的检查问题。 #### 5. 社区资源 - 支持渠道: - Slack: 加入友好社区讨论组。 - Discourse: 用于技术开发讨论。 - StackOverflow: 用于插件生态问题讨论。 #### 6. 使用 Django CMS 的原因 - 关键特性: - 强大的国际化支持。 - 前端编辑功能。 - 灵活的插件系统。 - 丰富的文档。 - 易于与现有项目集成。 - 活跃的开发者社区。 - 强调自动化测试的优秀代码文化。 #### 7. 升级注意事项 - 升级建议: 升级前仔细阅读《升级说明与信息》，备份数据库，并谨慎处理复杂升级路径。 ### 总结 Django CMS 是一个功能强大、灵活且易于集成的 CMS 平台，支持多语言、前端编辑和插件扩展。3.9.0 版本引入了对 Django 3.2 的支持，并修复了多项问题，提升了性能和兼容性。贡献文档和参与社区是推动项目发展的重要方式。