BookWorm 项目启动与配置教程

1. 项目目录结构及介绍

BookWorm 项目的目录结构如下所示：

BookWorm/
├── .gitignore           # 指定不被git追踪的文件
├── README.md            # 项目说明文件
├── requirements.txt     # 项目依赖列表
├── config/              # 配置文件目录
│   ├── settings.py       # 项目配置文件
│   └── ...
├── static/              # 静态文件目录，如CSS、JavaScript、图片等
│   └── ...
├── templates/           # 模板文件目录
│   └── ...
├── app/                 # 应用程序目录
│   ├── __init__.py      # 初始化应用程序
│   ├── models.py        # 数据模型文件
│   ├── views.py         # 视图函数文件
│   ├── ...
│   └── ...
└── manage.py            # 管理脚本，用于启动和运行应用程序

• .gitignore：包含不应该被git版本控制系统追踪的文件和目录列表。
• README.md：项目的说明文件，包含项目的简介、安装步骤、使用说明等。
• requirements.txt：列出项目运行所依赖的Python库。
• config/：包含项目的配置文件。
• static/：存储项目的静态文件，如CSS样式表、JavaScript脚本和图像文件等。
• templates/：存放项目的HTML模板文件。
• app/：项目的主要应用程序目录，包含初始化文件、数据模型、视图函数等。
• manage.py：项目的主要管理脚本，用于启动、运行和执行其他管理任务。

2. 项目的启动文件介绍

项目的启动文件为 manage.py，其主要功能如下：

• 用于启动开发服务器，以便在开发过程中实时查看更改。
• 提供命令行工具，用于执行数据库迁移、创建超级用户等管理任务。

启动开发服务器的命令通常为：

python manage.py runserver

该命令默认在 http://127.0.0.1:8000/ 地址上启动服务器。

3. 项目的配置文件介绍

项目的配置文件位于 config/settings.py，其中包含了项目的各种配置信息，如数据库连接、静态文件路径、模板路径等。

以下是一个示例配置文件的内容：

# settings.py

# 数据库配置
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

# 静态文件配置
STATIC_URL = '/static/'

# 模板配置
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

# 其他配置...

在配置文件中，可以根据实际需要修改数据库配置、静态文件路径和其他相关配置。确保在启动项目之前，所有配置都是正确的。