@pretextbook/pretext-html 0.6.0 → 0.8.0

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,41 @@ 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 property 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"/>
+    <!-- an empty declaration is an error, not an election -->
+    <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: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 property of your 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 -->
@@ -1178,113 +1207,68 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
     </xsl:choose>
 </xsl:variable>
 
-<!-- Historically this was given by the "images" directory as a default, -->
-<!-- and it seems almost every author just ran with this.                -->
+<!-- The generated directory is machine-owned, so it is defaultable:  -->
+<!-- an undeclared location is the directory "generated", beside the  -->
+<!-- source.  (Historically an unmanaged scheme fell back to the      -->
+<!-- "images" directory; managed directories are now the only scheme.)-->
 <xsl:variable name="generated-directory-source">
-    <xsl:variable name="raw-input" select="$publication/source/directories/@generated"/>
-    <xsl:choose>
-        <xsl:when test="$b-managed-directories">
-            <xsl:choose>
-                <xsl:when test="substring($raw-input, 1, 1) = '/'">
-                    <xsl:message>PTX:FALLBACK:   a generated-image directory (source/directories/@generated 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:text/>
-                </xsl:when>
-                <!-- trailing path separator is good -->
-                <xsl:when test="substring($raw-input, string-length($raw-input), 1) = '/'">
-                    <xsl:value-of select="$raw-input"/>
-                </xsl:when>
-                <!-- if there is substance, we need to add a trailing slash -->
-                <xsl:when test="string-length($raw-input) > 0">
-                    <xsl:value-of select="concat($raw-input, '/')"/>
-                </xsl:when>
-                <!-- specification must be empty, so we leave it that way -->
-                <xsl:otherwise/>
-            </xsl:choose>
-        </xsl:when>
-        <!-- Should issue a deprecation warning (elsewhere) for this.    -->
-        <!-- directory.images *is* defined elsewhere in this stylesheet, -->
-        <!-- and defaults to "images", but does not have a slash, which  -->
-        <!-- is presumed for the $generated-directory variable           -->
-        <xsl:otherwise>
-            <xsl:value-of select="concat($directory.images, '/')"/>
-        </xsl:otherwise>
-    </xsl:choose>
-</xsl:variable>
-
-<!-- For backward-compatibility, we want to know if the collection of  -->
-<!-- generated images is structured by their production method (newer) -->
-<!-- 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="$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>
+    <xsl:variable name="raw-input">
+        <xsl:choose>
+            <xsl:when test="$publication/source/directories/@generated">
+                <xsl:value-of select="$publication/source/directories/@generated"/>
+            </xsl:when>
+            <xsl:otherwise>
+                <xsl:text>generated</xsl:text>
+            </xsl:otherwise>
+        </xsl:choose>
+    </xsl:variable>
     <xsl:choose>
-        <xsl:when test="$publication/source/directories/@external and $publication/source/directories/@generated">
-            <xsl:text>yes</xsl:text>
+        <xsl:when test="substring($raw-input, 1, 1) = '/'">
+            <xsl:message>PTX:FALLBACK:   a generated-image directory (source/directories/@generated 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:text/>
         </xsl:when>
-        <xsl:when test="not($publication/source/directories/@external) and not($publication/source/directories/@generated)">
-            <xsl:text>no</xsl:text>
+        <!-- trailing path separator is good -->
+        <xsl:when test="substring($raw-input, string-length($raw-input), 1) = '/'">
+            <xsl:value-of select="$raw-input"/>
         </xsl:when>
+        <!-- add the trailing slash -->
         <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:text>no</xsl:text>
+            <xsl:value-of select="concat($raw-input, '/')"/>
         </xsl:otherwise>
     </xsl:choose>
 </xsl:variable>
-<xsl:variable name="b-managed-directories" select="$managed-directories = 'yes'"/>
 
-<!-- Destination directory is hard-coded here and used in      -->
-<!-- various conversions under the managed directories scheme. -->
-<xsl:variable name="external-directory">
-    <xsl:choose>
-        <xsl:when test="$b-managed-directories">
-            <xsl:text>external/</xsl:text>
-        </xsl:when>
-        <!-- backwards-compatiblity, there never was any sort of   -->
-        <!-- naming/copying scheme for externally produced content -->
-        <xsl:otherwise/>
-    </xsl:choose>
-</xsl:variable>
+<!-- Managed directories are the only scheme (2026-08-02).  The two  -->
+<!-- directions are independent facts: an undeclared external means  -->
+<!-- the project has no external assets, and the machine-owned       -->
+<!-- generated directory is defaultable.                             -->
 
-<!-- There was once a scheme of sorts for managing the directory -->
-<!-- where generated images landed and were found.  So we need   -->
-<!-- to preserve that logic for backward-compatibility.          -->
-<xsl:variable name="generated-directory">
-    <xsl:choose>
-        <xsl:when test="$b-managed-directories">
-            <xsl:value-of select="'generated/'"/>
-        </xsl:when>
-        <!-- Should issue a deprecation warning (elsewhere) for this.    -->
-        <!-- directory.images *is* defined elsewhere in this stylesheet, -->
-        <!-- and defaults to "images", but does not have a slash, which  -->
-        <!-- is presumed for the $generated-directory variable           -->
-        <xsl:otherwise>
-            <xsl:value-of select="concat($directory.images, '/')"/>
-        </xsl:otherwise>
-    </xsl:choose>
-</xsl:variable>
+
+<!-- The destination directories within any output are hard-coded -->
+<!-- here, and used in the various conversions.                   -->
+<xsl:variable name="external-directory" select="'external/'"/>
+<xsl:variable name="generated-directory" select="'generated/'"/>
 
 
 <!-- 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 -->
@@ -1405,22 +1389,17 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
     <!-- variable since it will not be used, and it is silent.        -->
     <xsl:if test="$original//webwork[node() or @*]">
         <xsl:choose>
-            <!-- Note: $generated-directory-source is never empty?    -->
-            <!-- Defaults to the very old "directory.images"?         -->
-            <!-- So testing for the publication file entry is better. -->
-            <xsl:when test="$publication/source/directories/@generated">
-                <xsl:value-of select="str:replace(concat($generated-directory-source, 'webwork/'), '&#x20;', '%20')"/>
-            </xsl:when>
-            <xsl:when test="$publication/source/@webwork-problems">
+            <!-- the deprecated location is honored only when no -->
+            <!-- generated directory is declared                 -->
+            <xsl:when test="$publication/source/@webwork-problems and not($publication/source/directories/@generated)">
                 <xsl:value-of select="str:replace($publication/source/@webwork-problems, '&#x20;', '%20')"/>
                 <xsl:message>PTX:DEPRECATE: the publication file entry  source/@webwork-problems  is</xsl:message>
                 <xsl:message>               deprecated, please move to using managed directories</xsl:message>
             </xsl:when>
-            <!-- no specification, so empty string for filename -->
-            <!-- this will be noted where it is employed        -->
-            <!-- no specification, so empty string for directory    -->
-            <!-- this will be noted where it is employed            -->
-            <xsl:otherwise/>
+            <!-- the generated directory, declared or defaulted -->
+            <xsl:otherwise>
+                <xsl:value-of select="str:replace(concat($generated-directory-source, 'webwork/'), '&#x20;', '%20')"/>
+            </xsl:otherwise>
         </xsl:choose>
     </xsl:if>
 </xsl:variable>
@@ -1432,15 +1411,8 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 <xsl:variable name="dynamic-substitutions-file">
     <!-- Only relevant if there are dynamic exercises present.      -->
     <xsl:if test="$original//exercise//setup">
-        <xsl:choose>
-            <!-- Look in the publication file for the generated directory -->
-            <xsl:when test="$publication/source/directories/@generated">
-                <xsl:value-of select="str:replace(concat($generated-directory-source, 'dynamic_subs/dynamic_substitutions.xml'), '&#x20;', '%20')"/>
-            </xsl:when>
-            <!-- no specification, so empty string for filename -->
-            <!-- this will be noted where it is employed        -->
-            <xsl:otherwise/>
-        </xsl:choose>
+        <!-- the generated directory, declared or defaulted -->
+        <xsl:value-of select="str:replace(concat($generated-directory-source, 'dynamic_subs/dynamic_substitutions.xml'), '&#x20;', '%20')"/>
     </xsl:if>
 </xsl:variable>
 
@@ -2709,23 +2681,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 +2702,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 +2731,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     -->
 <!--                            -->
@@ -2756,6 +2765,14 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 </xsl:variable>
 <xsl:variable name="b-has-embed-button" select="$embed-button = 'yes'"/>
 
+<!--                           -->
+<!-- HTML Read-aloud control   -->
+<!--                           -->
+
+<xsl:variable name="read-aloud">
+    <xsl:apply-templates select="$publisher-attribute-options/html/pi:pub-attribute[@name='read-aloud']" mode="set-pubfile-variable"/>
+</xsl:variable>
+<xsl:variable name="b-read-aloud" select="not($read-aloud = 'no')"/>
 
 <!--                            -->
 <!-- HTML Banner options        -->
@@ -3480,6 +3497,7 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
     </common>
     <html>
         <pi:pub-attribute name="short-answer-responses" default="graded" options="always"/>
+        <pi:pub-attribute name="read-aloud" default="yes" options="no"/>
         <pi:pub-attribute name="favicon" default="none" options="simple"/>
         <pi:pub-attribute name="embed-button" default="no" options="yes"/>
         <pi:pub-attribute name="design-width" freeform="yes"/>
@@ -3851,7 +3869,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 -->
@@ -3878,9 +3896,11 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
 <!-- silently moved here, which should make no real difference -->
 <xsl:param name="directory.knowls"  select="''" />
 
-<!-- Deprecated 2020-11-23 in favor of publisher file -->
-<!-- specification, but will still be respected       -->
-<xsl:param name="directory.images" select="'images'" />
+<!-- Deprecated 2020-11-23 in favor of publisher file  -->
+<!-- specification; as of 2026-08-02 managed           -->
+<!-- directories are the only scheme, so this is dead: -->
+<!-- it survives only to power a deprecation warning.  -->
+<xsl:param name="directory.images" select="''" />
 
 <!-- 2021-01-03 chunk.level to publisher file -->
 <xsl:param name="chunk.level" select="''" />
@@ -4065,15 +4085,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 -->
@@ -4671,6 +4691,13 @@ along with PreTeXt.  If not, see <http://www.gnu.org/licenses/>.
         <xsl:with-param name="incorrect-use" select="($html.annotation != '')" />
     </xsl:call-template>
     <!--  -->
+    <!-- 2026-08-02  managed directories are the only scheme -->
+    <xsl:call-template name="parameter-deprecation-message">
+        <xsl:with-param name="date-string" select="'2026-08-02'" />
+        <xsl:with-param name="message" select="'the  directory.images  parameter is now ignored: managed directories are the only scheme.  Generated assets live in the directory given by  source/directories/@generated  in the publication file (default: &quot;generated&quot;, beside the source), and external assets in the directory given by  &quot;directories/@external&quot;  within  &quot;docinfo&quot;.'" />
+        <xsl:with-param name="incorrect-use" select="($directory.images != '')" />
+    </xsl:call-template>
+    <!--  -->
 </xsl:template>
 
 </xsl:stylesheet>

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/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>

package/assets/xsl/tests/README.md

@@ -1,3 +1,22 @@
+<!--********************************************************************
+Copyright (C) 2025-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/>.
+*****************************************************************-->
+
 # XSL Automated Tests
 
 This folder contains testing utilities for XSL templates. The tests focus on function-like templates for tasks like string manipulation that are used as helpers throughout the XSL stylesheets. Most of these functions are otherwise only observable indirectly through their effects on the output of the main XSL stylesheets.

package/assets/xsl/tests/null.xml

@@ -1,4 +1,23 @@
 <?xml version="1.0" encoding="UTF-8" ?>
+
+<!--********************************************************************
+Copyright (C) 2025-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/>.
+*****************************************************************-->
 <!-- intentionally empty valid XML file for use with pretext-text-utilities-text.xsl -->
 <nothing>
 </nothing>

package/assets/xsl/tests/pretext-text-utilities-test.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/utilities/README.md

@@ -1,3 +1,22 @@
+<!--********************************************************************
+Copyright (C) 2017-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/>.
+*****************************************************************-->
+
 # Utilities
 
 ## Source-to-Source conversions

package/assets/xsl/utilities/author-report.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/utilities/fix-deprecations.xsl

@@ -1,22 +1,22 @@
 <?xml version='1.0'?>
 
 <!--********************************************************************
-Copyright 2017 Robert A. Beezer
+Copyright (C) 2017-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/>.
 *********************************************************************-->
 
 <!-- Identify as a stylesheet -->

package/assets/xsl/utilities/pretext-enhanced-source.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.