django-admin-sortable 的安装和配置教程

2025-05-15 12:53:47作者：宣聪麟

1. 项目的基础介绍和主要的编程语言

django-admin-sortable 是一个开源项目，它为 Django 的管理员界面提供了一个排序功能，允许用户通过拖放的方式对列表中的项目进行排序。该项目是用 Python 编写的，主要针对 Django 框架。

2. 项目使用的关键技术和框架

该项目使用了 Django 框架，并且依赖于 Django 的 admin 界面。在实现排序功能时，它使用了 JavaScript 和 AJAX技术与后端进行交互，使得排序操作无需刷新页面即可完成。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装 django-admin-sortable 之前，请确保你已经满足了以下条件：

安装了 Python 环境
安装了 Django 框架
创建了一个 Django 项目，并且有一个或多个应用

安装步骤

首先，确保你的 Django 项目已经创建好，并且可以运行。
克隆或者下载 django-admin-sortable 项目到本地。可以使用以下命令克隆项目：
```
git clone https://github.com/jazzband/django-admin-sortable.git
```
将克隆下来的 django-admin-sortable 目录移动到你的 Django 项目的某个位置，通常是放在项目下的 _APPS 或者 third_party 目录中。
在你的 Django 项目的 settings.py 文件中，将 django_admin_sortable 添加到 INSTALLED_APPS 列表中。例如：
```
INSTALLED_APPS = [
    # ...
    'django_admin_sortable',
    # ...
]
```

如果你使用了 admin.py 文件来自定义 Django 管理界面，你需要在相应的模型类上添加 sortable 相关的配置。例如：

from django_admin_sortable.admin import SortableAdmin
from .models import MyModel

class MyModelAdmin(SortableAdmin):
    sortable = 'field_name'

admin.site.register(MyModel, MyModelAdmin)

在这里，field_name 是你希望排序的字段。

在完成以上步骤后，运行以下命令来收集静态文件：
```
python manage.py collectstatic
```
这一步将确保所有静态文件如 CSS 和 JavaScript 被正确地复制到静态文件目录。
最后，运行以下命令来启动 Django 开发服务器：
```
python manage.py runserver
```
打开浏览器，访问你的 Django 管理界面，你应该可以看到排序功能已经可以使用了。