@pretextbook/pretext-html 0.7.0 → 0.9.0

package/assets/xsl/pretext-html.xsl

@@ -224,6 +224,7 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 <xsl:variable name="b-has-myopenmath"   select="boolean($document-root//myopenmath)"/>
 <xsl:variable name="b-has-stack"        select="boolean($document-root//exercise/stack)"/>
 <xsl:variable name="b-has-program"      select="boolean($document-root//program)"/>
+<xsl:variable name="b-has-gdscript"     select="boolean($document-root//program[@language='gdscript'])"/>
 <xsl:variable name="b-has-sage"         select="boolean($document-root//sage)"/>
 <xsl:variable name="b-has-sfrac"        select="boolean($document-root//m[contains(text(),'sfrac')] or $document-root//mrow[contains(text(),'sfrac')])" />
 <xsl:variable name="b-has-geogebra"     select="boolean($document-root//interactive[@platform='geogebra'])"/>
@@ -249,17 +250,6 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 <xsl:variable name="b-needs-custom-marker-css" select="boolean(exsl:node-set($ol-markers)/ol-markers/ol-marker)"/>
 
 
-<!-- ######## -->
-<!-- WeBWorK  -->
-<!-- ######## -->
-
-<!-- We mine some values from the first "WW representation" to have been -->
-<!-- inserted into the source by the pre-processor ("assembly") when     -->
-<!-- making dynamic exercises.                                           -->
-
-<xsl:variable name="webwork-major-version" select="$document-root//webwork-reps[1]/@webwork2_major_version"/>
-<xsl:variable name="webwork-minor-version" select="$document-root//webwork-reps[1]/@webwork2_minor_version"/>
-
 <!-- #### EXPERIMENTAL #### -->
 <!-- We allow for the HTML conversion to chunk output, starting  -->
 <!-- from an arbitrary node.  $subtree-node needs context.       -->
@@ -505,8 +495,9 @@ along with PreTeXt.  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>
 
@@ -561,6 +552,7 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
             <xsl:if test="not($num = '')">
                 <span class="codenumber">
                     <xsl:value-of select="$num" />
+                    <xsl:apply-templates select="." mode="division-number-separator"/>
                 </span>
                 <xsl:text> </xsl:text>
             </xsl:if>
@@ -982,6 +974,7 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
     <xsl:call-template name="space-styled"/>
     <span class="codenumber">
         <xsl:apply-templates select="." mode="number" />
+        <xsl:apply-templates select="." mode="division-number-separator"/>
     </span>
     <xsl:call-template name="space-styled"/>
     <span class="title">
@@ -1025,7 +1018,7 @@ along with PreTeXt.  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>
@@ -1175,6 +1168,12 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 </xsl:template>
 
 <xsl:template match="affiliation">
+    <xsl:if test="position">
+        <xsl:apply-templates select="position" />
+        <xsl:if test="position/following-sibling::*">
+            <br />
+        </xsl:if>
+    </xsl:if>
     <xsl:if test="department">
         <xsl:apply-templates select="department" />
         <xsl:if test="department/following-sibling::*">
@@ -1196,11 +1195,11 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 </xsl:template>
 
 <!-- Departments and Institutions are free-form, or sequences of lines -->
-<xsl:template match="department|institution|location">
+<xsl:template match="position|department|institution|location">
     <xsl:apply-templates/>
 </xsl:template>
 
-<xsl:template match="department[line]|institution[line]|location[line]">
+<xsl:template match="position[line]|department[line]|institution[line]|location[line]">
     <xsl:apply-templates select="line" />
 </xsl:template>
 
@@ -1215,10 +1214,11 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
     </div>
 </xsl:template>
 
-<!-- General support (not for a particular author) -->
+<!-- General support (not for a particular author).  The schema -->
+<!-- says a "support" statement is text-level, mixed content    -->
 <xsl:template match="bibinfo/support">
     <div class="support">
