Add gallery cards, SEO improvements, and per-page dates

- Add 3 new simulation gallery cards (earplug, orifice, particle cloud)
- Add JSON-LD structured data to landing page for rich search results
- Add per-page meta description to Doxygen header template
- Switch sitemap from txt to xml format for better SEO
- Add inject-dates.py build step for per-page last-updated dates
- Use full git history in docs CI for accurate file dates

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: sbryngelson

.github/workflows/docs.yml

@@ -15,6 +15,8 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0  # Full history for per-page last-updated dates
 
     # We build doxygen from source because of
     # https://github.com/doxygen/doxygen/issues/9016
@@ -51,7 +53,7 @@ jobs:
         base-url-path: https://mflowcode.github.io/
         path-to-root: build/install/docs/mfc
         include-pdf: false
-        sitemap-format: txt
+        sitemap-format: xml
 
     - name: Output stats
       run: |

.lychee.toml

@@ -17,4 +17,4 @@ accept = ["200", "429"]
 verbose = "error"
 
 # Exclude sitemap from link checking (it contains pre-publish production URLs)
-exclude_path = ["**/sitemap.txt"]
+exclude_path = ["**/sitemap.xml"]

CMakeLists.txt

@@ -806,6 +806,24 @@ if (MFC_DOCUMENTATION)
     GEN_DOCS(post_process  "MFC: Post-Process")
     GEN_DOCS(documentation "MFC")
 
