Xadmin中文文档（二）

Xadmin 快速入门指南

要使用Xadmin，需要安装Django 1.4并且必须激活管理站点。

注：由于Xadmin已经停止维护，使用Django2.0 以上版本会存在许多兼容性问题

安装

使用pip:

pip install django-xadmin

从源代码安装

从https://github.com/sshwsfc/django-xadmin下载最新的源代码或者从仓库git clone 。然后在项目目录中执行以下命令：

pip install -r requirements.txt

注：不建议使用pip直接安装，建议下载源码之后自行配置。配置方案参考其他中文博客。

运行演示

如果已下载Xadmin的源代码，你将会在工程目录找到一个demo_app文件夹。以下命令可以用来快速创建Xadmin的演示实例：

cd demo_app
python manage.py runserver

使用浏览器访问http://127.0.0.1:8000查看结果。

使用现有项目

作为Django应用程序，Xadmin可以轻松插入Django支持的站点。

首先，编辑你的setting.py ，将Xadmin添加到INSTALLED_APPS。(请注意，还需要安装原Django admin app的依赖项，但Django admin 自身不需要)：

INSTALLED_APPS = (
	...
    'xadmin', # 必选
    'crispy_forms', # 必选
    'reversion', # 可选
    ...
)

然后添加urlpatterns并执行autdiscover :

# -*- coding: utf-8 -*-
import xadmin
xadmin.autodiscover()

# version模块自动注册需要版本控制的 Model
from xadmin.plugins import xversion
xversion.register_models()

urlpatterns = patterns('',
    url(r'xadmin/', include(xadmin.site.urls)),
)

收集 media:

python manage.py collectstatic