-        <xsl:apply-templates select="*"/>
+        <xsl:apply-templates select="node()"/>
     </div>
 </xsl:template>
 
@@ -1751,11 +1751,25 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
             <!-- https://stackoverflow.com/questions/538293/find-common-parent-using-xpath -->
             <xsl:variable name="nearest-common-ancestor"
                           select="./ancestor::*[count(. | $link/ancestor::*) = count($link/ancestor::*)] [1]"/>
-            <xsl:variable name="nearest-ancestor-level">
-                <xsl:apply-templates select="$nearest-common-ancestor" mode="enclosing-level"/>
-            </xsl:variable>
-            <!-- remove not(), replace operator with <, then radically different behavior -->
-            <xsl:value-of select="not($nearest-ancestor-level >= $chunk-level)"/>
+            <xsl:choose>
+                <!-- A division's "introduction" or "conclusion" renders on   -->
+                <!-- its division's page, whole, whatever the chunk level.    -->
+                <!-- So a link and target together inside one companion are   -->
+                <!-- always on one page, though the companion's level would   -->
+                <!-- say otherwise.  Deliberately a containment test, not     -->
+                <!-- level arithmetic: the levels of these companions are     -->
+                <!-- slated for rework.                                       -->
+                <xsl:when test="$nearest-common-ancestor/ancestor-or-self::introduction[parent::*[&STRUCTURAL-FILTER;]] or $nearest-common-ancestor/ancestor-or-self::conclusion[parent::*[&STRUCTURAL-FILTER;]]">
+                    <xsl:value-of select="false()"/>
+                </xsl:when>
+                <xsl:otherwise>
+                    <xsl:variable name="nearest-ancestor-level">
+                        <xsl:apply-templates select="$nearest-common-ancestor" mode="enclosing-level"/>
+                    </xsl:variable>
+                    <!-- remove not(), replace operator with <, then radically different behavior -->
+                    <xsl:value-of select="not($nearest-ancestor-level >= $chunk-level)"/>
+                </xsl:otherwise>
+            </xsl:choose>
         </xsl:otherwise>
     </xsl:choose>
 </xsl:template>
@@ -2745,6 +2759,35 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 <!-- Footnotes -->
 <!-- ######### -->
 
+<!-- A table note ("tn") drops only its superscript letter mark at the -->
+<!-- cell location, linked to the note text collected below the table  -->
+<!-- in the "tabular-inclusion" template.  Letters count per-tabular   -->
+<!-- in document order (Notes to tables: CMoS 18th ed., 3.77-3.81;     -->
+<!-- specific notes at 3.80).  Adjacency is the presentation: a note   -->
+<!-- sits just below its table, so there is no knowl.                  -->
+<xsl:template match="tabular//tn">
+    <xsl:variable name="note-number">
+        <xsl:apply-templates select="." mode="number"/>
+    </xsl:variable>
+    <sup class="tablenote-mark">
+        <xsl:apply-templates select="." mode="html-id-attribute"/>
+        <a>
+            <xsl:attribute name="href">
+                <xsl:text>#</xsl:text>
+                <xsl:apply-templates select="." mode="html-id"/>
+                <xsl:text>-note</xsl:text>
+            </xsl:attribute>
+            <xsl:attribute name="aria-label">
+                <xsl:text>Go to table note </xsl:text>
+                <xsl:value-of select="$note-number"/>
+            </xsl:attribute>
+            <i>
+                <xsl:value-of select="$note-number"/>
+            </i>
+        </a>
+    </sup>
+</xsl:template>
+
 <!-- Currently implemented as a details html element with no guardrails   -->
 <!-- on nested content. Other footnotes, block content, etc... will all   -->
 <!-- be rendered, but perhaps not well. Caveat emptor.                    -->
@@ -4046,17 +4089,42 @@ along with PreTeXt.  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 -->
@@ -5424,6 +5492,10 @@ along with PreTeXt.  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">
@@ -6042,10 +6114,11 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
     </xsl:element>
 </xsl:template>
 
