@pretextbook/pretext-html 0.5.0 → 0.7.0

package/assets/xsl/pretext-runestone-static.xsl

@@ -1,7 +1,7 @@
 <?xml version='1.0'?> <!-- As XML file -->
 
 <!--********************************************************************
-Copyright 2022 Robert A. Beezer
+Copyright (C) 2022-2026  Robert A. Beezer
 
 This file is part of PreTeXt.
 
@@ -55,11 +55,17 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 
 <!-- These get-programming-language templates duplicate logic from pretext-common  -->
 <!-- as the contents of that file are not available yet.                           -->
+<!-- NB: these run during assembly, before the repair pass has produced the tree  -->
+<!-- behind $docinfo, so they read the version tree and must recognize both the   -->
+<!-- "docinfo/defaults" home (preferred) and the deprecated top-level placement.  -->
 <xsl:template match="program" mode="get-programming-language">
     <xsl:choose>
         <xsl:when test="@language">
             <xsl:value-of select="@language" />
         </xsl:when>
+        <xsl:when test="$version-docinfo/defaults/programs/@language">
+            <xsl:value-of select="$version-docinfo/defaults/programs/@language" />
+        </xsl:when>
         <xsl:when test="$version-docinfo/programs/@language">
             <xsl:value-of select="$version-docinfo/programs/@language" />
         </xsl:when>
@@ -71,9 +77,15 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
         <xsl:when test="@language">
             <xsl:value-of select="@language" />
         </xsl:when>
+        <xsl:when test="$version-docinfo/defaults/parsons/@language">
+            <xsl:value-of select="$version-docinfo/defaults/parsons/@language" />
+        </xsl:when>
         <xsl:when test="$version-docinfo/parsons/@language">
             <xsl:value-of select="$version-docinfo/parsons/@language" />
         </xsl:when>
+        <xsl:when test="$version-docinfo/defaults/programs/@language">
+            <xsl:value-of select="$version-docinfo/defaults/programs/@language" />
+        </xsl:when>
         <xsl:when test="$version-docinfo/programs/@language">
             <xsl:value-of select="$version-docinfo/programs/@language" />
         </xsl:when>

package/assets/xsl/pretext-runestone.xsl

@@ -1,7 +1,7 @@
 <?xml version='1.0'?> <!-- As XML file -->
 
 <!--********************************************************************
-Copyright 2022 Robert A. Beezer
+Copyright (C) 2022-2026  Robert A. Beezer
 
 This file is part of PreTeXt.
 
@@ -2292,12 +2292,40 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
                                 <xsl:with-param name="hosting" select="$hosting"/>
                             </xsl:call-template>
                             <!-- CodeTailor: when an author requests it, emit the data       -->
-                            <!-- attributes that have Runestone offer the reader an          -->
-                            <!-- automatically-personalized Parsons puzzle as scaffolding     -->
+                            <!-- The presence of @codetailor has Runestone offer the reader   -->
+                            <!-- an automatically-personalized Parsons puzzle as scaffolding  -->
                             <!-- (a "Get Help" button) when they are stuck on the exercise.   -->
-                            <xsl:if test="@codetailor = 'yes'">
-                                <xsl:attribute name="data-parsonspersonalize">movable</xsl:attribute>
-                                <xsl:attribute name="data-parsonsexample">LLM-example</xsl:attribute>
+                            <!-- The value "all" scrambles a complete solution, while         -->
+                            <!-- "incorrect" locks blocks the reader already has right, so    -->
+                            <!-- only wrong ones move.  A @codetailor-fallback names, by      -->
+                            <!-- @xml:id, a Parsons problem of this document to present when  -->
+                            <!-- a personalized puzzle cannot be generated; in its absence,   -->
+                            <!-- generation is always requested.                              -->
+                            <xsl:if test="@codetailor">
+                                <xsl:attribute name="data-parsonspersonalize">
+                                    <xsl:choose>
+                                        <xsl:when test="@codetailor = 'incorrect'">
+                                            <xsl:text>partial</xsl:text>
+                                        </xsl:when>
+                                        <!-- "all", the only other value the schema admits -->
+                                        <xsl:otherwise>
+                                            <xsl:text>movable</xsl:text>
+                                        </xsl:otherwise>
+                                    </xsl:choose>
+                                </xsl:attribute>
+                                <xsl:attribute name="data-parsonsexample">
+                                    <xsl:choose>
+                                        <xsl:when test="@codetailor-fallback">
+                                            <xsl:call-template name="runestone-targets">
+                                                <xsl:with-param name="id-list" select="@codetailor-fallback"/>
+                                                <xsl:with-param name="separator" select="''"/>
+                                            </xsl:call-template>
+                                        </xsl:when>
+                                        <xsl:otherwise>
+                                            <xsl:text>LLM-example</xsl:text>
+                                        </xsl:otherwise>
+                                    </xsl:choose>
+                                </xsl:attribute>
                             </xsl:if>
                             <!-- This is a bit awful, but we need to figure out how much margin     -->
                             <!-- to add to runestone dividers. It must match indentation used for   -->

