使用XSLT生成XHTML文档后添加link:schemaRef元素失败的排查求助

Let's figure out why your link:schemaRef element isn't showing up in the output and fix the issues step by step. Here are the most likely culprits and how to address them:

1. Missing Namespace Declarations #

Your XSLT uses prefixes like xhtml:, ix:, link:, and xlink:—but if you haven't declared their corresponding namespaces in the <xsl:stylesheet> root element, the XSLT processor can't recognize these prefixes. This means:

• It won't match the input nodes you're targeting
• It can't generate valid elements with those prefixes in the output

Add the necessary namespace declarations to your stylesheet. You'll need to replace placeholder URIs with the actual namespaces used in your input document (e.g., the official XHTML namespace, your ix namespace, and the correct namespace for link: elements):

<xsl:stylesheet version="1.0"
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    xmlns:xhtml="http://www.w3.org/1999/xhtml" <!-- Official XHTML namespace -->
    xmlns:ix="YOUR_ACTUAL_IX_NAMESPACE"       <!-- Replace with your ix namespace URI -->
    xmlns:link="YOUR_ACTUAL_LINK_NAMESPACE"   <!-- Replace with your link namespace URI -->
    xmlns:xlink="http://www.w3.org/1999/xlink"<!-- Official XLink namespace -->
    exclude-result-prefixes="xsl xhtml ix link xlink">

2. Incorrect Template Matching Path #

Double-check that the path in your match template exactly matches the structure of your input XHTML:
/xhtml:html/xhtml:body/xhtml:div[1]/ix:header/ix:hidden/ix:references

If any part of this path is wrong (e.g., the first <div> isn't a direct child of <body>, or ix:header is nested differently), the template won't trigger. To debug this:

• Add an <xsl:message> inside the template to confirm if it's being called:

  <xsl:template match="/xhtml:html/xhtml:body/xhtml:div[1]/ix:header/ix:hidden/ix:references">
      <xsl:message>Template matched the ix:references node!</xsl:message>
      <!-- Rest of your code -->
  </xsl:template>
  

• If the message doesn't appear, simplify the match path (e.g., start with //ix:references to target any ix:references node) to isolate where the mismatch is.

3. Improper Element Creation #

When you use <xsl:element name="link:schemaRef">, you need to ensure the link prefix is mapped to a namespace. Instead of manually adding attributes for xlink, you can simplify element creation by using the prefix directly (since we declared the namespaces earlier):

<xsl:template match="/xhtml:html/xhtml:body/xhtml:div[1]/ix:header/ix:hidden/ix:references">
    <xsl:copy>
        <xsl:copy-of select="@*" />
        <!-- Use the declared prefix to create the element directly -->
        <link:schemaRef xlink:type="simple" xlink:href="http://example.org"/>
        <xsl:apply-templates/>
    </xsl:copy>
</xsl:template>

This ensures the element is generated with the correct namespace, which is critical for it to appear in the output (some processors will drop elements with unrecognized namespaces).

Full Corrected Example #

Putting it all together, here's your updated stylesheet (with placeholders for your custom namespaces):

<xsl:stylesheet version="1.0"
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    xmlns:xhtml="http://www.w3.org/1999/xhtml"
    xmlns:ix="YOUR_ACTUAL_IX_NAMESPACE"
    xmlns:link="YOUR_ACTUAL_LINK_NAMESPACE"
    xmlns:xlink="http://www.w3.org/1999/xlink"
    exclude-result-prefixes="xsl xhtml ix link xlink">

    <!-- Identity transform to copy all content by default -->
    <xsl:template match="node()|@*">
        <xsl:copy>
            <xsl:apply-templates select="node()|@*"/>
        </xsl:copy>
    </xsl:template>

    <!-- Add link:schemaRef to the target ix:references node -->
    <xsl:template match="/xhtml:html/xhtml:body/xhtml:div[1]/ix:header/ix:hidden/ix:references">
        <xsl:copy>
            <xsl:copy-of select="@*" />
            <link:schemaRef xlink:type="simple" xlink:href="http://example.org"/>
            <xsl:apply-templates/>
        </xsl:copy>
    </xsl:template>

</xsl:stylesheet>

Make sure to replace YOUR_ACTUAL_IX_NAMESPACE and YOUR_ACTUAL_LINK_NAMESPACE with the real URIs from your input document, and verify the match path aligns with your XHTML structure. That should get your link:schemaRef element showing up correctly!

内容的提问来源于stack exchange，提问作者Toolbox