Calenco utilise la version 1.75.2 des feuilles de style DocBook. Les instructions fournies dans cette section sont valables pour tous les formats DocBook supportés par Calenco.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                xmlns:fo="http://www.w3.org/1999/XSL/Format"
                xmlns:xlink='http://www.w3.org/1999/xlink'
                xmlns:exsl="http://exslt.org/common"
                xmlns:date="http://exslt.org/dates-and-times"
                xmlns:db="http://docbook.org/ns/docbook"
                exclude-result-prefixes="xlink"
                version='1.0'>

<!-- Import standard -->
<xsl:import href="http://docbook.sourceforge.net/release/xsl-ns/current/fo/profile-docbook.xsl"/>

<?cco_xsltype addon="DocBook5.0" toolchain="DocBook_to_PDF_FOP"?>
<?cco_xsltype addon="DocBook5.0" toolchain="DocBook_to_RTF_FOP"?>
<?cco_xsltype addon="DocBook5.0" toolchain="DocBook_to_PS_FOP"?>

<!-- DocBook XSL Parameters -->
<xsl:param name="fop1.extensions" select="1"></xsl:param>

<xsl:param name="paper.type">A4</xsl:param>
</xsl:stylesheet>

Vous trouverez également des informations sur les sites dédiés à la personnalisation des feuilles de style DocBook suivants :

<?cco_xsltype addon="DocBook5.0" toolchain="DocBook_to_PDF_FOP"?>

<xsl:param name="admon.graphics" select="1"></xsl:param>
<xsl:param name="admon.graphics.path">http://docbook.sourceforge.net/release/xsl/current/images/</xsl:param>
<xsl:param name="admon.graphics.extension">.svg</xsl:param>

<?calenco-dep note.svg?>
                              
                                 
                              
<?calenco-dep caution.svg?>
<?calenco-dep important.svg?>
<?calenco-dep warning.svg?>
<?calenco-dep tip.svg?>
<xsl:param name="admon.graphics" select="1"></xsl:param>
<xsl:param name="admon.graphics.path"></xsl:param>
<xsl:param name="admon.graphics.extension">.svg</xsl:param>

Ces paramètres et variables sont valués par Calenco lors de la publication :

Par défaut, les inclusions d'un document sont toutes résolues avant une publication. Ce comportement peut être désactivé.

Exemple :

<?cco_tparam xincludes="false"?>

Par défaut, les références vers des fichiers externes sont téléchargées avant d'être intégrées dans le résultat de la publication. Ce comportement peut être désactivé.

Exemple :

<?cco_tparam download="false"?>

Le code MathML contenu dans un fichier peut être convertit en images qui peuvent être utilisées par le résultat de la publication.

Exemple :

<?cco_tparam convert.mathml="png"?>
<?cco_tparam convert.mathml.size="18"?>

La feuille de style doit se charger de la création des fichiers contenant le code MathML pour chaque équation. Exemple :

<xsl:param name="extract.mathml.ext" />
<xsl:param name="convert.mathml.ext" />

<xsl:template name="extract.mathml">
  <xsl:if test="$convert.mathml.ext != ''">
    <xsl:for-each select="$profiled-nodes//mml:math">
      <xsl:variable name="fname" select="concat(generate-id(), $extract.mathml.ext)" />
      <xsl:variable name="href" select="$fname" />
      
      <saxon:output href="{$base.dir}{$href}" method="xml" indent="no"
                    doctype-public="-//W3C//DTD MathML 2.0//EN"
                    doctype-system="http://www.w3.org/TR/MathML2/dtd/mathml2.dtd">
        <xsl:copy-of select="." />
      </saxon:output>
    </xsl:for-each>
  </xsl:if>
</xsl:template>

<xsl:template match="mml:math">
  <xsl:choose>
    <xsl:when test="$convert.mathml.ext != ''">
      <img src="{concat(generate-id(), $convert.mathml.ext)}" 
           alt="(MathML)"
           class="mathml"/>
    </xsl:when>
    <xsl:otherwise>
      <xsl:element name="{local-name()}" namespace="http://www.w3.org/1998/Math/MathML">
        <xsl:copy-of select="@*"/>
        <xsl:apply-templates/>
      </xsl:element>
    </xsl:otherwise>
  </xsl:choose>
</xsl:template>

<xsl:template match="mml:*">
  <xsl:element name="{local-name()}" namespace="http://www.w3.org/1998/Math/MathML">
    <xsl:copy-of select="@*"/>
    <xsl:apply-templates/>
  </xsl:element>
</xsl:template>

