@pretextbook/pretext-html 0.1.0 → 0.2.0

package/assets/xsl/utilities/pretext-enhanced-source.xsl

@@ -1,112 +1,112 @@
-<?xml version='1.0'?>
-
-<!--********************************************************************
-Copyright 2020 Robert A. Beezer
-
-This file is part of PreTeXt.
-
-PreTeXt is free software: you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation, either version 2 or version 3 of the
-License (at your option).
-
-PreTeXt is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
-*********************************************************************-->
-
-<xsl:stylesheet
-    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
-    xmlns:xml="http://www.w3.org/XML/1998/namespace"
->
-
-<!-- This stylesheet should behave, without any errors, without    -->
-<!-- importing the "pretext-common.xsl" stylesheet.  Typically,    -->
-<!-- in other uses of the two stylesheets above, we import         -->
-<!-- "pretext-common.xsl" as well, which will include many         -->
-<!-- "strip-space" directives, which will impact the assembled     -->
-<!-- source (without any real harm, though, just different).       -->
-<!-- In other words, the two (symbiotic) stylesheets used here     -->
-<!-- should remain independent of the -common stylesheet.          -->
-<!--                                                               -->
-<!-- The "publisher-variables.xsl" and "pretext-assembly.xsl"      -->
-<!-- stylesheets are symbiotic, and should be imported             -->
-<!-- simultaneously.  Assembly will change the source in various   -->
-<!-- ways, while some defaults for publisher variables will depend -->
-<!-- on source.  The default variables should depend on gross      -->
-<!-- structure and adjustments should be to smaller portions of    -->
-<!-- the source, but we don't take any chances.  So, note in       -->
-<!-- "assembly" that an intermediate tree is defined as a          -->
-<!-- variable, which is then used in defining some variables,      -->
-<!-- based on assembled source.  Conversely, certain variables,    -->
-<!-- such as locations of customizations or private solutions,     -->
-<!-- are needed early in assembly, while other variables, such     -->
-<!-- as options for numbering, are needed for later enhancements   -->
-<!-- to the source.  If new code results in undefine, or           -->
-<!-- recursively defined, variables, this discussion may be        -->
-<!-- relevant.  (This is repeated verbatim in the other            -->
-<!-- stylesheet).                                                  -->
-
-<xsl:import href="../publisher-variables.xsl"/>
-<xsl:import href="../pretext-assembly.xsl"/>
-
-<!-- Every conversion that imports "pretext-assembly.xsl"        -->
-<!-- also imports "pretext-common.xsl".  So we do likewise here, -->
-<!-- which brings in whitespace control via "strip-space" and    -->
-<!-- templates (like "type-name") that assembly-time processing  -->
-<!-- may depend on.                                              -->
-
-<xsl:import href="../pretext-common.xsl"/>
-
-<xsl:output method="xml" indent="yes" encoding="UTF-8"/>
-
-<!-- The "pretext-assembly.xsl" stylesheet is parameterized by a   -->
-<!-- *variable* for what types of exercises to create - mostly     -->
-<!-- static, but for HTML, interactive (dynamic).  In this way     -->
-<!-- importing stylesheets can set and override the variable as    -->
-<!-- necessary, but it is a bit harder to set via string parameters-->
-<!-- in the usual ways.  But for this utility, we want to run both -->
-<!-- modes.  So we *do* have a parameter here, and it just becomes -->
-<!-- the value of the variable, as just described.  Default if not -->
-<!-- set is "static", the alternative is "dynamic".                -->
-
-<xsl:param name="debug.assembly.exercise" select="'static'"/>
-<xsl:variable name="exercise-style">
-    <xsl:value-of select="$debug.assembly.exercise"/>
-</xsl:variable>
-
-<!-- ############## -->
-<!-- Entry Template -->
-<!-- ############## -->
-
-<!-- $root points to intermediate enhanced source created        -->
-<!-- in the "pretext-assembly.xsl" stylesheet, so study that     -->
-<!-- stylesheet to understand what it is being displayed.        -->
-<!-- This stylesheet will be affected by whatever parameters     -->
-<!-- and auxiliary files that the assembly stylesheet reacts to. -->
-
-<xsl:template match="/">
-    <xsl:choose>
-        <xsl:when test="$b-version-only">
-            <xsl:apply-templates select="$version" mode="showme"/>
-        </xsl:when>
-        <xsl:when test="$b-assembly-id-only">
-            <xsl:apply-templates select="$assembly-label" mode="showme"/>
-        </xsl:when>
-        <xsl:otherwise>
-            <xsl:apply-templates select="$root" mode="showme"/>
-        </xsl:otherwise>
-    </xsl:choose>
-</xsl:template>
-
-<xsl:template match="node()|@*" mode="showme">
-    <xsl:copy>
-        <xsl:apply-templates select="node()|@*" mode="showme"/>
-    </xsl:copy>
-</xsl:template>
-
-</xsl:stylesheet>
+<?xml version='1.0'?>
+
+<!--********************************************************************
+Copyright 2020 Robert A. Beezer
+
+This file is part of PreTeXt.
+
+PreTeXt is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 or version 3 of the
+License (at your option).
+
+PreTeXt is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
+*********************************************************************-->
+
+<xsl:stylesheet
+    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
+    xmlns:xml="http://www.w3.org/XML/1998/namespace"
+>
+
+<!-- This stylesheet should behave, without any errors, without    -->
+<!-- importing the "pretext-common.xsl" stylesheet.  Typically,    -->
+<!-- in other uses of the two stylesheets above, we import         -->
+<!-- "pretext-common.xsl" as well, which will include many         -->
+<!-- "strip-space" directives, which will impact the assembled     -->
+<!-- source (without any real harm, though, just different).       -->
+<!-- In other words, the two (symbiotic) stylesheets used here     -->
+<!-- should remain independent of the -common stylesheet.          -->
+<!--                                                               -->
+<!-- The "publisher-variables.xsl" and "pretext-assembly.xsl"      -->
+<!-- stylesheets are symbiotic, and should be imported             -->
+<!-- simultaneously.  Assembly will change the source in various   -->
+<!-- ways, while some defaults for publisher variables will depend -->
+<!-- on source.  The default variables should depend on gross      -->
+<!-- structure and adjustments should be to smaller portions of    -->
+<!-- the source, but we don't take any chances.  So, note in       -->
+<!-- "assembly" that an intermediate tree is defined as a          -->
+<!-- variable, which is then used in defining some variables,      -->
+<!-- based on assembled source.  Conversely, certain variables,    -->
+<!-- such as locations of customizations or private solutions,     -->
+<!-- are needed early in assembly, while other variables, such     -->
+<!-- as options for numbering, are needed for later enhancements   -->
+<!-- to the source.  If new code results in undefine, or           -->
+<!-- recursively defined, variables, this discussion may be        -->
+<!-- relevant.  (This is repeated verbatim in the other            -->
+<!-- stylesheet).                                                  -->
+
+<xsl:import href="../publisher-variables.xsl"/>
+<xsl:import href="../pretext-assembly.xsl"/>
+
+<!-- Every conversion that imports "pretext-assembly.xsl"        -->
+<!-- also imports "pretext-common.xsl".  So we do likewise here, -->
+<!-- which brings in whitespace control via "strip-space" and    -->
+<!-- templates (like "type-name") that assembly-time processing  -->
+<!-- may depend on.                                              -->
+
+<xsl:import href="../pretext-common.xsl"/>
+
+<xsl:output method="xml" indent="yes" encoding="UTF-8"/>
+
+<!-- The "pretext-assembly.xsl" stylesheet is parameterized by a   -->
+<!-- *variable* for what types of exercises to create - mostly     -->
+<!-- static, but for HTML, interactive (dynamic).  In this way     -->
+<!-- importing stylesheets can set and override the variable as    -->
+<!-- necessary, but it is a bit harder to set via string parameters-->
+<!-- in the usual ways.  But for this utility, we want to run both -->
+<!-- modes.  So we *do* have a parameter here, and it just becomes -->
+<!-- the value of the variable, as just described.  Default if not -->
+<!-- set is "static", the alternative is "dynamic".                -->
+
+<xsl:param name="debug.assembly.exercise" select="'static'"/>
+<xsl:variable name="exercise-style">
+    <xsl:value-of select="$debug.assembly.exercise"/>
+</xsl:variable>
+
+<!-- ############## -->
+<!-- Entry Template -->
+<!-- ############## -->
+
+<!-- $root points to intermediate enhanced source created        -->
+<!-- in the "pretext-assembly.xsl" stylesheet, so study that     -->
+<!-- stylesheet to understand what it is being displayed.        -->
+<!-- This stylesheet will be affected by whatever parameters     -->
+<!-- and auxiliary files that the assembly stylesheet reacts to. -->
+
+<xsl:template match="/">
+    <xsl:choose>
+        <xsl:when test="$b-version-only">
+            <xsl:apply-templates select="$version" mode="showme"/>
+        </xsl:when>
+        <xsl:when test="$b-assembly-id-only">
+            <xsl:apply-templates select="$assembly-label" mode="showme"/>
+        </xsl:when>
+        <xsl:otherwise>
+            <xsl:apply-templates select="$root" mode="showme"/>
+        </xsl:otherwise>
+    </xsl:choose>
+</xsl:template>
+
+<xsl:template match="node()|@*" mode="showme">
+    <xsl:copy>
+        <xsl:apply-templates select="node()|@*" mode="showme"/>
+    </xsl:copy>
+</xsl:template>
+
+</xsl:stylesheet>

