From 16a890af7de8fe55f7cafeb3200b47e6b41c3649 Mon Sep 17 00:00:00 2001 From: Shaun McCance Date: Fri, 16 Oct 2020 11:53:48 -0400 Subject: Some doc updates for text templates --- doc/yelp-xsl/C/html.css.core.page | 33 ++++---------------- doc/yelp-xsl/C/html.css.elements.page | 54 ++++----------------------------- doc/yelp-xsl/C/html.css.syntax.page | 36 ++++------------------ doc/yelp-xsl/C/html.page | 57 ++--------------------------------- doc/yelp-xsl/C/tmpl.file.page | 2 +- doc/yelp-xsl/C/tmpl.page | 2 +- doc/yelp-xsl/C/tmpl.text.page | 2 +- xslt/common/html.xsl | 12 ++++++++ xslt/common/tmpl.xsl | 6 ++-- 9 files changed, 39 insertions(+), 165 deletions(-) diff --git a/doc/yelp-xsl/C/html.css.core.page b/doc/yelp-xsl/C/html.css.core.page index 374ca1eb..fa25af26 100644 --- a/doc/yelp-xsl/C/html.css.core.page +++ b/doc/yelp-xsl/C/html.css.core.page @@ -33,34 +33,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.

- - Calls Parameters - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - Calls Templates @@ -72,5 +48,8 @@

+ +

+ diff --git a/doc/yelp-xsl/C/html.css.elements.page b/doc/yelp-xsl/C/html.css.elements.page index 8e2a48fd..4da538ff 100644 --- a/doc/yelp-xsl/C/html.css.elements.page +++ b/doc/yelp-xsl/C/html.css.elements.page @@ -33,55 +33,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.

- - Calls Parameters - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - Calls Templates @@ -96,5 +51,8 @@

+ +

+ diff --git a/doc/yelp-xsl/C/html.css.syntax.page b/doc/yelp-xsl/C/html.css.syntax.page index 1b95d85d..32cafba7 100644 --- a/doc/yelp-xsl/C/html.css.syntax.page +++ b/doc/yelp-xsl/C/html.css.syntax.page @@ -33,39 +33,12 @@ 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.

Calls Parameters - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

-

@@ -81,5 +54,8 @@

+ +

+ diff --git a/doc/yelp-xsl/C/html.page b/doc/yelp-xsl/C/html.page index 5edd6d26..b148fca8 100644 --- a/doc/yelp-xsl/C/html.page +++ b/doc/yelp-xsl/C/html.page @@ -33,66 +33,15 @@ Calls Parameters - -

- - -

- - -

-

- -

- - -

- - -

- - -

- - -

- - -

-

- -

- - -

- - -

- - -

- - -

- - -

-

- -

- - -

-

@@ -111,9 +60,6 @@

- -

- Calls Templates @@ -135,6 +81,9 @@

+ +

+ Calls Modes diff --git a/doc/yelp-xsl/C/tmpl.file.page b/doc/yelp-xsl/C/tmpl.file.page index 5d4179b7..8cfb8206 100644 --- a/doc/yelp-xsl/C/tmpl.file.page +++ b/doc/yelp-xsl/C/tmpl.file.page @@ -4,7 +4,7 @@ Perform text substitutions on a file. - + tmpl.file diff --git a/doc/yelp-xsl/C/tmpl.page b/doc/yelp-xsl/C/tmpl.page index 1715bc39..f0419a63 100644 --- a/doc/yelp-xsl/C/tmpl.page +++ b/doc/yelp-xsl/C/tmpl.page @@ -3,7 +3,7 @@ Perform simple substitutions in text files. - + Text Templates

This stylesheet contains templates to perform simple substitutions on text diff --git a/doc/yelp-xsl/C/tmpl.text.page b/doc/yelp-xsl/C/tmpl.text.page index 4f4f5901..375e9ece 100644 --- a/doc/yelp-xsl/C/tmpl.text.page +++ b/doc/yelp-xsl/C/tmpl.text.page @@ -4,7 +4,7 @@ Perform text substitutions on some text. - + tmpl.text 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. --> @@ -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. --> @@ -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. --> 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