Markup problem in rendering grammar productions in HTML

[ruv]

there's also some kind of markup problem that means the links within the grammar don't always work properly.

Originally posted by @michaelhkay in #2345 (comment)

The problem is that some local links are incorrect (don't work), and some items don't have links.

For example, in 4.1 Namespace Declarations,
in the line "declare" "default" "element" "namespace" URILiteral,

The html source code for "URILiteral" is:

<a href="#doc-xpath40-DefaultElementNamespaceDecl-URILiteral doc-xpath40-NamespaceDecl-URILiteral">URILiteral</a>

(note a space in the fragment identifier in href)

The code for the first occurrence of URILiteral at the left side is:

<a id="doc-xpath40-DefaultElementNamespaceDecl-URILiteral"></a>
<code><a href="#prod-xpath40-URILiteral">URILiteral</a></code>

(seems correct)

And the code for the second occurrence of URILiteral at the left side is:

<a id="doc-xpath40-NamespaceDecl-URILiteral"></a>
<code>URILiteral</code>

(one anchor is missing, is this intentional?)

The XML source is:

         <scrap role="xpath">
            <prodrecap ref="DefaultElementNamespaceDecl"/>
            <prodrecap ref="NamespaceDecl"/>
         </scrap>

[ruv]

(note a space in the fragment identifier in href)

The root of this problem is probably in /style/xsl-query-2016.xsl#L1203-L1204.

  <xsl:template match="scrap/prod/rhs//nt">
    <xsl:variable name="localDefn" select="ancestor::scrap/prod[lhs = current()]"/>
    <xsl:choose>
      <!-- If the relevant rule appears within the same scrap -->
      <xsl:when test="exists($localDefn)">
        <a href="#{$localDefn/@id}"><xsl:value-of select="."/></a>
      </xsl:when>

I would suggest to change the variable localDefn to:

    <xsl:variable name="localDefn" select="ancestor::scrap/prod[lhs = current()][ . >> current() ][1]"/>

Update:

An intermediate XML fragment (an instance) that is processed by this template

<scrap role="xpath" headstyle="show">
  <prod id="doc-xpath-DefaultElementNamespaceDecl">
    <lhs>DefaultElementNamespaceDecl</lhs>
    <rhs>"declare"  "default"  "element"  "namespace"  <nt def="prod-xpath-URILiteral">URILiteral<!--$idref_lang_part = xpath- --></nt></rhs>
  </prod>
  <prod id="doc-xpath-DefaultElementNamespaceDecl-URILiteral">
    <lhs>URILiteral</lhs>
    <rhs>
      <nt def="doc-xpath-StringLiteral">StringLiteral<!--$idref_lang_part = xpath- --></nt>
    </rhs>
  </prod>
  <prod id="doc-xpath-DefaultElementNamespaceDecl-StringLiteral">
    <lhs>StringLiteral</lhs>
    <rhs><nt def="prod-xpath-AposStringLiteral">AposStringLiteral<!--$idref_lang_part = xpath- --></nt>  |  <nt def="prod-xpath-QuotStringLiteral">QuotStringLiteral<!--$idref_lang_part = xpath- --></nt></rhs>
  </prod>
  <prod id="doc-xpath-NamespaceDecl">
    <lhs>NamespaceDecl</lhs>
    <rhs>"declare"  "namespace"  <nt def="prod-xpath-NCName">NCName<!--$idref_lang_part = xpath- --></nt>  "="  <nt def="prod-xpath-URILiteral">URILiteral<!--$idref_lang_part = xpath- --></nt></rhs>
  </prod>
  <prod id="doc-xpath-NamespaceDecl-URILiteral">
    <lhs>URILiteral</lhs>
    <rhs>
      <nt def="doc-xpath-StringLiteral">StringLiteral<!--$idref_lang_part = xpath- --></nt>
    </rhs>
  </prod>
  <prod id="doc-xpath-NamespaceDecl-StringLiteral">
    <lhs>StringLiteral</lhs>
    <rhs><nt def="prod-xpath-AposStringLiteral">AposStringLiteral<!--$idref_lang_part = xpath- --></nt>  |  <nt def="prod-xpath-QuotStringLiteral">QuotStringLiteral<!--$idref_lang_part = xpath- --></nt></rhs>
  </prod>
</scrap>