-<!-- A "headnote" prefaces the content of a "glossary".  Below -->
-<!-- is modeled on block introductions (just above), but with  -->
-<!-- no "title" and with a provisional recycled CSS class.     -->
-<xsl:template match="glossary/headnote">
+<!-- A "headnote" prefaces the list of a list-like division: a -->
+<!-- "glossary", a "references", an "index", an "appendix"     -->
+<!-- that is a notation list.  Below is modeled on block       -->
+<!-- introductions (just above), but with no "title".          -->
+<xsl:template match="glossary/headnote|references/headnote|index/headnote|appendix/headnote">
     <xsl:param name="b-original" select="true()" />
     <section class="headnote">
         <xsl:if test="$b-original">
@@ -6422,16 +6495,14 @@ along with PreTeXt.  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"/>
@@ -6487,9 +6558,7 @@ along with PreTeXt.  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 -->
@@ -6527,9 +6596,7 @@ along with PreTeXt.  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')" />
@@ -6538,9 +6605,7 @@ along with PreTeXt.  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>
@@ -6679,16 +6744,14 @@ along with PreTeXt.  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>
@@ -8121,6 +8184,44 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
             <xsl:with-param name="ambient-relative-width" select="$width" />
         </xsl:apply-templates>
     </table>
+    <!-- Table notes ("tn") collect just below the table, lettered in -->
+    <!-- reading order, which is document order of the marks (Notes   -->
+    <!-- to tables: CMoS 18th ed., 3.77-3.81; specific notes at       -->
+    <!-- 3.80).  Disjoint from true footnote numbering.               -->
+    <xsl:if test=".//tn">
+        <!-- each note is a list item (not a "p"): one tight -->
+        <!-- line per note, free of paragraph margins        -->
+        <ol class="tablenotes" aria-label="Table notes">
+            <xsl:for-each select=".//tn">
+                <xsl:variable name="note-number">
+                    <xsl:apply-templates select="." mode="number"/>
+                </xsl:variable>
+                <li class="tablenote">
+                    <xsl:attribute name="id">
+                        <xsl:apply-templates select="." mode="html-id"/>
+                        <xsl:text>-note</xsl:text>
+                    </xsl:attribute>
+                    <sup>
+                        <a>
+                            <xsl:attribute name="href">
+                                <xsl:text>#</xsl:text>
+                                <xsl:apply-templates select="." mode="html-id"/>
+                            </xsl:attribute>
+                            <xsl:attribute name="aria-label">
+                                <xsl:text>Back to table note reference </xsl:text>
+                                <xsl:value-of select="$note-number"/>
+                            </xsl:attribute>
+                            <i>
+                                <xsl:value-of select="$note-number"/>
+                            </i>
+                        </a>
+                    </sup>
+                    <xsl:text> </xsl:text>
+                    <xsl:apply-templates/>
+                </li>
+            </xsl:for-each>
+        </ol>
+    </xsl:if>
 </xsl:template>
 
 <!-- A row of table -->
@@ -9049,8 +9150,13 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
     </code>
 </xsl:template>
 
+<!-- A copy button serves a block of code; within a "tabular"  -->
+<!-- cell the content is short and the floating button crowds  -->
+<!-- the cell, so there we decline to provide one.             -->
 <xsl:template name="insert-clipboardable-class">
-    <xsl:text> clipboardable</xsl:text>
+    <xsl:if test="not(ancestor::tabular)">
+        <xsl:text> clipboardable</xsl:text>
+    </xsl:if>
 </xsl:template>
 
 <!-- 100% analogue of LaTeX's verbatim            -->
@@ -10352,30 +10458,30 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 </xsl:template>
 
 <!-- HTML Code                                                  -->
-<!-- Simply create deep-copy of HTML elements                   -->
 <!-- TODO: should this be a div, with width and height?         -->
