From: Joey Hess <joey@gnu.kitenet.net>
Date: Thu, 29 Oct 2009 14:32:02 +0000 (-0400)
Subject: add an example of how to use the recently added HAS_PARENTLINKS
X-Git-Tag: 3.20091031~9
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=c4784a437d82c2c7747ffc600ac54355130b2ac0;p=ikiwiki.git

add an example of how to use the recently added HAS_PARENTLINKS
---

diff --git a/doc/tips/parentlinks_style.mdwn b/doc/tips/parentlinks_style.mdwn
index b992a11a0..8b95cd396 100644
--- a/doc/tips/parentlinks_style.mdwn
+++ b/doc/tips/parentlinks_style.mdwn
@@ -82,6 +82,24 @@ following lines in `page.tmpl`:
 
 Then write the appropriate CSS bits for `a.height1`, etc.
 
+Avoid showing title of toplevel index page
+------------------------------------------
+
+If you don't like having "index" appear on the top page of the wiki,
+but you do want to see the name of the page otherwise, you can use a
+special `HAS_PARENTLINKS` template variable that the plugin provides.
+It is true for every page *except* the toplevel index.
+
+Here is an example of using it to hide the title of the toplevel index
+page:
+
+	<TMPL_LOOP NAME="PARENTLINKS">
+	<a href="<TMPL_VAR NAME=URL>"><TMPL_VAR NAME=PAGE></a>/ 
+	</TMPL_LOOP>
+	<TMPL_IF HAS_PARENTLINKS>
+	<TMPL_VAR TITLE>
+	</TMPL_IF>
+
 Full-blown example
 ------------------