summaryrefslogtreecommitdiffstats
path: root/docs-xml/xslt/latex
diff options
context:
space:
mode:
authorJelmer Vernooij <jelmer@samba.org>2009-05-01 20:51:43 +0200
committerJelmer Vernooij <jelmer@samba.org>2009-05-01 22:49:12 +0200
commit11b6c1137d1b0e7d37627831338ce21be2bee218 (patch)
tree793367a18a2594b10c20d901b151414fa010dd7a /docs-xml/xslt/latex
parent04071251b126b37203821cc3b29a81b1dade823e (diff)
downloadsamba-11b6c1137d1b0e7d37627831338ce21be2bee218.tar.gz
samba-11b6c1137d1b0e7d37627831338ce21be2bee218.tar.xz
samba-11b6c1137d1b0e7d37627831338ce21be2bee218.zip
Move expansion of Samba-specific XML elements out of xslt/latex.xsl into a
separate file, for better readability. xslt/latex.xsl now only contains tweaks to the dblatex configuration.
Diffstat (limited to 'docs-xml/xslt/latex')
-rw-r--r--docs-xml/xslt/latex/samba.xsl146
1 files changed, 146 insertions, 0 deletions
diff --git a/docs-xml/xslt/latex/samba.xsl b/docs-xml/xslt/latex/samba.xsl
new file mode 100644
index 0000000000..9fc27e6bbb
--- /dev/null
+++ b/docs-xml/xslt/latex/samba.xsl
@@ -0,0 +1,146 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+ Expand Samba-specific XML elements to LaTeX, for use with dblatex
+
+ Copyright (C) 2003,2004,2009 Jelmer Vernooij <jelmer@samba.org>
+ Published under the GNU GPLv3 or later
+-->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version='1.0'
+ xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+
+<!-- FIXME: dblatex should have some way to load additional packages, user.params.set2
+ isn't really meant for this sort of thing -->
+<xsl:template name="user.params.set2">
+ <xsl:text>\usepackage{samba}&#10;</xsl:text>
+</xsl:template>
+
+<xsl:template match="smbconfblock/smbconfoption">
+ <xsl:text> </xsl:text><xsl:value-of select="@name"/>
+ <xsl:if test="text() != ''">
+ <xsl:text> = </xsl:text>
+ <xsl:value-of select="text()"/>
+ </xsl:if>
+ <xsl:text>&#10;</xsl:text>
+</xsl:template>
+
+<xsl:template match="smbconfblock/smbconfcomment">
+ <xsl:text># </xsl:text>
+ <xsl:apply-templates/>
+ <xsl:text>&#10;</xsl:text>
+</xsl:template>
+
+<xsl:template match="smbconfblock/smbconfsection">
+ <xsl:value-of select="@name"/>
+ <xsl:text>&#10;</xsl:text>
+</xsl:template>
+
+<xsl:template match="smbconfoption">
+ <xsl:text>\smbconfoption{</xsl:text>
+ <xsl:call-template name="scape">
+ <xsl:with-param name="string" select="@name"/>
+ </xsl:call-template>
+ <xsl:text>}</xsl:text>
+
+ <xsl:choose>
+ <xsl:when test="text() != ''">
+ <xsl:text> = </xsl:text>
+ <xsl:call-template name="scape">
+ <xsl:with-param name="string" select="text()"/>
+ </xsl:call-template>
+ </xsl:when>
+ </xsl:choose>
+</xsl:template>
+
+<xsl:template match="smbconfblock">
+ <xsl:text>&#10;\begin{lstlisting}[language=smbconf,style=smbconfblock]&#10;</xsl:text>
+ <xsl:apply-templates/>
+ <xsl:text>\end{lstlisting}&#10;</xsl:text>
+</xsl:template>
+
+<xsl:template match="smbconfsection">
+ <xsl:text>\smbconfsection{</xsl:text>
+ <xsl:call-template name="scape">
+ <xsl:with-param name="string" select="@name"/>
+ </xsl:call-template>
+ <xsl:text>}</xsl:text>
+</xsl:template>
+
+
+<xsl:template match="description"><xsl:apply-templates/></xsl:template>
+
+<xsl:template match="value"><xsl:apply-templates/></xsl:template>
+
+<xsl:template match="synonym"><xsl:apply-templates/></xsl:template>
+
+<xsl:template match="related"><xsl:apply-templates/></xsl:template>
+
+<xsl:template match="//samba:parameterlist">
+ <xsl:text>\begin{description}&#10;</xsl:text>
+ <xsl:apply-templates>
+ <xsl:sort select="samba:parameter/@name"/>
+ </xsl:apply-templates>
+ <xsl:text>\end{description}&#10;</xsl:text>
+</xsl:template>
+
+<xsl:template match="value/comment">
+ <xsl:text>&#10;# </xsl:text>
+ <xsl:apply-templates/>
+</xsl:template>
+
+<xsl:template match="/">
+ <xsl:apply-templates/>
+</xsl:template>
+
+<xsl:template match="refentry">
+ <xsl:text>\section{</xsl:text><xsl:value-of select="refmeta/refentrytitle"/><xsl:text>}&#10;</xsl:text>
+ <xsl:apply-templates/>
+</xsl:template>
+
+<xsl:template match="//samba:parameter">
+ <xsl:for-each select="synonym">
+ <xsl:text>\item[{</xsl:text><xsl:value-of select="."/><xsl:text>}]\null{}&#10;</xsl:text>
+ <xsl:text>\index{</xsl:text><xsl:value-of select="."/><xsl:text>}&#10;</xsl:text>
+ <xsl:text>This parameter is a synonym for \smbconfoption{</xsl:text><xsl:value-of select="../@name"/><xsl:text>}.</xsl:text>
+ </xsl:for-each>
+
+ <xsl:text>\item[{</xsl:text><xsl:value-of select="@name"/>
+ <xsl:text> (</xsl:text>
+ <xsl:value-of select="@context"/>
+ <xsl:text>)</xsl:text>
+ <xsl:text>}]\null{}&#10;&#10;</xsl:text>
+ <xsl:text>\index{</xsl:text><xsl:value-of select="@name"/><xsl:text>}&#10;</xsl:text>
+
+ <!-- Print default value-->
+ <xsl:text>&#10;</xsl:text>
+ <xsl:text>Default: </xsl:text>
+ <xsl:text>\emph{</xsl:text>
+ <xsl:choose>
+ <xsl:when test="value[@type='default'] != ''">
+ <xsl:value-of select="@name"/>
+ <xsl:text> = </xsl:text>
+ <xsl:apply-templates select="value"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:text>No default</xsl:text>
+ </xsl:otherwise>
+ </xsl:choose>
+ <xsl:text>}</xsl:text>
+ <xsl:text>&#10;</xsl:text>
+
+ <!-- Generate list of examples -->
+ <xsl:text>&#10;</xsl:text>
+ <xsl:for-each select="value[@type='example']">
+ <xsl:text>&#10;</xsl:text>
+ <xsl:text>Example: </xsl:text>
+ <xsl:text>\emph{</xsl:text><xsl:value-of select="../@name"/>
+ <xsl:text> = </xsl:text>
+ <xsl:apply-templates select="."/>
+ <xsl:text>}</xsl:text>
+ <xsl:text>&#10;</xsl:text>
+ </xsl:for-each>
+
+ <!-- Description -->
+ <xsl:apply-templates select="description"/>
+</xsl:template>
+
+</xsl:stylesheet>