xsl-list
[Top] [All Lists]

RE: [xsl] numbering question

2008-12-23 05:33:53

The xsl:number instruction generates a number that depends on the position
of the current node in the input document. Although you typically want
numbers attached to nodes in the result tree, you are actually computing
numbers in relation to the source tree. If you have multiple source trees,
you can't get a single numbering sequence except by doing a two-phase
transformation - first generate a tree with the structure of the output,
then transform it to add the numbers.

Michael Kay
http://www.saxonica.com/  

-----Original Message-----
From: Trevor Nicholls [mailto:trevor(_at_)castingthevoid(_dot_)com] 
Sent: 23 December 2008 10:25
To: xsl-list(_at_)lists(_dot_)mulberrytech(_dot_)com
Subject: [xsl] numbering question

Hello all

I am getting results I don't understand when I try to number 
sections in my document.

My input documents are created by amalgamating various 
subdocuments - this structure is reflected by the <included 
srcfile=""> elements in the sample document which follows.
My output documents are also split into subfiles, and these 
splits are reflected in the output of the sample XSL 
stylesheet which also follows. 

Probably I misunderstand how xsl:number works, but there are 
two features of my sample output which surprise me; in one 
case it works to my advantage and in the other case it doesn't.

A) Why does the numbering restart within each output subfile, 
i.e. why do the myself2, myself3 and myself4 files all give 
their first section the number "1.1"? (I'm actually quite 
pleased that they do this, because it's exactly the result I 
wanted, but I don't understand why.)

B) Why are the generated numbers in the fourth output 
document not unique, i.e. why are the "Introduction" and 
"Examples" sections both numbered "1.1.1"? (In this case I 
don't want this happening, because duplicated section numbers 
are BAD and I get duplicate key errors further down the
track.)

Can somebody please explain to me why this numbering is happening?

Thanks in advance,
Trevor

 
Sample XML:
===========

  <?xml version="1.0" encoding="UTF-8"?>
  <document>
    <title>Top level introduction</title>
    <included srcfile="introduction.xml">
      <document>
        <title>Second level introduction</title>
        <section>
          <title>Section introduction</title>
          <para>text</para>
        </section>
        <section>
          <title>About</title>
          <para>text</para>
          <section>
            <title>New</title>
            <para>text</para>
          </section>
          <section>
            <title>Old</title>
            <para>text</para>
          </section>
        </section>
        <section>
          <title>Help</title>
          <para>text</para>
        </section>
        <section>
          <title>Conventions</title>
          <para>text</para>
        </section>
      </document>
    </included>
    <included srcfile="starting.xml">
      <document>
        <title>Starting</title>
        <para>text</para>
        <section>
          <title>Before you start</title>
          <para>text</para>
        </section>
        <section>
          <title>One way</title>
          <para>text</para>
        </section>
        <section>
          <title>Another way</title>
          <para>text</para>
        </section>
      </document>
    </included>
    <included secfile="basics.xml">
      <document>
        <title>Basics</title>
        <included srcfile="basics_first.xml">
          <section>
            <title>Introduction</title>
            <para>text</para>
          </section>
        </included>
        <included secfile="basics_second.xml">
          <section>
            <title>Examples</title>
            <para>text</para>
          </section>
        </included>
        <included srcfile="basics_third.xml">
          <title>Resources</title>
          <para>text</para>
        </included>
      </document>
    </included>
  </document>

Sample XSL:
===========

  <?xml version="1.0" encoding="UTF-8"?>
  <xsl:stylesheet version="2.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
xmlns:xs="http://www.w3.org/2001/XMLSchema"; 
exclude-result-prefixes="xs">
  <xsl:output method="text" />

  <xsl:param name="myself" select="'myself'" />

  <xsl:variable name="subfilecnt" select="count(//document)" />

  <xsl:template match="/">
    <xsl:apply-templates />
  </xsl:template>

  <xsl:template match="document">
    <xsl:call-template name="subfilename" />
    <xsl:text>&#xa;</xsl:text>
    <xsl:call-template name="num-gen" />
    <xsl:apply-templates />
  </xsl:template>

  <xsl:template match="section">
    <xsl:call-template name="num-gen" />
    <xsl:apply-templates />
  </xsl:template>

  <xsl:template name="num-gen">
    <xsl:text>  </xsl:text>
    <xsl:number count="document | section" level="multiple" />
    <xsl:value-of select="concat(' - ',title)" />
    <xsl:text>&#xa;</xsl:text>
  </xsl:template>

  <xsl:template match="text()" />

  <xsl:template name="containing-doc">
    <xsl:apply-templates select="." mode="containing-doc" />
  </xsl:template>

  <xsl:template match="*" mode="containing-doc">
    <xsl:choose>
      <xsl:when test="self::document">
        <xsl:for-each select="title">
          <xsl:call-template name="subfilename" />
        </xsl:for-each>
      </xsl:when>
      <xsl:otherwise>
        <xsl:apply-templates select=".." mode="containing-doc" />
      </xsl:otherwise>
    </xsl:choose>
  </xsl:template>

  <!-- return the output filename -->
  <xsl:template name="subfilename">
    <xsl:value-of select="$myself" />
    <xsl:call-template name="subfilenum" />
  </xsl:template>

  <!-- return the output file number -->
  <xsl:template name="subfilenum">
    <xsl:call-template name="padfilenum">
      <xsl:with-param name="num">
        <xsl:number count="document" level="any" />
      </xsl:with-param>
    </xsl:call-template>
  </xsl:template>

  <!-- return num padded to the correct size -->
  <xsl:template name="padfilenum">
    <xsl:param name="num" />
    <xsl:choose>
      <xsl:when test="$subfilecnt > 999"><xsl:number value="$num"
format="0001" /></xsl:when>
      <xsl:when test="$subfilecnt > 99"><xsl:number value="$num"
format="001" /></xsl:when>
      <xsl:when test="$subfilecnt > 9"><xsl:number 
value="$num" format="01"
/></xsl:when>
      <xsl:otherwise><xsl:number value="$num" format="1" 
/></xsl:otherwise>
    </xsl:choose>
  </xsl:template>

  </xsl:stylesheet>

The output I get:
=================

  myself1
    1 - Top level introduction
  myself2
    1.1 - Second level introduction
    1.1.1 - Section introduction
    1.1.2 - About
    1.1.2.1 - New
    1.1.2.2 - Old
    1.1.3 - Help
    1.1.4 - Conventions
  myself3
    1.1 - Starting
    1.1.1 - Before you start
    1.1.2 - One way
    1.1.3 - Another way
  myself4
    1.1 - Basics
    1.1.1 - Introduction
    1.1.1 - Examples



--~------------------------------------------------------------------
XSL-List info and archive:  http://www.mulberrytech.com/xsl/xsl-list
To unsubscribe, go to: http://lists.mulberrytech.com/xsl-list/
or e-mail: 
<mailto:xsl-list-unsubscribe(_at_)lists(_dot_)mulberrytech(_dot_)com>
--~--



--~------------------------------------------------------------------
XSL-List info and archive:  http://www.mulberrytech.com/xsl/xsl-list
To unsubscribe, go to: http://lists.mulberrytech.com/xsl-list/
or e-mail: <mailto:xsl-list-unsubscribe(_at_)lists(_dot_)mulberrytech(_dot_)com>
--~--

<Prev in Thread] Current Thread [Next in Thread>