Django-cities-light 开源项目教程

1. 项目目录结构及介绍

django-cities-light 是一个简单的 Django 应用，提供了国家、地区和城市三个模型，以及从 GeoNames 数据库导入数据的命令。以下是项目的目录结构及其简要介绍：

• cities_light/：包含应用的核心代码，如模型、管理命令等。
• cities_light/forms.py：表单定义文件。
• cities_light/models.py：模型定义文件。
• cities_light/admin.py：Django 管理界面配置。
• cities_light/management/commands/cities_light.py：自定义管理命令，用于导入 GeoNames 数据。
• cities_light/management/commands/cities_light_fixtures.py：用于导出和导入数据/fixtures。
• cities_light/migrations/：数据库迁移文件。
• cities_light/tests/：单元测试代码。
• docs/：项目文档。
• test_project/：测试项目配置。
• tox.ini：tox 配置文件，用于自动化测试。
• setup.py：项目打包配置。
• README.rst：项目说明文件。

2. 项目的启动文件介绍

manage.py 是 Django 项目的启动文件，用于运行各种管理任务，例如数据库迁移、运行测试等。以下是启动文件的基本用法：

• python manage.py migrate：运行数据库迁移，创建数据库表。
• python manage.py runserver：启动开发服务器。
• python manage.py test：运行单元测试。

3. 项目的配置文件介绍

项目的配置主要在 test_project/settings.py 文件中，以下是配置文件的一些关键部分：

• INSTALLED_APPS：列出项目中安装的应用，包括 cities_light。
• DATABASES：数据库配置，可以根据需要更改为 PostgreSQL、MySQL 或 SQLite。
• CITIES_LIGHT_TRANSLATION_LANGUAGES：设置支持的语言，用于翻译城市名称等。
• CITIES_LIGHT_INCLUDE_COUNTRIES：设置要包括的国家。
• CITIES_LIGHT_INCLUDE_CITY_TYPES：设置要包括的城市类型。

这些配置项可以根据具体的项目需求进行调整。在完成配置后，可以通过运行 python manage.py cities_light 命令来导入 GeoNames 数据库中的城市信息。