django cms 3.7.x Documentation

《django CMS 3.7.x Documentation》主要涵盖了django CMS 3.7.x版本及其相关的内容，包括功能更新、修复、改进、升级指南和项目治理等内容。以下是文档的核心总结： ### 1. **版本更新与功能改进** - **3.7.1 版本更新**： - 修复了通过`cms.api.create_page`创建页面时忽略左右位置的问题。 - 修复了`urls.py`文档示例中多语言配置的问题。 - 修复了请求页面时`request.current_page`始终显示为公共页面的问题。 - 修复了菜单渲染时显示草稿页面的bug。 - 修复了`urls.W001`警告、缺失的`{% trans %}`标签以及文档中的一些小错误。 - 改进了权限文档、apphooks文档、`CMSPluginBase`文档以及嵌套插件的文档。 - 更新了安装教程和分支发布政策。 - **3.7.0 版本更新**： - 引入了对Django 2.2 LTS和Python 3.7的支持。 - 修复了测试套件和`urlconf_module`的覆盖问题，避免系统检查崩溃。 - 更新了安装和升级指南，强调从旧版本升级时需注意的事项。 - **3.0.7 版本更新**： - 更新了教程和文档，以更好地支持South 1.0。 - 修复了前端UI的多个小问题，以及与`#`符号相关的页面重新加载问题。 - 修复了`limit_choices_to`和`PageField`在Django 1.7环境中的问题。 ### 2. **升级指南** - 升级前需备份数据库并确保其一致性。 - 执行`python manage.py migrate`以应用迁移。 - 使用`python manage.py cms fix-tree`修复树结构。 - 检查第三方应用是否与新版本兼容。 - 安装新版本并通过`pip`或GitHub获取最新代码。 ### 3. **项目与社区治理** - 更新了社区和项目治理文档，包括核心开发者名单和分支策略。 - 3.7版本成为新的长期支持（LTS）版本，提供24个月的安全更新。 - 项目维护了多个分支： - `develop`：默认开发分支。 - `release/x.y.z`：已发布的版本分支。 - `release/4.0.x`：实验性分支。 ### 4. **贡献文档** - 文档采用Sphinx和RestructuredText编写，需遵循格式规范。 - 贡献文档被视为项目的重要部分，非技术人员也可通过简单的英语写作参与。 - 文档需易于理解，假设读者熟悉Python和Django，但不熟悉其他技术。 ### 5. **版本兼容性** - 提供了详细的Python和Django兼容性表格，标记了经过测试的组合（✓）和未测试/不兼容的组合（x）。 - 3.7.x系列是当前支持的LTS版本，支持Django 2.2和Python 3.7。 ### 6. **功能亮点** - 强大的国际化支持，适合多语言网站。 - 前端编辑功能，快速访问内容管理界面。 - 灵活的插件系统，支持多种编辑器和高级文本编辑功能。 - 健壮的文档和活跃的开发者社区。 ### 7. **其他** - 提供了详细的发布说明和升级信息，强调在升级前仔细阅读文档的重要性。 - 提供了完整的依赖信息和安装指南。 总结来看，文档全面介绍了django CMS 3.7.x的功能更新、升级方法、项目治理和贡献指南，旨在帮助用户更好地理解和使用该CMS平台。