Update Pandoc PDF template with version metadata support (#39)

* Initial plan

* Update Pandoc PDF template and add version/date metadata

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

* Fix metadata parameter handling in pandoc commands

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

* Simplify date metadata handling using bash date command

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

Author: Copilot

.github/workflows/build.yaml

@@ -349,6 +349,8 @@ jobs:
           dotnet pandoc
           --defaults docs/guide/definition.yaml
           --filter node_modules/.bin/mermaid-filter.cmd
+          --metadata version="${{ inputs.version }}"
+          --metadata date="$(date +'%Y-%m-%d')"
           --output docs/guide/guide.html
 
       - name: Generate Guide PDF with Weasyprint
@@ -363,6 +365,8 @@ jobs:
           dotnet pandoc
           --defaults docs/quality/definition.yaml
           --filter node_modules/.bin/mermaid-filter.cmd
+          --metadata version="${{ inputs.version }}"
+          --metadata date="$(date +'%Y-%m-%d')"
           --output docs/quality/quality.html
 
       - name: Generate Code Quality PDF with Weasyprint
@@ -377,6 +381,8 @@ jobs:
           dotnet pandoc
           --defaults docs/requirements/definition.yaml
           --filter node_modules/.bin/mermaid-filter.cmd
+          --metadata version="${{ inputs.version }}"
+          --metadata date="$(date +'%Y-%m-%d')"
           --output docs/requirements/requirements.html
 
       - name: Generate Requirements PDF with Weasyprint
@@ -391,6 +397,8 @@ jobs:
           dotnet pandoc
           --defaults docs/tracematrix/definition.yaml
           --filter node_modules/.bin/mermaid-filter.cmd
+          --metadata version="${{ inputs.version }}"
+          --metadata date="$(date +'%Y-%m-%d')"
           --output docs/tracematrix/tracematrix.html
 
       - name: Generate Trace Matrix PDF with Weasyprint

docs/template/template.html

@@ -56,6 +56,13 @@
   margin-bottom: 1rem;
 }
 
+.version {
+  font-size: 1rem;
+  color: #888;
+  margin-bottom: 1rem;
+  font-style: italic;
+}
+
 .author, .date {
   font-size: 1rem;
   color: #888;
@@ -153,7 +160,7 @@
   border: 1px solid #ddd;
   border-radius: 4px;
   padding: 1rem;
-  overflow-x: auto;
+  overflow: auto;
   margin-bottom: 1rem;
   page-break-inside: avoid;
 }
@@ -250,26 +257,32 @@
   size: letter;
   margin: 1in 0.75in;
 
-  @top-center {
+  @top-left {
     content: string(doctitle);
     font-size: 10pt;
     color: #666;
-    border-bottom: 1px solid #e0e0e0;
-    padding-bottom: 0.25in;
+  }
+  
+  @top-right {
+    content: string(docversion);
+    font-size: 10pt;
+    color: #666;
   }
 
   @bottom-center {
     content: "Page " counter(page) " of " counter(pages);
     font-size: 10pt;
     color: #666;
-    border-top: 1px solid #e0e0e0;
-    padding-top: 0.25in;
   }
 }
 
 /* Don't show header/footer on title page */
 @page :first {
-  @top-center {
+  @top-left {
+    content: none;
+  }
+  
+  @top-right {
     content: none;
   }
 
@@ -283,6 +296,11 @@
   string-set: doctitle content();
 }
 
+/* Set the document version for the header */
+.version {
+  string-set: docversion content();
+}
+
 /* Add page numbers to TOC entries using target-counter */
 #TOC a::after {
   content: leader('.') target-counter(attr(href), page);
@@ -309,6 +327,9 @@ <h1 class="title">$title$</h1>
 $if(subtitle)$
 <p class="subtitle">$subtitle$</p>
 $endif$
+$if(version)$
+<p class="version">Version $version$</p>
+$endif$
 $for(author)$
 <p class="author">$author$</p>
 $endfor$