Fix/link handling (#11)

* Only render global namespace if anything inside

* Initial step to rework link handling.
Should be unified in one template and handle different cases

* Initial workaround for embedded enums

* Fix warning for links of wrong type

* Rendering of slots, see sections and ulinks

* Fix generation of inherited methods.
Dont rely on the inheritance graph, since that will output all children members
into the "Inherited methods summary".
Better / easier is to rely on basecompoundref.

* Add signals, dont bail hard if ref not found

* Dont bail on multiple base classes

Author: Hauke Wintjen

Customization/xsl/class.xsl

@@ -22,6 +22,10 @@
       <xsl:attribute name="id">
         <xsl:value-of select="dita-ot:name-to-id(compoundname)"/>
       </xsl:attribute>
+      <xsl:attribute name="keys">
+        <xsl:value-of select="concat('doxygen-',dita-ot:name-to-id(compoundname))"/>
+      </xsl:attribute>
+      
       <xsl:attribute name="outputclass">
         <xsl:text>class</xsl:text>
       </xsl:attribute>
@@ -39,8 +43,8 @@
             <xsl:value-of select="dita-ot:prismjs(@language)"/>
         </xsl:attribute>
 
-        <xsl:if test="basecompoundref/@refid">
-          <xsl:if test="starts-with(basecompoundref/@refid, 'interface')">
+        <xsl:if test="basecompoundref[1]/@refid">
+          <xsl:if test="starts-with(basecompoundref[1]/@refid, 'interface')">
             <p class="- topic/p ">
               <b class="+ topic/ph hi-d/b ">
                 <xsl:text>All Implemented Interfaces:</xsl:text>
@@ -58,7 +62,7 @@
               </xsl:for-each>
             </ul>
           </xsl:if>
-          <xsl:if test="not(starts-with(basecompoundref/@refid, 'interface'))">
+          <xsl:if test="not(starts-with(basecompoundref[1]/@refid, 'interface'))">
             <p class="- topic/p ">
               <b class="+ topic/ph hi-d/b ">
                 <xsl:text>Direct Base Classes:</xsl:text>
@@ -133,7 +137,7 @@
         <xsl:call-template name="parse-brief-description"/>
         <xsl:call-template name="parse-detailed-description"/>
 
-        <xsl:if test="sectiondef/memberdef[@kind='typedef' and @prot='public']">
+        <xsl:if test="sectiondef/memberdef[(@kind='typedef' or @kind='enum') and @prot='public']">
           <!-- Class typedef Summary -->
           <section class="- topic/section " outputclass="typedefs_summary">
             <title class="- topic/title ">
@@ -166,14 +170,14 @@
              <xsl:text>Method Summary</xsl:text>
            </title>
           <xsl:if
-            test="sectiondef[contains(@kind,'-func')]/memberdef[@kind='function' and not(type='') and @prot='public']"
+            test="sectiondef/memberdef[ (@kind='function' or @kind='slot') and not(type='') and @prot='public']"
           >
             <xsl:call-template name="add-method-summary"/>
           </xsl:if>
           <xsl:call-template name="add-inherited-method-summary"/>
         </section>
 
-         <xsl:if test="sectiondef/memberdef[@kind='typedef'and @prot='public']">
+         <xsl:if test="sectiondef/memberdef[(@kind='typedef' or @kind='enum') and @prot='public']">
           <!-- typedef Detail -->
           <section class="- topic/section " outputclass="typedefs">
             <xsl:attribute name="id">
@@ -183,7 +187,7 @@
               <xsl:text>Types Detail</xsl:text>
             </title>
             <xsl:apply-templates
-              select="sectiondef/memberdef[@kind='typedef' and @prot='public']"
+              select="sectiondef/memberdef[(@kind='typedef' or @kind='enum') and @prot='public']"
               mode="typedef"
             >
               <xsl:sort select="@id"/>
@@ -210,7 +214,7 @@
           </section>
         </xsl:if>
 
-        <xsl:if test="sectiondef[contains(@kind,'-func')]/memberdef[@kind='function' and type='' and @prot='public']">
+        <xsl:if test="sectiondef/memberdef[ @kind='function' and type='' and @prot='public']">
           <!-- Constructor Detail -->
           <section class="- topic/section " outputclass="constructors">
             <xsl:attribute name="id">
@@ -229,7 +233,7 @@
         </xsl:if>
 
         <xsl:if
-          test="sectiondef[contains(@kind,'-func')]/memberdef[@kind='function' and  not(type='') and @prot='public']"
+          test="sectiondef/memberdef[(@kind='function' or @kind='slot') and  not(type='') and @prot='public']"
         >
           <!-- Method Detail-->
           <section class="- topic/section " outputclass="methods">
@@ -240,7 +244,7 @@
               <xsl:text>Method Detail</xsl:text>
             </title>
             <xsl:apply-templates
-              select="sectiondef[contains(@kind,'-func')]/memberdef[@kind='function' and not(type='') and @prot='public']"
+              select="sectiondef/memberdef[ ( @kind='function' or @kind='slot') and not(type='') and @prot='public']"
               mode="method"
             >
               <xsl:sort select="name"/>
@@ -364,8 +368,9 @@
                 <codeph class="+ topic/ph pr-d/codeph ">
                   <xsl:attribute name="xtrc" select="concat('codeph:',generate-id(.),'3')"/>
                   <xsl:call-template name="add-modifiers"/>
-                  <xsl:call-template name="add-class-link">
-                    <xsl:with-param name="class" select="type"/>
+                  <xsl:call-template name="add-type-link">
+                    <xsl:with-param name="refid" select="type/ref/@refid"/>
+                    <xsl:with-param name="reftext" select="type"/>
                   </xsl:call-template>
                 </codeph>
               </entry>
@@ -411,8 +416,9 @@
         <xsl:if test="@final='true'">
           <xsl:text>final </xsl:text>
         </xsl:if>
-        <xsl:call-template name="add-class-link">
-          <xsl:with-param name="class" select="type"/>
+        <xsl:call-template name="add-type-link">
+          <xsl:with-param name="refid" select="type/ref/@refid"/>
+          <xsl:with-param name="reftext" select="type"/>
         </xsl:call-template>
         <xsl:value-of select="concat(' ',$field)"/>
       </codeph>
@@ -457,7 +463,7 @@
           </row>
         </thead>
         <tbody class="- topic/tbody ">
-          <xsl:for-each select="sectiondef/memberdef[@kind='typedef' and @prot='public']">
+          <xsl:for-each select="sectiondef/memberdef[(@kind='typedef' or @kind ='enum') and @prot='public']">
             <xsl:sort select="name"/>
             <xsl:variable name="field" select="name"/>
             <row class="- topic/row ">

Customization/xsl/html-processing.xsl

@@ -81,6 +81,35 @@
   -->
   <xsl:template match="simplesect[@kind='return']" mode="html">
   </xsl:template>
+
+  <!--
+    simplesect kind=see 
+  -->
+  <xsl:template match="simplesect[@kind='see']" mode="html">
+    <xsl:text>see </xsl:text>
+    <xsl:apply-templates mode="html"/>
+  </xsl:template>
+  
+  <!-- Rendering of ref (like in @see links)
+   -->
+  <xsl:template match="ref" mode="html">
+    <xsl:call-template name="add-type-link">
+      <xsl:with-param name="refid" select="@refid"/>
+      <xsl:with-param name="reftext" select="."/>
+    </xsl:call-template>
+  </xsl:template>
+
+  <!-- Rendering of ulink (link to external urls)
+   -->
+  <xsl:template match="ulink" mode="html">
+      <xref class="- topic/xref " format="html" scope="external">
+      <xsl:attribute name="href">
+        <xsl:value-of select="@url"/>
+      </xsl:attribute>
+      <xsl:processing-instruction name="ditaot">
+        <xsl:text>usertext</xsl:text>
+      </xsl:processing-instruction><xsl:value-of select="normalize-space(.)"/></xref>
+  </xsl:template>
 
 
   <!--

Customization/xsl/interface.xsl

@@ -40,16 +40,18 @@
         <codeblock class="+ topic/pre pr-d/codeblock ">
           <xsl:attribute name="xtrc" select="concat('codeblock:',generate-id(.),'7')"/>
           <xsl:value-of select="concat(@prot, ' interface ')"/>
-          <b class="+ topic/ph hi-d/b ">
-          	<xsl:variable name="class" select="replace(compoundname, '^.*::','')"/>
-		        <xsl:call-template name="add-class-link">
-		          <xsl:with-param name="class" select="$class"/>
-		        </xsl:call-template>
+            <b class="+ topic/ph hi-d/b ">
+            	<xsl:variable name="class" select="replace(compoundname, '^.*::','')"/>
+
+                <xsl:call-template name="add-type-link">
+                  <xsl:with-param name="refid" select="./ref/@refid"/>
+                  <xsl:with-param name="reftext" select="$class"/>
+                </xsl:call-template>
         	</b>
         </codeblock>
         <xsl:value-of select="briefdescription"/>
 
-        <xsl:if test="sectiondef[contains(@kind,'-func')]/memberdef[@kind='function' and  not(type='')]">
+        <xsl:if test="sectiondef[contains(@kind,'-func')]/memberdef[ (@kind='function' or @kind='slot') and  not(type='')]">
           <!-- Interface Method Summary -->
           <section class="- topic/section " outputclass="methods_summary">
             <title class="- topic/title ">
@@ -59,7 +61,7 @@
           </section>
         </xsl:if>
 
-        <xsl:if test="sectiondef[contains(@kind,'-func')]/memberdef[@kind='function' and  not(type='')]">
+        <xsl:if test="sectiondef/memberdef[ (@kind='function' or @kind='slot') and  not(type='')]">
           <!-- Interface Method Details -->
           <section class="- topic/section " outputclass="methods">
             <xsl:attribute name="id">
@@ -69,7 +71,7 @@
             	<xsl:text>Method Detail</xsl:text>
             </title>
             <xsl:apply-templates
-              select="sectiondef[contains(@kind,'-func')]/memberdef[@kind='function' and  not(type='')]"
+              select="sectiondef/memberdef[ (@kind='function' or @kind='slot') and  not(type='')]"
               mode="method"
             >
               <xsl:sort select="name"/>