Add web cover images

Affects: #27
io7m-com · Sep 15, 2024 · a03ea9e · a03ea9e
1 parent b4d00b2
commit a03ea9e
Show file tree

Hide file tree

Showing 7 changed files with 56 additions and 0 deletions.
diff --git a/....documentation/src/main/resources/com/io7m/xstructural/documentation/banner.jpg b/....documentation/src/main/resources/com/io7m/xstructural/documentation/banner.jpg
diff --git a/...ral.documentation/src/main/resources/com/io7m/xstructural/documentation/language-meta.xml b/...ral.documentation/src/main/resources/com/io7m/xstructural/documentation/language-meta.xml
@@ -137,6 +137,12 @@ file2.txt
         element.
       </Paragraph>
     </Subsection>
+    <Subsection title="com.io7m.xstructural.web.cover">
+      <Paragraph>
+        The contents of this property denote the relative (to the input document) filename of the cover image that will
+        be used for the book.
+      </Paragraph>
+    </Subsection>
   </Subsection>
 
   <Footnote id="7c66cd52-4ace-4fd6-a05d-fd0255e441bb">

diff --git a/....xstructural.documentation/src/main/resources/com/io7m/xstructural/documentation/main.xml b/....xstructural.documentation/src/main/resources/com/io7m/xstructural/documentation/main.xml
@@ -18,6 +18,7 @@
     <MetaProperty name="com.io7m.xstructural.epub.cover">cover.jpg</MetaProperty>
     <MetaProperty name="com.io7m.xstructural.web.branding.header">brand.xml</MetaProperty>
     <MetaProperty name="com.io7m.xstructural.web.branding.footer">brand.xml</MetaProperty>
+    <MetaProperty name="com.io7m.xstructural.web.cover">banner.jpg</MetaProperty>
   </Metadata>
 
   <xi:include href="language.xml"/>

diff --git a/com.io7m.xstructural.xml/src/main/css/com/io7m/xstructural/xml/structural.css b/com.io7m.xstructural.xml/src/main/css/com/io7m/xstructural/xml/structural.css
@@ -382,3 +382,15 @@ h6
   text-align: left;
   padding-right: 1em;
 }
+
+/*
+ * Cover image.
+ */
+
+.stWebCoverImage img
+{
+  max-width:  100%;
+  max-height: 100%;
+  width:      100%;
+  height:     auto;
+}
diff --git a/...io7m.xstructural.xml/src/main/xsl/com/io7m/xstructural/xml/s8/xstructural8-blocks-web.xsl b/...io7m.xstructural.xml/src/main/xsl/com/io7m/xstructural/xml/s8/xstructural8-blocks-web.xsl
@@ -371,4 +371,35 @@
     </xsl:choose>
   </xsl:template>
 
+  <xdoc:doc>
+    Generate a document title image element in a rendered document.
+  </xdoc:doc>
+
+  <xsl:template match="s:Document"
+                mode="xstructural.documentTitleImageElement">
+    <xsl:if test="s:Metadata/s:MetaProperty[@name='com.io7m.xstructural.web.cover']">
+      <xsl:variable name="content" as="element()">
+        <div class="stWebCoverImage">
+          <xsl:element name="img">
+            <xsl:attribute name="src">
+              <xsl:value-of select="s:Metadata/s:MetaProperty[@name='com.io7m.xstructural.web.cover']"/>
+            </xsl:attribute>
+            <xsl:attribute name="alt">
+              <xsl:value-of select="normalize-space(s:Metadata/dc:title)"/>
+            </xsl:attribute>
+          </xsl:element>
+        </div>
+      </xsl:variable>
+
+      <xsl:call-template name="xstructural.regions.standardRegion">
+        <xsl:with-param name="class"
+                        select="'stWebCoverImage'"/>
+        <xsl:with-param name="stMarginNode">
+          <xsl:comment>Empty</xsl:comment>
+        </xsl:with-param>
+        <xsl:with-param name="stContentNode" select="$content"/>
+      </xsl:call-template>
+    </xsl:if>
+  </xsl:template>
+
 </xsl:stylesheet>
diff --git a/com.io7m.xstructural.xml/src/main/xsl/com/io7m/xstructural/xml/s8/xstructural8-web-multi.xsl b/com.io7m.xstructural.xml/src/main/xsl/com/io7m/xstructural/xml/s8/xstructural8-web-multi.xsl
@@ -155,6 +155,9 @@
             <xsl:apply-templates select="."
                                  mode="xstructural.titleElement"/>
 
+            <xsl:apply-templates select="."
+                                 mode="xstructural.documentTitleImageElement"/>
+
             <xsl:apply-templates select="s:Metadata"
                                  mode="xstructural.metadata.table"/>
 

diff --git a/...io7m.xstructural.xml/src/main/xsl/com/io7m/xstructural/xml/s8/xstructural8-web-single.xsl b/...io7m.xstructural.xml/src/main/xsl/com/io7m/xstructural/xml/s8/xstructural8-web-single.xsl
@@ -113,6 +113,9 @@
             <xsl:apply-templates select="."
                                  mode="xstructural.titleElement"/>
 
+            <xsl:apply-templates select="."
+                                 mode="xstructural.documentTitleImageElement"/>
+
             <xsl:apply-templates select="s:Metadata"
                                  mode="xstructural.metadata.table"/>