[gnome-doc-utils/mallard] [mal2html] Added link trails, moved mallard.xml to index.xml

[Shaun McCance <shaunm src gnome org>]

commit c426c2bf99144c869b3dc99b58d8b729c4ad63fe
Author: Shaun McCance <shaunm gnome org>
Date:   Fri May 29 12:22:45 2009 -0500

    [mal2html] Added link trails, moved mallard.xml to index.xml
---
 doc/mallard/C/{mallard.xml => index.xml} |    2 +-
 xslt/mallard/html/mal2html-css.xsl       |    6 ++
 xslt/mallard/html/mal2html-page.xsl      |  107 ++++++++++++++++++++++++++++++
 3 files changed, 114 insertions(+), 1 deletions(-)

diff --git a/doc/mallard/C/mallard.xml b/doc/mallard/C/index.xml
similarity index 97%
rename from doc/mallard/C/mallard.xml
rename to doc/mallard/C/index.xml
index 94b1657..d3c923c 100644
--- a/doc/mallard/C/mallard.xml
+++ b/doc/mallard/C/index.xml
@@ -1,6 +1,6 @@
 <page xmlns="http://www.gnome.org/~shaunm/mallard";
       type="guide"
-      id="mallard">
+      id="index">
 
 <info>
   <link type="topic" xref="tenminutes"/>
diff --git a/xslt/mallard/html/mal2html-css.xsl b/xslt/mallard/html/mal2html-css.xsl
index 5ae2315..20fbba9 100644
--- a/xslt/mallard/html/mal2html-css.xsl
+++ b/xslt/mallard/html/mal2html-css.xsl
@@ -154,6 +154,12 @@ div.autolinks div.title span {
 }
 li.autolink { margin: 0.5em 0 0 0; padding: 0 0 0 1em; list-style-type: none; }
 
+div.linktrail {
+  font-size: 0.83em;
+  padding-left: 1.2em;
+  margin: 0 1px 0.2em 1px;
+}
+
 td.twocolumnleft { width: 48%; vertical-align: top; padding: 0; margin: 0; }
 td.twocolumnright { width: 52%; vertical-align: top; padding: 0 0 0 1em; margin: 0; }
 
diff --git a/xslt/mallard/html/mal2html-page.xsl b/xslt/mallard/html/mal2html-page.xsl
index fdfc1d2..7a10165 100644
--- a/xslt/mallard/html/mal2html-page.xsl
+++ b/xslt/mallard/html/mal2html-page.xsl
@@ -18,6 +18,7 @@ Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
                 xmlns:mal="http://www.gnome.org/~shaunm/mallard";
+                xmlns:str="http://exslt.org/strings";
                 xmlns="http://www.w3.org/1999/xhtml";
                 version="1.0">
 
@@ -357,6 +358,109 @@ REMARK: Describe this template
 </xsl:template>
 
 
