冷CMS 0.2.10

您有权访问ColdCMS实例，并希望创建一个网站

您可以在这里找到用户文档

• 英文文档

• 法语文档

您想安装ColdCMS

您有两个选择：Docker安装或手动安装。

cd docker && docker-compose up

docker exec -it docker_backend_1 python3 manage.py createsuperuser

[uwsgi]
socket = 0.0.0.0:8000
chdir = /srv/app/
module = coldcms.wsgi:application
master = true
processes = 4
threads = 2
uid = coldcms
gid = coldcms
buffer-size = 65535
env = BUILD_DIR=/srv/build
env = STATIC_ROOT=/srv/build/static/
env = SECRET_KEY=something_big_and_random

您是开发者，并希望快速查看

注意：此配置仅在 Linux 环境中进行过测试。

使用 pypi 安装 ColdCMS

pip install coldcms

运行快速启动命令

python -m coldcms

在运行此命令之前，您可以设置以下环境变量

• RUN_DJANGO_MIGRATION=0：不运行迁移

• SETUP_INITIAL_DATA=0：不设置初始数据，如果您想保留冷cms数据库中已有的数据

• COLLECT_STATIC=0：不收集静态文件。如果您第一次启动 ColdCMS，不要将该变量设置为 0。

• CREATE_SUPERUSER=0：不创建新的超级用户（您可以在同一时间内拥有多个超级用户，但不能使用相同的用户名或电子邮件）

• BUILD_ASSETS=0：不构建构建资产。如果您第一次启动 ColdCMS，不要将该变量设置为 0。

• BUILD_STATIC=0：不构建静态文件。如果您已将 SETUP_INITIAL_DATA 设置为 0，也不要将该变量设置为 0。

示例：设置 CREATE_SUPERUSER=0 python -m coldcms 将运行迁移并设置一些新的初始数据，但不会创建新的超级用户。

您是开发者，并希望为 ColdCMS 做出贡献

克隆 GitLab 仓库，并阅读下面的 Dev 部分，以安装 ColdCMS 开发环境。

遵循[贡献指南](https://gitlab.com/hashbangfr/coldcms/-/blob/master/CONTRIBUTING.rst)

1. 安装依赖项

安装 libjpeg 和 zlib，用于通过 Pillow 库处理图像。如果您使用的是基于 Debian 的发行版，请使用以下命令

sudo apt-get install zlib1g-dev
sudo apt-get install libjpeg-dev

此外，请安装 PurgeCSS 和 clean-css，以减小 CSS 文件的大小

npm install -g purgecss@2.1.0 clean-css-cli@4.3.0

并且为了继续进行 JavaScript，请安装静态依赖

(cd coldcms/static/ && npm i --save-dev)

我们使用 sass 将 sass 文件转换为 CSS。确保从 sassc 包中的 sass 二进制文件在您的 $PATH 中存在。在基于 Debian 的发行版中，请运行以下命令

sudo apt-get install sassc
sudo ln -s /usr/bin/sassc /usr/bin/sass # might be necessary if /usr/bin/sass doesn't exist after the previous command

最后，运行

pip install -r requirements_dev.txt

2. 创建数据库

默认情况下，./manage.py migrate 将创建一个名为 coldcms 的 sqlite3 数据库。

• 如果您想使用不同的数据库引擎，可以在环境变量 DB_URL 中指定它。确保您有您要使用的引擎的正确数据库驱动程序。

• 如果您想为您的sqlite数据库使用不同的名称，您可以在环境变量DB_NAME中指定它（对于某些引擎来说是无用的，因为它已在URL中直接指定 - 见下表）。

如Django文档中建议，如果您对数据库不熟悉，或者只是想尝试ColdCMS，请使用默认的sqlite3数据库，它包含在Python中，因此您不需要安装任何其他支持数据库的软件。然而，当您开始您的第一个实际项目时，您可能希望使用像PostgreSQL这样的更可扩展的数据库，以避免将来数据库切换的麻烦。

将PATH、USER、PASSWORD、HOST、PORT和NAME替换为正确的值。

来源

例如，如果您想使用PostgreSQL

systemctl status postgresql # make sure postgresql is running
createdb coldcms # create the coldcms postgres database
sudo -u postgres psql
CREATE USER username PASSWORD 'password';
ALTER ROLE username WITH SUPERUSER;
\q
export DB_URL="postgres://username:password@localhost:5432/coldcms"

3. 启动开发服务器

./manage.py migrate
./manage.py collectstatic
./manage.py compilemessages
./manage.py createsuperuser
./manage.py setup_initial_data # optional - loads data of a basic home page
./manage.py runserver

如果collectstatic不起作用，请尝试

cd coldcms/static && npm i
cd ../.. && ./manage.py assets build