django-databrowse 2016.3.16

目录

• Installation
• How to use Databrowse
• Requiring user login
• Tests
• Translations

注意

从Django 1.4 since databrowse deprecation中提取

Installation

django-databrowse在pypi上可用

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

很容易通过pip

$ pip install django-databrowse

或者通过easy_install

$ easy_install django-databrowse

另一种方法是克隆django-databrowse'sgit repo

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

然后运行：

$ python setup.py install

How to use Databrowse

1. 将django指向默认的databrowse模板。有两种方法 执行以下操作：

   • 将'django_databrowse'添加到INSTALLED_APPS 设置。如果您的TEMPLATE_LOADERS设置有效 包括app_directories模板加载器（按 默认设置）。有关详细信息，请参见template loader docs
   • 否则，请确定 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)
   

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

   可以在同一个系统中注册多个模型 呼叫django_databrowse.site.register

   不管你把它放在哪里只要它在某个地方被执行 要点。你的URLconf file（urls.py）是个不错的地方。

3. 更改urlconf以导入~django_databrowse模块：

   from django_databrowse
   

   …并在urlconf中添加以下行：

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

   前缀不重要–您可以使用databrowse/或db/或 你想要什么都行。

4. 运行django服务器并访问浏览器中的/databrowse/。

Requiring user login

您可以限制对已登录用户的访问，只需添加几行 代码。只需将以下导入添加到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)),

如果您还没有向URLconf添加对用户登录的支持，如user authentication docs中所述，则现在需要执行以下操作 映射：

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

最后一步是创建 django.contrib.auth.views.login。这个 user authentication docs提供完整的详细信息和 可用于此目的的示例模板

Tests

django-databrowse已经过django 1.6及更高版本的测试。运行测试：

$ python run_tests.py

travis ci也提供此功能：

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

Translations

当前English是正在打包的唯一可用语言如果你愿意贡献 在本地化中，您还可以在transifex上找到django-databrowse项目： https://www.transifex.com/projects/p/django-databrowse/

transifex上的翻译状态