django cms 3.5.x Documentation

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

摘要

The document provides comprehensive documentation for Django CMS version 3.5.x, focusing on usability improvements, including the decoupling of the structure board from page rendering and the separation of the Page model from the site navigation hierarchy. It also highlights new features such as page copying between sites, improved language handling, and enhanced publishing controls. The documentation includes tutorials, how-to guides, reference materials, and contribution guidelines. Key improvements in this release include better responsiveness during editing operations, faster page rendering, and a focus on decoupling logical layers for future extensibility.

AI总结

# Django CMS 3.5.x 文档总结

## 1. 提交 Pull Request
- 提交代码前，需运行 `make spelling` 检查拼写错误，并使用 `make html` 重建文档。
- 检查无误后，将代码推送到 GitHub 并按常规流程提交 Pull Request。

## 2. 文档结构
- 主要分为以下部分：
- 教程（入门）：从安装到创建自定义addon的分步指南。
- How-to 指南：针对开发者的高级主题分步指导。
- 关键主题：解释系统核心部分。
- 参考：API、关键模型等技术参考资料。
- 开发与社区（贡献指南）。
- 版本说明与升级信息。

## 3. 版本说明（3.5.0）
- **主要改进**：
- 结构板与页面渲染分离，提升编辑效率。
- 页面模型与导航树解耦，优化性能。
- 支持跨站页面复制。
- 语言选择器和语言回退处理改进。
- 重构模型的 `repr` 表示。
- 发布控制不再特指“页面”，为未来内容扩展奠定基础。
- **新功能**：
- 支持站点间页面复制。
- 改进语言选择器行为。
- 文档更新。
- **修复**：
- 页面模板设置权限问题。
- 其他 JavaScript 相关问题。

## 4. 贡献文档
- 文档贡献的重要性：
- 为新手提供入门指引，为资深开发者提供参考资料。
- 非技术人员也能通过简单英语贡献文档。
- 文档编写规范：
- 使用 Sphinx/RestructuredText，文件扩展名为 `.rst`。
- 行长不超过 100 字符。
- 使用 British English。
- 假设读者熟悉 Python 和 Django，但不熟悉其他技术。

## 5. 使用 Django CMS
- **核心功能**：
- 强大的国际化支持，适合多语言站点。
- 前端编辑模式，快速访问内容管理界面。
- 支持多种文本编辑器和灵活的插件系统。
- **优势**：
- 详细的文档和易于集成。
- 活跃的开发者社区。
- 代码质量高，注重自动化测试。

## 6. 软件版本要求
- 文档基于 Django CMS 3.5.4，支持 Django 2.2、3.0、3.1、3.2 和 Python 3.5+。
- 升级步骤：
1. 备份数据库并运行 `python manage.py migrate`。
2. 运行 `python manage.py cms fix-tree`。
3. 更新自定义代码和第三方应用。
4. 安装新版本并再次迁移。

## 7. 教程
- 面向新手的分步指南，涵盖从安装到自定义addon的全过程。
- 主要内容包括：
- 安装 Django CMS。
- 模板与占位符。
- 集成应用。
- 插件开发。
- Apphooks。
- 工具栏扩展。
- 导航菜单扩展。
- 内容创建向导。
- 第三方应用集成。

## 8. 社区与支持
- ** IRC 频道**：`#django-cms`（freenode）。
- **邮件列表**：
- 用户讨论：`[e-mail]`。
- 开发者讨论：`[e-mail]`。
- **KiwiIRC**：适用于无 IRC 客户端的用户。

## 9. 为什么选择 Django CMS？
- **核心优势**：
- 通过严格测试的成熟平台。
- 易于集成到现有项目。
- 健康的开发社区。
- 强调代码质量和自动化测试。

## 10. 创建新项目
- **Divio Cloud**：通过控制面板快速创建 Django CMS 项目。
- **Django CMS 安装程序**：使用 `djangocms` 命令安装最新版本。

## 11. 贡献者
- 本版本贡献者名单未详细列出，但文档提到社区成员积极参与开发和测试。

---

总结：Django CMS 3.5.0 版本聚焦于用户体验优化和架构改进，提供了详细的文档和活跃的社区支持，适合开发者快速上手和深入定制。