django cms 3.4.x Documentation

• 语言: 英语
• 格式: .epub
• 来源: docs.django-cms.org

摘要

文档详细介绍了Django CMS 3.4版本的发布和相关内容。该版本是第一个“长期支持”（LTS）版本，将提供24个月的安全和关键更新支持。文档涵盖了新功能、重大变化、升级注意事项、分支管理、代码格式、Sass相关变化、gulp.js使用、结构板改进、侧边栏替换、新启动页面、应用钩自动重新加载中间件、开发者改进、内容向导、模块重命名、新页面类型、多语言编辑改进、SEO字段移除、菜单标题覆盖、插件回退语言、语言选择器、自定义模块和插件标签、新copy_lang子命令、前端编辑器、页面与站点相关名称更改及潜在的向后不兼容问题。

AI总结

### Django CMS 3.4.x 文档总结

#### 1. **提案与讨论重大变化**
- 重大功能变更需通过邮件列表 [https://groups.google.com/group/django-cms-developers] 提案和讨论，确保社区参与和透明度。
- 拉取请求前需在邮件列表中进行讨论。

#### 2. **发布计划**
- 发布计划参考 [https://www.django-cms.org/en/roadmap/]
- **Django CMS 3.4** 是首个“长期支持（LTS）”版本，提供 24 个月的安全和关键更新支持，且更新将保持向后兼容。

#### 3. **分支变更**
- 从 `master` 分支转向 `release` 分支，GitHub 仓库维护多个分支，`release/x.y.z` 为下一个 PyPI 发布版本。
- 开发集中在 `release/x.y.z` 分支，`develop` 分支已不再使用。

#### 4. **3.4 版本新特性**
- **移除修订支持**：核心 CMS 中不再提供 undo/redo 功能，未来将作为可选插件。
- **插件渲染方式改变**：移除 `cms-plugin` 类的 HTML 包裹，改用模板标签和 JavaScript。
- **资产缓存策略**：缓存 busting 通过路径变更实现，而非 GET 参数。
- **拖放复制页面**：支持通过拖放界面复制页面。
- **结构板改进**：树形显示元素，支持旧模式的 `CMS_TOOLBAR_SIMPLE_STRUCTURE_MODE` 设置。
- **侧边栏替换为叠加层**：提供更简洁的视图，不影响 API。
- **新启动页面**：使用 `ATIC_ROOT` 和 `manage.py collectstatic`。

#### 5. **升级指南**
- 代码格式从制表符改为四个空格。
- 更新模板标记至 `cms_tags` 命名空间。

#### 6. **Sass 相关变化**
- 使用 LibSass 和 CSSComb 进行静态文件构建。

#### 7. **新功能与改进**
- **ApphookReloadMiddleware**：自动重新加载 apphooks，无需重启服务器。
- **前端编辑器**：支持任意 Django 模型的前端编辑。
- **语言复制子命令**：通过 `manage.py cms copy_lang` 复制内容。
- **SEO 改进**：移除 SEO 字段，`meta_description` 最大长度调整为 155。
- **菜单标题覆盖**：默认启用 `CMS_MENU_TITLE_OVERWRITE`。

#### 8. **警告与兼容性**
- 升级到 3.0 需 `Django.contrib.messages`。
- `Site` 模型的 `related_name` 从 `page` 变更为 `djangocms_pages`，可能影响现有代码。

#### 9. **贡献与文档**
- 文档新增拼写检查，可通过 `make spelling` 和 Travis CI 进行验证。
- 邮件列表和 IRC 频道提供社区支持。

#### 10. **其他改进**
- **多语言支持**：语言选择器和内容回退语言功能增强。
- **模块重命名**：`cms_app`、`cms_toolbar`、`menu` 模块重命名为 `cms_apps`、`cms_tools`、`cms_menus`，旧名称已弃用。

总结：Django CMS 3.4 提供了 LTS 支持、多项功能改进和开发者工具优化，移除了部分旧功能，建议用户根据文档升级和调整代码。