====== xslt Plugin ======

---- plugin ----
description: Allows you to display in DokuWiki the result of a XSL transformation
author     : Rémi Peyronnet
email      : remi+dokuwiki@via.ecp.fr
type       : syntax
lastupdate : 2016-02-07
compatible : Lemming, Anteater, Rincewind, Angua, Adora Belle, Weatherwax, Binky, Ponder Stibbons, Hrun, Detritus, Elenor of Tsort, Frusterick Manners, Greebo
depends    : 
conflicts  : 
similar    : 
tags       : formatting, xml

downloadurl: https://github.com/rpeyron/plugin-xslt/archive/master.zip
bugtracker:  https://github.com/rpeyron/plugin-xslt/issues
sourcerepo:  https://github.com/rpeyron/plugin-xslt
----

===== Download and Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

Your DokuWiki installation must run on PHP5 or later and have **xsl module** installed.

===== Usage =====

To use XSLT transformation, you will need to use ''&&XML&&'', ''&&XSLT&&'' and ''&&END&&'' tags. Theses tags must have line separators before and after them. The XML file is located between ''&&XML&&'' and ''&&XSLT&&'', and the xslt to use is between ''&&XSLT&&'' and ''&&END&&''. Easy enough, no?

<code xml>
&&XML&&

<xml>
<book>Book 1</book>
<book>Book 2</book>
</xml>

&&XSLT&&

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns="http://www.w3.org/TR/REC-html40">
<xsl:template match="/">List of books : <ul><xsl:apply-templates /></ul></xsl:template>
<xsl:template match="book"><li><b><xsl:apply-templates /></b></li></xsl:template>
</xsl:stylesheet>

&&END&&
</code>

This will display as:

<code>
List of books :
  * Book 1
  * Book 2
</code>