@pretextbook/pretext-html 0.1.0

package/assets/xsl/support/README.md

@@ -0,0 +1,22 @@
+# PreTeXt (Miscellaneous) Support Files
+
+### Runestone Services
+
+The `webpack_static_imports.xml` file contains the current version of the minimal set of JS and CSS files for providing "Runestone Services", either when hosted on a Runestone Server or when creating HTML for self-hosting.
+
+As of 2024-07-31 the latest version can obtained with a `wget` from [https://runestone.academy/cdn/runestone/latest/webpack_static_imports.xml](https://runestone.academy/cdn/runestone/latest/webpack_static_imports.xml).
+
+An outline of the procedure to update this file is:
+
+```
+cd xsl/support
+wget -O webpack_static_imports.xml https://runestone.academy/cdn/runestone/latest/webpack_static_imports.xml
+git diff
+git st
+
+<verify/obtain new version number in diff, use in commit message>
+
+git commit -am "Runestone: update services file to vX.Y.Z"
+
+<push new commit to PreTeXt repository>
+```

package/assets/xsl/support/extract-math.xsl

@@ -0,0 +1,256 @@
+<?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/>.
+*********************************************************************-->
+
+<!-- We build a very basic HTML page intended for MathJax    -->
+<!-- to process with its *-page tools                        -->
+<!--                                                         -->
+<!-- Pro: faster than a new system call for each and         -->
+<!--      every math element                                 -->
+<!-- Pro: if MathJax produces output that is not XHTML       -->
+<!--      any defects will be minimal and controllable       -->
+<!-- Con: one massive cache of font info, which could be     -->
+<!--      much more than an eventual chunked page might need -->
+<!--                                                         -->
+<!-- The result is meant to be processed by the              -->
+<!-- package-math.xsl  stylesheet for eventual use           -->
+
+<!-- NB: string functions can leave if latex macros get fixed elsewhere -->
+<xsl:stylesheet
+    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
+    xmlns:xml="http://www.w3.org/XML/1998/namespace"
+    xmlns:str="http://exslt.org/strings"
+    extension-element-prefixes="str"
+>
+
+<!-- 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"/>
+
+<!-- Use the HTML variants, as we are making input for MathJax -->
+<xsl:import href="../pretext-html.xsl" />
+
+<!-- Extraction infrastructure, plus redefinition -->
+<!-- of entry template, so *after* HTML template  -->
+<xsl:import href="../extract-identity.xsl" />
+
+<!-- Write XML, since 'output="html"' creates things  -->
+<!-- like unclosed "meta" and these get replicated by  -->
+<!-- the MathJax tools, producing a non-XML file. -->
+
+<!-- Output an HTML for MathJax to consume page -->
+<xsl:output method="xml" encoding="UTF-8" omit-xml-declaration="yes" doctype-system="about:legacy-compat"/>
+
+<!-- This variable controls representations of interactive exercises   -->
+<!-- built in  pretext-assembly.xsl.  The imported  pretext-html.xsl   -->
+<!-- stylesheet sets it to "dynamic".  But for this stylesheet we want -->
+<!-- to utilize the "standard" PreTeXt exercise versions built with    -->
+<!-- "static".  See both  pretext-assembly.xsl  and  pretext-html.xsl  -->
+<!-- for more discussion. -->
+<xsl:variable name="exercise-style" select="'static'"/>
+
+<!-- This stylesheet is parameterized by how trailing punctuation       -->
+<!-- is handled by math elements.  An  xsl:param  immediately overrides -->
+<!-- the global cross-stylesheet variable, to counteract how the HTML   -->
+<!-- routinely incorporates trailing punctuation into the LaTeX math.   -->
+<!-- The param default is the same as the variable default.             -->
+<!-- NB: a stylesheet that eventually consumes this math will need to   -->
+<!-- use the modal "get-clause-punctuation" template to coordinate with -->
+<!-- what happens here.  Give the global varible the same value and     -->
+<!-- then the "get-clause-punctuation" used at the end of the           -->
+<!-- construction of the math element should produce the right action.  -->
+<xsl:param name="math.punctuation" select="'none'"/>
+<xsl:variable name="math.punctuation.include" select="$math.punctuation"/>
+
+<!-- A consumer that renders the math SVG into a single-file target  -->
+<!-- (such as the XSL-FO conversion to PDF) can make a               -->
+<!-- cross-reference inside math an active link by setting this to   -->
+<!-- 'yes': the "xref" then emits a \href{#id} that MathJax turns    -->
+<!-- into an SVG "a" element. The "#id" is the shared "unique-id" of -->
+<!-- the target, so it matches the anchor that conversion places on  -->
+<!-- the target. Off ('no') by default, since a chunked target       -->
+<!-- (HTML, EPUB) needs a filename, not a bare fragment, and not     -->
+<!-- every reader honors the SVG link.                               -->
+<xsl:param name="math.cross-references" select="'no'"/>
+
+<!-- We import the HTML stylesheet since we want HTML versions of -->
+<!-- the math bits, but we don't need all the chunking machinery  -->
+<!-- for extracting math, since we are building a single file,    -->
+<!-- so we set the level to control associated templates          -->
+<xsl:variable name="chunk-level" select="number(0)"/>
+
+<!-- Base HTML conversion (which we have imported) wraps mathematics   -->
+<!-- with a class "process-math", which is specified in the MathJax 3  -->
+<!-- configuration so we can ignore non-math bits and not get confused -->
+<!-- by stray LaTeX/ASCIIMath/MathJax markup.  Here we just rip out    -->
+<!-- and package math for subsequent processing, so no such            -->
+<!-- contortions are necessary and a simpler wrapping is possible.     -->
+
+<!-- Inline math does not need a "span", just delimiters -->
+<xsl:template name="inline-math-wrapper">
+     <xsl:param name="math"/>
+     <xsl:text>\(</xsl:text>
+     <xsl:value-of select="$math"/>
+     <xsl:text>\)</xsl:text>
+ </xsl:template>
+
+<!-- No special wrapping needed for display  -->
+<!-- mathematics, so just copy the content   -->
+<xsl:template match="md[mrow]" mode="display-math-wrapper">
+    <xsl:param name="content" />
+    <xsl:copy-of select="$content" />
+</xsl:template>
+
+<!-- Build a super-simple HTML page, whose only -->
+<!-- purpose is to serve as input to a MathJax  -->
+<!-- *-page routine.                            -->
+<!-- calling context is $root, or subtree root  -->
+<xsl:template match="*" mode="extraction-wrapper">
+    <html>
+        <!-- no "head" at all -->
+        <body>
+            <!-- MathJax predefines \lt and \gt to avoid XML's <, >      -->
+            <!-- We therefore define these for LaTeX use to be           -->
+            <!-- universal.  Usually no harm having them in HTML output, -->
+            <!-- BUT MathJax puts raw LaTeX into the @alttext attribute, -->
+            <!-- where our definitions with unescaped version of <, >    -->
+            <!-- are a syntax violation.  So we scrub them.              -->
+            <!-- TODO: move this and make two $latex-macros,             -->
+            <!-- one for HTML and one for LaTeX                          -->
+            <xsl:variable name="no-less-than"      select="str:replace($latex-macros, '\newcommand{\lt}{&lt;}&#xa;', '')"/>
+            <xsl:variable name="latex-macros-html" select="str:replace($no-less-than, '\newcommand{\gt}{&gt;}&#xa;', '')"/>
+            <!-- put macros and packages early for MJ to find         -->
+            <!-- give the div an @id so we can trash it as a leftover -->
+            <!-- NB: "math support" macros (fillin-math, sfrac) must  -->
+            <!-- be defined here AND in the "latex-macros" named      -->
+            <!-- template in  pretext-html.xsl                        -->
+            <div id="latex-macros">
+                <xsl:call-template name="inline-math-wrapper">
+                    <xsl:with-param name="math">
+                        <xsl:value-of select="$latex-packages-mathjax"/>
+                        <xsl:value-of select="$latex-macros-html"/>
+                        <xsl:call-template name="fillin-math"/>
+                        <!-- legacy built-in support for "slanted|beveled|nice" fractions -->
+                        <xsl:if test="$b-has-sfrac">
+                            <xsl:text>\newcommand{\sfrac}[2]{{#1}/{#2}}&#xa;</xsl:text>
+                        </xsl:if>
+                    </xsl:with-param>
+                </xsl:call-template>
+            </div>
+            <!-- initiate tree-walker "extraction" templates -->
+            <xsl:apply-imports/>
+        </body>
+    </html>
+</xsl:template>
+
+<!-- Associate IDs with the LaTeX so we know where     -->
+<!-- the processed results belong when reinserted.     -->
+<!-- Flag the context as "inline" v. "displaymath"     -->
+<!-- so that we can do things like place a CSS class   -->
+<!-- for MathJax to see when processing the math bits. -->
+<xsl:template match="m|md" mode="extraction">
+    <xsl:variable name="context">
+        <xsl:choose>
+            <xsl:when test="self::m">
+                <xsl:text>inline</xsl:text>
+            </xsl:when>
+            <xsl:when test="self::md">
+                <xsl:text>displaymath</xsl:text>
+            </xsl:when>
+        </xsl:choose>
+    </xsl:variable>
+    <div context="{$context}">
+        <!-- NB: stylesheets receiving these representations will  -->
+        <!-- want to *also* mark math bits via the "unique-id"   -->
+        <!-- The speed of the "unique-id" is critical here       -->
+        <xsl:attribute name="id">
+            <xsl:apply-templates select="." mode="unique-id"/>
+        </xsl:attribute>
+        <xsl:apply-templates select="."/>
+    </div>
+</xsl:template>
+
+
+<!-- An "xref" inside of math is a delicate matter.                                   -->
+<!--                                                                                  -->
+<!--   1.  A number is computed based on various numbering switches so this           -->
+<!--       sort of information needs to be available to this conversion.              -->
+<!--                                                                                  -->
+<!--   2.  A \href{} is recognized by MathJax and puts an "a" element into            -->
+<!--       an output SVG.  But Calibre (for example) does not seem to recognize this. -->
+<!--       See "xLinks" section of https://wiki.mobileread.com/wiki/SVG (2020-03-25), -->
+<!--       perhaps the MathJax version does not have enough namespace info, etc.      -->
+<!--       The \knowl{} extension of the conversion to HTML is not understood at all. -->
+<!--       A knowl requires that PreTeXt Javascript named like "mathjaxknowl.js"      -->
+<!--       loaded as a MathJax extension for knowls to possibly render                -->
+<!--                                                                                  -->
+<!--   3.  Our links' base filename will depend on chunking level, and the file       -->
+<!--       extension may need to ".xhtml" (not ".html") if the destination is EPUB.   -->
+<!--       And the lxml parser complains when a global XSL variable is redefined      -->
+<!--       in an override/import.                                                     -->
+<!--                                                                                  -->
+<!-- We drop in text (1, the computed number, already wrapped in a LaTeX \text{}),    -->
+<!-- which is all a chunked target (3) can use, and is the default ('no') because not -->
+<!-- every reader honors an SVG link (2). But when "math.cross-references" is 'yes' a -->
+<!-- single-file target (such as the XSL-FO conversion to PDF) wants the live link of -->
+<!-- (2): wrap that same text in a \href to the target's "#id", which MathJax renders -->
+<!-- as an "a" element in the SVG.                                                    -->
+<xsl:template match="*" mode="xref-link-display-math">
+    <xsl:param name="target"/>
+    <xsl:param name="content"/>
+    <xsl:choose>
+        <xsl:when test="$math.cross-references = 'yes'">
+            <xsl:text>\href{#</xsl:text>
+            <xsl:apply-templates select="$target" mode="unique-id"/>
+            <xsl:text>}{</xsl:text>
+            <xsl:choose>
+                <!-- an electronic PDF colors the reference like every    -->
+                <!-- other link (the dark blue of "link-attributes" in    -->
+                <!-- pretext-fo.xsl), via MathJax's \color; print leaves   -->
+                <!-- it black, exactly as the other links do               -->
+                <xsl:when test="$b-latex-print">
+                    <xsl:value-of select="$content"/>
+                </xsl:when>
+                <xsl:otherwise>
+                    <xsl:text>\color{#000080}{</xsl:text>
+                    <xsl:value-of select="$content"/>
+                    <xsl:text>}</xsl:text>
+                </xsl:otherwise>
+            </xsl:choose>
+            <xsl:text>}</xsl:text>
+        </xsl:when>
+        <xsl:otherwise>
+            <xsl:value-of select="$content"/>
+        </xsl:otherwise>
+    </xsl:choose>
+</xsl:template>
+
+<!-- Knowls -->
+<!-- No cross-reference should be a knowl      -->
+<!-- Turn off knowls so SVG production goes OK -->
+<!-- TODO: Need to know desired chunk level for links to be -->
+<!-- correct, possibly in the publisher file once revisited -->
+<xsl:template match="*" mode="xref-as-knowl">
+    <xsl:value-of select="false()" />
+</xsl:template>
+
+</xsl:stylesheet>

package/assets/xsl/support/package-math.xsl

@@ -0,0 +1,141 @@
+<?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/>.
+*********************************************************************-->
+
+<!-- This stylesheet expects the XHTML built by the  extract-math.xsl -->
+<!-- stylesheet, to have been processed by MathJax 3 and Speech Rule  -->
+<!-- Engine (SRE).  The result, which as an organization created by   -->
+<!-- the script from mathJax is here repackaged with PreTeXt          -->
+<!-- internal elements (in a different namespace).                    -->
+<!-- The output is organized as follows:                              -->
+<!--                                                                  -->
+<!-- pi:math-representations                                          -->
+<!--     pi:math                                                      -->
+<!--     ...                                                          -->
+<!--     pi:math                                                      -->
+<!--     svg/defs                                                     -->
+<!--                                                                  -->
+<!-- The multiple  pi:math  elements have                             -->
+<!--   @id: matches the id of its progenitor in the source            -->
+<!--   @context: category of progenitor ("inline" v. "displaymath")   -->
+<!--       div: one to four, with classes indicating content          -->
+<!--           MathML and/or SVG (structured)                         -->
+<!--           braille, speech (raw content)                          -->
+<!--                                                                  -->
+<!-- The final element is a font cache, which                         -->
+<!-- has the @id attribute value "font-data"                          -->
+
+<xsl:stylesheet
+    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
+    xmlns:xml="http://www.w3.org/XML/1998/namespace"
+    xmlns:pi="http://pretextbook.org/2020/pretext/internal"
+    xmlns:svg="http://www.w3.org/2000/svg"
+    xmlns:math="http://www.w3.org/1998/Math/MathML"
+    exclude-result-prefixes="svg"
+>
+
+<xsl:output method="xml" encoding="UTF-8"/>
+
+<!-- Our simple webpage is processed by MathJax via the mathjax-node-page -->
+<!-- program.  This invocation is parameterized by a choice of SVG output -->
+<!-- or MathML output.  Either way, the structure of the page is          -->
+<!-- identical, so we seem to handle both simultaneously here.  However,  -->
+<!-- only one or the other is present.                                    -->
+
+<!-- This is "pure" MathJax output, we leave adjustments to consumers -->
+
+<!-- Entry template, and cruiser -->
+<!-- We start here, and at each node, we simply descend, -->
+<!-- *unless* some template below kicks into action      -->
+<xsl:template match="/|node()|@*">
+    <xsl:apply-templates select="node()|@*"/>
+</xsl:template>
+
+<!-- We explicitly kill the LaTeX macro div, lest  -->
+<!-- it get picked up as similar to the other math -->
+<xsl:template match="div[@id = 'latex-macros']"/>
+
+<!-- Body has what we want/need -->
+<xsl:template match="body">
+    <pi:math-representations>
+        <xsl:apply-templates select="node()|@*"/>
+        <xsl:text>&#xa;&#xa;</xsl:text>
+    </pi:math-representations>
+</xsl:template>
+
+<!-- Replace PreTeXt "div" w/ location info plus MJ "mjx-data" -->
+<!-- container by a consolidated PreteXt "pi:math" container   -->
+<!-- with location info                                        -->
+<xsl:template match="div/mjx-data">
+    <xsl:text>&#xa;&#xa;</xsl:text>
+    <pi:math>
+        <!-- duplicate location, context info -->
+        <xsl:copy-of select="../@*"/>
+        <!-- pickup whatever gets produced by MJ/SRE script with    -->
+        <!-- its own containerization: MathML, SVG, braille, speech -->
+        <xsl:apply-templates select="math:math|svg:svg|mjx-braille|mjx-speech"/>
+    </pi:math>
+</xsl:template>
+
+<!-- Now duplicate actual representations (structured or -->
+<!-- raw content), always wrapped in an identifying div  -->
+
+<xsl:template match="math:math">
+    <div class="mathml">
+        <xsl:copy-of select="."/>
+    </div>
+</xsl:template>
+
+<xsl:template match="svg:svg">
+    <div class="svg">
+        <xsl:copy-of select="."/>
+    </div>
+</xsl:template>
+
+<xsl:template match="mjx-braille">
+    <div class="braille">
+        <xsl:copy-of select="node()"/>
+    </div>
+</xsl:template>
+
+<xsl:template match="mjx-speech">
+    <div class="speech">
+        <xsl:copy-of select="node()"/>
+    </div>
+</xsl:template>
+
+<!-- SVG font (glyphs) cache -->
+<!-- Following depends on font caching behavior      -->
+<!-- as passed to  mathjax-node-page  routine        -->
+<!--   global cache:  a pile of defs in a single SVG -->
+<!--   no caching:  defs are per-SVG, no match here  -->
+<!-- NB: need to have this prefixed with "body" to   -->
+<!-- identify it as top-level, global situation,     -->
+<!-- rather than local to each individual SVG        -->
+<xsl:template match="body/svg:svg[svg:defs]">
+    <xsl:copy>
+        <xsl:attribute name="id">
+            <xsl:text>font-data</xsl:text>
+        </xsl:attribute>
+        <xsl:apply-templates select="node()|@*"/>
+    </xsl:copy>
+</xsl:template>
+
+</xsl:stylesheet>

package/assets/xsl/support/play-button/README.md

@@ -0,0 +1,46 @@
+Generic Video Preview Image
+
+```
+
+2023-02-07: This image was previously provided for LaTeX output as a macro that resolves to a TikZ version.  See removed code and comments below.  In HTML we use an SVG we have mildly edited.  Search the HTML conversion for a template with name "generic-preview-svg".
+
+The SVG image in this directory is a copy of the HTML SVG code.
+
+ImageMagick's `convert` command has been used to make the PNG here.  The option `-density 600` was used to reduce pixelated lines.
+
+The purpose of the PNG image is to be the static version created via the pre-processor.
+
+
+%% Page: https://commons.wikimedia.org/wiki/File:YouTube_Play_Button.svg
+%% File: https://upload.wikimedia.org/wikipedia/commons/d/d1/YouTube_Play_Button.svg
+%% License text:  This image only consists of simple geometric shapes or text.
+%% It does not meet the threshold of originality needed for copyright protection,
+%% and is therefore in the public domain.
+%% Converted from HTML's SVG into tikZ code via  github.com/kjellmf/svg2tikz.git
+%% Generic red play button (from SVG)
+%% tikz package should be loaded by now
+\definecolor{playred}{RGB}{230,33,23}
+\newcommand{\genericpreview}{
+\begin{tikzpicture}[y=0.80pt, x=0.80pt, yscale=-1.000000, xscale=1.000000, inner sep=0pt, outer sep=0pt]
+\path[fill=playred] (94.9800,28.8400) .. controls (94.9800,28.8400) and
+(94.0400,22.2400) .. (91.1700,19.3400) .. controls (87.5300,15.5300) and
+(83.4500,15.5100) .. (81.5800,15.2900) .. controls (68.1800,14.3200) and
+(48.0600,14.4400) .. (48.0600,14.4400) .. controls (48.0600,14.4400) and
+(27.9400,14.3200) .. (14.5400,15.2900) .. controls (12.6700,15.5100) and
+(8.5900,15.5300) .. (4.9500,19.3400) .. controls (2.0800,22.2400) and
+(1.1400,28.8400) .. (1.1400,28.8400) .. controls (1.1400,28.8400) and
+(0.1800,36.5800) .. (0.0000,44.3300) -- (0.0000,51.5900) .. controls
+(0.1800,59.3400) and (1.1400,67.0800) .. (1.1400,67.0800) .. controls
+(1.1400,67.0800) and (2.0700,73.6800) .. (4.9500,76.5800) .. controls
+(8.5900,80.3900) and (13.3800,80.2700) .. (15.5100,80.6700) .. controls
+(23.0400,81.3900) and (47.2100,81.5600) .. (48.0500,81.5700) .. controls
+(48.0600,81.5700) and (68.1900,81.6000) .. (81.5900,80.6300) .. controls
+(83.4600,80.4100) and (87.5400,80.3900) .. (91.1800,76.5800) .. controls
+(94.0500,73.6800) and (94.9900,67.0800) .. (94.9900,67.0800) .. controls
+(94.9900,67.0800) and (95.9500,59.3300) .. (96.0100,51.5900) --
+(96.0100,44.3300) .. controls (95.9400,36.5800) and (94.9800,28.8400) ..
+(94.9800,28.8400) -- cycle(38.2800,61.4100) -- (38.2800,34.4100) --
+(64.0200,47.9100) -- (38.2800,61.4100) -- cycle;
+\end{tikzpicture}
+}
+```

package/assets/xsl/support/play-button/play-button.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 14 96 68" style="cursor:pointer; position: absolute; top: 0; left: 0; width: 100%; height: 100%;" preserveAspectRatio="none">
+    <path fill="#e62117" d="M94.98,28.84c0,0-0.94-6.6-3.81-9.5c-3.64-3.81-7.72-3.83-9.59-4.05c-13.4-0.97-33.52-0.85-33.52-0.85s-20.12-0.12-33.52,0.85c-1.87,0.22-5.95,0.24-9.59,4.05c-2.87,2.9-3.81,9.5-3.81,9.5S0.18,36.58,0,44.33v7.26c0.18,7.75,1.14,15.49,1.14,15.49s0.93,6.6,3.81,9.5c3.64,3.81,8.43,3.69,10.56,4.09c7.53,0.72,31.7,0.89,32.54,0.9c0.01,0,20.14,0.03,33.54-0.94c1.87-0.22,5.95-0.24,9.59-4.05c2.87-2.9,3.81-9.5,3.81-9.5s0.96-7.75,1.02-15.49v-7.26C95.94,36.58,94.98,28.84,94.98,28.84z M38.28,61.41v-27l25.74,13.5L38.28,61.41z"/>
+</svg>

package/assets/xsl/support/pretext-pg-macros.xsl

@@ -0,0 +1,110 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<!-- ********************************************************************* -->
+<!-- Copyright 2021                                                        -->
+<!-- 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"
+    xmlns:exsl="http://exslt.org/common"
+    xmlns:str="http://exslt.org/strings"
+    extension-element-prefixes="exsl str"
+>
+
+<!-- This style sheet creates a perl library (.pl) file with WeBWorK PG    -->
+<!-- macros that support WeBWorK problems authored in a PreTeXt project.   -->
+<!-- Eventually when used by the pretext script, the name of the perl      -->
+<!-- library file will be generated from the project title.                -->
+
+<!-- Standard conversion groundwork -->
+<xsl:import href="../publisher-variables.xsl"/>
+<xsl:import href="../pretext-assembly.xsl"/>
+<xsl:import href="../pretext-common.xsl"/>
+
+<!-- We need to alert the pretext-assembly.xsl stylesheet     -->
+<!-- that it is being used in the very specific instance      -->
+<!-- of extracting these objects for processing externally,   -->
+<!-- with results collected in additional files, for          -->
+<!-- consultation/collection in a more general use of this    -->
+<!-- stylesheet for the purpose of actually building a useful -->
+<!-- output format.  This variable declaration here overrides -->
+<!-- the default setting of "false" in pretext-assembly.xsl.  -->
+<!-- Look there for a more comprehensive discussion of the    -->
+<!-- necessity of this scheme.                                -->
+<xsl:variable name="b-extracting-pg" select="true()"/>
+
+<!-- We are outputting perl code, and there is no reason to output         -->
+<!-- anything other than "text"                                            -->
+<xsl:output method="text" encoding="UTF-8" />
+
+<!--#######################################################################-->
+<!-- Entry Template                                                        -->
+<!--#######################################################################-->
+
+<xsl:template match="/">
+    <xsl:variable name="macro-file-name">
+        <xsl:choose>
+            <xsl:when test="$docinfo/initialism">
+                <xsl:value-of select="$docinfo/initialism"/>
+            </xsl:when>
+            <xsl:otherwise>
+                <xsl:apply-templates select="$document-root" mode="title-filesafe"/>
+            </xsl:otherwise>
+        </xsl:choose>
+        <text>.pl</text>
+    </xsl:variable>
+    <xsl:variable name="macro-file-content">
+        <xsl:call-template name="header"/>
+        <xsl:apply-templates select="$document-root" mode="latex-image-preamble"/>
+    </xsl:variable>
+    <exsl:document href="{$macro-file-name}" method="text">
+        <xsl:call-template name="sanitize-text">
+            <xsl:with-param name="text" select="$macro-file-content" />
+        </xsl:call-template>
+    </exsl:document>
+</xsl:template>
+
+<xsl:template match="book|article" mode="latex-image-preamble">
+    <xsl:if test="$docinfo/latex-image-preamble">
+        <xsl:text># Return a string containing the latex-image-preamble contents.&#xa;</xsl:text>
+        <xsl:text># To be used by LaTeXImage objects as in:&#xa;</xsl:text>
+        <xsl:text># $image->addToPreamble(latexImagePreamble())&#xa;</xsl:text>
+        <xsl:text>&#xa;</xsl:text>
+        <xsl:text>sub latexImagePreamble {&#xa;</xsl:text>
+        <xsl:text>return &lt;&lt;'END_LATEX_IMAGE_PREAMBLE'&#xa;</xsl:text>
+        <xsl:call-template name="sanitize-text">
+            <xsl:with-param name="text" select="$docinfo/latex-image-preamble" />
+        </xsl:call-template>
+        <xsl:text>&#xa;</xsl:text>
+        <xsl:text>END_LATEX_IMAGE_PREAMBLE&#xa;</xsl:text>
+        <xsl:text>}&#xa;&#xa;</xsl:text>
+    </xsl:if>
+</xsl:template>
+
+<xsl:template name="header">
+    <xsl:text>#############################################################################&#xa;</xsl:text>
+    <xsl:text># This macro library supports WeBWorK problems from the PreTeXt project named&#xa;</xsl:text>
+    <xsl:text># </xsl:text>
+    <xsl:apply-templates select="$document-root" mode="title-full" />
+    <xsl:text>&#xa;</xsl:text>
+    <xsl:text>#############################################################################&#xa;</xsl:text>
+    <xsl:text>&#xa;&#xa;</xsl:text>
+</xsl:template>
+
+</xsl:stylesheet>

package/assets/xsl/support/webpack_static_imports.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" ?>
+<all>
+	<js type="list">
+		<item type="str">prefix-runtime.00db6230172ad960.bundle.js</item>
+		<item type="str">prefix-347.8328b60515045466.bundle.js</item>
+		<item type="str">prefix-runestone.aa624e4071d017c3.bundle.js</item>
+	</js>
+	<css type="list">
+		<item type="str">prefix-347.f9add1ca35d5ad93.css</item>
+		<item type="str">prefix-runestone.51d479d87f8466bb.css</item>
+	</css>
+	<cdn-url type="str">https://runestone.academy/cdn/runestone/</cdn-url>
+	<version type="str">7.4.4</version>
+</all>

package/assets/xsl/tests/README.md

@@ -0,0 +1,24 @@
+# XSL Automated Tests
+
+This folder contains testing utilities for XSL templates. The tests focus on function-like templates for tasks like string manipulation that are used as helpers throughout the XSL stylesheets. Most of these functions are otherwise only observable indirectly through their effects on the output of the main XSL stylesheets.
+
+## Running Tests
+
+To run the tests, you can use the `xsltproc` command-line tool. For example:
+
+```
+xsltproc pretext-text-utilities-test.xsl null.xml
+```
+
+A successfully run will just produce the output `Tests complete!`. If there are any issues, the output will include error messages indicating what went wrong.
+
+## Writing Tests
+
+Ideally, before making changes to any low-level utility XSL templates, a developer should document the intended behavior of the template in a set of tests. These tests can be submitted as part of a pull request as evidence the XSL works as intended and to prevent regressions in the future.
+
+Refer to the existing tests in `pretext-text-utilities-test.xsl` for examples of how to do so.
+
+## Files
+
+- `pretext-text-utilities-test.xsl`: Contains tests for the text utilities templates.
+- `null.xml`: A minimal XML file used as input for the tests.

package/assets/xsl/tests/null.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!-- intentionally empty valid XML file for use with pretext-text-utilities-text.xsl -->
+<nothing>
+</nothing>