La taille en pixels des images ainsi que leur qualité peuvent être contrôlées par ces paramètres.

Exemple :

<?cco_tparam images.maxsize="1024"?>
<?cco_tparam images.quality="0.6"?>

La feuille de style peut générer des fichiers JSON contenant des données destinées à être transformés en graphiques.

Exemple :

<?cco_tparam generate.plots="1"?>

La feuille de style doit se charger de la création des fichiers JSON contenants les données. Exemple (PDF) :

<xsl:param name="base.dir"/><!-- Temporary folder for the publication. -->

<xsl:template match="*[@tabstyle = 'histogram']">
  <xsl:variable name="id">
    <xsl:text>diagram_</xsl:text>
    <xsl:number level="any" count="*[d:tgroup]"/>
  </xsl:variable>
    
  <saxon:output href="{$base.dir}plot/{$id}.json" method="text">
    <!-- JSON Data -->
  </saxon:output>

  <fo:block text-align="center" xsl:use-attribute-sets="normal.para.spacing">
    <fo:external-graphic src="file:{$base.dir}plot/{$id}.png"
                         width="75%"
                         content-width="scale-down-to-fit"/>
  </fo:block>
</xsl:template>

Exemple (HTML) :

<xsl:template match="*[@tabstyle = 'histogram']">
  <xsl:variable name="id">
    <xsl:text>diagram_</xsl:text>
    <xsl:number level="any" count="*[d:tgroup]"/>
  </xsl:variable>
    
  <saxon:output href="{$base.dir}../plot/{$id}.json" method="text" encoding="UTF-8">
    <!-- JSON Data -->
  </saxon:output>

  <div class="diagram">
    <img src="file:{$base.dir}../plot/{$id}.png"/>
  </div>
</xsl:template>

Le dossier contenant les fichiers JSON doit obligatoirement être nommé "plot" et doit être dans le répertoire temporaire de la publication (le dossier parent pour du HTML).

Dans la sortie HTML, la valeur de l'attribut src sera remplacé par une référence relative.

{
    "title": "Titre",
    "background": "#ffffff",
    "width": 1024,
    "height": 768,
    "barset": [
        {
            "color": "#00a5cd",
            "title": "Volume distribué",
            "data": [
                {
                    "x": 2017,
                    "y": 309695
                },
                {
                    "x": 2018,
                    "y": 288623
                }
            ]
        },
        {
            "color": "#7cd2e6",
            "title": "Volume consommé",
            "data": [
                {
                    "x": 2017,
                    "y": 260211
                },
                {
                    "x": 2018,
                    "y": 238583
                }
            ]
        }
    ],
    "curveset": [
        {
            "color": "#ff0000",
            "title": "Rendement",
            "data": [
                {
                    "x": 2017,
                    "y": 84.02
                },
                {
                    "x": 2018,
                    "y": 82.66
                }
            ]
        }
    ]
}

Les chaînes de transformation pour les formats "traitement de texte" convertissent les images vectorielles SVG en bitmap.

Exemple :

<?cco_tparam svg.convert.dpi="96"?>

La valeur par défaut est "127".

Exemple :

<?cco_tparam rev="1.2"?>
<?cco_tparam against.rev="1.8"?>

Exemple :

<?cco_tparam intermediate="if-massage.xsl"?>

Exemple :

<?cco_tparam diff="if-diff.xsl"?>

Exemple :

<!--
    Where to find the list of the modified files?
    
    This will be used by the toolchain to call the "injectDiff" stylesheet
    (see below) on each modified file.
-->
<?cco_tparam injectFilesPath="//*[@xml:id = 'modifications']/db:tgroup/db:tbody/db:row/db:entry[4]"?>

<!--
    Inject the revision date for each modified page.
-->
<?cco_tparam injectDiff="inject-diff.xsl"?>

Pour personnaliser le format de sortie, importez la feuille de style par défaut dans votre propre feuille de style :

<xsl:import href="http://www.calenco.com/xsl/docbook/ns/fo/calenco-fo.xsl" />

Cette feuille de style par défaut importe la feuille de style XSL DocBook standard : http://docbook.sourceforge.net/release/xsl-ns/current/fo/profile-docbook.xsl. Toutes les options et paramètres de la feuille de style XSL DocBook standard sont disponibles dans votre propre feuille de style personnalisée. Pour les paramètres additionnels.

Les feuilles de style professionnelles par défaut sont disponibles pour les formats suivants :

<xsl:import href="http://www.calenco.com/xsl/docbook/ns/webhelp/calenco-webhelp.xsl" />