-<!-- Authored HTML goes into the page verbatim.  But a plain    -->
-<!-- "xsl:copy-of" materializes every namespace in scope at the -->
-<!-- source location as a declaration on the copy: the source   -->
-<!-- file's own declarations (such as XInclude) and any         -->
-<!-- namespace employed by the assembly machinery.  So instead  -->
-<!-- we rebuild each element, which carries along only the      -->
-<!-- namespaces actually in use.                                -->
+<!-- Authored HTML goes into the page, which is the content's   -->
+<!-- only destination, and an HTML parser has no notion of      -->
+<!-- namespaces.  So the copy keeps just the local name of each -->
+<!-- element: an author declares the XHTML namespace once (say, -->
+<!-- a prefix on the "slate") to satisfy validation, and the    -->
+<!-- output carries plain HTML tags with no declarations at     -->
+<!-- all.  (This utility may serve other embedded-markup        -->
+<!-- copying; nothing about it is specific to a "slate".)       -->
 <xsl:template match="slate[@surface = 'html']">
-    <xsl:apply-templates select="*" mode="copy-authored-html"/>
+    <xsl:apply-templates select="*" mode="copy-authored-xml"/>
 </xsl:template>
 
 <!-- Attributes in the internal namespace are the assembly's     -->
 <!-- identification stamps, not the author's work, so they stay  -->
 <!-- out of the copy.                                            -->
-<xsl:template match="*" mode="copy-authored-html">
-    <xsl:element name="{name()}" namespace="{namespace-uri()}">
+<xsl:template match="*" mode="copy-authored-xml">
+    <xsl:element name="{local-name()}">
         <xsl:copy-of select="@*[namespace-uri(.) != 'http://pretextbook.org/2020/pretext/internal']"/>
-        <xsl:apply-templates select="node()" mode="copy-authored-html"/>
+        <xsl:apply-templates select="node()" mode="copy-authored-xml"/>
     </xsl:element>
 </xsl:template>
 
-<xsl:template match="text()|comment()|processing-instruction()" mode="copy-authored-html">
+<xsl:template match="text()|comment()|processing-instruction()" mode="copy-authored-xml">
     <xsl:copy/>
 </xsl:template>
 
@@ -10763,11 +10869,7 @@ along with PreTeXt.  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>
@@ -10797,11 +10899,7 @@ along with PreTeXt.  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>
@@ -11085,7 +11183,7 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 <!-- WeBWorK Javascript header -->
 <xsl:template name="webwork-js">
     <xsl:if test="$b-has-webwork-reps">
-        <script src="{$html.js.dir}/pretext-webwork/2.{$webwork-minor-version}/pretext-webwork.js"></script>
+        <script src="{$html.js.dir}/pretext-webwork.js"></script>
         <script src="{$webwork-server}/webwork2_files/node_modules/iframe-resizer/js/iframeResizer.min.js"></script>
     </xsl:if>
 </xsl:template>
@@ -11156,19 +11254,22 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
     <xsl:param name="b-has-answer"/>
     <xsl:param name="b-has-solution"/>
 
-    <!-- For Runestone, the WW problem is handled in isolation, -->
-    <!-- yet capturing and storing student work/results needs   -->
-    <!-- to be associated with the parent/enclosing "exercise"  -->
-    <!-- (or PROJECT-LIKE).  So in this case (only) we place    -->
-    <!-- an id value on the  div.exercise-wrapper that is       -->
-    <!-- derived from the parent.  Otherwise, we use the        -->
-    <!-- parent @pi:assembly-id with a "-ww-inner" suffix.      -->
-    <!-- The suffix ensures the inner wrapper's DOM id is       -->
-    <!-- distinct from the enclosing "exercise" article's       -->
-    <!-- id (which also holds the @pi:assembly-id value).       -->
-    <!-- Without the suffix, JavaScript (handleWW) would        -->
-    <!-- look up the inner id with getElementById and find      -->
-    <!-- the outer "exercise" article instead.                  -->
+    <!-- For Runestone, the WW problem is handled in isolation,   -->
+    <!-- yet capturing and storing student work/results needs     -->
+    <!-- to be associated with the parent/enclosing "exercise"    -->
+    <!-- (or PROJECT-LIKE).  So in this case (only) we place      -->
+    <!-- an id value on the  div.exercise-wrapper that is         -->
+    <!-- derived from the parent.  Otherwise, we use the          -->
+    <!-- @assembly-id of this "webwork-reps" with a "-ww-inner"   -->
+    <!-- suffix.  That attribute is NOT the assembly stamp and    -->
+    <!-- carries no "pi" prefix: it is written by webwork.py into -->
+    <!-- the generated representation file, naming it for the     -->
+    <!-- exercise it belongs to.  The suffix ensures the inner    -->
+    <!-- wrapper's DOM id is distinct from the enclosing          -->
+    <!-- "exercise" article's id, which holds the same value.     -->
+    <!-- Without the suffix, JavaScript (handleWW) would          -->
+    <!-- look up the inner id with getElementById and find        -->
+    <!-- the outer "exercise" article instead.                    -->
     <xsl:variable name="inner-id">
         <xsl:choose>
             <xsl:when test="$b-host-runestone">
