Django CMS 4.1.x Documentation

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

摘要

文档详细介绍了Django CMS 4.1.x的功能、升级指南和兼容性信息。Django CMS 4.1是该框架的首个社区版本，引入了多项重要更改，包括核心简化、移除过时功能以及新的功能如右到左语言支持的改进。文档还提供了从3.x版本升级到4.x版本的步骤指南，并强调了与Django和Python的兼容性。此外，文档涵盖了第三方包的集成、常用插件的概述以及新手教程，帮助用户快速上手并自定义Django CMS。每个版本的发布说明详细列出了新功能、错误修复和改进。

AI总结

以下是对《Django CMS 4.1.x Documentation》的简要总结：

---

### **Django CMS 4.1.x 文档总结**

#### **1. 版本概述**
- **4.1.x 系列**：这是 Django CMS 4 的第一个社区版本，包含了 4.0.0 及后续版本的所有更改。
- **4.0.0**：作为完全重写的核心版本，significant changes were made to simplify the CMS and remove baked-in opinions. It has never been released on PyPI but is available on GitHub.
- **重要升级注意事项**：
- 升级自 3.x 版本需注意，需参考 4.0.0 发布说明中的分步升级指南。
- 4.1.0 是 4.x 系列的首个社区版本，升级自 3.11 或更早版本需特别注意 4.0.0 的发布说明。

#### **2. 核心变化与新功能**
- **简化核心功能**：4.x 系列核心简化，移除了 viele opinions，允许第三方定义发布功能。
- **版本控制**：发布功能已迁移到 `djangocms-versioning`，以支持更灵活的版本管理。
- **页面树状态指示器**：4.1 新增页面树状态指示器，目前支持“public”和“empty”两种状态，其他功能可通过第三方包扩展。
- **右对左语言支持优化**：4.1.1 和 4.1.3 改进了右对左语言（RTL）的 CSS 和 JS 资产，提升了 admin 后台管理的易用性。
- **性能优化**：
- 4.1.1 提升了菜单渲染速度，减少了数据库访问。
- 4.1.3 改进了页面内容缓存，优化了权限缓存失效逻辑。

#### **3. 兼容性**
- **Django 和 Python 支持**：
- 4.1 支持 Django 3.2 to 5.0（推荐最新版本）和 Python 3.8 to 3.12。
- 4.1.3 和 4.1.5 扩展支持至 Django 3.2 to 5.1 和 Python 3.9 to 3.12。
- **第三方包**：
- 包如 `djangocms-frontend`（基于 Bootstrap 5）、`django-filer`（资产管理）、`djangocms-icons`（图标支持）和 `djangocms-admin-style`（admin 后台样式）均支持 4.1。

#### **4. 教程与文档**
- 教程部分面向新手，涵盖从安装到扩展的关键功能，包括：
- 安装 django CMS 和创建新项目。
- Templates & Placeholders。
- 应用集成、插件、Apphooks、工具栏扩展、导航菜单扩展、内容创建向导等。
- 教程内容 entry-level，后续可在 How-to 部分找到更深入的参考资料。

#### **5. 升级指南**
- **从 3.5+ 升级到 4.0.0**：
- 4.0.0 介绍了major changes，需手动操作升级。
- 推荐新项目直接使用 4.0.0。
- **从 2.1.x 和 Django 1.2.x 升级**：
- 需参考 4.1.5 发布说明中的详细步骤。

#### **6. 贡献者与社区支持**
- 感谢所有贡献者，包括 Mark Walker、Vinit Kumar、Fabian Braun 等。
- 社区支持可通过 Discord 服务器获得帮助：[https://discord-support-channel.django-cms.org](https://discord-support-channel.django-cms.org)。

---

### **总结**
Django CMS 4.1.x 系列是近年来一个major release，重点在于简化核心功能、提升灵活性和兼容性，并修复了多项 bug。升级自 3.x 版本需要特别注意版本兼容性和升级步骤。同时，4.1.x 系列继续优化了 RTL 支持、性能和用户体验，为开发者提供了更强大的工具集。