💚 Fix CI: PDF Generation Error

.github/workflows/publish.yml

@@ -57,7 +57,7 @@ jobs:
         run: playwright install --with-deps chromium
 
       - name: Build Website
-        run: mkdocs build
+        run: MKDOCS_EXPORTER_PDF=true mkdocs build
 
       - name: Push Website to gh-pages Branch
         uses: JamesIves/github-pages-deploy-action@v4

docs/assets/templates/covers/front.html.j2

@@ -84,7 +84,9 @@
   <section>
     <div class="brand">{{ config.site_name }}</div>
     <div class="version">
-      version {{ version }}
+      Version: {{ version }}
+      <br />
+      Date: {{ build_date }}
       <p>
         Download the latest version on: https://docs.diy-trio.org
       </p>

main.py

@@ -0,0 +1,5 @@
+from datetime import datetime
+
+def define_env(env):
+    # Define a macro that returns the current build date in UTC
+    env.variables['build_date'] = datetime.utcnow().strftime('%B %d, %Y')

mkdocs.yml

@@ -65,8 +65,7 @@ theme:
 
 plugins:
   - open-in-new-tab
-  - macros:
-      include_dir: .
+  - macros
   - exporter:
       formats:
         pdf:
@@ -95,7 +94,7 @@ extra_css:
 extra_javascript:
   - assets/javascripts/mathjax.js
   - assets/javascripts/mkdocs-exporter.js
-  - https://unpkg.com/mathjax@3/es5/tex-mml-chtml.js
+  - https://cdnjs.cloudflare.com/ajax/libs/mathjax/3.2.2/es5/tex-mml-chtml.min.js
   - https://cdnjs.cloudflare.com/ajax/libs/mermaid/10.9.1/mermaid.min.js
 
 # Customizations
@@ -110,7 +109,7 @@ extra:
     - icon: fontawesome/brands/facebook
       link: https://www.facebook.com/groups/diytrio
       name: Trio on Facebook
-  version: 0.2.1
+  version: 0.2.2
 
 markdown_extensions:
   - admonition