@@ -11176,7 +11277,7 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
                 <xsl:text>-ww-rs</xsl:text>
             </xsl:when>
             <xsl:otherwise>
-                <xsl:value-of select="concat(@pi:assembly-id, '-ww-inner')"/>
+                <xsl:value-of select="concat(@assembly-id, '-ww-inner')"/>
             </xsl:otherwise>
         </xsl:choose>
     </xsl:variable>
@@ -11324,7 +11425,7 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
     </xsl:variable>
     <!-- build the iframe -->
     <!-- mimicking Mike Gage's blog post -->
-    <iframe name="{concat(@pi:assembly-id, '-ww-inner')}" width="{$design-width}" src="{$the-url}" data-seed="{static/@seed}"/>
+    <iframe name="{concat(@assembly-id, '-ww-inner')}" width="{$design-width}" src="{$the-url}" data-seed="{static/@seed}"/>
     <script>
         <xsl:text>iFrameResize({log:true,inPageLinks:true,resizeFrom:'child',checkOrigin:["</xsl:text>
         <xsl:value-of select="$webwork-server" />
@@ -12587,6 +12688,116 @@ along with PreTeXt.  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">
@@ -12862,6 +13073,10 @@ along with PreTeXt.  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>
@@ -13070,6 +13285,7 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
             <xsl:if test="not($the-number = '')">
                 <span class="codenumber">
                     <xsl:value-of select="$the-number" />
+                    <xsl:apply-templates select="." mode="division-number-separator"/>
                 </span>
                 <!-- separating space, only if needed -->
                 <xsl:text> </xsl:text>
@@ -13748,6 +13964,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 -->
@@ -14119,6 +14337,9 @@ TODO:
     <xsl:if test="$b-has-program and not($b-debug-react)">
         <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.26.0/components/prism-core.min.js"></script>
         <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.26.0/plugins/autoloader/prism-autoloader.min.js"></script>
+        <xsl:if test="$b-has-gdscript">
+            <script src="{$html.js.dir}/prism/gdscript-prism.js"></script>
+        </xsl:if>
         <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.26.0/plugins/line-numbers/prism-line-numbers.min.js" integrity="sha512-dubtf8xMHSQlExGRQ5R7toxHLgSDZ0K7AunqPWHXmJQ8XyVIG19S1T95gBxlAeGOK02P4Da2RTnQz0Za0H0ebQ==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
         <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.26.0/plugins/line-highlight/prism-line-highlight.min.js" integrity="sha512-93uCmm0q+qO5Lb1huDqr7tywS8A2TFA+1/WHvyiWaK6/pvsFl6USnILagntBx8JnVbQH5s3n0vQZY6xNthNfKA==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
         <xsl:if test="$b-html-theme-legacy or $b-reveal-build" >
@@ -14319,6 +14540,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>
@@ -14717,7 +14943,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">
@@ -14745,7 +14988,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)"/>