@pretextbook/pretext-html 0.6.0 → 0.8.0

package/assets/xsl/pretext-html.xsl

@@ -1,22 +1,22 @@
 <?xml version='1.0'?> <!-- As XML file -->
 
 <!--********************************************************************
-Copyright 2013 Robert A. Beezer
+Copyright (C) 2013-2026  Robert A. Beezer
 
-This file is part of MathBook XML.
+This file is part of PreTeXt.
 
-MathBook XML is free software: you can redistribute it and/or modify
+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).
 
-MathBook XML is distributed in the hope that it will be useful,
+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 MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
+along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 *********************************************************************-->
 
 <!-- http://pimpmyxslt.com/articles/entity-tricks-part2/ -->
@@ -505,8 +505,9 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
                  <xsl:with-param name="heading-level" select="$chunk-heading-level"/>
             </xsl:apply-templates>
         </xsl:with-param>
-        <!-- Set b-has-printout to true if the structural node is or contains a worksheet or handout -->
-        <xsl:with-param name="b-has-printout" select="descendant-or-self::worksheet or descendant-or-self::handout"/>
+        <!-- Set b-has-printout to true if the structural node is or contains a  -->
+        <!-- worksheet or handout, or a PROJECT-LIKE acting as its own printout. -->
+        <xsl:with-param name="b-has-printout" select="descendant-or-self::worksheet or descendant-or-self::handout or descendant::*[&PROJECT-FILTER;][not(ancestor::worksheet|ancestor::handout)][@workspace|.//@workspace]"/>
     </xsl:apply-templates>
 </xsl:template>
 
@@ -754,10 +755,10 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
             <xsl:with-param name="heading-level" select="$next-level"/>
         </xsl:apply-templates>
 
-        <!-- Sometimes conclude with groupwork submission items -->
-        <xsl:if test="$b-is-groupwork">
-            <xsl:apply-templates select="." mode="runestone-groupwork"/>
-        </xsl:if>
+        <!-- Groupwork submission items are not emitted here.  They belong   -->
+        <!-- above the Runestone progress indicator, which the various        -->
+        <!-- "structural-division-inner-content" templates emit as their last -->
+        <!-- act, so each of those emits the submission items just before it. -->
 
         <!-- Include permalink for the section as last child -->
         <xsl:apply-templates select="." mode="permalink"/>
@@ -813,9 +814,8 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
         <xsl:when test="$b-is-groupwork">
             <!-- the actual list of exercises -->
             <xsl:copy-of select="$the-exercises"/>
-            <!-- Infrastructure for groupwork is provided by -->
-            <!--   "structural-division-content"             -->
-            <!-- template (early and late in "section")      -->
+            <!-- and the group selection and submission items -->
+            <xsl:apply-templates select="." mode="runestone-groupwork"/>
             <!-- No progress indicator in this case -->
         </xsl:when>
         <!-- some extra wrapping for timed exercises      -->
@@ -845,6 +845,13 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
     <xsl:apply-templates select="*">
         <xsl:with-param name="heading-level" select="$heading-level"/>
     </xsl:apply-templates>
+    <!-- A "worksheet" electing group work arrives here, and its submission  -->
+    <!-- items go above the progress indicator: Runestone attaches the "mark -->
+    <!-- as completed" control to that indicator, and a reader chooses their -->
+    <!-- group before declaring the page done, not after.                    -->
+    <xsl:if test="$b-host-runestone and (@groupwork = 'yes') and (self::worksheet or self::exercises) and (parent::chapter or parent::appendix)">
+        <xsl:apply-templates select="." mode="runestone-groupwork"/>
+    </xsl:if>
     <!-- only at "section" level. only when building for a Runestone server -->
     <xsl:apply-templates select="." mode="runestone-progress-indicator"/>
 </xsl:template>
