From c0afaab1e23ac0db4c666c5ca55b680f12a53a07 Mon Sep 17 00:00:00 2001 From: Jared Callaham Date: Fri, 30 Jan 2026 16:38:46 -0500 Subject: [PATCH 1/3] Add base URL --- docs/source/conf.py | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/source/conf.py b/docs/source/conf.py index ed44bfe..aef0aab 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -41,6 +41,7 @@ html_theme = "furo" html_static_path = ["_static"] html_css_files = ["custom.css"] +html_baseurl = "https://pinetreelabs.github.io/lynx/" # Furo theme options html_theme_options = { From 11832e40a8324683ba57f0d45748b8bceb851bb7 Mon Sep 17 00:00:00 2001 From: Jared Callaham Date: Fri, 30 Jan 2026 19:24:09 -0500 Subject: [PATCH 2/3] Add _plots to cache --- .github/workflows/docs.yaml | 4 +++- docs/source/conf.py | 1 - 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml index ca493d2..81f4fb2 100644 --- a/.github/workflows/docs.yaml +++ b/.github/workflows/docs.yaml @@ -57,7 +57,9 @@ jobs: - name: Cache Jupyter execution uses: actions/cache@v4 with: - path: docs/_build/.jupyter_cache + path: | + docs/_build/.jupyter_cache + docs/source/examples/_plots key: jupyter-${{ runner.os }}-${{ hashFiles('docs/source/examples/*.md') }} restore-keys: | jupyter-${{ runner.os }}- diff --git a/docs/source/conf.py b/docs/source/conf.py index aef0aab..ed44bfe 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -41,7 +41,6 @@ html_theme = "furo" html_static_path = ["_static"] html_css_files = ["custom.css"] -html_baseurl = "https://pinetreelabs.github.io/lynx/" # Furo theme options html_theme_options = { From 2b8a65c8a9c6b64dc5196ee9b63fd3d649f5096e Mon Sep 17 00:00:00 2001 From: Jared Callaham Date: Fri, 30 Jan 2026 20:48:27 -0500 Subject: [PATCH 3/3] Fix Git LFS checkout for documentation images The static documentation images (feedback-tf-*.png, edited-template-*.png, etc.) are stored in Git LFS. Without lfs: true in the checkout action, GitHub Actions only downloads 130-byte LFS pointer files instead of the actual images. This causes GitHub Pages to serve broken images. The cruise_control plots work because they're generated during the build (not stored in Git), so they bypass the LFS issue entirely. Adding lfs: true ensures the checkout action pulls the actual image files from Git LFS storage. --- .github/workflows/docs.yaml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml index 81f4fb2..f1b0faa 100644 --- a/.github/workflows/docs.yaml +++ b/.github/workflows/docs.yaml @@ -22,6 +22,8 @@ jobs: steps: - name: Checkout uses: actions/checkout@v4 + with: + lfs: true - name: Setup Python uses: actions/setup-python@v5