**Django Subadmin 安装与使用指南**

Django Subadmin 安装与使用指南

django-subadminA special kind of ModelAdmin that allows it to be nested within another ModelAdmin 项目地址:https://gitcode.com/gh_mirrors/dj/django-subadmin

1. 项目目录结构及介绍

django-subadmin 是一个增强版的Django ModelAdmin，允许其被嵌套在另一个 ModelAdmin 内部，提供多层次的管理界面。以下是典型的项目结构概览，基于提供的GitHub仓库示例：

django-subadmin/
│  
├── LICENSE                # 许可证文件
├── README.md              # 项目说明文档
├── pyproject.toml         # 环境和依赖管理文件
├── subadmin               # 主要源代码目录
│   ├── __init__.py
│   └── ...                 # 包含子模块和相关代码
├── tests                  # 测试目录
│   └── ...
├── github/workflows       # CI/CD 工作流配置
├── requirements.txt       # 可选，如果有，列出项目依赖
└── examples               # 示例应用或用法演示（如django-subadmin-example）
    ├── ...

• subadmin: 包含了django-subadmin的核心代码。
• tests: 存放项目的测试案例。
• requirements.txt（未直接提及但通常存在）: 列出项目运行所需的Python包及其版本。
• examples: 提供如何使用的实例应用，对于理解项目如何融入Django项目至关重要。

2. 项目的启动文件介绍

虽然具体的启动文件并不直接包含在这个仓库中，但在实际部署django-subadmin时，关键的启动配置位于你的Django项目的settings.py文件中。你需要进行以下步骤来启用它：

1. 安装：首先通过pip安装django-subadmin：

   pip install django-subadmin
   

2. 添加到INSTALLED_APPS：然后，在你的Django项目设置中的INSTALLED_APPS列表里添加'subadmin'：

   INSTALLED_APPS = (
       ...
       'subadmin',  # 添加此行
       ...
   )
   

启动Django服务器时，你会依赖于常规的命令：

python manage.py runserver

3. 项目的配置文件介绍

Django Settings 配置

主要的配置发生在settings.py文件内，除了将subadmin加入到INSTALLED_APPS之外，无需额外特定于django-subadmin的配置。然而，为了正确使用django-subadmin，确保你的数据库配置也是完整的，并且Django的admin部分已经正确设置。

在Django Admin中使用SubAdmin

在你的Django应用的admin.py文件中，你需要创建一个SubAdmin类并将其关联到相应的ModelAdmin。例如，如果你想要在一个邮件列表管理页面内嵌入订阅者和消息的管理，你将定义SubAdmin类然后作为属性添加到主ModelAdmin中。这允许层次化管理视图的定制，但具体实现细节需参考项目内的例子或者django-subadmin-example仓库。

通过以上步骤，你可以将django-subadmin集成进你的Django项目，享受多级管理界面带来的便利。

django-subadminA special kind of ModelAdmin that allows it to be nested within another ModelAdmin 项目地址:https://gitcode.com/gh_mirrors/dj/django-subadmin