@pretextbook/pretext-html 0.1.0

package/assets/xsl/extract-prefigure.xsl

@@ -0,0 +1,157 @@
+<?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 <prefigure> elements and copies them for processing -->
+
+<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"
+    xmlns:pf="https://prefigure.org"
+    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 PreFigure XML -->
+<xsl:output method="xml" encoding="UTF-8"/>
+
+<!-- PreFigure graphics to standalone file            -->
+<!-- NB: don't match the empty element that is a text -->
+<!-- generator.  Once PreFigure has a namespace, then -->
+<!-- it should be used here instead.                  -->
+<xsl:template match="pf:prefigure[node()]" mode="extraction">
+    <xsl:variable name="filebase">
+        <xsl:apply-templates select="." mode="image-source-basename"/>
+    </xsl:variable>
+    <!-- Do not use directories here, as Windows paths will get mangled -->
+    <!-- Instead, set working directory before applying stylesheet      -->
+    <exsl:document href="{$filebase}.xml" method="xml">
+        <!-- xerox the "prefigure" element, but with modifications -->
+        <xsl:apply-templates select="." mode="prefigure-edit"/>
+    </exsl:document>
+ </xsl:template>
+
+<!-- Identity template, with a mode, so we can edit a diagram -->
+<!-- NB: it does not seem the "pf:" is necessary here         -->
+<xsl:template match="node()|@*" mode="prefigure-edit">
+    <xsl:copy>
+        <xsl:apply-templates select="node()|@*" mode="prefigure-edit"/>
+    </xsl:copy>
+</xsl:template>
+
+<!-- Raison d'etre for "prefigure-edit": insert a PF "caption" with -->
+<!-- a type-name/number pair and a document-wide serial number      -->
+<xsl:template match="pf:diagram" mode="prefigure-edit">
+    <xsl:copy>
+        <xsl:apply-templates select="@*" mode="prefigure-edit"/>
+        <!-- insert a PF "caption", hopefully with helpful content -->
+        <!-- duplicate indentation of first child of "diagram" to  -->
+        <!-- make insertion of the first new children look good    -->
+        <xsl:value-of select="text()[1]"/>
+        <xsl:comment> Reference to containing ancestor comes from PreTeXt context     </xsl:comment>
+        <xsl:value-of select="text()[1]"/>
+        <xsl:comment> Serial number is from document-wide count of PreFigure diagrams </xsl:comment>
+        <xsl:value-of select="text()[1]"/>
+        <xsl:element name="caption" namespace="https://prefigure.org">
+            <!-- pf:diagram, pf:prefigure, and "image" all lack meaningful  -->
+            <!-- numbers, so start searching for a [location with a number] -->
+            <!-- from the parent of the "image"                             -->
+            <xsl:apply-templates select="parent::pf:prefigure/parent::image/parent::*" mode="prefigure-container"/>
+            <!-- previous template supplies a space, if it provides a type/number pair -->
+            <!-- Serial number, just document-wide for pf:prefigure -->
+            <!-- NB: implement this as part of the overall numbering -->
+            <!-- scheme, so it comes through as an attribute.        -->
+            <xsl:text>(</xsl:text>
+            <!-- pf:diagram is current context, no danger that an empty "pretext" -->
+            <!-- generator will be mistakenly used for the @from pattern          -->
+            <xsl:number count="pf:prefigure" from="pretext" level="any"/>
+            <xsl:text>)</xsl:text>
+        </xsl:element>
+        <!-- xerox remaining elements -->
+        <xsl:apply-templates select="node()" mode="prefigure-edit"/>
+    </xsl:copy>
+</xsl:template>
+
+<!-- Recurse up the tree, looking for the first element with a -->
+<!-- non-empty number.  Produce type-name and a serial number. -->
+<xsl:template match="*" mode="prefigure-container">
+    <!-- Will test on non-empty number strings.  This can be -->
+    <!-- fooled by elements with un-implemented numbers such -->
+    <!-- as a pure container like a "sidebyside".            -->
+    <xsl:variable name="the-number">
+        <xsl:apply-templates select="." mode="number"/>
+    </xsl:variable>
+
+    <xsl:choose>
+        <!-- this is the safety-valve halting condition -->
+        <xsl:when test="self::pretext"/>
+        <!-- Test here for useless containers that have better parents. -->
+        <!-- Examples might be a "case" in a "proof" or a "task" in an  -->
+        <!-- "exercise" or an "li" in an "ol".                          -->
+        <!-- Then recurse with the parent, as below.                    -->
+        <xsl:when test="not($the-number = '')">
+            <xsl:apply-templates select="." mode="type-name" />
+            <xsl:text> </xsl:text>
+            <xsl:value-of select="$the-number"/>
+            <!-- will always follow with a serial number, -->
+            <!-- so add a space here, since conditional   -->
+            <xsl:text> </xsl:text>
+            <!-- mission accomplished, no more recursion -->
+        </xsl:when>
+        <xsl:otherwise>
+            <!-- step-up (recurse) to the parent -->
+            <xsl:apply-templates select="parent::*" mode="prefigure-container"/>
+        </xsl:otherwise>
+    </xsl:choose>
+</xsl:template>
+
+<!-- PreFigure publication file -->
+<!-- We need a one-off generation of a PreFigure publication    -->
+<!-- file, dumped in the same directory as the extracted source -->
+<!-- diagrams.  So we match the *only* guaranteed node and let  -->
+<!-- it do its thing, and then create the necessary file.       -->
+ <xsl:template match="/">
+    <xsl:apply-imports/>
+    <exsl:document href="pf_publication.xml" method="xml">
+        <xsl:element name="prefigure" namespace="https://prefigure.org">
+            <!-- No "prefigure-preamble" => nothing produced       -->
+            <xsl:copy-of select="$docinfo/pf:prefigure-preamble/*"/>
+            <!-- $latex-macros is never empty (<, >, &) so always a "macros" -->
+            <xsl:element name="macros" namespace="https://prefigure.org">
+                <!-- move to a new line for minimal readability -->
+                <xsl:text>&#xa;</xsl:text>
+                <!-- global variable in -common, includes \lt, \gt, \amp -->
+                <xsl:value-of select="$latex-macros"/>
+            </xsl:element>
+        </xsl:element>
+    </exsl:document>
+</xsl:template>
+
+</xsl:stylesheet>

