summaryrefslogtreecommitdiff
path: root/xslt
diff options
context:
space:
mode:
authorShaun McCance <shaunm@redhat.com>2020-10-16 11:53:48 -0400
committerShaun McCance <shaunm@redhat.com>2020-10-16 11:53:48 -0400
commit16a890af7de8fe55f7cafeb3200b47e6b41c3649 (patch)
treed24d2694b778b6d2118f8fb6228ec64004653166 /xslt
parentf26a7f86b10197d011f0084765564d332e19e14f (diff)
downloadyelp-xsl-16a890af7de8fe55f7cafeb3200b47e6b41c3649.tar.gz
Some doc updates for text templates
Diffstat (limited to 'xslt')
-rw-r--r--xslt/common/html.xsl12
-rw-r--r--xslt/common/tmpl.xsl6
2 files changed, 15 insertions, 3 deletions
diff --git a/xslt/common/html.xsl b/xslt/common/html.xsl
index 453d205c..17778344 100644
--- a/xslt/common/html.xsl
+++ b/xslt/common/html.xsl
@@ -1222,6 +1222,10 @@ common spacings for block-level elements like paragraphs and lists, defines
styles for links, and defines four common wrapper divs: `header`, `side`,
`body`, and `footer`.
+This template uses text templates to keep the actual CSS content in a
+separate file, `css/core.css.tmpl`, and do simple param substitutions.
+This makes it easier to update the CSS without working with XSLT.
+
All parameters can be automatically computed if not provided.
-->
<xsl:template name="html.css.core">
@@ -1266,6 +1270,10 @@ the simpler element names from Mallard, although there some class names which
are not taken from Mallard. Stylesheets which convert to HTML should use the
appropriate common classes.
+This template uses text templates to keep the actual CSS content in a
+separate file, `css/elements.css.tmpl`, and do simple param substitutions.
+This makes it easier to update the CSS without working with XSLT.
+
All parameters can be automatically computed if not provided.
-->
<xsl:template name="html.css.elements">
@@ -1377,6 +1385,10 @@ is broken up into chunks and wrapped in HTML elements with particular classes.
This template outputs CSS to match those elements and style them with the
built-in themeable colors from {color}.
+This template uses text templates to keep the actual CSS content in a
+separate file, `css/syntax.css.tmpl`, and do simple param substitutions.
+This makes it easier to update the CSS without working with XSLT.
+
All parameters can be automatically computed if not provided.
-->
<xsl:template name="html.css.syntax">
diff --git a/xslt/common/tmpl.xsl b/xslt/common/tmpl.xsl
index 4df8e1ed..c52a95cf 100644
--- a/xslt/common/tmpl.xsl
+++ b/xslt/common/tmpl.xsl
@@ -24,7 +24,7 @@ along with this program; see the file COPYING.LGPL. If not, see
<!--!!==========================================================================
Text Templates
Perform simple substitutions in text files.
-@revision[version=40 date=FIXME status=FIXME]
+@revision[version=40 date=2020-10-16 status=final]
This stylesheet contains templates to perform simple substitutions on text
and files containing text. The primary purpose of these templates is to allow
@@ -48,7 +48,7 @@ This stylesheet was added in version 40.
<!--**==========================================================================
tmpl.file
Perform text substitutions on a file.
-@revision[version=40 date=FIXME status=FIXME]
+@revision[version=40 date=2020-10-16 status=final]
[xsl:params]
$file: The filename of the file to process for substitutions.
@@ -100,7 +100,7 @@ This template was added in version 40.
<!--**==========================================================================
tmpl.text
Perform text substitutions on some text.
-@revision[version=40 date=FIXME status=FIXME]
+@revision[version=40 date=2020-10-16 status=final]
[xsl:params]
$text: The text to process for substitutions.