@pretextbook/pretext-html 0.1.0 → 0.1.1

package/assets/xsl/extract-runestone-page-template.xsl

@@ -1,139 +1,139 @@
-<?xml version='1.0'?>
-
-<!--********************************************************************
-Copyright 2026 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/>.
-*********************************************************************-->
-
-<!-- Empty shell page that Runestone can use to display content on a page -->
-<!-- that looks like it belongs to the book.                              -->
-
-<xsl:stylesheet
-    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
-    xmlns:xml="http://www.w3.org/XML/1998/namespace"
->
-
-<!-- Import the HTML conversion for file wrapping and page-part templates,   -->
-<!-- but override its entry point so this extraction only writes _base.html. -->
-<xsl:import href="./pretext-html.xsl"/>
-
-<!-- Override the variable open and close to use normal Jinga syntax      -->
-<!-- This will be used as a template to insert other Jinga content into   -->
-<!-- and that content uses normal variable delimeters.                    -->
-<!-- We are not worried about LaTeX content we don't directly control.    -->
-<xsl:variable name="rso" select="'{{'"/>
-<xsl:variable name="rsc" select="'}}'"/>
-
-<!-- Override latex-macros so we can escape them in bulk -->
-<xsl:template match="*" mode="latex-macros">
-    <xsl:text>{% raw %}&#xa;</xsl:text>
-    <!-- Call the original template -->
-    <xsl:apply-imports/>
-    <xsl:text>{% endraw %}&#xa;</xsl:text>
-</xsl:template>
-
-<!-- Overrride navigation template to prevent next button from being enabled -->
-<xsl:template match="*" mode="next-linear-url"/>
-
-<!-- Override the HTML default so file-wrap emits Runestone template hooks -->
-<xsl:template match="*" mode="file-wrap-head-pre">
-    {% set using_ptx_base = "true" %}
-    <base>
-        <!-- avoid wonkiness with XSL {{ escaping. No spaces is important -->
-        <xsl:attribute name="href">{{base_url}}</xsl:attribute>
-    </base>
-    <!-- Call the original template just in case something is added there -->
-    <xsl:apply-imports/>
-</xsl:template>
-
-<!-- Override canonical link - don't want to generate the same value for  -->
-<!-- all pages and don't need to SEO the internal student pages           -->
-<xsl:template name="canonical-link"/>
-
-<xsl:template match="*" mode="file-wrap-head-post">
-    <!-- Call the original template just in case something is added there -->
-    <xsl:apply-imports/>
-    <link href="/staticAssets/main-ptx-based.css" rel="stylesheet" />
-    <script>
-        window.addEventListener("DOMContentLoaded", () => {
-            const sidebar = document.getElementById("ptx-sidebar");
-            if (sidebar) {
-                sidebar.classList.add("hidden");
-            }
-        });
-    </script>
-    {% block css %}
-    {% endblock %}
-</xsl:template>
-
-<xsl:template match="*" mode="file-wrap-body-attr-extra">
-    <!-- Call the original template just in case something is added there -->
-    <xsl:apply-imports/>
-    <xsl:text> ptx-runestone-template</xsl:text>
-</xsl:template>
-
-<xsl:template match="*" mode="file-wrap-body-post">
-    <!-- Call the original template just in case something is added there -->
-    <xsl:apply-imports/>
-    <!-- rs footer -->
-    {% include 'footer.html' %}
-    <!-- scripts -->
-    <script>
-        <!-- hide sidebar by default in all themes -->
-        const sidebar = document.getElementById("ptx-sidebar");
-        if (sidebar) {
-            sidebar.classList.add("hidden");
-        }
-    </script>
-    <script src="https://cdn.jsdelivr.net/npm/popper.js@1.16.1/dist/umd/popper.min.js" integrity="sha384-9/reFTGAW83EW2RDu2S0VKaIzap3H66lZH81PoYlFhbGU+6BZp6G7niu735Sk7lN" crossorigin="anonymous"></script>
-    <script src="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/js/bootstrap.min.js"></script>
-    {% block js %}
-    {% endblock %}
-</xsl:template>
-
-
-<xsl:output method="html" indent="yes" encoding="UTF-8" doctype-system="about:legacy-compat" />
-
-<xsl:template match="/">
-    <xsl:call-template name="runestone-page-template"/>
-</xsl:template>
-
-<xsl:template name="runestone-page-template">
-    <xsl:if test="$b-host-runestone and ($b-is-book or $b-is-article)">
-        <xsl:apply-templates select="$document-root" mode="runestone-page-template"/>
-    </xsl:if>
-</xsl:template>
-
-<xsl:template match="book|article" mode="runestone-page-template">
-    <xsl:apply-templates select="." mode="file-wrap">
-        <xsl:with-param name="filename">
-            <xsl:text>_base.html</xsl:text>
-        </xsl:with-param>
-        <xsl:with-param name="title">
-            <xsl:text>{% block title %}</xsl:text>
-            <xsl:apply-templates select="." mode="title-plain" />
-            <xsl:text>{% endblock %}</xsl:text>
-        </xsl:with-param>
-        <xsl:with-param name="b-include-bottom-nav" select="false()"/>
-        <xsl:with-param name="content">
-            {% block content %}
-            {% endblock %}
-        </xsl:with-param>
-    </xsl:apply-templates>
-</xsl:template>
-
-</xsl:stylesheet>
+<?xml version='1.0'?>
+
+<!--********************************************************************
+Copyright 2026 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/>.
+*********************************************************************-->
+
+<!-- Empty shell page that Runestone can use to display content on a page -->
+<!-- that looks like it belongs to the book.                              -->
+
+<xsl:stylesheet
+    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
+    xmlns:xml="http://www.w3.org/XML/1998/namespace"
+>
+
+<!-- Import the HTML conversion for file wrapping and page-part templates,   -->
+<!-- but override its entry point so this extraction only writes _base.html. -->
+<xsl:import href="./pretext-html.xsl"/>
+
+<!-- Override the variable open and close to use normal Jinga syntax      -->
+<!-- This will be used as a template to insert other Jinga content into   -->
+<!-- and that content uses normal variable delimeters.                    -->
+<!-- We are not worried about LaTeX content we don't directly control.    -->
+<xsl:variable name="rso" select="'{{'"/>
+<xsl:variable name="rsc" select="'}}'"/>
+
+<!-- Override latex-macros so we can escape them in bulk -->
+<xsl:template match="*" mode="latex-macros">
+    <xsl:text>{% raw %}&#xa;</xsl:text>
+    <!-- Call the original template -->
+    <xsl:apply-imports/>
+    <xsl:text>{% endraw %}&#xa;</xsl:text>
+</xsl:template>
+
+<!-- Overrride navigation template to prevent next button from being enabled -->
+<xsl:template match="*" mode="next-linear-url"/>
+
+<!-- Override the HTML default so file-wrap emits Runestone template hooks -->
+<xsl:template match="*" mode="file-wrap-head-pre">
+    {% set using_ptx_base = "true" %}
+    <base>
+        <!-- avoid wonkiness with XSL {{ escaping. No spaces is important -->
+        <xsl:attribute name="href">{{base_url}}</xsl:attribute>
+    </base>
+    <!-- Call the original template just in case something is added there -->
+    <xsl:apply-imports/>
+</xsl:template>
+
+<!-- Override canonical link - don't want to generate the same value for  -->
+<!-- all pages and don't need to SEO the internal student pages           -->
+<xsl:template name="canonical-link"/>
+
+<xsl:template match="*" mode="file-wrap-head-post">
+    <!-- Call the original template just in case something is added there -->
+    <xsl:apply-imports/>
+    <link href="/staticAssets/main-ptx-based.css" rel="stylesheet" />
+    <script>
+        window.addEventListener("DOMContentLoaded", () => {
+            const sidebar = document.getElementById("ptx-sidebar");
+            if (sidebar) {
+                sidebar.classList.add("hidden");
+            }
+        });
+    </script>
+    {% block css %}
+    {% endblock %}
+</xsl:template>
+
+<xsl:template match="*" mode="file-wrap-body-attr-extra">
+    <!-- Call the original template just in case something is added there -->
+    <xsl:apply-imports/>
+    <xsl:text> ptx-runestone-template</xsl:text>
+</xsl:template>
+
+<xsl:template match="*" mode="file-wrap-body-post">
+    <!-- Call the original template just in case something is added there -->
+    <xsl:apply-imports/>
+    <!-- rs footer -->
+    {% include 'footer.html' %}
+    <!-- scripts -->
+    <script>
+        <!-- hide sidebar by default in all themes -->
+        const sidebar = document.getElementById("ptx-sidebar");
+        if (sidebar) {
+            sidebar.classList.add("hidden");
+        }
+    </script>
+    <script src="https://cdn.jsdelivr.net/npm/popper.js@1.16.1/dist/umd/popper.min.js" integrity="sha384-9/reFTGAW83EW2RDu2S0VKaIzap3H66lZH81PoYlFhbGU+6BZp6G7niu735Sk7lN" crossorigin="anonymous"></script>
+    <script src="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/js/bootstrap.min.js"></script>
+    {% block js %}
+    {% endblock %}
+</xsl:template>
+
+
+<xsl:output method="html" indent="yes" encoding="UTF-8" doctype-system="about:legacy-compat" />
+
+<xsl:template match="/">
+    <xsl:call-template name="runestone-page-template"/>
+</xsl:template>
+
+<xsl:template name="runestone-page-template">
+    <xsl:if test="$b-host-runestone and ($b-is-book or $b-is-article)">
+        <xsl:apply-templates select="$document-root" mode="runestone-page-template"/>
+    </xsl:if>
+</xsl:template>
+
+<xsl:template match="book|article" mode="runestone-page-template">
+    <xsl:apply-templates select="." mode="file-wrap">
+        <xsl:with-param name="filename">
+            <xsl:text>_base.html</xsl:text>
+        </xsl:with-param>
+        <xsl:with-param name="title">
+            <xsl:text>{% block title %}</xsl:text>
+            <xsl:apply-templates select="." mode="title-plain" />
+            <xsl:text>{% endblock %}</xsl:text>
+        </xsl:with-param>
+        <xsl:with-param name="b-include-bottom-nav" select="false()"/>
+        <xsl:with-param name="content">
+            {% block content %}
+            {% endblock %}
+        </xsl:with-param>
+    </xsl:apply-templates>
+</xsl:template>
+
+</xsl:stylesheet>

package/assets/xsl/extract-sageplot.xsl

@@ -1,166 +1,166 @@
-<?xml version='1.0'?> 
-
-<!--********************************************************************
-Copyright 2014-2016 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/>.
-*********************************************************************-->
-
-<!-- This stylesheet locates <sageplot> elements     -->
-<!-- and bundles them into a Sage/Python program     -->
-<!-- The program accepts one command-line parameter: -->
-<!-- the file extension of the desired format        -->
-<!-- (i.e. svg, eps, pdf, png, etc)                  -->
-<!-- N.B. 3D plots always render as PNG              -->
-
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
-    xmlns:xml="http://www.w3.org/XML/1998/namespace" 
-    xmlns:exsl="http://exslt.org/common"
-    extension-element-prefixes="exsl"
->
-
-<!-- Get internal ID's for filenames, etc -->
-<!-- Standard conversion groundwork       -->
-<xsl:import href="./publisher-variables.xsl"/>
-<xsl:import href="./pretext-assembly.xsl"/>
-<xsl:import href="./pretext-common.xsl"/>
-
-<!-- Get a "subtree" xml:id value   -->
-<!-- Then walk the XML source tree  -->
-<!-- applying specializations below -->
-<xsl:import href="./extract-identity.xsl" />
-
-<!-- Output Sage code as text -->
-<xsl:output method="text" encoding="UTF-8"/>
-
-<!-- This stylesheet is parameterized by a requested file format to be  -->
-<!-- produced by Sage, which Sage picks up from file extensions in the  -->
-<!-- filename argument in a .save() method.  We supply this from the    -->
-<!-- pretext/pretext  script, so there is no error checking.  Values    -->
-<!-- vary by the @variant of the "sageplot".  *.png  are low-quality    -->
-<!-- (not cropped tight), so even if possible for 2D graphics, we do    -->
-<!-- not build such a thing.  Otherwise the formats are exclusive to    -->
-<!-- their variant (Sage capability).                                   -->
-<!--                                                                    -->
-<!--   2D variant: pdf (LaTeX), svg (HTML) formats                      -->
-<!--   3D variant: png (LaTeX), html (HTML) formats                     -->
-
-<xsl:param name="sageplot.fileformat" select="'pdf'"/>
-
-<!-- Sage graphics to standalone Sage/Python file      -->
-<xsl:template match="sageplot" mode="extraction">
-    <!-- Construct the file for Sage to execute                    -->
-    <!-- Convert final line to an assignment, so we can do save(s) -->
-    <!-- First, basename for the file (Sage input, image output)   -->
-    <!-- Second, the (unique) name of the graphics object in Sage  -->
-    <!-- (We do this first, so we can use "$filebase" below)       -->
-    <xsl:variable name="filebase">
-        <xsl:apply-templates select="." mode="image-source-basename"/>
-    </xsl:variable>
-    <xsl:variable name="plot-name">
-        <xsl:text>plot_</xsl:text>
-        <xsl:value-of select="generate-id(.)" />
-    </xsl:variable>
-    <!-- Look to see if "sageplot" is building 2d or 3d -->
-    <xsl:variable name="variant">
-        <xsl:choose>
-            <!-- default is a 2d graphic -->
-            <xsl:when test="not(@variant)">
-                <xsl:text>2d</xsl:text>
-            </xsl:when>
-            <xsl:when test="@variant = '2d'">
-                <xsl:text>2d</xsl:text>
-            </xsl:when>
-            <xsl:when test="@variant = '3d'">
-                <xsl:text>3d</xsl:text>
-            </xsl:when>
-            <xsl:otherwise>
-                <xsl:message>PTX:ERROR:   a "sageplot" has a @variant attribute ("<xsl:value-of select="@variant"/>") for "<xsl:value-of select="$filebase"/>" whose value is not "2d" nor "3d".  The default ("2d") is being used, which could be incorrect</xsl:message>
-                <xsl:text>2d</xsl:text>
-            </xsl:otherwise>
-        </xsl:choose>
-    </xsl:variable>
-    <!-- has one trailing newline, which we ignore later (?) -->
-    <xsl:variable name="plot-code-sanitary">
-        <xsl:call-template name="sanitize-text">
-            <xsl:with-param name="text" select="." />
-        </xsl:call-template>
-    </xsl:variable>
-    <!-- remove the trailing newline provided by sanitization -->
-    <xsl:variable name="plot-code-trimmed" select="substring($plot-code-sanitary,1,string-length($plot-code-sanitary)-1)"/>
-    <!-- conditionally provide a breakpoint for single-line source -->
-    <xsl:variable name="plot-code">
-        <xsl:if test="not(contains($plot-code-trimmed, '&#xa;'))">
-            <xsl:text>&#xa;</xsl:text>
-        </xsl:if>
-        <xsl:value-of select="$plot-code-trimmed"/>
-    </xsl:variable>
-    <!-- split on last newline, which is first character for single-line source -->
-    <xsl:variable name="preamble">
-        <xsl:call-template name="substring-before-last">
-            <xsl:with-param name="input" select="$plot-code"/>
-            <xsl:with-param name="substr" select="'&#xa;'" />
-        </xsl:call-template>
-    </xsl:variable>
-    <xsl:variable name="plotcmd">
-        <xsl:call-template name="substring-after-last">
-            <xsl:with-param name="input" select="$plot-code"/>
-            <xsl:with-param name="substr" select="'&#xa;'" />
-        </xsl:call-template>
-    </xsl:variable>
-    <!-- NB: 2D PNG is not preferable, but needed for EPUB sent to Kindle -->
-    <xsl:variable name="b-legal-combination" select="($variant = '2d' and $sageplot.fileformat = 'pdf')
-                                                 or  ($variant = '2d' and $sageplot.fileformat = 'svg')
-                                                 or  ($variant = '2d' and $sageplot.fileformat = 'png')
-                                                 or  ($variant = '3d' and $sageplot.fileformat = 'png')
-                                                 or  ($variant = '3d' and $sageplot.fileformat = 'html')"/>
-    <!-- Only certain combinations are supported and only certain       -->
-    <!-- combinations are needed in subsequent conversions.  Yes,  this -->
-    <!-- setup is all inefficient to just bail out now.                 -->
-    <!-- Do not use directories here, as Windows paths will get mangled -->
-    <!-- Instead, set working directory before applying stylesheet      -->
-    <xsl:if test="$b-legal-combination">
-        <exsl:document href="{$filebase}.sage" method="text">
-            <!-- Duplicate most code, massage code at last line -->
-            <xsl:value-of select="$preamble" />
-            <xsl:text>&#xa;</xsl:text>
-            <xsl:value-of select="$plot-name" />
-            <xsl:text> = </xsl:text>
-            <xsl:value-of select="$plotcmd" />
-            <xsl:text>&#xa;</xsl:text>
-            <!-- We could build a try/except block here, where a ValueError -->
-            <!-- indicates a fileformat not supported, but we may have that -->
-            <!-- covered.  Would need to get the exception out of the sage  -->
-            <!-- executable invocation in the Python script to relay.       -->
-            <xsl:value-of select="$plot-name" />
-            <xsl:text>.save('</xsl:text>
-            <xsl:value-of select="$filebase" />
-            <xsl:text>.</xsl:text>
-            <xsl:value-of select="$sageplot.fileformat"/>
-            <xsl:text>'</xsl:text>
-            <!-- Need to inform Sage display manager for 3d HTML that we -->
-            <!-- are not inside a notebook or the command-line and we    -->
-            <!-- want self-contained  threejs  apllications with         -->
-            <!-- Javascript coming from a CDN.                           -->
-            <xsl:if test="$sageplot.fileformat = 'html'">
-                <xsl:text>, online=True</xsl:text>
-            </xsl:if>
-            <xsl:text>)&#xa;</xsl:text>
-        </exsl:document>
-    </xsl:if>
- </xsl:template>
-
-</xsl:stylesheet>
+<?xml version='1.0'?> 
+
+<!--********************************************************************
+Copyright 2014-2016 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/>.
+*********************************************************************-->
+
+<!-- This stylesheet locates <sageplot> elements     -->
+<!-- and bundles them into a Sage/Python program     -->
+<!-- The program accepts one command-line parameter: -->
+<!-- the file extension of the desired format        -->
+<!-- (i.e. svg, eps, pdf, png, etc)                  -->
+<!-- N.B. 3D plots always render as PNG              -->
+
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
+    xmlns:xml="http://www.w3.org/XML/1998/namespace" 
+    xmlns:exsl="http://exslt.org/common"
+    extension-element-prefixes="exsl"
+>
+
+<!-- Get internal ID's for filenames, etc -->
+<!-- Standard conversion groundwork       -->
+<xsl:import href="./publisher-variables.xsl"/>
+<xsl:import href="./pretext-assembly.xsl"/>
+<xsl:import href="./pretext-common.xsl"/>
+
+<!-- Get a "subtree" xml:id value   -->
+<!-- Then walk the XML source tree  -->
+<!-- applying specializations below -->
+<xsl:import href="./extract-identity.xsl" />
+
+<!-- Output Sage code as text -->
+<xsl:output method="text" encoding="UTF-8"/>
+
+<!-- This stylesheet is parameterized by a requested file format to be  -->
+<!-- produced by Sage, which Sage picks up from file extensions in the  -->
+<!-- filename argument in a .save() method.  We supply this from the    -->
+<!-- pretext/pretext  script, so there is no error checking.  Values    -->
+<!-- vary by the @variant of the "sageplot".  *.png  are low-quality    -->
+<!-- (not cropped tight), so even if possible for 2D graphics, we do    -->
+<!-- not build such a thing.  Otherwise the formats are exclusive to    -->
+<!-- their variant (Sage capability).                                   -->
+<!--                                                                    -->
+<!--   2D variant: pdf (LaTeX), svg (HTML) formats                      -->
+<!--   3D variant: png (LaTeX), html (HTML) formats                     -->
+
+<xsl:param name="sageplot.fileformat" select="'pdf'"/>
+
+<!-- Sage graphics to standalone Sage/Python file      -->
+<xsl:template match="sageplot" mode="extraction">
+    <!-- Construct the file for Sage to execute                    -->
+    <!-- Convert final line to an assignment, so we can do save(s) -->
+    <!-- First, basename for the file (Sage input, image output)   -->
+    <!-- Second, the (unique) name of the graphics object in Sage  -->
+    <!-- (We do this first, so we can use "$filebase" below)       -->
+    <xsl:variable name="filebase">
+        <xsl:apply-templates select="." mode="image-source-basename"/>
+    </xsl:variable>
+    <xsl:variable name="plot-name">
+        <xsl:text>plot_</xsl:text>
+        <xsl:value-of select="generate-id(.)" />
+    </xsl:variable>
+    <!-- Look to see if "sageplot" is building 2d or 3d -->
+    <xsl:variable name="variant">
+        <xsl:choose>
+            <!-- default is a 2d graphic -->
+            <xsl:when test="not(@variant)">
+                <xsl:text>2d</xsl:text>
+            </xsl:when>
+            <xsl:when test="@variant = '2d'">
+                <xsl:text>2d</xsl:text>
+            </xsl:when>
+            <xsl:when test="@variant = '3d'">
+                <xsl:text>3d</xsl:text>
+            </xsl:when>
+            <xsl:otherwise>
+                <xsl:message>PTX:ERROR:   a "sageplot" has a @variant attribute ("<xsl:value-of select="@variant"/>") for "<xsl:value-of select="$filebase"/>" whose value is not "2d" nor "3d".  The default ("2d") is being used, which could be incorrect</xsl:message>
+                <xsl:text>2d</xsl:text>
+            </xsl:otherwise>
+        </xsl:choose>
+    </xsl:variable>
+    <!-- has one trailing newline, which we ignore later (?) -->
+    <xsl:variable name="plot-code-sanitary">
+        <xsl:call-template name="sanitize-text">
+            <xsl:with-param name="text" select="." />
+        </xsl:call-template>
+    </xsl:variable>
+    <!-- remove the trailing newline provided by sanitization -->
+    <xsl:variable name="plot-code-trimmed" select="substring($plot-code-sanitary,1,string-length($plot-code-sanitary)-1)"/>
+    <!-- conditionally provide a breakpoint for single-line source -->
+    <xsl:variable name="plot-code">
+        <xsl:if test="not(contains($plot-code-trimmed, '&#xa;'))">
+            <xsl:text>&#xa;</xsl:text>
+        </xsl:if>
+        <xsl:value-of select="$plot-code-trimmed"/>
+    </xsl:variable>
+    <!-- split on last newline, which is first character for single-line source -->
+    <xsl:variable name="preamble">
+        <xsl:call-template name="substring-before-last">
+            <xsl:with-param name="input" select="$plot-code"/>
+            <xsl:with-param name="substr" select="'&#xa;'" />
+        </xsl:call-template>
+    </xsl:variable>
+    <xsl:variable name="plotcmd">
+        <xsl:call-template name="substring-after-last">
+            <xsl:with-param name="input" select="$plot-code"/>
+            <xsl:with-param name="substr" select="'&#xa;'" />
+        </xsl:call-template>
+    </xsl:variable>
+    <!-- NB: 2D PNG is not preferable, but needed for EPUB sent to Kindle -->
+    <xsl:variable name="b-legal-combination" select="($variant = '2d' and $sageplot.fileformat = 'pdf')
+                                                 or  ($variant = '2d' and $sageplot.fileformat = 'svg')
+                                                 or  ($variant = '2d' and $sageplot.fileformat = 'png')
+                                                 or  ($variant = '3d' and $sageplot.fileformat = 'png')
+                                                 or  ($variant = '3d' and $sageplot.fileformat = 'html')"/>
+    <!-- Only certain combinations are supported and only certain       -->
+    <!-- combinations are needed in subsequent conversions.  Yes,  this -->
+    <!-- setup is all inefficient to just bail out now.                 -->
+    <!-- Do not use directories here, as Windows paths will get mangled -->
+    <!-- Instead, set working directory before applying stylesheet      -->
+    <xsl:if test="$b-legal-combination">
+        <exsl:document href="{$filebase}.sage" method="text">
+            <!-- Duplicate most code, massage code at last line -->
+            <xsl:value-of select="$preamble" />
+            <xsl:text>&#xa;</xsl:text>
+            <xsl:value-of select="$plot-name" />
+            <xsl:text> = </xsl:text>
+            <xsl:value-of select="$plotcmd" />
+            <xsl:text>&#xa;</xsl:text>
+            <!-- We could build a try/except block here, where a ValueError -->
+            <!-- indicates a fileformat not supported, but we may have that -->
+            <!-- covered.  Would need to get the exception out of the sage  -->
+            <!-- executable invocation in the Python script to relay.       -->
+            <xsl:value-of select="$plot-name" />
+            <xsl:text>.save('</xsl:text>
+            <xsl:value-of select="$filebase" />
+            <xsl:text>.</xsl:text>
+            <xsl:value-of select="$sageplot.fileformat"/>
+            <xsl:text>'</xsl:text>
+            <!-- Need to inform Sage display manager for 3d HTML that we -->
+            <!-- are not inside a notebook or the command-line and we    -->
+            <!-- want self-contained  threejs  apllications with         -->
+            <!-- Javascript coming from a CDN.                           -->
+            <xsl:if test="$sageplot.fileformat = 'html'">
+                <xsl:text>, online=True</xsl:text>
+            </xsl:if>
+            <xsl:text>)&#xa;</xsl:text>
+        </exsl:document>
+    </xsl:if>
+ </xsl:template>
+
+</xsl:stylesheet>