Django CMS 2.2.x Documentation

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

摘要

文档详细介绍了Django CMS 2.2.x的安装、配置和使用指南。推荐在Ubuntu系统上使用Virtualenv环境，安装所需依赖如Django 1.3、South、PIL和数据库驱动。升级时需注意django-mptt的版本冲突问题，并建议在配置时使用PostgreSQL或MySQL数据库。文档还涵盖了扩展功能的实现，如自定义插件和命令行工具的使用，以管理数据库迁移和插件安装。

AI总结

以下是对《Django CMS 2.2.x Documentation》的总结，涵盖了文档的核心内容和关键信息：

---

### **1. 安装与配置**
#### **1.1 系统要求**
- Python 2.5 或更高版本（2.x系列）。
- Django 1.2.5 或 1.3.x 版本。
- South 0.7.2 或更高版本。
- PIL 1.1.6 或更高版本。
- 其他依赖项包括 `django-classy-tags`、`django-mptt`、`django-sekizai`、`html5lib` 等。

#### **1.2 数据库**
- 推荐使用 PostgreSQL 或 MySQL，需为 django CMS 创建独立数据库和凭据。

#### **1.3 升级注意事项**
- django CMS 2.2requires `django-mptt` 0.4.2 或更高版本，旧版本的 `mptt` 包需手动删除。

#### **1.4 初步使用教程**
- **环境准备**：推荐在虚拟环境（virtualenv）中安装 Django、South 和 django CMS。
- **项目设置**：
- 创建 Django 项目：`django-admin.py startproject myproject`。
- 在 `settings.py` 中添加必要的 App，包括 `cms`、`mptt`、`menus`、`south`、`sekizai` 等。
- 配置静态文件和模板，确保 `{% cms_toolbar %}` 标签在 `` 标签内。
- **数据库初始化**：
- 使用 South 迁移工具：`python manage.py syncdb` 和 `python manage.py migrate`。

---

### **2. 扩展功能**
#### **2.1 应用集成**
- 5 种集成方式：
1. **菜单扩展**：通过 `menu.py` 创建自定义菜单。
2. **附加菜单**：将菜单附加到页面。
3. **应用钩子**：将整个应用附加到页面。
4. **导航修饰器**：修改菜单树。
5. **自定义插件**：在 CMS 页面中显示模型或内容。

#### **2.2 插件开发**
- 自定义插件可通过创建 `menus.py` 和 `menu_pool` 注册菜单项。

---

### **3. 命令行工具**
- **信息查询**：`cms list plugins` 和 `cms list apphooks` 查看插件和应用钩子。
- **插件管理**：`cms uninstall` 用于卸载插件或应用钩子，注意数据不可恢复。
- **审核命令**：`cms moderator` 用于修改数据库，需备份数据。

---

### **4. 贡献与文档**
- **编写文档**：使用 Sphinx/restructuredText 格式，文件扩展名为 `.rst`，内容需英文撰写，注重可读性。
- **翻译**：通过 Transifex 平台贡献翻译，无需 Git 或 Mercurial。
- **风格规范**：采用 Python 文档风格，标题等级分明，段落清晰。

---

### **5. 高级主题**
- **模板与静态文件**：使用 `sekizai` 管理 CSS 和 JS，需定义 `css` 和 `js` 名字空间。
- **数据库迁移**：South 是核心工具，支持schema和数据迁移。

---

以上是《Django CMS 2.2.x Documentation》的核心内容和关键信息的总结，涵盖了安装、配置、扩展、命令行工具和贡献指南等主要部分，力求准确简洁，突出重点。