django-crumbs 0.5.0

姜果屑

django crumbs是一个可插入的django应用程序，用于向项目添加面包屑。

安装

1. 用pip:

   安装django crumbs

   pip install django-crumbs
   

2. 添加到已安装的应用程序并运行syncdb:

   INSTALLED_APPS = (
       ...,
       'crumbs',
   )
   

工作原理

1. 在每个模板中，您需要使用add_crumb template标记将项目附加到trail:

   # basic crumb without a link
   {% add_crumb 'People' %}
   # crumb with link
   {% add_crumb 'People' 'list_people' %}
   # crumb with link and args
   {% add_crumb person.name 'view_person' person.pk %}
   

注意：如果只调用一次添加面包屑，则不会打印面包屑。

设置

1. 在base.html模板中，沿以下代码行添加一些内容：

   <div id="breadcrumbs">
       {% block breadcrumb %}
           {% load breadcrumb_tags %}
           {% add_crumb 'Home' 'home' %}
       {% endblock %}
       {% render_breadcrumbs %}
   </div>
   

2. 现在，在每个扩展子模板中，只需在breadcrumb块的trail中添加一个新的crumb即可：

   {% block breadcrumb %}
       {{ block.super }}
       {% load breadcrumb_tags %}
       {% add_crumb 'People' 'list_people' %}
   {% endblock %}
   

示例

1. base.html:

   <div id="breadcrumbs">
       {% block breadcrumb %}
           {% load breadcrumb_tags %}
           {% add_crumb 'Home' 'home' %}
       {% endblock %}
       {% render_breadcrumbs %}
   </div>
   

2. person/list.html:

   {% extends "base.html" %}
   {% block breadcrumb %}
       {{ block.super }}
       {% load breadcrumb_tags %}
       {% add_crumb 'People' 'list_people' %}
   {% endblock %}
   

3. person/view.html:

   {% extends "person/list.html" %}
   {% block breadcrumb %}
       {{ block.super }}
       {% load breadcrumb_tags %}
       {% add_crumb person.name 'view_person' person.pk %}
   {% endblock %}
   

由Caktus Consulting Group, LLC赞助的开发。