package/assets/xsl/pretext-sage-doctest.xsl

@@ -1,5 +1,23 @@
 <?xml version='1.0'?> <!-- As XML file -->
 
+<!--********************************************************************
+Copyright (C) 2013-2026  Robert A. Beezer
+
+This file is part of PreTeXt.
+
+PreTeXt is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 or version 3 of the
+License (at your option).
+
+PreTeXt is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
+*****************************************************************-->
 <!-- http://pimpmyxslt.com/articles/entity-tricks-part2/ -->
 <!DOCTYPE xsl:stylesheet [
     <!ENTITY % entities SYSTEM "entities.ent">

package/assets/xsl/pretext-solution-manual-latex.xsl

@@ -1,22 +1,22 @@
 <?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.
 
-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-text-utilities.xsl

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

package/assets/xsl/pretext-text.xsl

@@ -1,22 +1,22 @@
 <?xml version='1.0'?>
 
 <!--********************************************************************
-Copyright 2018 Robert A. Beezer
+Copyright (C) 2018-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-units.xsl

@@ -4,22 +4,22 @@
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
 
 <!--********************************************************************
-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/>.
 *********************************************************************-->
 
 <!-- This file contains unit-related abbreviations, such as 'kilo' => 'k'           -->

package/assets/xsl/pretext-view-source.xsl

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

package/assets/xsl/pretext-ww-problem-sets.xsl

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 
 <!-- ********************************************************************* -->
-<!-- Copyright 2015-18                                                     -->
+<!-- Copyright (C) 2015-2026                                               -->
 <!-- Robert A. Beezer, Michael Gage, Geoff Goehle, Alex Jordan             -->
 <!--                                                                       -->
 <!-- This file is part of PreTeXt.                                         -->
@@ -29,6 +29,7 @@
 <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:pi="http://pretextbook.org/2020/pretext/internal"
     extension-element-prefixes="exsl"
 >
 
@@ -154,18 +155,20 @@
     <xsl:value-of select="concat('/',$external-directory,@local)"/>
 </xsl:template>
 
-<!-- For copied problems move to the problem that was copied -->
-<!-- NB: this @copied-from is a plain attribute, not a "pi"  -->
-<!-- namespace stamp: it arrives via the representations     -->
-<!-- file, an interchange format written by the Python       -->
-<!-- routines, and is promoted onto "webwork" elements when  -->
-<!-- the representations merge into the tree.                -->
-<xsl:template match="webwork[@copied-from]" mode="relative-filename">
-    <xsl:variable name="copied-from" select="@copied-from"/>
+<!-- For copied problems move to the problem that was copied.   -->
+<!-- This stylesheet imports pretext-assembly.xsl and assembles -->
+<!-- from source, so the attribute it sees is the tree stamp    -->
+<!-- "@pi:copied-from", holding the @xml:id the author aimed    -->
+<!-- @copy at.  The plain "@copied-from" of the representations -->
+<!-- file is a different thing with a different value, the      -->
+<!-- assembly identifier of the copied problem's exercise, and  -->
+<!-- it never reaches this stylesheet.                          -->
+<xsl:template match="webwork[@pi:copied-from]" mode="relative-filename">
+    <xsl:variable name="copied-from" select="@pi:copied-from"/>
     <xsl:apply-templates select="$document-root//webwork[@xml:id=$copied-from]" mode="relative-filename"/>
 </xsl:template>
-<xsl:template match="webwork[@copied-from]" mode="filename">
-    <xsl:variable name="copied-from" select="@copied-from"/>
+<xsl:template match="webwork[@pi:copied-from]" mode="filename">
+    <xsl:variable name="copied-from" select="@pi:copied-from"/>
     <xsl:apply-templates select="$document-root//webwork[@xml:id=$copied-from]" mode="filename"/>
 </xsl:template>
 
@@ -203,7 +206,7 @@
 </xsl:template>
 
 <!-- We don't write a new file for a copied webwork exercise -->
-<xsl:template match="webwork[@copied-from]" mode="write-file"/>
+<xsl:template match="webwork[@pi:copied-from]" mode="write-file"/>
 
 <!-- ################## -->
 <!-- Chunking Def Files-->

package/assets/xsl/publisher-variables.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.
 
@@ -1156,12 +1156,34 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 <!-- while a trailing slash will be reliably added if                     -->
 <!--     (a) not present in publisher file specification                  -->
 <!--     (b) the path is not empty                                        -->
+<!-- The external directory is a fact of the source (a different       -->
+<!-- directory of files is a different document), so its declaration    -->
+<!-- is "directories/@external" within "docinfo" (2026-07-30).  The     -->
+<!-- publication file "source/directories/@external" is deprecated but  -->
+<!-- honored while the "docinfo" is silent.  NB: the version tree is    -->
+<!-- consulted, since machinery within the assembly chain consumes      -->
+<!-- directory variables and the tree behind  $docinfo  does not exist  -->
+<!-- yet at that point (referencing it is a circular definition).       -->
 <xsl:variable name="external-directory-source">
-    <xsl:variable name="raw-input" select="$publication/source/directories/@external"/>
+    <xsl:variable name="raw-input">
+        <xsl:choose>
+            <xsl:when test="$version-docinfo/directories/@external">
+                <xsl:if test="$publication/source/directories/@external">
+                    <xsl:message>PTX:WARNING: the external directory is specified both within "docinfo" ("directories/@external") and in the publication file ("source/directories/@external").  The "docinfo" value is used; please remove the publication file entry.</xsl:message>
+                </xsl:if>
+                <xsl:value-of select="$version-docinfo/directories/@external"/>
+            </xsl:when>
+            <xsl:when test="$publication/source/directories/@external">
+                <xsl:message>PTX:DEPRECATE: (2026-07-30) the external directory is a fact of the source, and is now declared with a "directories/@external" attribute within "docinfo".  The publication file entry "source/directories/@external" is honored meanwhile, but please relocate it.</xsl:message>
+                <xsl:value-of select="$publication/source/directories/@external"/>
+            </xsl:when>
+            <xsl:otherwise/>
+        </xsl:choose>
+    </xsl:variable>
     <xsl:choose>
         <!-- leading path separator is an error -->
         <xsl:when test="substring($raw-input, 1, 1) = '/'">
-            <xsl:message>PTX:FALLBACK:   an external-image directory (source/directories/@external in the publisher file) must be a relative path and not begin with "/" as in "<xsl:value-of select="$raw-input"/>".  Proceeding with the default, which is an empty string, and may lead to unexpected results.</xsl:message>
+            <xsl:message>PTX:FALLBACK:   an external-image directory ("directories/@external", within "docinfo" or the publication file) must be a relative path and not begin with "/" as in "<xsl:value-of select="$raw-input"/>".  Proceeding with the default, which is an empty string, and may lead to unexpected results.</xsl:message>
             <xsl:text/>
         </xsl:when>
         <!-- trailing path separator is good and -->
@@ -1216,21 +1238,30 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 <!-- or not (older, historical).  So we create a boolean based on the  -->
 <!-- presence of the publisher file specification.                     -->
 <xsl:variable name="managed-directories">
+    <xsl:if test="$version-docinfo/directories/@external = ''">
+        <xsl:message terminate="yes">PTX:FATAL:   the value of "directories/@external" within "docinfo" must be nonempty</xsl:message>
+    </xsl:if>
     <xsl:if test="$publication/source/directories/@external = ''">
         <xsl:message terminate="yes">PTX:FATAL:   the value of source/directories/@external in the publisher file must be nonempty</xsl:message>
     </xsl:if>
     <xsl:if test="$publication/source/directories/@generated = ''">
         <xsl:message terminate="yes">PTX:FATAL:   the value of source/directories/@generated in the publisher file must be nonempty</xsl:message>
     </xsl:if>
+    <!-- The external directory may be declared in "docinfo" (preferred) -->
+    <!-- or the publication file (deprecated, honored); the generated    -->
+    <!-- directory is a publication file entry.  Management requires an  -->
+    <!-- external declaration, from either home, together with the       -->
+    <!-- generated declaration.                                          -->
+    <xsl:variable name="b-has-external" select="boolean($version-docinfo/directories/@external) or boolean($publication/source/directories/@external)"/>
     <xsl:choose>
-        <xsl:when test="$publication/source/directories/@external and $publication/source/directories/@generated">
+        <xsl:when test="$b-has-external and $publication/source/directories/@generated">
             <xsl:text>yes</xsl:text>
         </xsl:when>
-        <xsl:when test="not($publication/source/directories/@external) and not($publication/source/directories/@generated)">
+        <xsl:when test="not($b-has-external) and not($publication/source/directories/@generated)">
             <xsl:text>no</xsl:text>
         </xsl:when>
         <xsl:otherwise>
-            <xsl:message>PTX:FALLBACK:   the publisher file specifies one of source/directories/@external and source/directories/@generated, but not both. Proceeding as if neither was specified.</xsl:message>
+            <xsl:message>PTX:FALLBACK:   an external directory ("directories/@external" within "docinfo", or the deprecated publication file form) and a generated directory (source/directories/@generated in the publication file) must be specified together; only one was found. Proceeding as if neither was specified.</xsl:message>
             <xsl:text>no</xsl:text>
         </xsl:otherwise>
     </xsl:choose>
@@ -1272,19 +1303,19 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 <!-- This is a directory that may need to be copied to a      -->
 <!-- scratch location in anticipation of data files necessary -->
 <!-- for compilation of images, such as pie charts or plots   -->
-<!-- NB: this is broken and waiting for generated and external to settle down -->
+<!-- The data directory runs with the source, declared as     -->
+<!-- "directories/@data" within "docinfo" (the version tree,  -->
+<!-- for the same reason as the external directory above).    -->
+<!-- An earlier form of this variable consulted a publication -->
+<!-- file "source/directories/@data" which was never in the   -->
+<!-- publication schema, and hard-coded the value "data".     -->
 <xsl:variable name="data-directory">
     <xsl:variable name="raw-input">
-        <xsl:choose>
-            <xsl:when test="$publication/source/directories/@data">
-                <xsl:value-of select="'data'"/>
-            </xsl:when>
-            <xsl:otherwise/>
-        </xsl:choose>
+        <xsl:value-of select="$version-docinfo/directories/@data"/>
     </xsl:variable>
     <xsl:choose>
         <xsl:when test="substring($raw-input, 1, 1) = '/'">
-            <xsl:message>PTX:FALLBACK:   a data directory (source/directories/@data in the publisher file) must be a relative path and not begin with "/" as in "<xsl:value-of select="$raw-input"/>".  Proceeding with the default, which is an empty string, and may lead to unexpected results.</xsl:message>
+            <xsl:message>PTX:FALLBACK:   a data directory ("directories/@data" within "docinfo") must be a relative path and not begin with "/" as in "<xsl:value-of select="$raw-input"/>".  Proceeding with the default, which is an empty string, and may lead to unexpected results.</xsl:message>
             <xsl:text/>
         </xsl:when>
         <!-- trailing path separator is good -->
@@ -2709,23 +2740,19 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 <!-- Always use cdn when "b-portable-html" is true or "resources-host" is "cdn" -->
 <xsl:variable name="b-cdn-resources" select="$b-portable-html or $resources-host = 'cdn'"/>
 
-<!-- HTML chunk-level defaults, available to any stylesheet that    -->
-<!-- needs to compute HTML filenames via the "containing-filename"  -->
-<!-- template (pretext-common.xsl) without importing the full       -->
-<!-- pretext-html.xsl.  Uses $version-root rather than $root        -->
-<!-- because this is computed before later assembly passes.  The    -->
-<!-- contract (documented at the definition of $version-root in     -->
-<!-- pretext-assembly.xsl) is that no assembly pass alters the      -->
-<!-- gross document structure (book/article type, part/chapter/     -->
-<!-- section hierarchy), so $version-root is reliable for these     -->
-<!-- top-level queries.  Same contract relied upon by $toc-level.   -->
-<xsl:variable name="html-chunk-level">
+<!-- The chunk level a document's structure implies, with no publisher -->
+<!-- or command-line choice consulted.  A conversion that accepts such -->
+<!-- a choice layers it over this; one that does not, such as EPUB,    -->
+<!-- uses this as-is, so the two can never drift apart.                -->
+<!-- Uses $version-root rather than $root because this is computed     -->
+<!-- before later assembly passes.  The contract (documented at the    -->
+<!-- definition of $version-root in pretext-assembly.xsl) is that no   -->
+<!-- assembly pass alters the gross document structure (book/article   -->
+<!-- type, part/chapter/section hierarchy), so $version-root is        -->
+<!-- reliable for these top-level queries.  Same contract relied upon  -->
+<!-- by $toc-level.                                                    -->
+<xsl:variable name="chunk-level-default">
     <xsl:choose>
-        <!-- portable html always gets chunk level 0 -->
-        <xsl:when test="$b-portable-html">0</xsl:when>
-        <xsl:when test="$chunk-level-entered != ''">
-            <xsl:value-of select="$chunk-level-entered" />
-        </xsl:when>
         <xsl:when test="$version-has-parts">3</xsl:when>
         <xsl:when test="$version-doc-type = 'book'">2</xsl:when>
         <xsl:when test="$version-article-sections or $version-article-printouts">1</xsl:when>
@@ -2734,7 +2761,23 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
         <xsl:when test="$version-doc-type = 'letter'">0</xsl:when>
         <xsl:when test="$version-doc-type = 'memo'">0</xsl:when>
         <xsl:otherwise>
-            <xsl:message>PTX:BUG:   HTML chunk level not determined</xsl:message>
+            <xsl:message>PTX:BUG:   chunk level not determined</xsl:message>
+        </xsl:otherwise>
+    </xsl:choose>
+</xsl:variable>
+
+<!-- The chunk level for HTML, available to any stylesheet that needs  -->
+<!-- to compute HTML filenames via the "containing-filename" template  -->
+<!-- (pretext-common.xsl) without importing the full pretext-html.xsl. -->
+<xsl:variable name="html-chunk-level">
+    <xsl:choose>
+        <!-- portable html always gets chunk level 0 -->
+        <xsl:when test="$b-portable-html">0</xsl:when>
+        <xsl:when test="$chunk-level-entered != ''">
+            <xsl:value-of select="$chunk-level-entered" />
+        </xsl:when>
+        <xsl:otherwise>
+            <xsl:value-of select="$chunk-level-default"/>
         </xsl:otherwise>
     </xsl:choose>
 </xsl:variable>
@@ -2747,6 +2790,31 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
     <xsl:apply-templates select="$publisher-attribute-options/html/pi:pub-attribute[@name='favicon']" mode="set-pubfile-variable"/>
 </xsl:variable>
 
+<!--                            -->
+<!-- HTML Image Archive Links   -->
+<!--                            -->
+
+<!-- Requests for archive (download) versions of images: repeatable  -->
+<!-- "archive" elements within an "images" element.  The publication -->
+<!-- file form is preferred, and wins wholesale when present; the    -->
+<!-- "images" element within "docinfo" is deprecated (2026-07-30)    -->
+<!-- but honored while the publication file is silent.               -->
+<xsl:variable name="image-archives" select="$publication/html/images/archive | $docinfo/images/archive[not($publication/html/images/archive)]"/>
+
+<!--                            -->
+<!-- HTML Brand Logo            -->
+<!--                            -->
+
+<!-- An image for the masthead, optionally linking to a landing   -->
+<!-- page.  The publication file form is preferred, and elects    -->
+<!-- the logo wholesale (both attributes); the "brandlogo" within -->
+<!-- "docinfo" is deprecated (2026-07-30) but honored while the   -->
+<!-- publication file is silent.                                  -->
+<xsl:variable name="brandlogo-elected" select="$publication/html/brandlogo | $docinfo/brandlogo[not($publication/html/brandlogo)]"/>
+<xsl:variable name="brandlogo-source" select="string($brandlogo-elected/@source)"/>
+<xsl:variable name="brandlogo-url" select="string($brandlogo-elected/@url)"/>
+<xsl:variable name="b-brandlogo" select="not($brandlogo-source = '')"/>
+
 <!--                            -->
 <!-- HTML Embed Page button     -->
 <!--                            -->
@@ -3851,7 +3919,7 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 <xsl:param name="author-tools" select="''" />
 
 <!-- The autoname parameter is deprecated (2017-07-25) -->
-<!-- Replace with docinfo/cross-references/@text       -->
+<!-- Replace with docinfo/defaults/xrefs/@text         -->
 <xsl:param name="autoname" select="''" />
 
 <!-- 2020-11-22: latex.print to publisher file -->
@@ -4065,15 +4133,15 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
     <!-- 2017-07-25  deprecate intentional autoname without new setting -->
     <xsl:call-template name="parameter-deprecation-message">
         <xsl:with-param name="date-string" select="'2017-07-25'" />
-        <xsl:with-param name="message" select="'the  autoname  parameter is deprecated, but is still effective since  &quot;docinfo/cross-references/@text&quot;  has not been set.  The following parameter values equate to the attribute values: &quot;no&quot; is &quot;global&quot;, &quot;yes&quot; is &quot;type-global&quot;, &quot;title&quot; is &quot;title&quot;'" />
-        <xsl:with-param name="incorrect-use" select="not($autoname = '') and not(//docinfo/cross-references)" />
+        <xsl:with-param name="message" select="'the  autoname  parameter is deprecated, but is still effective since  &quot;docinfo/defaults/xrefs/@text&quot;  has not been set.  The following parameter values equate to the attribute values: &quot;no&quot; is &quot;global&quot;, &quot;yes&quot; is &quot;type-global&quot;, &quot;title&quot; is &quot;title&quot;'" />
+        <xsl:with-param name="incorrect-use" select="not($autoname = '') and not(//docinfo/cross-references | //docinfo/defaults/xrefs)" />
     </xsl:call-template>
     <!--  -->
     <!-- 2017-07-25  deprecate intentional autoname also with new setting -->
     <xsl:call-template name="parameter-deprecation-message">
         <xsl:with-param name="date-string" select="'2017-07-25'" />
-        <xsl:with-param name="message" select="'the  autoname  parameter is deprecated, and is being overidden by a  &quot;docinfo/cross-references/@text&quot;  and so is totally ineffective and can be removed'" />
-            <xsl:with-param name="incorrect-use" select="not($autoname = '') and //docinfo/cross-references" />
+        <xsl:with-param name="message" select="'the  autoname  parameter is deprecated, and is being overidden by a  &quot;docinfo/defaults/xrefs/@text&quot;  and so is totally ineffective and can be removed'" />
+            <xsl:with-param name="incorrect-use" select="not($autoname = '') and (//docinfo/cross-references | //docinfo/defaults/xrefs)" />
     </xsl:call-template>
     <!--  -->
     <!-- 2017-12-18  deprecate three console macro characters -->

package/assets/xsl/support/README.md

@@ -1,3 +1,22 @@
+<!--********************************************************************
+Copyright (C) 2022-2026  Robert A. Beezer
+
+This file is part of PreTeXt.
+
+PreTeXt is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 or version 3 of the
+License (at your option).
+
+PreTeXt is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
+*****************************************************************-->
+
 # PreTeXt (Miscellaneous) Support Files
 
 ### Runestone Services

package/assets/xsl/support/extract-math.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.
 

package/assets/xsl/support/package-math.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.
 

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

@@ -1,5 +1,6 @@
 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".
 
@@ -42,3 +43,4 @@ The purpose of the PNG image is to be the static version created via the pre-pro
 (64.0200,47.9100) -- (38.2800,61.4100) -- cycle;
 \end{tikzpicture}
 }
+```

package/assets/xsl/support/webpack_static_imports.xml

@@ -1,4 +1,23 @@
 <?xml version="1.0" ?>
+
+<!--********************************************************************
+Copyright (C) 2021-2026  Robert A. Beezer
+
+This file is part of PreTeXt.
+
+PreTeXt is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 or version 3 of the
+License (at your option).
+
+PreTeXt is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
+*****************************************************************-->
 <all>
 	<js type="list">
 		<item type="str">prefix-runtime.00db6230172ad960.bundle.js</item>