django-databrowse 2016.3.16

安装

django-databrowse可在pypi上找到

http://pypi.python.org/pypi/django-databrowse

因此，可以轻松地通过pip安装它

$ pip install django-databrowse

或者通过easy_install

$ easy_install django-databrowse

另一种方式是克隆django-databrowse的git仓库

$ git clone git://github.com/Alir3z4/django-databrowse.git

然后运行以下命令安装

$ python setup.py install

如何使用Databrowse

1. 将Django指向默认的Databrowse模板。有两种方法可以实现这一点

   • 将'django_databrowse'添加到您的INSTALLED_APPS设置中。如果您的TEMPLATE_LOADERS设置包括app_directories模板加载器（这是默认情况），则此方法将有效。有关更多信息，请参阅模板加载器文档。

   • 否则，确定到django_databrowse/templates目录的完整文件系统路径，并将其目录添加到您的TEMPLATE_DIRS设置中。

2. 在Databrowse网站上注册多个模型

   import django_databrowse
   from myapp.models import SomeModel, SomeOtherModel, YetAnotherModel
   
   django_databrowse.site.register(SomeModel)
   django_databrowse.site.register(SomeOtherModel, YetAnotherModel)

   注意，您应该注册模型类，而不是实例。

   可以在一个调用中注册多个模型到django_databrowse.site.register。

   无论您将其放在哪里都无关紧要，只要它在某个时候执行即可。一个好的地方是您的URLconf文件（urls.py）。

3. 修改您的URLconf以导入~django_databrowse模块

   from django_databrowse

   …并将以下行添加到您的URLconf中

   (r'^django_databrowse/(.*)', django_databrowse.site.root),

   前缀无关紧要 - 您可以使用databrowse/、db/或您想要的任何内容。

4. 运行Django服务器，并在浏览器中访问/databrowse/。

需要用户登录

您可以通过仅添加几行代码来限制只有登录用户才能访问。只需将以下导入添加到您的URLconf中

from django.contrib.auth.decorators import login_required

然后修改URLconf，使django_databrowse.site.root视图被装饰为django.contrib.auth.decorators.login_required

(r'^databrowse/(.*)', login_required(django_databrowse.site.root)),

如果您还没有按照用户认证文档中所述添加对用户登录的支持，那么您现在需要这样做，如下所示

(r'^accounts/login/$', 'django.contrib.auth.views.login'),

最后一步是创建django.contrib.auth.views.login所需的登录表单。用户认证文档提供了完整细节和示例模板，可用于此目的。

测试

django-databrowse已在Django 1.6及以后版本进行了测试。要运行测试

$ python run_tests.py

它也可在travis-ci上使用

https://travis-ci.org/Alir3z4/django-databrowse/

翻译

目前只有English是打包的唯一语言。如果您想为此做出贡献，可以在Transifex上找到django-databrowse项目：https://www.transifex.com/projects/p/django-databrowse/

Transifex上的翻译状态