Django CMS 2.4.x Documentation

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

摘要

文档详细介绍了Django CMS 2.4版本的新功能及升级说明，包括对Django 1.5的支持、Django 1.3和Python 2.5的弃用，迁移脚本的重构，以及配置选项如模板继承和多语言支持的设置。同时，文档还涵盖了菜单系统的工作原理、站点地图的配置、如何为项目做贡献以及测试方法。

AI总结

以下是《Django CMS 2.4.x Documentation》的中文总结：

---

### 《Django CMS 2.4.x Documentation》总结

#### 1. 版本更新内容
- **新功能**：Django CMS 2.4 引入了对 **Django 1.5** 的支持，同时 **取消了对 Django 1.3 和 Python 2.5 的支持**。当前最低要求为 **Django 1.4** 和 **Python 2.6**。
- **迁移系统改写**：迁移文件被重写，所有 `cms` 应用的迁移文件合并至 `0001_initial.py`。迁移 `0002` 到 `0036` 为虚拟迁移，`0037` 及后续为新增迁移。

#### 2. 安装与升级
- **升级注意事项**：升级前需阅读 **“Migrations overhaul”** 和 **“Added a check command”** 部分。
- **安装基本步骤**：包括环境配置、依赖安装和数据库设置。

#### 3. 社区与贡献
- **开发者社区**：参与开发者可加入 `django-cms-developers` 邮件列表，并访问 `#django-cms` IRC 频道。
- **安全漏洞报告**：发现安全问题请通过 `[e-mail]` 私下报告，避免在公共论坛公开。
- **贡献流程**：代码贡献需遵循 GitHub 流程，包括 Fork 仓库、创建分支、提交代码并Pull Request。

#### 4. 配置说明
- **必要设置**：
- **`CMS_TEMPLATES`**：定义页面可选模板，需包含 `js` 和 `css` 种族空间。
- **`CMS_TEMPLATE_INHERITANCE`**：控制模板继承功能，默认启用。
- **多语言支持**：
- 支持多语言内容展示，根据用户语言偏好（URL、会话、Cookie、浏览器设置）确定语言。
- 可配置语言回退策略，隐藏未翻译内容。

#### 5. 菜单系统
- **核心概念**：菜单系统由 **生成器（Generators）** 和 **修改器（Modifiers）** 组成，动态构建菜单节点。
- **功能**：通过 `cms.menu.CMSMenu` 生成器添加页面节点，支持自定义修改器扩展功能。

#### 6. 站点地图
- **功能**：生成 `sitemap.xml` 文件，方便搜索引擎索引。
- **配置步骤**：
1. 添加 `django.contrib.sitemaps` 到 `INSTALLED_APPS`。
2. 在 `urls.py` 导入 `CMSSitemap` 并配置路由规则。

---

以上总结涵盖了文档的核心内容，突出了关键功能、升级注意事项和配置要点，语言简洁明了，逻辑清晰。