Django CMS Admin Style 使用教程

1. 项目介绍

Django CMS Admin Style 是一个专门为 Django CMS 定制的 Django 主题。它为 Django CMS 的管理界面添加了美观的 CSS 样式，并支持可选的 django-admin-shortcuts 包。此项目是一个第三方项目，不受 django CMS 协会的监督。它通过开源社区的支持和贡献来维护和发展。

2. 项目快速启动

在开始之前，确保你的环境中已经安装了 Django 和 pip。

安装

通过以下命令手动安装：

pip install djangocms-admin-style

配置

将 djangocms_admin_style 添加到你的 INSTALLED_APPS 设置中，位置在 'django.contrib.admin' 之前：

INSTALLED_APPS = [
    # ...
    'djangocms_admin_style',
    'django.contrib.admin',
    # ...
]

运行以下命令进行数据库迁移：

python manage.py migrate djangocms_admin_style

使用

Django CMS Admin Style 会覆盖 Django admin 的 base_site.html 模板。如果你需要部分自定义这个页面，可以查看 templates/admin/base_site.html 的源代码，并覆盖包含在不同块中的模板。例如，你可以在 templates/admin/inc/extrastyle.html 中添加自己的 CSS。

3. 应用案例和最佳实践

自定义样式

如果你的项目或应用需要特定的样式，可以在你的应用中通过 .djangocms-admin-style 选择器添加选择性样式：

.djangocms-admin-style #my-widget {
    color: var(--dca-primary, black);
}

建议在你的应用的管理 CSS 中遵循以下规则：

• 尽可能避免使用 color、background 等样式，除非有意义且必要。
• 如果需要使用，尽量使用尽可能少的 django CMS 颜色（最好从上面的颜色列表中选择）。

Dark Mode 支持

Django 从 3.1 版本开始支持暗模式管理界面。Django CMS Admin Style 引入了 CSS 变量，这些变量的颜色代码会随着选择的主题模式改变。

4. 典型生态项目

Django CMS Admin Style 作为 Django CMS 生态系统中的一部分，通常与其他 Django CMS 相关的项目一起使用，例如：

• django-cms：Django CMS 核心项目，一个强大的 CMS 框架。
• django-admin-shortcuts：为 Django 管理界面提供快捷方式。
• djangocms-text-ckeditor：集成 CKEditor 作为 Django CMS 的富文本编辑器。

以上是 Django CMS Admin Style 的基本使用教程。通过遵循这些步骤，你可以轻松地将这个主题集成到你的 Django CMS 项目中，并开始享受定制化的管理界面。