@@ -1019,7 +1026,7 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
 <!-- print previews.  A simple button with printer icon that reloads -->
 <!-- the page with a url parameter that tells javascript to switch   -->
 <!-- to printout css and format all the pages and workspace.         -->
-<xsl:template match="&PRINTOUT;" mode="standalone-printout-links">
+<xsl:template match="&PRINTOUT;|&PROJECT-LIKE;" mode="standalone-printout-links">
     <xsl:variable name="printout-id">
         <xsl:apply-templates select="." mode="html-id"/>
     </xsl:variable>
@@ -4040,17 +4047,42 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
 </xsl:template>
 
 <!-- And its CSS class -->
+<!-- A project acting as a standalone printout is marked as such, so the -->
+<!-- stylesheet can treat it as the printable thing it is (for one, its   -->
+<!-- title gets a line of its own rather than running into the text).     -->
 <xsl:template match="&PROJECT-LIKE;" mode="body-css-class">
     <xsl:value-of select="local-name()"/>
     <xsl:text> project-like</xsl:text>
+    <xsl:variable name="b-standalone-printout">
+        <xsl:apply-templates select="." mode="is-standalone-printout"/>
+    </xsl:variable>
+    <xsl:if test="$b-standalone-printout = 'true'">
+        <xsl:text> standalone-printout</xsl:text>
+    </xsl:if>
 </xsl:template>
 
 <!-- When born use this heading -->
