Ella CMS 技术文档

1. 安装指南

环境准备

确保您的系统中已安装 Python、setuptools 和 python-imaging（PIL）。我们推荐使用 pip 和 virtualenv 管理项目。

创建虚拟环境

首先，安装 virtualenv（以 root 用户）：

easy_install virtualenv

然后创建并激活虚拟环境：

virtualenv ella_sandbox
source ella_sandbox/bin/activate

安装 Ella CMS

在虚拟环境中，使用 pip 安装 Ella：

pip install ella

创建 Django 项目

创建一个新的 Django 项目，并添加必要的应用设置：

mkdir ellablog
cd ellablog
django-admin.py startproject ellablog

编辑 ellablog/settings.py 文件，添加以下内容：

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.sites',
    'django.contrib.redirects',
    'ella.core',
    'ella.photos',
    'ella.articles',
)

设置模板目录和媒体文件路径：

from os.path import join, dirname

PROJECT_ROOT = dirname(__file__)

TEMPLATE_DIRS = (
    join(PROJECT_ROOT, 'templates'),
)

MEDIA_ROOT = join(PROJECT_ROOT, 'media')
MEDIA_URL = '/media/'

2. 项目的使用说明

Ella CMS 是基于 Django 框架的开源内容管理系统，设计上注重灵活性。它由几个模块组成：

• Ella core 是核心模块，负责连接其他模块。它定义了其他模块构建的架构，但本身并不具备实际功能。
• Ella core plugins 是与 Ella 一起提供的插件包，包括 articles 和 positions，我们将其视为每个 Ella 站点的基本工具箱。
• 其他 Ella 插件 是独立的应用程序（因此不随核心一起提供），它们使用 Ella 的架构 提供特定功能，例如投票、图库、测验等。

Ella CMS 的特点包括：

• 基于类别的简单内容组织
• 高效的发布内容实现
• 内置照片格式化后端
• 支持 Django-admin
• 插件系统
• 灵活、可扩展、缓存友好
• 经过充分测试
• 在生产环境中得到验证

3. 项目 API 使用文档

Ella CMS 的 API 文档目前托管在 readthedocs.org。请参考官方文档了解如何使用 API。

4. 项目安装方式

如上所述，Ella CMS 的安装方式主要通过 pip 在虚拟环境中进行。请确保遵循上述步骤，正确设置 Django 项目和应用。

---

本文档旨在帮助用户安装、使用和了解 Ella CMS。如需进一步的帮助，请访问 Ella CMS 的社区资源，包括 GitHub 问题跟踪、邮件列表和 IRC 频道。