+    # Inject per-page last-updated dates into documentation markdown files.
+    # Runs after auto-generated .md files exist, before Doxygen processes them.
+    # Uses a stamp file so it only runs once per build.
+    add_custom_command(
+        OUTPUT  "${CMAKE_CURRENT_BINARY_DIR}/inject-dates.stamp"
+        DEPENDS "${CMAKE_CURRENT_SOURCE_DIR}/docs/documentation/examples.md"
+                "${CMAKE_CURRENT_SOURCE_DIR}/docs/documentation/case_constraints.md"
+                "${CMAKE_CURRENT_SOURCE_DIR}/docs/documentation/physics_constraints.md"
+                "${CMAKE_CURRENT_SOURCE_DIR}/docs/documentation/cli-reference.md"
+                "${CMAKE_CURRENT_SOURCE_DIR}/docs/documentation/parameters.md"
+        COMMAND "${Python3_EXECUTABLE}" "${CMAKE_CURRENT_SOURCE_DIR}/docs/inject-dates.py"
+                "${CMAKE_CURRENT_SOURCE_DIR}"
+        COMMAND "${CMAKE_COMMAND}" -E touch "${CMAKE_CURRENT_BINARY_DIR}/inject-dates.stamp"
+        COMMENT "Injecting page dates into documentation"
+    )
+    add_custom_target(inject_page_dates DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/inject-dates.stamp")
+    add_dependencies(documentation_doxygen inject_page_dates)
+
     # > Copy Resources (main landing page & assets)
     install(DIRECTORY   "${CMAKE_CURRENT_SOURCE_DIR}/docs/res"
             DESTINATION "docs/mfc")

docs/header.html

@@ -18,7 +18,8 @@
 <meta name="viewport" content="width=device-width, initial-scale=1"/>
 <!--BEGIN PROJECT_NAME--><title>$projectname: $title</title><!--END PROJECT_NAME-->
 <!--BEGIN !PROJECT_NAME--><title>$title</title><!--END !PROJECT_NAME-->
-<meta name=”keywords” content="exascale, fluid dynamics, cfd, computational fluid dynamics, compressible, hpc, bryngelson, colonius, subgrid, multiphase, frontier, summit, el capitan, aurora, amd gpu, gpu, nvidia"/>
+<meta name="description" content="$title — MFC documentation. Open-source exascale multiphase flow solver." />
+<meta name="keywords" content="exascale, fluid dynamics, cfd, computational fluid dynamics, compressible, hpc, bryngelson, colonius, subgrid, multiphase, frontier, summit, el capitan, aurora, amd gpu, gpu, nvidia"/>
 <link href="$relpath^tabs.css" rel="stylesheet" type="text/css"/>
 <script type="text/javascript" src="$relpath^jquery.js"></script>
 <script type="text/javascript" src="$relpath^dynsections.js"></script>

docs/index.html

@@ -23,6 +23,27 @@
     <meta property="og:url" content="https://mflowcode.github.io" />
     <meta property="og:type" content="website" />
     <meta name="twitter:card" content="summary_large_image" />
+    <script type="application/ld+json">
+    {
+      "@context": "https://schema.org",
+      "@type": "SoftwareApplication",
+      "name": "MFC",
+      "alternateName": "Multi-Component Flow Code",
+      "description": "Open-source exascale multiphase flow solver. 2025 Gordon Bell Prize Finalist. Scales to 200+ trillion grid points on 43,000+ GPUs.",
+      "url": "https://mflowcode.github.io",
+      "applicationCategory": "Scientific Computing",
+      "operatingSystem": "Linux, macOS",
+      "license": "https://opensource.org/licenses/MIT",
+      "programmingLanguage": ["Fortran", "Python"],
+      "codeRepository": "https://github.com/MFlowCode/MFC",
+      "author": {
+        "@type": "Organization",
+        "name": "MFlowCode",
+        "url": "https://github.com/MFlowCode"
+      },
+      "award": "2025 ACM Gordon Bell Prize Finalist"
+    }
+    </script>
     <script src="https://cdn.tailwindcss.com"></script>
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
     <link rel="icon" type="image/x-icon" href="res/icon.ico">
@@ -43,9 +64,12 @@
             { name: "Cavitation fragments kidney stone", image: "res/simulations/d.png", computer: "Summit",   computerUrl: "https://www.olcf.ornl.gov/summit/",                                            accelerators: "576 V100s", walltime: "30 min",  source: "https://doi.org/10.48550/arXiv.2305.09163" },
             { name: "Kidney stone stress waves",         image: "res/simulations/l.png", computer: "Bridges2", computerUrl: "https://www.psc.edu/resources/bridges-2/",                                      accelerators: "8 V100s",   walltime: "20m",     source: "https://www.youtube.com/watch?v=Q2L0J68qnRw" },
             { name: "Whale bubble net feeding",          image: "res/simulations/p.png", computer: "Delta",    computerUrl: "https://www.ncsa.illinois.edu/research/project-highlights/delta/",              accelerators: "128 A100s", walltime: "30m",     source: "https://www.youtube.com/watch?v=6EpP6tdCZSA" },
+            { name: "Earplug acoustics (kinetic energy)", image: "res/simulations/q.png", computer: "Delta",    computerUrl: "https://www.ncsa.illinois.edu/research/project-highlights/delta/",              accelerators: "8 A100s",   walltime: "5h",      source: "https://www.youtube.com/watch?v=xSW5wZkdbrc" },
+            { name: "Circular orifice (1 kHz)",          image: "res/simulations/r.png", computer: "Delta",    computerUrl: "https://www.ncsa.illinois.edu/research/project-highlights/delta/",              accelerators: "16 A100s",  walltime: "5h",      source: "https://www.youtube.com/watch?v=jOhJ_c7eco4" },
             // Bubble dynamics
             { name: "Collapsing bubbles (pressure)",     image: "res/simulations/b.png", computer: "Summit",   computerUrl: "https://www.olcf.ornl.gov/summit/",                                            accelerators: "216 V100s", walltime: "3h",      source: "https://doi.org/10.48550/arXiv.2305.09163" },
             { name: "Collapsing bubbles (streamlines)",  image: "res/simulations/c.png", computer: "Summit",   computerUrl: "https://www.olcf.ornl.gov/summit/",                                            accelerators: "216 V100s", walltime: "3h",      source: "https://doi.org/10.48550/arXiv.2305.09163" },
+            { name: "Euler-Lagrange particle cloud",     image: "res/simulations/s.png", computer: "Phoenix",  computerUrl: "https://www.pace.gatech.edu/",                                                 accelerators: "8 A100s",   walltime: "<1h",     source: "https://www.youtube.com/watch?v=RoT-yC5Lxmg" },
             // Fundamentals
             { name: "Breakup of vibrated interface",     image: "res/simulations/f.png", computer: "Summit",   computerUrl: "https://www.olcf.ornl.gov/summit/",                                            accelerators: "128 V100s", walltime: "4h",      source: "https://www.youtube.com/watch?v=XQ3g1oSg8mc" },
             { name: "Viscous Taylor-Green vortex",       image: "res/simulations/h.png", computer: "Delta",    computerUrl: "https://www.ncsa.illinois.edu/research/project-highlights/delta/",              accelerators: "128 A100s", walltime: "17h",     source: "https://www.youtube.com/watch?v=7i2h08dlDQw" },

docs/inject-dates.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env python3
+"""Inject last-updated dates into docs before Doxygen runs.
+
+Usage: python3 inject-dates.py [source_dir]
+  source_dir defaults to current directory.
+"""
+import subprocess
+import sys
+from pathlib import Path
+from datetime import date
+
+src_dir = Path(sys.argv[1]) if len(sys.argv) > 1 else Path(".")
+docs_dir = src_dir / "docs" / "documentation"
+
+for md_file in sorted(docs_dir.glob("*.md")):
+    if "Page last updated:" in md_file.read_text():
+        continue
+
+    result = subprocess.run(
+        ["git", "log", "-1", "--format=%as", "--", str(md_file)],
+        capture_output=True, text=True,
+        cwd=str(src_dir),
+    )
+    page_date = result.stdout.strip() or str(date.today())
+
+    with open(md_file, "a") as f:
+        f.write(
+            f"\n\n<div style='text-align:center; font-size:0.75rem; "
+            f"color:#888; padding:16px 0 0;'>"
+            f"Page last updated: {page_date}</div>\n"
+        )

docs/res/simulations/q.png

@@ -1,4 +1,4 @@
 User-agent: *
 Allow: /
 
-Sitemap: https://mflowcode.github.io/sitemap.txt
+Sitemap: https://mflowcode.github.io/sitemap.xml