package/assets/xsl/extract-qrcode.xsl

@@ -0,0 +1,100 @@
+<?xml version='1.0'?>
+
+<!--********************************************************************
+Copyright 2014-2016 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/>.
+*********************************************************************-->
+
+<!-- This stylesheet extracts URL information for audio, video,  -->
+<!-- and interactive elements.  For each, it writes a sidecar    -->
+<!-- XML file (via exsl:document) containing a standalone URL    -->
+<!-- and an in-context URL, used later for QR code generation    -->
+<!-- (Python) and for links in static representations            -->
+<!-- (pretext-assembly.xsl).                                     -->
+<!--                                                             -->
+<!-- It is hard to get a link into chunked HTML while actually   -->
+<!-- building generic PreTeXt for a static representation.  The  -->
+<!-- chunking level and file extension are format-specific, but  -->
+<!-- assembly must remain format-neutral.  So we set HTML-        -->
+<!-- specific variables ($chunk-level, $file-extension) here in  -->
+<!-- the extraction stylesheet, which has the highest import     -->
+<!-- precedence.  Assembly then reads the pre-computed URLs from  -->
+<!-- the sidecar files rather than computing them itself.         -->
+
+<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"
+    xmlns:str="http://exslt.org/strings"
+    xmlns:pi="http://pretextbook.org/2020/pretext/internal"
+    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" />
+
+<xsl:output method="text" encoding="UTF-8"/>
+
+<!-- Avoid Catch-22: default assembly/pre-processor provides output  -->
+<!-- for a conversion to a static format, but that format will       -->
+<!-- *replace* "audio", "video", "interactive" by a static version   -->
+<!-- (a "sidebyside") and it will not be available for extraction.    -->
+<xsl:variable name="exercise-style" select="'dynamic'"/>
+
+<!-- In "normal" circumstances, this variable is   -->
+<!-- set to "false()", but when employing this     -->
+<!-- specialized stylesheet, we override to "true" -->
+<xsl:variable name="b-extracting-qrcode" select="true()"/>
+
+<!-- Set HTML-specific variables so that "containing-filename" -->
+<!-- (used by "context-url") produces correct HTML filenames.  -->
+<!-- These override the abstract defaults in pretext-common.xsl -->
+<!-- by virtue of this stylesheet's higher import precedence.   -->
+<xsl:variable name="chunk-level" select="$html-chunk-level"/>
+<xsl:variable name="file-extension" select="'.html'"/>
+
+<xsl:template match="audio[@source|@href]|video[@source|@href|@youtube|@youtubeplaylist|@vimeo]|interactive" mode="extraction">
+    <!-- Sidecar XML file with pre-computed URLs for use      -->
+    <!-- by pretext-assembly.xsl when building static         -->
+    <!-- representations, and by the Python script when       -->
+    <!-- generating QR code images.                           -->
+    <xsl:variable name="the-id">
+        <xsl:apply-templates select="." mode="visible-id"/>
+    </xsl:variable>
+    <exsl:document href="{$the-id}-url.xml" method="xml">
+        <pi:qrcode-urls>
+            <pi:standalone-url>
+                <xsl:apply-templates select="." mode="static-url"/>
+            </pi:standalone-url>
+            <pi:context-url>
+                <xsl:apply-templates select="." mode="context-url"/>
+            </pi:context-url>
+            <pi:embed-iframe-url>
+                <xsl:apply-templates select="." mode="embed-iframe-url"/>
+            </pi:embed-iframe-url>
+        </pi:qrcode-urls>
+    </exsl:document>
+</xsl:template>
+
+</xsl:stylesheet>

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

@@ -0,0 +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>

package/assets/xsl/extract-sageplot.xsl

@@ -0,0 +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>

package/assets/xsl/extract-stack.xsl

@@ -0,0 +1,56 @@
+<?xml version='1.0'?>
+
+<!--********************************************************************
+Copyright 2014-2016 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/>.
+*********************************************************************-->
+
+<!-- This stylesheet locates all  exercise/stack  elements and     -->
+<!-- writes out a single file listing the @source attribute value  -->
+<!-- for eaCh one (the files with these names will be sent to a    -->
+<!-- server for conversion to static forms)                        -->
+
+<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" />
+
+<xsl:output method="text" encoding="UTF-8"/>
+
+<!-- Flag an extraction pass, so pretext-assembly does not get confused -->
+<xsl:variable name="b-extracting-stack" select="true()"/>
+
+<xsl:template match="exercise/stack" mode="extraction">
+    <xsl:value-of select="@source"/>
+    <xsl:text> </xsl:text>
+    <xsl:apply-templates select="." mode="assembly-id"/>
+    <xsl:text>&#xa;</xsl:text>
+</xsl:template>
+
+</xsl:stylesheet>