emelie/zola
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

Document conditional TOC rendering (#1376)

Browse source 
* Document conditional TOC rendering

* Simplify demonstration of conditional rendering
This commit is contained in:
Yngve Høiseth 2021-02-22 21:05:45 +01:00 committed by GitHub
parent 8630c790b8
commit d29693066e
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 18 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

34
docs/content/documentation/content/table-of-contents.md
View file

@ -12,22 +12,24 @@ documentation for information on its structure.
Here is an example of using that field to render a two-level table of contents:
```jinja2
<ul>
{% for h1 in page.toc %}
<li>
<a href="{{h1.permalink | safe}}">{{ h1.title }}</a>
{% if h1.children %}
<ul>
{% for h2 in h1.children %}
<li>
<a href="{{h2.permalink | safe}}">{{ h2.title }}</a>
</li>
{% endfor %}
</ul>
{% endif %}
</li>
{% endfor %}
</ul>
{% if page.toc %}
<ul>
{% for h1 in page.toc %}
<li>
<a href="{{h1.permalink | safe}}">{{ h1.title }}</a>
{% if h1.children %}
<ul>
{% for h2 in h1.children %}
<li>
<a href="{{h2.permalink | safe}}">{{ h2.title }}</a>
</li>
{% endfor %}
</ul>
{% endif %}
</li>
{% endfor %}
</ul>
{% endif %}
```
While headers are neatly ordered in this example, it will work just as well with disjoint headers.