This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!
Project Description
There is currently no great way to do tree structures in Django templates.

Thus, this module contains a tag for rendering trees from sequences.

For this, a method for recursion is given, as well as for defining start and end
markers. A full example of the syntax of this template tag is the following:

{% load treetag %}
{% tree item_seq %}
<ul> {# indentation section #}
{% for item in tree %} {# item start #}
<li>{{ item.description }}
{% subtree item.sub_seq %} {# subtree renders same as whole tree #}
{% endfor %} {# item end #}
</ul> {# outdentation section #}
{% endtree %}

The syntax defined here thus has two special tags and splits into three
sections. The sections are:

1. The tree indentation section
2. The tree item section
3. The tree outdentation section

Start a tree by enclosing the whole of the tree code with a `tree`/`endtree` tag
pair. The `tree` tag needs to receive one argument, a sequence of items. This
sequence will be available inside the tree as a variable named `tree`. The
renaming is necessary so we can map the sequence in subtrees to the same name.

The three sections are separated by a `for`-loop looping over the items.

In the tree indentation section, place everything that belongs to the 'head' of
a tree, like the start tags of a list or a table.

In the item section, place everything that renders the item, as well as the
special recursive tag that renders the subtree. The `subtree` tag simply takes

Finally in the outdentation section, place everything that closes the tree, like
the closing of the list or table tags and any footer material for the tree.

Nested trees are not supported at the moment (i.e. placing a `tree` section
inside of another `tree` section).

Alternatives are:
* django-mptt:
* self-made tree unrolling:
* hacking the `include` tag: (please don't do this!)
* for simpler cases, the builtin `unordered-list` filter might be sufficient:
Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-tree-tag-1.0.tar.gz (3.7 kB) Copy SHA256 Checksum SHA256 Source Jan 7, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting