Listing filename basics

examples/sample-article/sample-article.xml

@@ -10015,7 +10015,9 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
 
             <p>A <c>program</c> may also be nested inside a <c>listing</c>, which behaves similar to a <c>figure</c>.  You can provide a <c>caption</c>, and the listing will be numbered along with tables and figures.  This then makes it possible to cross-reference the listing, such as <xref ref="listing-c-hello" text="type-global" />.  It also removes the requirement of wrapping the <c>program</c> in a <c>sidebyside</c>.  For technical reasons, the three examples above will not split across a page break in PDF output, but the placement inside a <c>listing</c> will allow splits, as you should see in at least one example following.</p>
 
-            <listing xml:id="listing-c-hello">
+            <p>If a <attr>filename</attr> is supplied for the listing, it will be rendered as part of the listing caption. Filenames do not have to be unique - thus a particular filename can "evolve" throughout a work.</p>
+
+            <listing xml:id="listing-c-hello" filename="helloworld.c">
                 <caption>C Version of <q>Hello, World!</q></caption>
                 <program language="c">
                     <input>

schema/pretext.xml

@@ -1722,6 +1722,7 @@
                 element listing {
                     MetaDataCaption,
                     Landscape?,
+                    attribute filename {"yes" | "no"}?,
                     (
                         Program |
                         Console

xsl/pretext-html.xsl

@@ -1945,6 +1945,13 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
                 </span>
             </xsl:otherwise>
         </xsl:choose>
+        <!-- listings may have an @filename that should be displayed-->
+        <xsl:if test="self::listing[@filename]">
+            <xsl:call-template name="space-styled"/>
+            <span class="filename">
+                <xsl:value-of select="@filename"/>
+            </span>
+        </xsl:if>
         <!-- When a listing has an activecode, the caption will be picked -->
         <!-- up by the activecode, so we don't want to duplicate it.      -->
         <xsl:variable name="has-valid-activecode">

xsl/pretext-latex.xsl

@@ -8610,6 +8610,11 @@ along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>.
     <xsl:text>}{</xsl:text>
     <xsl:apply-templates select="." mode="type-name"/>
     <xsl:text>}{</xsl:text>
+    <xsl:if test="self::listing[@filename]">
+        <xsl:value-of select="@filename"/>
+        <xsl:text>\space</xsl:text>
+    </xsl:if>
+    <xsl:apply-templates select="." mode="caption-full"/>
     <xsl:apply-templates select="." mode="caption-full"/>
     <xsl:text>}{</xsl:text>
     <xsl:apply-templates select="." mode="unique-id"/>