+<!-- A standalone printout earns a print preview icon.  Unlike a printout, -->
+<!-- whose icon lives inside its heading, a project's icon is a sibling    -->
+<!-- following the heading: a project's title is a styled thing in its own -->
+<!-- right in several themes (a boxed legend, a filled bar), and the icon  -->
+<!-- has no business inside that.  As a floated sibling it lands just      -->
+<!-- below the title at the right, clear of the title's decoration.        -->
+<!-- NB: a project born hidden as a knowl (the publisher's knowl-project)  -->
+<!-- also comes through here, putting the icon in the knowl's "summary",   -->
+<!-- the only place it is visible while the knowl is closed.  The preview  -->
+<!-- javascript ("flattenKnowledPrintout") knows how to unpack that.       -->
 <xsl:template match="&PROJECT-LIKE;" mode="heading-birth">
     <xsl:param name="heading-level"/>
     <xsl:apply-templates select="." mode="heading-full">
         <xsl:with-param name="heading-level" select="$heading-level"/>
     </xsl:apply-templates>
+    <xsl:variable name="b-standalone-printout">
+        <xsl:apply-templates select="." mode="is-standalone-printout"/>
+    </xsl:variable>
+    <xsl:if test="$b-standalone-printout = 'true'">
+        <xsl:apply-templates select="." mode="standalone-printout-links"/>
+    </xsl:if>
 </xsl:template>
 
 <!-- When used in solutions -->
@@ -5418,6 +5450,10 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
         <xsl:if test="$b-original and not($block-type = 'hidden')">
             <xsl:apply-templates select="." mode="html-id-attribute"/>
         </xsl:if>
+        <!-- Both are empty unless this block is a standalone printout, -->
+        <!-- ie a PROJECT-LIKE with workspace outside of any printout.  -->
+        <xsl:apply-templates select="." mode="page-margins-attribute"/>
+        <xsl:apply-templates select="." mode="page-header-footer-attributes"/>
         <!-- If visible, heading interior to article -->
         <xsl:if test="$block-type = 'visible'">
             <xsl:apply-templates select="." mode="heading-birth">
@@ -6416,16 +6452,14 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
     <!-- $base-pathname needed later for archive links -->
     <xsl:variable name="base-pathname">
         <xsl:value-of select="$generated-directory"/>
-        <xsl:if test="$b-managed-directories">
-            <xsl:choose>
-                <xsl:when test="latex-image">
-                    <xsl:text>latex-image/</xsl:text>
-                </xsl:when>
-                <xsl:when test="pf:prefigure">
-                    <xsl:text>prefigure/</xsl:text>
-                </xsl:when>
-            </xsl:choose>
-        </xsl:if>
+        <xsl:choose>
+            <xsl:when test="latex-image">
+                <xsl:text>latex-image/</xsl:text>
+            </xsl:when>
+            <xsl:when test="pf:prefigure">
+                <xsl:text>prefigure/</xsl:text>
+            </xsl:when>
+        </xsl:choose>
         <!-- NB: node-set in @select will have exactly -->
         <!-- one (child) node, given @match above      -->
         <xsl:apply-templates select="latex-image|pf:prefigure" mode="image-source-basename"/>
@@ -6481,9 +6515,7 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
     <!-- $base-pathname needed later for archive links -->
     <xsl:variable name="base-pathname">
         <xsl:value-of select="$generated-directory"/>
-        <xsl:if test="$b-managed-directories">
-            <xsl:text>sageplot/</xsl:text>
-        </xsl:if>
+        <xsl:text>sageplot/</xsl:text>
         <xsl:apply-templates select="sageplot" mode="image-source-basename"/>
     </xsl:variable>
     <!-- 2d are SVG, 3d are HTML -->
@@ -6521,9 +6553,7 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
     <!-- for source analysis.                                           -->
     <xsl:variable name="base-pathname">
         <xsl:value-of select="$generated-directory"/>
-        <xsl:if test="$b-managed-directories">
-            <xsl:text>asymptote/</xsl:text>
-        </xsl:if>
+        <xsl:text>asymptote/</xsl:text>
         <xsl:apply-templates select="asymptote" mode="image-source-basename"/>
     </xsl:variable>
     <xsl:variable name="html-filename" select="concat($base-pathname, '.html')" />
@@ -6532,9 +6562,7 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
     <!-- insert correctly as a scaled instance                     -->
     <xsl:variable name="html-source-filename">
         <xsl:value-of select="$generated-directory-source"/>
-        <xsl:if test="$b-managed-directories">
-            <xsl:text>asymptote/</xsl:text>
-        </xsl:if>
+        <xsl:text>asymptote/</xsl:text>
         <xsl:apply-templates select="asymptote" mode="image-source-basename"/>
         <xsl:text>.html</xsl:text>
     </xsl:variable>
@@ -6673,16 +6701,14 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
     <!-- Get the filename of the generated svg file -->
     <xsl:variable name="svg-source-filename">
         <xsl:value-of select="$generated-directory-source" />
-        <xsl:if test="$b-managed-directories">
-            <xsl:choose>
-                <xsl:when test="latex-image">
-                    <xsl:text>latex-image/</xsl:text>
-                </xsl:when>
-                <xsl:when test="pf:prefigure">
-                    <xsl:text>prefigure/</xsl:text>
-                </xsl:when>
-            </xsl:choose>
-        </xsl:if>
+        <xsl:choose>
+            <xsl:when test="latex-image">
+                <xsl:text>latex-image/</xsl:text>
+            </xsl:when>
+            <xsl:when test="pf:prefigure">
+                <xsl:text>prefigure/</xsl:text>
+            </xsl:when>
+        </xsl:choose>
         <xsl:apply-templates select="latex-image|pf:prefigure" mode="image-source-basename"/>
         <xsl:text>.svg</xsl:text>
     </xsl:variable>
@@ -6920,7 +6946,9 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
 <!-- 2.  Author must ensure the versions are next to file employed -->
 <!-- 3.  Formatting and case of suffixes is author's choice        -->
 <!-- 4.  Order in suffix list is respected in output               -->
-<!-- 5.  Per-image, with global spec in "docinfo/images/archive"   -->
+<!-- 5.  Per-image, with global spec in the publication file       -->
+<!--     ("/publication/html/images/archive"); the old location    -->
+<!--     within "docinfo" is honored while the former is silent    -->
 <!--                                                               -->
 <!-- The originating image template knows/computes the filename,   -->
 <!-- so this template accepts the filename, sans period and        -->
@@ -6942,28 +6970,42 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
             <!-- last in list that contains the image wins             -->
             <!-- Documented heavily as first "mid-range" specification -->
             <!-- A single @from puts us in mid-range mode              -->
-            <xsl:when test="$docinfo/images/archive[@from]">
-                <!-- context of next "select" filters is "archive" -->
-                <!-- so save off the present context, the "image"  -->
+            <xsl:when test="$image-archives[@from]">
+                <!-- An "archive" node may live in the publication file,  -->
+                <!-- so the id() lookup for its @from must be evaluated   -->
+                <!-- with the context switched into the (assembled)       -->
+                <!-- source, where the present "image" lives.             -->
                 <xsl:variable name="the-image" select="." />
-                <!-- Filter all of the "archive" in docinfo with @from      -->
-                <!-- Subset occurs in document order                        -->
-                <!-- Form two subtrees of all desendant nodes, rooted at    -->
+                <!-- Test each "archive" with @from, in document order:     -->
+                <!-- Form two subtrees of all descendant nodes, rooted at   -->
                 <!--   (1) the image node                                   -->
                 <!--   (2) the node pointed to by @from                     -->
                 <!-- The pipe forms a union of the nodes in the subtrees    -->
                 <!-- "image" is on the subtree @from iff union is no larger -->
-                <xsl:variable name="containing-archives"
-                    select="$docinfo/images/archive[@from][count($the-image/descendant-or-self::node()|id(@from)/descendant-or-self::node())=count(id(@from)/descendant-or-self::node())]" />
+                <!-- Each containing "archive" records its formats, so the  -->
+                <!-- effective (last) one can be read off the collection.   -->
+                <xsl:variable name="containing-archives-rtf">
+                    <xsl:for-each select="$image-archives[@from]">
+                        <xsl:variable name="the-formats" select="string(.)"/>
+                        <xsl:variable name="the-from" select="string(@from)"/>
+                        <xsl:for-each select="$the-image">
+                            <xsl:if test="count($the-image/descendant-or-self::node()|id($the-from)/descendant-or-self::node())=count(id($the-from)/descendant-or-self::node())">
+                                <pi:archive-formats>
+                                    <xsl:value-of select="$the-formats"/>
+                                </pi:archive-formats>
+                            </xsl:if>
+                        </xsl:for-each>
+                    </xsl:for-each>
+                </xsl:variable>
                 <!-- We mimic XSL and the last applicable "archive" is effective -->
                 <!-- This way, big subtrees go first, included subtrees refine   -->
                 <!-- @from can be an empty string and turn off the behavior      -->
                 <!-- We grab the content of the last "archive" to be the formats -->
-                <xsl:value-of select="$containing-archives[last()]/." />
+                <xsl:value-of select="exsl:node-set($containing-archives-rtf)/pi:archive-formats[last()]" />
             </xsl:when>
             <!-- global, presumes one only, ignores subtree versions -->
-            <xsl:when test="$docinfo/images/archive[not(@from)]">
-                <xsl:value-of select="normalize-space($docinfo/images/archive)" />
+            <xsl:when test="$image-archives[not(@from)]">
+                <xsl:value-of select="normalize-space($image-archives)" />
             </xsl:when>
             <!-- nothing begets nothing -->
             <xsl:otherwise />
@@ -10741,11 +10783,7 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
                     <xsl:when test="substring($raw-location,1,4) = 'http'">
                         <xsl:value-of select="$raw-location"/>
                     </xsl:when>
-                    <xsl:when test="not($b-managed-directories)">
-                        <xsl:value-of select="$raw-location"/>
-                    </xsl:when>
                     <xsl:otherwise>
-                        <!-- empty when not using managed directories -->
                         <xsl:value-of select="$external-directory"/>
                         <xsl:value-of select="$raw-location"/>
                     </xsl:otherwise>
@@ -10775,11 +10813,7 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
                     <xsl:when test="substring($raw-location,1,4) = 'http'">
                         <xsl:value-of select="$raw-location"/>
                     </xsl:when>
-                    <xsl:when test="not($b-managed-directories)">
-                        <xsl:value-of select="$raw-location"/>
-                    </xsl:when>
                     <xsl:otherwise>
-                        <!-- empty when not using managed directories -->
                         <xsl:value-of select="$external-directory"/>
                         <xsl:value-of select="$raw-location"/>
                     </xsl:otherwise>
@@ -11341,6 +11375,7 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
             <xsl:value-of select="$external-directory"/>
             <xsl:value-of select="@source"/>
         </xsl:attribute>
+        <xsl:apply-templates select="." mode="html-id-attribute"/>
         <xsl:if test="@qname != ''">
             <xsl:attribute name="data-qname">
                 <xsl:value-of select="@qname" />
@@ -11805,7 +11840,7 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
         </xsl:call-template>
     </xsl:if>
     <!-- image (og,twitter) - if its URL can be constructed -->
-    <xsl:if test="$b-has-baseurl and $docinfo/brandlogo">
+    <xsl:if test="$b-has-baseurl and $b-brandlogo">
         <xsl:call-template name="social-meta-element">
             <xsl:with-param name="og" select="true()"/>
             <xsl:with-param name="twitter" select="true()"/>
@@ -11815,7 +11850,7 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
                 <!-- empty when not using managed directories -->
                 <xsl:value-of select="$baseurl"/>
                 <xsl:value-of select="$external-directory"/>
-                <xsl:value-of select="$docinfo/brandlogo/@source"/>
+                <xsl:value-of select="$brandlogo-source"/>
             </xsl:with-param>
         </xsl:call-template>
         <!-- alttext -->
@@ -11866,7 +11901,7 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
         <xsl:with-param name="property" select="'card'"/>
         <xsl:with-param name="content">
             <xsl:choose>
-                <xsl:when test="$b-has-baseurl and $docinfo/brandlogo">
+                <xsl:when test="$b-has-baseurl and $b-brandlogo">
                     <xsl:text>summary_large_image</xsl:text>
                 </xsl:when>
                 <xsl:otherwise>
@@ -12564,6 +12599,116 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
     </dialog>
 </xsl:template>
 
+<!-- Read-aloud (embedded text-to-speech): a toolbar button, a minimal      -->
+<!-- expanding player (prev, play/pause, next, continue, settings), and the  -->
+<!-- settings dialog that button opens.                                     -->
+<!--                                                                        -->
+<!-- The words below are literal English rather than localization           -->
+<!-- string-ids.  xsl/localizations is for content that reaches more than   -->
+<!-- one output format, and this is an HTML-only control surface.  Nothing  -->
+<!-- here has a LaTeX or EPUB counterpart.  The strings the player *speaks* -->
+<!-- live in js/src/read-aloud/strings.js for the same reason; a            -->
+<!-- JavaScript-side translation layer will eventually address both halves. -->
+<xsl:template name="read-aloud-controls">
+    <button id="ptx-read-aloud-button" class="ptx-read-aloud-button button" title="Read aloud" aria-expanded="false">
+        <xsl:call-template name="insert-symbol">
+            <xsl:with-param name="name" select="'text_to_speech'"/>
+        </xsl:call-template>
+        <span class="name">Read aloud</span>
+    </button>
+    <!-- player-ui.js retitles the toolbar and play/pause buttons as their -->
+    <!-- states change; the titles here are the pre-JavaScript defaults.   -->
+    <div id="ptx-read-aloud-player" class="ptx-read-aloud-player" hidden="hidden" role="group" aria-label="Read aloud">
+        <button id="ptx-read-aloud-prev" class="button" title="Previous sentence">
+            <xsl:call-template name="insert-symbol">
+                <xsl:with-param name="name" select="'skip_previous'"/>
+            </xsl:call-template>
+        </button>
+        <button id="ptx-read-aloud-toggle" class="ptx-read-aloud-toggle button" title="Play">
+            <span class="ptx-read-aloud-icon-play">
+                <xsl:call-template name="insert-symbol">
+                    <xsl:with-param name="name" select="'play_arrow'"/>
+                </xsl:call-template>
+            </span>
+            <span class="ptx-read-aloud-icon-pause">
+                <xsl:call-template name="insert-symbol">
+                    <xsl:with-param name="name" select="'pause'"/>
+                </xsl:call-template>
+            </span>
+        </button>
+        <button id="ptx-read-aloud-next" class="button" title="Next sentence">
+            <xsl:call-template name="insert-symbol">
+                <xsl:with-param name="name" select="'skip_next'"/>
+            </xsl:call-template>
+        </button>
+        <a id="ptx-read-aloud-continue" class="ptx-read-aloud-continue button" hidden="hidden">
+            <xsl:text>Continue</xsl:text>
+            <xsl:call-template name="insert-symbol">
+                <xsl:with-param name="name" select="'play_arrow'"/>
+            </xsl:call-template>
+        </a>
+        <button id="ptx-read-aloud-settings-button" class="ptx-read-aloud-settings-button button" title="Reading settings">
+            <xsl:call-template name="insert-symbol">
+                <xsl:with-param name="name" select="'tune'"/>
+            </xsl:call-template>
+        </button>
+        <!-- No close button: the toolbar button that opened the player is  -->
+        <!-- a disclosure toggle and collapses it again, so a second        -->
+        <!-- dismissal control would only cost space in the navbar row.     -->
+    </div>
+    <!-- Read-aloud settings, opened from the player's own settings button.   -->
+    <!-- Deliberately a sibling of the player rather than a child: the player -->
+    <!-- is a flex row, and a dialog inside it would be a flex item.          -->
+    <dialog class="ptx-dialog ptx-read-aloud-settings-popup" id="ptx-read-aloud-settings-popup">
+        <div class="ptx-readability-options-popup-controls">
+            <h2 class="heading">Read aloud settings</h2>
+            <button class="ptx-read-aloud-settings-close-button button" id="ptx-read-aloud-settings-close-button" title="Close">
+                <xsl:call-template name="insert-symbol">
+                    <xsl:with-param name="name" select="'close'"/>
+                </xsl:call-template>
+            </button>
+        </div>
+        <div class="ptx-readability-options-group">
+            <label for="ptx-read-aloud-voice">
+                <xsl:call-template name="insert-symbol">
+                    <xsl:with-param name="name" select="'record_voice_over'"/>
+                </xsl:call-template>
+                <span>Voice</span>
+            </label>
+            <!-- options populated by settings.js from speechSynthesis.getVoices() -->
+            <select id="ptx-read-aloud-voice"></select>
+            <label class="ptx-readability-slider-label" for="ptx-read-aloud-rate">
+                <xsl:call-template name="insert-symbol">
+                    <xsl:with-param name="name" select="'speed'"/>
+                </xsl:call-template>
+                <span>Reading speed</span>
+                <output id="ptx-read-aloud-rate-value" for="ptx-read-aloud-rate">1×</output>
+            </label>
+            <input type="range" id="ptx-read-aloud-rate" min="0.5" max="2" step="0.1" value="1"/>
+            <label for="ptx-read-aloud-asides">
+                <xsl:call-template name="insert-symbol">
+                    <xsl:with-param name="name" select="'unfold_more'"/>
+                </xsl:call-template>
+                <span>Collapsed content</span>
+            </label>
+            <!-- What happens to a knowl's body once its title is read. -->
+            <select id="ptx-read-aloud-asides">
+                <option value="skip">Announce, do not read</option>
+                <option value="read">Read automatically</option>
+            </select>
+            <label for="ptx-read-aloud-autoscroll">
+                <input type="checkbox" id="ptx-read-aloud-autoscroll" checked="checked"/>
+                <span>Follow along (auto-scroll)</span>
+            </label>
+            <!-- Unchecked by default: this one navigates, so it is opt-in. -->
+            <label for="ptx-read-aloud-autocontinue">
+                <input type="checkbox" id="ptx-read-aloud-autocontinue"/>
+                <span>Continue to the next page automatically</span>
+            </label>
+        </div>
+    </dialog>
+</xsl:template>
+
 <xsl:template name="embed-button">
     <xsl:variable name="embed-localization">
         <xsl:apply-templates select="." mode="type-name">
@@ -12839,6 +12984,10 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
          <xsl:if test="$b-has-embed-button">
              <xsl:call-template name="embed-button" />
         </xsl:if>
+        <!-- Read-aloud button and expanding player  -->
+        <xsl:if test="$b-read-aloud">
+            <xsl:call-template name="read-aloud-controls" />
+        </xsl:if>
         <xsl:call-template name="readability-options" />
     </span>
 </xsl:template>
@@ -13725,6 +13874,8 @@ TODO:
             <xsl:text>hasSage: </xsl:text><xsl:value-of select="$b-has-sage"/><xsl:text>,&#xa;</xsl:text>
             <xsl:text>isReact: </xsl:text><xsl:value-of select="$b-debug-react"/><xsl:text>,&#xa;</xsl:text>
             <xsl:text>htmlPresentation: </xsl:text><xsl:value-of select="$b-html-presentation"/><xsl:text>,&#xa;</xsl:text>
+            <!-- Added to support read-aloud functionality; shouldn't hurt anything else -->
+            <xsl:text>lang: "</xsl:text><xsl:value-of select="$document-language"/><xsl:text>",&#xa;</xsl:text>
         <xsl:text>});&#xa;</xsl:text>
     </script>
     <!-- MathJax 4 CDN -->
