Django-Admin-Charts 项目启动与配置教程

1. 项目目录结构及介绍

Django-Admin-Charts 是一个用于在 Django 管理后台添加图表的开源项目。以下是项目的目录结构及各部分功能的简要介绍：

django-admin-charts/
├── admin_charts/              # 包含项目的核心代码
│   ├── __init__.py
│   ├── apps.py               # 应用配置文件
│   ├── models.py             # 定义模型
│   ├── templates/            # 存放模板文件
│   │   └── admin_charts/
│   ├── static/               # 存放静态文件，如CSS、JavaScript
│   │   └── admin_charts/
│   ├── urls.py               # 应用URL配置
│   └── views.py              # 视图函数
├── demo_project/              # 示例项目，用于展示如何集成admin-charts
│   ├── manage.py             # 管理脚本，用于数据库迁移等操作
│   ├── settings.py           # 项目配置文件
│   ├── urls.py               # 项目URL配置
│   └── wsgi.py               # WSGI兼容的Web服务器入口
├── requirements.txt          # 依赖文件列表
└── setup.py                  # 打包配置文件

• admin_charts/: 项目的主要应用目录。
• demo_project/: 一个示例 Django 项目，用于演示如何使用 admin_charts 应用。

2. 项目的启动文件介绍

在 demo_project/ 目录中，manage.py 是主要的启动和管理脚本。以下是如何使用 manage.py 来启动项目：

• python manage.py runserver: 在开发服务器上启动项目。
• python manage.py migrate: 进行数据库迁移，创建表结构。
• python manage.py createsuperuser: 创建一个超级用户。

3. 项目的配置文件介绍

demo_project/settings.py 是项目的主要配置文件。以下是其中几个关键的配置项：

• INSTALLED_APPS: 包含所有已安装应用的列表，包括 admin_charts。
• DATABASES: 数据库配置，默认使用 SQLite。
• STATIC_URL 和 STATICFILES_DIRS: 静态文件的URL和搜索路径。
• TEMPLATES: 模板配置，包括 admin_charts 应用的模板。

在配置文件中，还需要确保 django.contrib.admin 应用在 INSTALLED_APPS 列表中位于 admin_charts 应用之前，以确保图表能够正确显示在 Django 管理后台。

确保配置正确后，可以通过 manage.py 脚本启动和运行项目。