Django CMS 2.3.x Documentation

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

摘要

文档详细介绍了如何安装和配置Django CMS 2.3.x版本，包括依赖项安装、数据库配置、新功能和升级注意事项。文档还提供了使用南（South）进行数据库迁移的指导，并介绍了如何设置项目模板和静态文件路径。此外，文档提到了与Django 1.4的兼容性以及弃用的旧功能。

AI总结

### Django CMS 2.3.x 文档总结

#### 1. 安装指南
- **推荐系统**: Ubuntu（已测试10.10版本）。
- **安装命令**:

  sudo aptitude install python2.6 python-setuptools python-imaging
  sudo easy_install pip
  sudo pip install Django==1.4 Django-cms south

- **数据库驱动**: 根据选择的数据库（PostgreSQL或MySQL）安装相应的Python驱动：

  sudo aptitude install python-psycopg2 或 sudo aptitude install python-mysql

- **准备工作**: 安装完成后，可以开始按照《入门指南》进行操作。

#### 2. 数据库推荐
- 推荐使用PostgreSQL或MySQL。
- **建议**:
- 为Django CMS创建独立的数据库和凭据。
- 安装和维护数据库的具体操作不在文档范围内，但有丰富的官方文档可供参考。

#### 3. 版本更新
- **2.3.8 版本**:
- 修复了占位符主键格式问题，解决了前端编辑时的错误。
- **2.3.7 版本**:
- 引入了对Django-Sekizai 0.7的支持（从0.6.1升级）。
- 修复了缓存相关问题，提升了性能。
- **2.3.3 版本**:
- 恢复了对Python 2.5的支持。
- **2.3.2 版本**:
- Google地图插件新增宽度和高度字段，并修复了缩放级别问题。
- **2.3 版本**:
- 支持Django 1.4，不再支持Django 1.2。
- 页面树在管理界面中实现惰性加载，提升性能。
- 工具栏需要在模板中显式启用，避免在不适当的位置显示。
- 静态文件从`/media/`迁移至`/static/`，以支持Django 1.3的`staticfiles`应用。

#### 4. 升级指南
- **从2.1.x和Django 1.2.x升级**:
- 升级命令：

    pip install --upgrade Django-cms==2.2 Django==1.3.1
    pip install --upgrade Django-reversion==1.4
    pip install --upgrade Django-mptt==0.5.1

- 修改`settings.py`中的静态文件配置：

    ADMIN_MEDIA_PREFIX = '/static/admin'
    STATIC_ROOT = os.path.join(PROJECT_PATH, 'static')
    STATIC_URL = '/static/'

- 确保静态文件目录存在且可写。

#### 5. 配置与功能
- **模板设置**:
- `CMS_TEMPLATES`：定义可用的模板，默认为空。
- `CMS_TEMPLATE_INHERITANCE`：启用模板继承，默认为`True`。
- **插件注册**:
- 使用`plugin_pool.register_plugin`多次注册插件。
- **弃用功能**:
- `CMS_FLAT_URLS`和 moderation功能将在2.4版本中移除。

#### 6. 贡献指南
- **参与方式**:
- 加入Django-CMS-Developers邮件列表或 IRC 频道 `#django-cms`。
- 在GitHub上 fork 项目并提交pull request。
- **代码要求**:
- 提交的代码需包含单元测试。
- 文档更新需与代码修改同步。

#### 7. 其他
- **sekizai 命名空间**: 所有模板必须包含`js`和`css`命名空间。
- **静态文件处理**: 使用`sekizai`框架管理静态资源。
- **缓存优化**: 修复了缓存相关性能问题，支持版本化缓存。

总结：Django CMS 2.3.x 提供了丰富的功能和灵活的配置，适合构建复杂的Web项目。文档详细介绍了安装、配置、升级和开发流程，帮助用户快速上手并深入定制。