DocBook documentation stub added

[stg.git] / doc / help / xslt / highlighting / common.xsl

diff --git a/doc/help/xslt/highlighting/common.xsl b/doc/help/xslt/highlighting/common.xsl
new file mode 100644 (file)
index 0000000..e9b5650
--- /dev/null
+++ b/doc/help/xslt/highlighting/common.xsl
@@ -0,0 +1,120 @@
+<?xml version='1.0'?>\r
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+\r
+               xmlns:s6hl="http://net.sf.xslthl/ConnectorSaxon6" \r
+               xmlns:sbhl="http://net.sf.xslthl/ConnectorSaxonB" \r
+               xmlns:xhl="http://net.sf.xslthl/ConnectorXalan"\r
+               xmlns:saxon6="http://icl.com/saxon" \r
+               xmlns:saxonb="http://saxon.sf.net/" \r
+               xmlns:xalan="http://xml.apache.org/xalan"\r
+               \r
+               xmlns:exsl="http://exslt.org/common"\r
+               xmlns:xslthl="http://xslthl.sf.net"\r
+               exclude-result-prefixes="exsl xslthl s6hl sbhl xhl"\r
+               version='1.0'>\r
+\r
+<!-- ********************************************************************\r
+     $Id: common.xsl 8257 2009-02-20 04:40:16Z abdelazer $\r
+     ********************************************************************\r
+\r
+     This file is part of the XSL DocBook Stylesheet distribution.\r
+     See ../README or http://docbook.sf.net/release/xsl/current/ for\r
+     and other information.\r
+\r
+     ******************************************************************** -->\r
+\r
+<!-- this construction is needed to have the saxon and xalan connectors working alongside each other -->\r
+<xalan:component prefix="xhl" functions="highlight"> \r
+  <xalan:script lang="javaclass" src="xalan://net.sf.xslthl.ConnectorXalan" /> \r
+</xalan:component> \r
+\r
+<!-- for saxon 6 -->\r
+<saxon6:script implements-prefix="s6hl" language="java" src="java:net.sf.xslthl.ConnectorSaxon6" />\r
+\r
+<!-- for saxon 8.5 and later -->\r
+<saxonb:script implements-prefix="sbhl" language="java" src="java:net.sf.xslthl.ConnectorSaxonB" />\r
+\r
+\r
+<!-- You can override this template to do more complex mapping of\r
+     language attribute to highlighter language ID (see xslthl-config.xml) -->\r
+<xsl:template name="language.to.xslthl">\r
+  <xsl:param name="context"/>\r
+\r
+  <xsl:choose>\r
+    <xsl:when test="$context/@language != ''">\r
+      <xsl:value-of select="$context/@language"/>\r
+    </xsl:when>\r
+    <xsl:when test="$highlight.default.language != ''">\r
+      <xsl:value-of select="$highlight.default.language"/>\r
+    </xsl:when>\r
+  </xsl:choose>\r
+</xsl:template>\r
+\r
+<xsl:template name="apply-highlighting">\r
+  <xsl:choose>\r
+    <!-- Do we want syntax highlighting -->\r
+    <xsl:when test="$highlight.source != 0">\r
+      <xsl:variable name="language">\r
+       <xsl:call-template name="language.to.xslthl">\r
+         <xsl:with-param name="context" select="."/>\r
+       </xsl:call-template>\r
+      </xsl:variable>\r
+      <xsl:choose>\r
+       <xsl:when test="$language != ''">\r
+         <xsl:variable name="content">\r
+           <xsl:apply-templates/>\r
+         </xsl:variable>\r
+         <xsl:choose>\r
+           <xsl:when test="function-available('s6hl:highlight')">\r
+             <xsl:apply-templates select="s6hl:highlight($language, exsl:node-set($content), $highlight.xslthl.config)"\r
+                                  mode="xslthl"/>\r
+           </xsl:when>\r
+           <xsl:when test="function-available('sbhl:highlight')">\r
+             <xsl:apply-templates select="sbhl:highlight($language, exsl:node-set($content), $highlight.xslthl.config)"\r
+                                  mode="xslthl"/>\r
+           </xsl:when>\r
+           <xsl:when test="function-available('xhl:highlight')">\r
+             <xsl:apply-templates select="xhl:highlight($language, exsl:node-set($content), $highlight.xslthl.config)"\r
+                                  mode="xslthl"/>\r
+           </xsl:when>\r
+           <xsl:otherwise>\r
+             <xsl:copy-of select="$content"/>\r
+           </xsl:otherwise>\r
+         </xsl:choose>\r
+       </xsl:when>\r
+       <xsl:otherwise>\r
+         <xsl:apply-templates/>\r
+       </xsl:otherwise>\r
+      </xsl:choose>\r
+    </xsl:when>\r
+    <!-- No syntax highlighting -->\r
+    <xsl:otherwise>\r
+      <xsl:apply-templates/>\r
+    </xsl:otherwise>\r
+  </xsl:choose>\r
+</xsl:template>\r
+\r
+<!-- A fallback when the specific style isn't recognized -->\r
+<xsl:template match="xslthl:*" mode="xslthl">\r
+  <xsl:message>\r
+    <xsl:text>unprocessed xslthl style: </xsl:text>\r
+    <xsl:value-of select="local-name(.)" />\r
+  </xsl:message>\r
+  <xsl:apply-templates mode="xslthl"/>\r
+</xsl:template>\r
+\r
+<!-- Copy over already produced markup (FO/HTML) -->\r
+<xsl:template match="node()" mode="xslthl" priority="-1">\r
+  <xsl:copy>\r
+    <xsl:apply-templates select="node()" mode="xslthl"/>\r
+  </xsl:copy>\r
+</xsl:template>\r
+\r
+<xsl:template match="*" mode="xslthl">\r
+  <xsl:copy>\r
+    <xsl:copy-of select="@*"/>\r
+    <xsl:apply-templates select="node()" mode="xslthl"/>\r
+  </xsl:copy>\r
+</xsl:template>\r
+\r
+</xsl:stylesheet>\r