Django Searchable Select 使用教程
1. 项目的目录结构及介绍
django-searchable-select/
├── django_searchable_select/
│ ├── __init__.py
│ ├── forms.py
│ ├── models.py
│ ├── urls.py
│ ├── views.py
│ ├── widgets.py
│ ├── static/
│ │ └── django_searchable_select/
│ │ ├── css/
│ │ │ └── searchable_select.css
│ │ └── js/
│ │ └── searchable_select.js
│ └── templates/
│ └── django_searchable_select/
│ └── searchable_select.html
├── manage.py
├── README.md
└── setup.py
django_searchable_select/
: 项目的主目录,包含了所有的Python模块和静态文件。__init__.py
: 初始化文件,使目录成为一个Python包。forms.py
: 包含表单相关的代码。models.py
: 包含模型相关的代码。urls.py
: 包含URL配置。views.py
: 包含视图相关的代码。widgets.py
: 包含自定义的搜索选择小部件。static/
: 静态文件目录,包含CSS和JavaScript文件。templates/
: 模板文件目录,包含HTML模板。
manage.py
: Django项目的管理脚本。README.md
: 项目的说明文档。setup.py
: 项目的安装脚本。
2. 项目的启动文件介绍
manage.py
是 Django 项目的管理脚本,用于启动开发服务器、运行迁移、创建超级用户等。
python manage.py runserver
这条命令会启动 Django 的开发服务器,默认运行在 http://127.0.0.1:8000/
。
3. 项目的配置文件介绍
在 Django 项目中,主要的配置文件是 settings.py
,通常位于项目的 settings
目录下。以下是一些关键的配置项:
# settings.py
INSTALLED_APPS = [
...
'django_searchable_select',
...
]
# 添加 URL 模式
from django.conf.urls import include, url
urlpatterns = [
...
url(r'^searchableselect/', include('django_searchable_select.urls')),
...
]
INSTALLED_APPS
: 添加django_searchable_select
到已安装的应用列表中。urlpatterns
: 添加django_searchable_select
的 URL 模式。
通过这些配置,项目就可以使用 django-searchable-select
提供的功能了。