[NeXus-definitions-tickets] [NeXusDefinitions] #187: incorrect links in HTML documentation

[NeXus Base Classes and Instrument Definitions]

#187: incorrect links in HTML documentation
-------------------------+-------------------------------
 Reporter:  Pete Jemian  |       Owner:  Pete Jemian
     Type:  defect       |      Status:  new
 Priority:  major        |   Milestone:  release NXDL 1.0
Component:  general      |  Resolution:
 Keywords:               |
-------------------------+-------------------------------

Comment (by Pete Jemian):

 Actually, the problem is caused by an incorrect DocBook handling of the
 link.  The link generated by {{{nxdl2docbook.xsl}}} ''is'' a DocBook link.
 The code used is

 {{{
     <xsl:element name="link">
         <xsl:attribute name="xlink:href"
                 >#<xsl:value-of select="@type"/>
             </xsl:attribute>
             <xsl:value-of select="@type"/>
         </xsl:element>
     </xsl:template>
 }}}


 Another way to do this would be

 {{{
         <xsl:element name="xref">
             <xsl:attribute name="linkend"><xsl:value-of
 select="@type"/></xsl:attribute>
         </xsl:element>
 }}}
 but the link text looks awkward:
      ''the section called "NXgroup"''

 Perhaps adding an {{{xreflabel}}} attribute to accompany the {{{xml:id}}}
 declaration will help?

-- 
Ticket URL: <http://trac.nexusformat.org/definitions/ticket/187#comment:2>
NeXus Base Classes and Instrument Definitions <http://www.nexusformat.org/>
NeXus Base Classes and Instrument Definitions