@@ -14296,6 +14447,11 @@ TODO:
                  ?v= query string busts the browser cache when the CLI version changes,
                  restoring the cache-busting that pretext_add_on.js?x=1 previously provided. -->
             <script src="{$html.js.dir}/pretext-core.js?v={$cli.version}"></script>
+            <!-- Read-aloud bundle: only when the publication option is on,
+                 so an opted-out build ships zero text-to-speech bytes. -->
+            <xsl:if test="$b-read-aloud">
+                <script src="{$html.js.dir}/pretext-read-aloud.js?v={$cli.version}"></script>
+            </xsl:if>
         </xsl:when>
         <xsl:when test="$b-debug-react-local">
             <script type="module" defer="" src="./static/js/main.js"></script>
@@ -14545,22 +14701,22 @@ TODO:
 <!-- Brand Logo -->
 <!-- Place image in masthead -->
 <!-- We either create a link with an image, or just an image. -->
-<!-- NB: This template does nothing unless $docinfo/brandlogo -->
-<!-- exists, in which case we assume @source exists, as       -->
-<!-- required by the schema.                                  -->
+<!-- NB: This template does nothing unless a brand logo has   -->
+<!-- been elected (publication file, or the deprecated        -->
+<!-- "docinfo" location), which requires its @source.         -->
 <xsl:template name="brand-logo">