+<!--**==========================================================================
+mal2html.page.linktrails
+FIXME
+
+REMARK: Describe this template
+-->
+<xsl:template name="mal2html.page.linktrails">
+  <xsl:param name="node" select="."/>
+  <xsl:param name="id">
+    <xsl:choose>
+      <xsl:when test="$node/self::mal:page or contains($node/@id, '#')">
+        <xsl:value-of select="$node/@id"/>
+      </xsl:when>
+      <xsl:otherwise>
+        <xsl:value-of select="$node/ancestor::mal:page/@id"/>
+        <xsl:text>#</xsl:text>
+        <xsl:value-of select="$node/@id"/>
+      </xsl:otherwise>
+    </xsl:choose>
+  </xsl:param>
+  <xsl:param name="trailid" select="$id"/>
+  <xsl:param name="trail" select="''"/>
+  <xsl:variable name="traillist" select="str:split($trail, ':')"/>
+  <xsl:if test="count($traillist) &lt; 5">
+    <xsl:choose>
+      <xsl:when test="$id = 'index'">
+        <xsl:if test="$trail != ''">
+          <xsl:variable name="fulltrail"
+                        select="str:split(concat($trailid, $trail), ':')"/>
+          <div class="linktrail">
+            <xsl:for-each select="$fulltrail">
+              <a class="linktrail">
+                <xsl:attribute name="href">
+                  <xsl:call-template name="mal.link.target">
+                    <xsl:with-param name="xref" select="."/>
+                  </xsl:call-template>
+                </xsl:attribute>
+                <xsl:call-template name="mal.link.content">
+                  <xsl:with-param name="xref" select="."/>
+                </xsl:call-template>
+              </a>
+              <xsl:text> » </xsl:text>
+            </xsl:for-each>
+          </div>
+        </xsl:if>
+      </xsl:when>
+      <xsl:otherwise>
+        <xsl:variable name="guidelinks"
+                      select="$node/mal:info/mal:link[ type = 'guide']"/>
+        <xsl:variable name="pagelinks"
+                      select="$mal.cache//*[mal:info/mal:link[ type = 'topic'][ xref = $id]]"/>
+        <xsl:if test="not($guidelinks or $pagelinks) and $node/self::mal:section">
+          <xsl:call-template name="mal2html.page.linktrails">
+            <xsl:with-param name="node" select="$node/ancestor::mal:page"/>
+            <xsl:with-param name="trailid" select="$trailid"/>
+            <xsl:with-param name="trail" select="$trail"/>
+          </xsl:call-template>
+        </xsl:if>
+        <xsl:variable name="newtrail">
+          <xsl:choose>
+            <xsl:when test="$trail = ''">
+              <xsl:text>:</xsl:text>
+            </xsl:when>
+            <xsl:otherwise>
+              <xsl:value-of select="concat(':', $trailid, $trail)"/>
+            </xsl:otherwise>
+          </xsl:choose>
+        </xsl:variable>
+        <xsl:for-each select="$guidelinks">
+          <xsl:variable name="fullid">
+            <xsl:choose>
+              <xsl:when test="contains(@xref, '#')">
+                <xsl:variable name="pageid" select="substring-before(@xref, '#')"/>
+                <xsl:variable name="sectionid" select="substring-after(@xref, '#')"/>
+                <xsl:if test="$pageid = ''">
+                  <xsl:value-of select="ancestor::mal:page/@id"/>
+                </xsl:if>
+                <xsl:value-of select="concat($pageid, '#', $sectionid)"/>
+              </xsl:when>
+              <xsl:otherwise>
+                <xsl:value-of select="@xref"/>
+              </xsl:otherwise>
+            </xsl:choose>
+          </xsl:variable>
+          <xsl:for-each select="$mal.cache">
+            <xsl:call-template name="mal2html.page.linktrails">
+              <xsl:with-param name="node" select="key('mal.cache.key', $fullid)"/>
+              <xsl:with-param name="trail" select="$newtrail"/>
+            </xsl:call-template>
+          </xsl:for-each>
+        </xsl:for-each>
+        <xsl:for-each select="$pagelinks">
+          <xsl:call-template name="mal2html.page.linktrails">
+            <xsl:with-param name="node" select="."/>
+            <xsl:with-param name="trail" select="$newtrail"/>
+          </xsl:call-template>
+        </xsl:for-each>
+      </xsl:otherwise>
+    </xsl:choose>
+  </xsl:if>
+</xsl:template>
+
+
 <!-- == Matched Templates == -->
 
 <!-- = / = -->
@@ -414,6 +518,9 @@ REMARK: Describe this template
           <xsl:apply-templates mode="mal2html.block.mode" select="$version/*"/>
         </div>
       </xsl:if>
+      <xsl:call-template name="mal2html.page.linktrails">
+        <xsl:with-param name="node" select="mal:page"/>
+      </xsl:call-template>
       <div class="body">
         <xsl:apply-templates select="mal:page"/>
       </div>