Versions Compared

Old Version 9

changes.mady.by.user Bob Swift

Saved on

compared with

New Version 10

changes.mady.by.user Bob Swift

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description

Excerpt

Transforms XML to a Confluence page via an XSLT style sheet.

Parameters

Table plus
ParameterDefault

...

Macro Browser LabelDescription
outputhtmlTransformed output format

Determines how the transformed output is

...

to be treated.

  • html -

...

  • transformed output is standard html
  • xhtml - transformed output is treated as xhtml and rendered with the Confluence xhtml renderer
  • wiki - transformed output is treated as wiki markup and rendered with the Confluence wiki renderer
sourcemacro bodyLocation of XML code

Required if style (XSLT code) is in macro body.

  • #filename - Data is read from the file located in confluence home directory/script/filename. Subdirectories can be

...

  • specified.
  • global page template name - Data is read from a global page template. Special note: How to deal with templates on Confluence 4.3 and later.
  • space:page template name - Data is read from a space template.
  • ^attachment - Data is read from an attachment to the current page.
  • page^attachment - Data is read from an attachment to the page name provided.
  • space:page^attachment - Data is read from an attachment to the page name provided in the space indicated.
style

...

required or

macro body if source is specified

Location of

...

XSLT code

...

Required if source XML is in the macro body, otherwise defaults to the macro body

...

  • #filename - Data is read from the file located in confluence home directory/script/filename. Subdirectories can be specified.

...

  • global page template name - Data is read from a global page template. Special note: How to deal with templates on Confluence 4.3 and later.
  • space:page template name - Data is read from a space template.
  • ^attachment - Data is read from an attachment to the current page.
  • page^attachment - Data is read from an attachment to the page name provided.
  • space:page^attachment - Data is read from an attachment to the page name provided in the space indicated.
find Find regex patterns

Comma separated list of regex patterns to use to post-process the output HTML with find and replace logic.

  • Example: (google\.dtd)
replace Replacement strings

Comma separated list corresponding to find patterns via index position in list. Single quote entries containing a comma.

  • Example: http://www.google.com/$1
headfalseInclude head section HTMLOnly in affect if clean=true. The head tag is always removed. However, setting this to true will retain all the other tags from the head section and treat them as regular body content. This is useful for retaining style information in particular.
showErrorsfalseShow error message panelXSLT transformer generated warning and errors will appear in a panel even if the transform is not terminated with an error. Terminating errors automatically generate an error panel.
encodingsystem defaultFile encodingEncoding for an external file if different from the system default handling. Example: UTF-8.
user URL user User name for URL access via basic authentication.
password URL user password User password for URL access via basic authentication. 
timeout Timeout in millisecondsURL connections may timeout before getting data. Use this to increase time needed for slow connections. Be careful using 0 for an infinite wait.
<transformer parameters>  Only available when specifying xslt macro via wiki markup. See this example.

Usage

No Format
{xslt:style=^cdcatalog.xsl}
<catalog>
<cd>
<title>Empire Burlesque</title>
<artist>Bob Dylan</artist>
<country>USA</country>
</cd>
<cd>
<title>Maggie May</title>
<artist>Rod Stewart</artist>
<country>UK</country>
</cd>
</catalog>
{xslt}

...

No Format
{xslt:source=xslt - basic^cdcatalog.xml|style=#http://www.w3schools.com/xsl/cdcatalog.xsl}
{xslt}

Anchor
transformerParameters
transformerParameters

Passing parameters to the XSLT engine

  • Parameters not interpreted by the xslt macro are passed through to xslt. You must use wiki macro syntax to take advantage of this.

  • The following example provided by Johan Nagels

    No Format
    {xslt:output=wiki|source=Home^snippets.xml|winnersOnly=lala}
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:param name="winnersOnly">no</xsl:param>
<xsl:output method="html"/>
<xsl:template match="/">
The value of winnersOnly is "<xsl:value-of select="$winnersOnly"/>"
</xsl:template>
</xsl:stylesheet>{xslt}

...