Django CMS 3.11.10 Documentation

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

摘要

文档详细介绍了Django CMS的项目文档、代码测试、贡献指南、行为准则以及如何为项目做出贡献。内容涵盖了技术委员会的作用、文档项目的重要性、测试要求、贡献者的行为准则、如何编写贡献文件以及Django CMS的教程和插件。文档还提供了不同版本的发布说明，包括新功能、改进和已知问题的修复。

AI总结

### Django CMS 3.11.10 文档总结

#### 1. **文档的重要性**
- 项目文档是项目成功的关键，包括面向用户的说明文档和贡献者的代码文档。
- 建议编写清晰简洁的内联代码文档，这是高质量代码的标志。
- 引用 Jazzband 的建议：“以未来几年的自己为目标写作”。

#### 2. **贡献指南**
- 贡献者需遵守 Django CMS 的行为准则。
- 项目需添加 `CONTRIBUTING.md` 或 `CONTRIBUTING.rst` 文件，明确贡献流程和规范。
- 感谢所有贡献者，并强调社区合作的重要性。

#### 3. **测试要求**
- 贡献代码需包含测试，确保代码库的质量。
- 提供了测试运行和编写的相关文档。

#### 4. **插件与功能**
- **常用插件**：包括音频、博客、表单构建器、前端组件、链接、地图、 moderation 等功能。
- **版本支持**：部分插件支持 Django 3.11、4.1、5.0 等版本。

#### 5. **安装与教程**
- 提供分步教程，涵盖从安装到配置的全过程。
- 适合新手快速上手，了解如何定制和使用 Django CMS。

#### 6. **版本发布说明**
- **3.3 版本**：
- 移除对 Django 1.6、1.7 和 Python 2.6 的支持。
- 默认 `CMSPlugin.position` 值改为 `0`。
- 优化语言菜单、工具栏动画、缓存机制等。
- 引入 `get_cache_expiration` 和 `get_vary_cache_on` 方法。

- **3.5.0 版本**：
- 结构板与页面渲染分离，提升编辑效率。
- 页面模型与导航树解耦，优化性能。
- 改进语言选择器和发布控制，增强用户体验。

- **3.0.7 版本**：
- 更新文档和教程，支持 South 1.0。
- 修复前端 UI、页面刷新、表单字段等问题。

- **3.2.5 版本**：
- 修复缓存设置、用户权限、页面复制等 bug。
- 引入新设置 `CMS_UNESCAPED_RENDER_MODEL_TAGS`（默认为 `True`，但建议审查 `render_model` 模板标签的安全性）。

#### 7. **项目治理与社区**
- 更新了社区治理文档，列出退休的核心开发者和分支策略。
- 提供了社区支持渠道，如 Discord 服务器。

#### 8. **总结**
- Django CMS 3.11.10 提供了丰富的插件、详细的文档和活跃的社区支持。
- 开发者需遵循行为准则和贡献指南，积极参与项目改进。