-    <xsl:if test="$docinfo/brandlogo">
+    <xsl:if test="$b-brandlogo">
         <xsl:variable name="location">
             <!-- empty when not using managed directories -->
             <xsl:value-of select="$external-directory"/>
-            <xsl:value-of select="$docinfo/brandlogo/@source"/>
+            <xsl:value-of select="$brandlogo-source"/>
         </xsl:variable>
 
         <xsl:choose>
-            <xsl:when test="$docinfo/brandlogo/@url">
+            <xsl:when test="not($brandlogo-url = '')">
                 <a id="logo-link" class="logo-link" target="_blank" >
                     <xsl:attribute name="href">
-                        <xsl:value-of select="$docinfo/brandlogo/@url"/>
+                        <xsl:value-of select="$brandlogo-url"/>
                     </xsl:attribute>
                     <img src="{$location}" alt="Logo image"/>
                 </a>
@@ -14694,7 +14850,24 @@ TODO:
 <!-- We put page-margins-attributes only on printout sections -->
 <xsl:template match="*" mode="page-margins-attribute"/>
 
+<!-- A PROJECT-LIKE acting as a standalone printout is paginated by the -->
+<!-- same javascript, so it needs the same data.  It has no margin      -->
+<!-- attributes of its own, so "printout-margin" falls through to the   -->
+<!-- publisher's worksheet defaults for all four sides.                 -->
+<xsl:template match="&PROJECT-LIKE;" mode="page-margins-attribute">
+    <xsl:variable name="b-standalone-printout">
+        <xsl:apply-templates select="." mode="is-standalone-printout"/>
+    </xsl:variable>
+    <xsl:if test="$b-standalone-printout = 'true'">
+        <xsl:call-template name="printout-margins-attribute"/>
+    </xsl:if>
+</xsl:template>
+
 <xsl:template match="&PRINTOUT;" mode="page-margins-attribute">
