• made xdoc:head/@version optional
  • added xdoc:head/@revised instead of xdoc:head/xdoc:revised (also optional)
  • if xdoc:head has no @version or @revised, use xdoc:head/xdoc:history/xdoc:revision[1]
  • added @author to xdoc:revision (linked to xdoc:author/@id via key)
  • TOC heading shows number of templates
  • new e-mail (anton@cking.be)
  • new namespace (http://cking.be/xdoc)
  • added mode="get-class"
  • added mode="doc-output"
  • added xdoc:history
  • reordered templates: first xsl, then xdoc
  • first public beta

this stylesheet generates XHTML documentation about another stylesheet

(and, as you can see, it can even generate documentation about itself)

Instructions...

output as XHTML 1.0 Strict

global variables

keys

xsl templates

/xsl:* root element (typically xsl:stylesheet or xsl:transform)

 <xsl:value-of select="$title"/>

link to xdoc.css stylesheet (must use absolute path URL to enable CSS on any input file)

process xdoc:head element (assume there's only one such in the input document)

called with mode="head" so we can filter it out later

generate TOC (list of all templates)

templates

build opening tag for root element

<>

process all children

add empty heading and close root element

 

</>

revision history

add footer with xdoc link

generate TOC
  • template

    • process any element

    calculate indent-size for this line (in pixels; will be passed to CSS in style attribute)

    is this an xsl element? if not, assume it's html

    if this is 'xsl:output' with more than 2 attributes, display all attributes on a separate line

    if this node only contains text, no other children, display text on one line, together with its enclosing element

    build opening tag (with name and all attributes, but no <> braces yet)

     /

    if the element's name is 'xsl:template', insert h2 heading

    display element (<> braces are added here)

    < >

    />

    process children recursively and close

    get class: elem-xsl or elem-html

     elem-xsl elem-html

    build closing tag

    </ >

    process comment node

    only if there's an ancestor (don't display comments at root level)

    <!-- -->

    process text node

    <xsl:text></xsl:text>

    process text node on one line (called for text nodes that have no siblings)

    close element

     </ >

    display attribute in the format of name="value"

     =" "

    display attribute on a new line (used by xsl:output template)

    add 2 extra indents

    exclude xsl:fallback elements from output

    xdoc templates

    process xdoc:head element and its contents

    display revision history from xdoc:head

    do nothing (already handled in mode="head")

    Author:

    [ ]

    Revision history

    Revision history:

    version date description author

    Version:

    Revised:

    process xdoc:doc element

    calculate indent-size for this line (in pixels; will be passed to CSS in style attribute)

    note that Mozilla does not display the style attribute values (cfr testcase)

    process xdoc:doc element inside xdoc:head

    output xdoc:doc element

    if there's an id attribute, use it in an anchor

    copy the contents of this element to the result tree

    display footer with xdoc link