package/assets/xsl/utilities/report-publisher-variables.xsl

@@ -1,162 +1,162 @@
-<?xml version='1.0'?> <!-- As XML file -->
-
-<!--********************************************************************
-Copyright 2013 Robert A. Beezer
-
-This file is part of MathBook XML.
-
-MathBook XML is free software: you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation, either version 2 or version 3 of the
-License (at your option).
-
-MathBook XML is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
-*********************************************************************-->
-
-<!-- http://pimpmyxslt.com/articles/entity-tricks-part2/ -->
-<!DOCTYPE xsl:stylesheet [
-    <!ENTITY % entities SYSTEM "../entities.ent">
-    %entities;
-]>
-
-<!-- Identify as a stylesheet -->
-<!-- We choose to not include a default namespace       -->
-<!-- (in particular  http://www.w3.org/1999/xhtml),     -->
-<!-- even if this complicates adding namespaces onto    -->
-<!-- derivatives, such as HTML destined for EPUB output -->
-<!-- xmlns="http://www.w3.org/1999/xhtml"               -->
-<!--                                                    -->
-<!-- NB:                                                -->
-<!--   "xsl" is necessary to identify XSL functionality -->
-<!--   "xml" is automatic, hence redundant              -->
-<!--   "svg" is necessary to for Asymptote 3D images    -->
-<!--   "pi" is meant to mark private PreTeXt markup     -->
-<!--   "exsl" namespaces enable extension functions     -->
-<!--                                                    -->
-<!-- Excluding result prefixes keeps them from bleeding -->
-<!-- into output unnecessarily -->
-<xsl:stylesheet
-    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
->
-
-<!-- DEBUGGING -->
-<!-- xsltproc -o crap.txt  -stringparam publisher ~/mathbook/mathbook/examples/sample-article/publication.xml /home/rob/mathbook/mathbook/xsl/utilities/report-publisher-variables.xsl ~/mathbook/mathbook/examples/sample-article/sample-article.xml -->
-
-<!-- Standard conversion groundwork -->
-<xsl:import href="../publisher-variables.xsl"/>
-<xsl:import href="../pretext-assembly.xsl"/>
-
-<!-- Intend output for a text file -->
-<xsl:output method="text" encoding="UTF-8"/>
-
-<!-- IMPORTANT: to report the value of a (computed) publisher variable,   -->
-<!-- two related routines are involved.  For a variable not previously    -->
-<!-- supported, a developer must take action to implement a report. The   -->
-<!-- XSL in the "utilities/report-publisher-variable.xsl" stylesheet must -->
-<!-- include the report of a value, which will be captured in a temporary -->
-<!-- file to be read by the Python routine "get_publisher_variable()".    -->
-
-<xsl:template match="/">
-    <!-- 2024-06-20 Testing-->
-    <xsl:text>generated-directory-source</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$generated-directory-source"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-- 2024-06-20 Testing-->
-    <xsl:text>external-directory-source</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$external-directory-source"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-- 2024-06-26 Mermaid theme -->
-    <xsl:text>mermaid-theme</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$mermaid-theme"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-- 2024-07-07 QR code image -->
-    <xsl:text>qrcode-image</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$qrcode-image"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-- 2024-07-21 theme for html build -->
-    <xsl:text>html-theme-name</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$html-theme-name"/>
-    <xsl:text>&#xa;</xsl:text>
-    <xsl:text>html-theme-options</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$html-theme-options"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-- 2024-10-04 LaTeX style xsl -->
-    <xsl:text>latex-style</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$latex-style"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-- 2025-02-25 journal name -->
-    <xsl:text>journal-name</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$journal-name"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-- 2025-03-10 portable html switch -->
-    <xsl:text>portable-html</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$portable-html"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-- 2026-06-30 local/cdn resources -->
-    <xsl:text>b-cdn-resources</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$b-cdn-resources"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-- 2025-05-10 CSL style indicator -->
-    <xsl:text>b-using-csl-styles</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$b-using-csl-styles"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-- 2025-05-10 CSL style filename -->
-    <xsl:text>csl-style-file</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$csl-style-file"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-- 2025-06-26 Mermaid layout engine -->
-    <xsl:text>mermaid-layout-engine</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$mermaid-layout-engine"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-- 2025-09-18 Server to call for STACK question rendering -->
-    <xsl:text>stack-server</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$stack-server"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-- 2026-02-16 Base URL that  interactives -->
-    <xsl:text>baseurl</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$baseurl"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-- 2026-06-25 platform host for html -->
-    <xsl:text>host-platform</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$host-platform"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-- -->
-
-    <!--
-    Boilerplate to support a new variable
-    Please use this style, as above
-    (remove "X" to format comments properly)
-
-    <!-X- YYY-MM-DD Purpose-X->
-    <xsl:text>[[var-name-here]]</xsl:text>
-    <xsl:text> </xsl:text>
-    <xsl:value-of select="$[[var-name-here-keep-prefix-$]]"/>
-    <xsl:text>&#xa;</xsl:text>
-    <!-X- -X->
-    -->
-
-</xsl:template>
-
-</xsl:stylesheet>
+<?xml version='1.0'?> <!-- As XML file -->
+
+<!--********************************************************************
+Copyright 2013 Robert A. Beezer
+
+This file is part of MathBook XML.
+
+MathBook XML is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 or version 3 of the
+License (at your option).
+
+MathBook XML is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
+*********************************************************************-->
+
+<!-- http://pimpmyxslt.com/articles/entity-tricks-part2/ -->
+<!DOCTYPE xsl:stylesheet [
+    <!ENTITY % entities SYSTEM "../entities.ent">
+    %entities;
+]>
+
+<!-- Identify as a stylesheet -->
+<!-- We choose to not include a default namespace       -->
+<!-- (in particular  http://www.w3.org/1999/xhtml),     -->
+<!-- even if this complicates adding namespaces onto    -->
+<!-- derivatives, such as HTML destined for EPUB output -->
+<!-- xmlns="http://www.w3.org/1999/xhtml"               -->
+<!--                                                    -->
+<!-- NB:                                                -->
+<!--   "xsl" is necessary to identify XSL functionality -->
+<!--   "xml" is automatic, hence redundant              -->
+<!--   "svg" is necessary to for Asymptote 3D images    -->
+<!--   "pi" is meant to mark private PreTeXt markup     -->
+<!--   "exsl" namespaces enable extension functions     -->
+<!--                                                    -->
+<!-- Excluding result prefixes keeps them from bleeding -->
+<!-- into output unnecessarily -->
+<xsl:stylesheet
+    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
+>
+
+<!-- DEBUGGING -->
+<!-- xsltproc -o crap.txt  -stringparam publisher ~/mathbook/mathbook/examples/sample-article/publication.xml /home/rob/mathbook/mathbook/xsl/utilities/report-publisher-variables.xsl ~/mathbook/mathbook/examples/sample-article/sample-article.xml -->
+
+<!-- Standard conversion groundwork -->
+<xsl:import href="../publisher-variables.xsl"/>
+<xsl:import href="../pretext-assembly.xsl"/>
+
+<!-- Intend output for a text file -->
+<xsl:output method="text" encoding="UTF-8"/>
+
+<!-- IMPORTANT: to report the value of a (computed) publisher variable,   -->
+<!-- two related routines are involved.  For a variable not previously    -->
+<!-- supported, a developer must take action to implement a report. The   -->
+<!-- XSL in the "utilities/report-publisher-variable.xsl" stylesheet must -->
+<!-- include the report of a value, which will be captured in a temporary -->
+<!-- file to be read by the Python routine "get_publisher_variable()".    -->
+
+<xsl:template match="/">
+    <!-- 2024-06-20 Testing-->
+    <xsl:text>generated-directory-source</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$generated-directory-source"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-- 2024-06-20 Testing-->
+    <xsl:text>external-directory-source</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$external-directory-source"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-- 2024-06-26 Mermaid theme -->
+    <xsl:text>mermaid-theme</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$mermaid-theme"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-- 2024-07-07 QR code image -->
+    <xsl:text>qrcode-image</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$qrcode-image"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-- 2024-07-21 theme for html build -->
+    <xsl:text>html-theme-name</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$html-theme-name"/>
+    <xsl:text>&#xa;</xsl:text>
+    <xsl:text>html-theme-options</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$html-theme-options"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-- 2024-10-04 LaTeX style xsl -->
+    <xsl:text>latex-style</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$latex-style"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-- 2025-02-25 journal name -->
+    <xsl:text>journal-name</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$journal-name"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-- 2025-03-10 portable html switch -->
+    <xsl:text>portable-html</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$portable-html"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-- 2026-06-30 local/cdn resources -->
+    <xsl:text>b-cdn-resources</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$b-cdn-resources"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-- 2025-05-10 CSL style indicator -->
+    <xsl:text>b-using-csl-styles</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$b-using-csl-styles"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-- 2025-05-10 CSL style filename -->
+    <xsl:text>csl-style-file</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$csl-style-file"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-- 2025-06-26 Mermaid layout engine -->
+    <xsl:text>mermaid-layout-engine</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$mermaid-layout-engine"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-- 2025-09-18 Server to call for STACK question rendering -->
+    <xsl:text>stack-server</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$stack-server"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-- 2026-02-16 Base URL that  interactives -->
+    <xsl:text>baseurl</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$baseurl"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-- 2026-06-25 platform host for html -->
+    <xsl:text>host-platform</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$host-platform"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-- -->
+
+    <!--
+    Boilerplate to support a new variable
+    Please use this style, as above
+    (remove "X" to format comments properly)
+
+    <!-X- YYY-MM-DD Purpose-X->
+    <xsl:text>[[var-name-here]]</xsl:text>
+    <xsl:text> </xsl:text>
+    <xsl:value-of select="$[[var-name-here-keep-prefix-$]]"/>
+    <xsl:text>&#xa;</xsl:text>
+    <!-X- -X->
+    -->
+
+</xsl:template>
+
+</xsl:stylesheet>