+    <xsl:call-template name="printout-margins-attribute"/>
+</xsl:template>
+
+<xsl:template name="printout-margins-attribute">
     <xsl:attribute name="data-margins">
         <!-- A space-separated list for top, right, bottom, and left margins -->
         <xsl:apply-templates select="." mode="printout-margin">
@@ -14722,7 +14895,20 @@ TODO:
 <!-- Add data-* attributes for headers and footers -->
 <xsl:template match="*" mode="page-header-footer-attributes"/>
 
+<xsl:template match="&PROJECT-LIKE;" mode="page-header-footer-attributes">
+    <xsl:variable name="b-standalone-printout">
+        <xsl:apply-templates select="." mode="is-standalone-printout"/>
+    </xsl:variable>
+    <xsl:if test="$b-standalone-printout = 'true'">
+        <xsl:call-template name="printout-header-footer-attributes"/>
+    </xsl:if>
+</xsl:template>
+
 <xsl:template match="&PRINTOUT;" mode="page-header-footer-attributes">
+    <xsl:call-template name="printout-header-footer-attributes"/>
+</xsl:template>
+
+<xsl:template name="printout-header-footer-attributes">
     <xsl:if test="not($ws-header-first-left = '')">
         <xsl:attribute name="data-header-first-left">
             <xsl:value-of select="normalize-space($ws-header-first-left)"/>

