Adding mermaid support

Author: dave2wave

.github/workflows/build-pelican.yml

@@ -26,3 +26,4 @@ jobs:
           # This must be appropriate for the branch being built
           destination: 'asf-site'
           gfm: 'true'
+          requirements: 'requirements-build.txt'

.pre-commit-config.yaml

@@ -17,7 +17,7 @@ repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v6.0.0
     hooks:
-      - id: check-added-large-files
+      # - id: check-added-large-files
       - id: check-ast
       - id: check-case-conflict
       - id: check-executables-have-shebangs
@@ -27,7 +27,7 @@ repos:
       - id: check-vcs-permalinks
       - id: check-yaml
       - id: detect-private-key
-      # - id: end-of-file-fixer
+      - id: end-of-file-fixer
       - id: fix-byte-order-marker
       - id: forbid-submodules
       - id: mixed-line-ending

content/js/mermaid.min.js

@@ -17,6 +17,12 @@
       </div>
     </main>
     <script>hljs.highlightAll();</script>
+    <script>
+      mermaid.initialize({
+          startOnLoad: true,
+          theme: "default"
+      });
+    </script>
   </body>
 </html>
 {% endblock %}

content/theme/templates/page.html

@@ -4,6 +4,7 @@
 <link href="/css/headerlink.css" rel="stylesheet">
 <link href="/highlight/github.min.css" rel="stylesheet">
 <script src="/highlight/highlight.min.js"></script>
+<script src="/js/mermaid.min.js"></script>
 <!-- pagefind search -->
 <link href="/_pagefind/pagefind-ui.css" rel="stylesheet">
 <script src="/_pagefind/pagefind-ui.js" type="text/javascript"></script>
@@ -29,4 +30,11 @@
       overflow: auto;
       margin-top: 5px;
   }
+  .mermaid {
+      margin: 1.2em 0;
+      padding: 1em;
+      background: #fff;
+      border: 1px solid #d0d7de;
+      broder-radius: 6px;
+  }
 </style>

content/theme/templates/styles.html

@@ -15,7 +15,7 @@
 # Specify location of plugins, and which to use
 PLUGIN_PATHS = [ 'plugins',  ]
 # If the website uses any *.ezmd files, include the 'gfm' and 'asfreader' plugins (in that order)
-PLUGINS = [ 'toc', 'spu', 'gfm', 'asfgenid', 'asfrun',  ]
+PLUGINS = [ 'toc', 'spu', 'gfm', 'asfgenid', 'asfrun', 'pelican_mermaid' ]
 # All content is located at '.' (aka content/ )
 PAGE_PATHS = [ 'pages' ]
 STATIC_PATHS = [ '.',  ]

pelicanconf.py

@@ -0,0 +1 @@
+pelican-mermaid