Django管理界面Bootstrap模板安装与使用指南

Django管理界面Bootstrap模板安装与使用指南

django-admin-bootstrap项目地址:https://gitcode.com/gh_mirrors/dja/django-admin-bootstrap

1. 项目目录结构及介绍

该项目django-admin-bootstrap是为了给Django管理界面添加Bootstrap主题。以下是其基本的目录结构：

project/
├── manage.py           # 用于管理Django项目的命令行工具
├── myapp/              # 你的应用目录（示例）
│   ├── __init__.py      # 应用初始化文件
│   ├── models.py        # 模型文件
│   ├── views.py         # 视图文件
│   └── ...              # 其他相关文件
├── templates/          # 自定义模板目录
│   └── admin/           # 包含自定义的login.html 和 base_site.html
│       ├── login.html   # 自定义登录页面模板
│       └── base_site.html   # 自定义基础站点模板
└── settings.py         # 项目设置文件
└── urls.py             # URL路由配置文件
└── wsgi.py             # WSGI入口文件

• manage.py: Django提供的一系列管理命令的入口。
• myapp/: 你的应用程序目录，包含了模型、视图等代码。
• templates/admin: 存放自定义的Bootstrap主题模板，如登录页和基础站点模板。
• settings.py: Django项目的配置文件，包含数据库连接、中间件、应用注册等重要设置。
• urls.py: 网站URL路由配置。
• wsgi.py: 作为WSGI服务器入口的文件。

2. 项目的启动文件介绍

manage.py 是一个Python脚本，它提供了许多用于开发和部署的命令，比如创建数据库迁移(makemigrations 和 migrate)，运行服务器(runserver)，创建超级用户(createsuperuser)等。

例如，要启动开发服务器，可以执行以下命令：

python manage.py runserver

这会在本地主机的8000端口上启动Django开发服务器。

3. 项目的配置文件介绍

settings.py 文件是项目的核心配置文件，包含以下关键部分：

1. 应用程序注册

在 INSTALLED_APPS 列表中，你需要将 'bootstrap_admin' 添加到 'django.contrib.admin' 之前，确保Bootstrap主题生效：

INSTALLED_APPS = [
    # 注意：'bootstrap_admin' 必须在 'django.contrib.admin' 之前
    'bootstrap_admin',
    'django.contrib.admin', 
    ...
]

2. 模板配置

为了使用自定义的Bootstrap模板，你需要配置TEMPLATES中的DIRS和APP_DIRS项：

TEMPLATES = [
    {
        ...
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        'APP_DIRS': True,
        ...
    },
]

这告诉Django查找templates/目录下的模板文件，包括admin/子目录内的自定义Bootstrap模板。

3. 静态文件配置

确保静态文件处理设置正确，以便于使用Bootstrap CSS和JavaScript：

STATIC_URL = '/static/'
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'static'),
]

STATIC_ROOT = os.path.join(BASE_DIR, 'collected_static')

这指示Django从STATICFILES_DIRS指定的路径收集静态文件到STATIC_ROOT，在生产环境中通常是Web服务器的位置。

完成这些步骤后，你应该能够看到具有Bootstrap样式的Django管理界面了。如有问题，请检查上述配置是否已正确实施。

django-admin-bootstrap项目地址:https://gitcode.com/gh_mirrors/dja/django-admin-bootstrap