Django CMS 2.1.x Documentation

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

摘要

本文档介绍了Django CMS 2.1.5版本的安装和配置步骤，包括系统要求、数据库设置、前端编辑模式的使用以及模板配置等核心内容。此外，文档还涉及了Haystack的集成方法，并提供了初始数据库设置和升级指南。

AI总结

以下是对《Django CMS 2.1.5 文档》的总结，重点突出核心内容和关键信息：

---

### 《Django CMS 2.1.5 文档》总结

#### 1. **安装**
- **要求**：
- Python 2.5 或更高版本。
- Django 1.2.3 或更高版本。
- South 0.7.2 或更高版本。
- PIL 1.1.6 或更高版本。
- django-classy-tags 0.2.2 或更高版本。
- 支持的数据库（如 PostgreSQL 或 MySQL）。
- **安装步骤**：
- 使用 `pip` 安装 `django-cms`，同时会自动安装 Django 和 `django-classy-tags`。
- 在 Ubuntu 上：
- 安装依赖项：`sudo aptitude install python2.6 python-setuptools python-imaging`。
- 使用 `pip` 安装 `django-cms`、`south` 和 `django-appmedia`。
- 根据选择的数据库安装对应的驱动（如 `psycopg2` 或 `mysql`）。
- Mac OSX 和 Windows 的安装步骤待完成。

#### 2. **入门教程**
- **环境配置与设置**：
- 创建 Django 项目，并在 `settings.py` 中添加必要的配置。
- 初始化数据库：使用 `syncdb` 和 `migrate` 命令。
- **创建模板**：
- Django CMS 使用标准的 Django 模板，模板需要在 `CMS_TEMPLATES` 设置中声明。
- 模板中定义可编辑区域（placeholders）。

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

#### 4. **配置**
- **媒体设置**：
- `CMS_MEDIA_PATH`：默认为 `cms/`。
- `CMS_MEDIA_ROOT` 和 `CMS_MEDIA_URL`：用于存储和访问 CMS 媒体文件。
- `CMS_PAGE_MEDIA_PATH`：默认为 `cms_page_media/`，用于存储页面上传的媒体文件。
- **URL 设置**：
- `CMS_URL_OVERWRITE`：默认为 `True`，允许覆盖页面的 URL。
- **插件处理**：
- `CMS_PLUGIN_CONTEXT_PROCESSORS` 和 `CMS_PLUGIN_PROCESSORS`：用于修改插件的上下文和输出。
- **应用钩子**：
- `CMS_APPHOOKS`：用于指定 CMS 应用的导入路径。
- **前端编辑**：
- `PLACEHOLDER_FRONTEND_EDITING`：默认为 `True`，启用前端编辑模式。
- **国际化与本地化**：
- `CMS_LANGUAGES`：定义 CMS 中的可用语言。
- `CMS_HIDE_UNTRANSLATED`：默认为 `True`，隐藏未翻译的菜单项。

#### 5. **搜索**
- 推荐使用 Haystack 集成搜索功能，尽管没有官方支持。需创建 `search_indexes.py` 文件。

#### 6. **附加功能**
- **前端编辑模式**：
- 在前端编辑模式下，placeholders 会显示菜单，允许添加插件。
- **字段集**：
- 每个 `PlaceholderField` 必须在单独的 fieldset 中。
- 必须包含 `plugin-holder` 和 `plugin-holder-nopage` 类。

#### 7. **投稿指南**
- 鼓励用户为文档贡献内容。

---

### 核心信息
- Django CMS 2.1.5 是一个功能强大的内容管理系统，依赖 Django 框架。
- 安装过程包括依赖项安装、数据库配置和初始设置。
- 配置项涵盖媒体管理、URL 过滤、插件处理、国际化、搜索集成等。
- 文档还提供了关于模板、前端编辑模式和数据库管理的详细指导。

通过以上内容，用户可以快速了解 Django CMS 2.1.5 的核心功能和配置方法。