From 2bbfd85a395baaef7790847149c63b1446ca9933 Mon Sep 17 00:00:00 2001
From: Holger Schurig <holgerschurig@gmx.de>
Date: Thu, 25 Jun 2009 16:41:20 +0200
Subject: [PATCH] doc: document two different style to make a sitemap

---
 in/hierarchy.md | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/in/hierarchy.md b/in/hierarchy.md
index 9fe5f89..cace962 100644
--- a/in/hierarchy.md
+++ b/in/hierarchy.md
@@ -136,3 +136,42 @@ To get a list of recently changed pages, do this:
 	: <a href="${link}">${page.title | entity}</a><br />
 	%   endfor
 	% endif
+
+
+= Generate a sitemap =
+
+To generate a site map for your whole project, do something like
+this:
+
+	<%
+	  site = get_sitemap()
+	%>
+	<ul>
+	% for level, page, link in site:
+	<li id="sidemap${level}"><a href="${link}">${page.title}</a></li>
+	% endfor
+	</ul>
+
+Now you'd need to use CSS to indent the entries. If you prefer a more
+normal "`<ul>..<li><ul><li></li></ul>..</il>`" style, you'd could do this
+with some more advanced Mako template magic:
+
+	<%
+	  site = get_sitemap()
+	  lvl = -1
+	%>
+	% for level, page, link in site:
+	### Adjust level by indenting/detenting via <ul> or </ul>:
+	%   while lvl < level:
+	<ul><% lvl += 1 %>
+	%   endwhile
+	%   while lvl > level:
+	</ul><% lvl -= 1 %>
+	%   endwhile
+	### Print out the <li>
+	<li id="sidemap${level}"><a href="${link}">${page.title}</a></li>
+	% endfor
+	### At the end of the sitemap, detent back to level -1
+	% while lvl >= 0:
+	</ul><% lvl -= 1 %>
+	% endwhile
-- 
2.39.2