China Regions 项目使用教程

1. 项目的目录结构及介绍

china_regions/
├── README.md
├── china_regions/
│   ├── __init__.py
│   ├── models.py
│   ├── utils.py
│   └── views.py
├── config/
│   ├── __init__.py
│   ├── settings.py
│   └── urls.py
├── manage.py
└── requirements.txt

• README.md: 项目介绍文件，包含项目的概述、安装步骤和使用说明。
• china_regions/: 项目的主要代码目录，包含模型、工具函数和视图等。
  • init.py: 初始化文件，用于标识该目录是一个Python包。
  • models.py: 定义数据库模型的文件。
  • utils.py: 包含项目中使用的工具函数。
  • views.py: 定义视图函数的文件，处理HTTP请求和响应。
• config/: 配置文件目录，包含项目的设置和路由配置。
  • init.py: 初始化文件，用于标识该目录是一个Python包。
  • settings.py: 项目的配置文件，包含数据库连接、调试模式等设置。
  • urls.py: 定义项目路由的文件，将URL映射到相应的视图函数。
• manage.py: 项目的启动文件，用于管理项目的运行和数据库操作。
• requirements.txt: 项目依赖文件，列出了项目运行所需的Python包。

2. 项目的启动文件介绍

manage.py 是项目的启动文件，用于管理项目的运行和数据库操作。通过该文件，可以启动开发服务器、执行数据库迁移、创建管理员用户等。

python manage.py runserver  # 启动开发服务器
python manage.py makemigrations  # 生成数据库迁移文件
python manage.py migrate  # 执行数据库迁移
python manage.py createsuperuser  # 创建管理员用户

3. 项目的配置文件介绍

config/settings.py 是项目的配置文件，包含项目的各种设置，如数据库连接、调试模式、静态文件路径等。以下是一些关键配置项的介绍：

# 数据库配置
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

# 调试模式
DEBUG = True

# 静态文件路径
STATIC_URL = '/static/'

# 语言和时区
LANGUAGE_CODE = 'zh-hans'
TIME_ZONE = 'Asia/Shanghai'

• DATABASES: 配置数据库连接信息，默认使用SQLite数据库。
• DEBUG: 调试模式开关，设置为 True 时，项目在开发环境中运行，显示详细的错误信息。
• STATIC_URL: 静态文件的URL路径，用于访问项目中的静态资源。
• LANGUAGE_CODE: 项目使用的语言，设置为 'zh-hans' 表示简体中文。
• TIME_ZONE: 项目使用的时区，设置为 'Asia/Shanghai' 表示中国标准时间。