Fix rendering of issues with empty namespace, add ankers for faster navigatin to c/i/t area

Author: theseer

templates/html/index.xsl

@@ -28,12 +28,16 @@
                 <div class="wrapper clearfix">
                     <div class="topbar clearfix">
                         <h1><a class="brand" href="./index.html"><xsl:value-of select="$project/@name" /> - API Documentation</a></h1>
+                        <span style="float:right; padding-right:10px;">
+                            <a href="#classes">Classes</a> | <a href="#interfaces">Interfaces</a> | <a href="#traits">Traits</a>
+                        </span>
                     </div>
 
                     <div class="indexcontent">
                         <h2><xsl:value-of select="$project/@name" /></h2>
                         <p>Welcome to the API documentation page. Please select one of the listed classes, interfaces or traits to learn more about the indivdual item. You can navigate back to this page by use of the top navigation bar.</p>
 
+                        <a name="classes" />
                         <h3>Classes</h3>
                         <xsl:choose>
                             <xsl:when test="//file:class">
@@ -47,7 +51,9 @@
                         </xsl:choose>
 
                         <div class="clearfix" />
-                        <h3>Interfaces</h3>
+
+                        <a name="interfaces" />
+                        <h3 class="separator">Interfaces</h3>
                         <xsl:choose>
                             <xsl:when test="//file:interface">
                                 <xsl:apply-templates select="//file:namespace[file:interface]" mode="interface">
@@ -60,7 +66,9 @@
                         </xsl:choose>
 
                         <div class="clearfix" />
-                        <h3>Traits</h3>
+
+                        <a name="traits" />
+                        <h3 class="separator">Traits</h3>
                         <xsl:choose>
                             <xsl:when test="//file:trait">
                                 <xsl:apply-templates select="//file:namespace[file:trait]" mode="trait">
@@ -79,9 +87,18 @@
         </html>
     </xsl:template>
 
+    <xsl:template match="file:namespace">
+        <h4>
+            <xsl:choose>
+                <xsl:when test="not(@name = '')"><xsl:value-of select="@name" /></xsl:when>
+                <xsl:otherwise>/</xsl:otherwise>
+            </xsl:choose>
+        </h4>
+    </xsl:template>
+
     <xsl:template match="file:namespace" mode="class">
         <div class="linkbox">
-        <h4><xsl:value-of select="@name" /></h4>
+        <xsl:apply-templates select="." />
         <ul class="linklist">
             <xsl:apply-templates select="file:class">
                 <xsl:sort select="@name" order="ascending" />
@@ -91,7 +108,7 @@
     </xsl:template>
 
     <xsl:template match="file:namespace" mode="interface">
-        <h4><xsl:value-of select="@name" /></h4>
+        <xsl:apply-templates select="." />
         <ul class="linklist">
             <xsl:apply-templates select="file:interface">
                 <xsl:sort select="@name" order="ascending" />
@@ -100,7 +117,7 @@
     </xsl:template>
 
     <xsl:template match="file:namespace" mode="trait">
-        <h4><xsl:value-of select="@name" /></h4>
+        <xsl:apply-templates select="." />
         <ul class="linklist">
             <xsl:apply-templates select="file:trait">
                 <xsl:sort select="@name" order="ascending" />
@@ -110,14 +127,12 @@
 
     <xsl:template match="file:class|file:interface|file:trait">
         <li>
-            <xsl:variable name="link">
-                <xsl:choose>
+            <xsl:variable name="link"><xsl:choose>
                     <xsl:when test="local-name(.) = 'class'">classes</xsl:when>
                     <xsl:when test="local-name(.) = 'interface'">interfaces</xsl:when>
                     <xsl:otherwise>traits</xsl:otherwise>
-                </xsl:choose>
-            </xsl:variable>
-            <a href="{$link}/{translate(../@name, '\', '_')}_{@name}.{$extension}"><xsl:value-of select="@name" /></a>
+                </xsl:choose>/<xsl:value-of select="translate(../@name, '\', '_')" /><xsl:if test="not(../@name = '')">_</xsl:if><xsl:value-of select="@name" />.<xsl:value-of select="$extension" /></xsl:variable>
+            <a href="{$link}"><xsl:value-of select="@name" /></a>
         </li>
     </xsl:template>