package/assets/xsl/pretext-json-manifest.xsl

@@ -1,7 +1,7 @@
 <?xml version='1.0'?> <!-- As XML file -->
 
 <!--********************************************************************
-Copyright 2018 Robert A. Beezer
+Copyright (C) 2018-2026  Robert A. Beezer
 
 This file is part of PreTeXt.
 

package/assets/xsl/pretext-jupyter.xsl

@@ -1,22 +1,22 @@
 <?xml version='1.0'?> <!-- As XML file -->
 
 <!--********************************************************************
-Copyright 2015 Robert A. Beezer
+Copyright (C) 2015-2026  Robert A. Beezer
 
-This file is part of MathBook XML.
+This file is part of PreTeXt.
 
-MathBook XML is free software: you can redistribute it and/or modify
+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).
 
-MathBook XML is distributed in the hope that it will be useful,
+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 MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
+along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 *********************************************************************-->
 
 <!-- http://pimpmyxslt.com/articles/entity-tricks-part2/ -->

package/assets/xsl/pretext-latex-classic.xsl

@@ -1,7 +1,7 @@
 <?xml version='1.0'?>
 
 <!--********************************************************************
-Copyright 2020 Robert A. Beezer
+Copyright (C) 2020-2026  Robert A. Beezer
 
 This file is part of PreTeXt.