Django CMS 2.1.x Documentation

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

摘要

The document provides comprehensive guidance on Django CMS version 2.1.5, covering installation requirements, configuration settings, and the creation of custom plugins. It includes detailed tutorials on setting up a Django project, integrating CMS, and using South for database migrations. The guide also explains how to extend the CMS through custom plugins, context processors, and navigation modifiers. Additionally, it offers instructions for contributing to the CMS, including code submission and community involvement.

AI总结

# Django CMS 2.1.x 文档总结

## 1. 安装指南
- **依赖要求**：
- Python 2.5 或更高版本。
- Django 1.2.3 或更高版本。
- South 0.7.2 或更高版本。
- PIL 1.1.6 或更高版本。
- Django-classy-tags 0.2.2 或更高版本。
- **安装方法**：
- 使用 pip 安装：`pip install Django-cms south Django-appmedia`。
- 支持的数据库：PostgreSQL、MySQL 等。
- **系统支持**：
- **Ubuntu**：安装 Python、Setuptools、PIL 和数据库驱动。
- **Mac OS X**：通过 Homebrew 或其他工具安装依赖。

## 2. 入门教程
- **项目创建**：
- 使用 `django-admin.py startproject` 创建 Django 项目。
- 配置数据库和运行服务器：`python manage.py runserver`。
- **Django CMS 配置**：
- 在项目 `settings.py` 中添加 CMS 相关设置。
- 创建并配置模板文件。
- **页面创建**：
- 使用 CMS 创建模板和页面。
- 支持多语言（I18N 和 L10N）。

## 3. 使用 South 进行数据库迁移
- **安装**：
- 使用 `pip install south` 安装 South。
- **基本用法**：
- 配置 South 以支持 Django CMS 的数据库迁移。
- 参考 South 的官方文档了解更多细节。

## 4. 配置
- **基本设置**：
- `CMS_TEMPLATES`：定义可用的模板。
- `CMS_TEMPLATE_INHERITANCE`：启用或禁用模板继承。
- `CMS_PLACEHOLDER_CONF`：配置占位符插件。
- **高级设置**：
- 支持媒体文件配置、URL 路由等。

## 5. 导航功能
- **菜单显示**：
- `show menu`：显示当前菜单。
- `show menu below id`：显示特定 ID 的子菜单。
- `show sub menu`：显示子菜单。
- `show breadcrumb`：显示面包屑导航。
- **软根**：
- 支持创建软根以管理导航结构。
- **菜单扩展**：
- 可通过插件和自定义菜单扩展导航功能。

## 6. 插件参考
- **内置插件**：
- File、Flash、GoogleMap、Link 等。
- **自定义插件**：
- 使用 `CMSPlugin` 创建自定义插件。
- 示例：创建与 Gallery 模型关联的插件。
- **插件上下文处理器**：
- 通过插件上下文处理器扩展插件功能。
- **插件处理器**：
- 定义插件处理器以自定义插件行为。

## 7. 应用集成
- **菜单和导航**：
- 集成自定义菜单和导航功能。
- **附件菜单**：
- 配置附件菜单以支持 CMS 功能。
- **App-Hooks**：
- 通过 App-Hooks 集成第三方应用。
- **导航修改器**：
- 使用导航修改器自定义导航行为。

## 8. 搜索与sitemap
- **sitemap.xml 配置**：
- 添加 `CMSSitemap` 到项目中。
- 配置 URL 路由生成sitemap.xml。
- **搜索功能**：
- 使用 Haystack 集成搜索功能。

## 9. 贡献指南
- **社区参与**：
- 加入 Django-cms-developers 邮件列表和 IRC 频道。
- 关注 Twitter 获取最新动态。
- **代码贡献**：
- 在 GitHub 上 fork 项目并提交 pull request。
- 讨论新功能以避免重复劳动。
- **文档贡献**：
- 提交文档修复或新增内容。

## 10. 指南和索引
- 提供详细的模块索引和搜索功能，便于查阅具体信息。

以上为《Django CMS 2.1.x Documentation》的核心内容总结，涵盖安装、配置、功能扩展及贡献指南等关键部分。