From 6652e60761d85cef0fba0f85262b77823f7fca14 Mon Sep 17 00:00:00 2001 From: Matt McKay Date: Fri, 9 Oct 2026 12:31:36 +1100 Subject: [PATCH] ci(publish): clear cached HTML so the publish build renders current sources The publish-2026oct09 run deployed the 5 October build cache unchanged: its HTML step logged "no targets are out of date" and wrote nothing, and the release tarball's ak2.html lacks the content merged in #1078. Sphinx's HTML builder rewrites a page only when its source is newer than the existing output file, and the cache artifact is extracted after the checkout, so every cached page looks newer than its source. Remove _build/html and _build/.doctrees after the cache download, as ci.yml already does for .doctrees. Notebook execution stays cached in _build/.jupyter_cache, so this costs only the HTML render. Co-Authored-By: Claude Fable 5.1 --- .github/workflows/publish.yml | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml index ce275f889..e6d5044bb 100644 --- a/.github/workflows/publish.yml +++ b/.github/workflows/publish.yml @@ -61,6 +61,14 @@ jobs: branch: main name: build-cache path: _build + # The cache is extracted after the checkout, so its HTML files carry a newer + # mtime than every source file and Sphinx's HTML builder sees nothing to + # rewrite ("no targets are out of date"). Drop the cached HTML and the pickled + # environment so the HTML build renders every page from the current sources. + # Executed notebook outputs live in _build/.jupyter_cache and are kept. + - name: Clear cached HTML and stale Sphinx environment + shell: bash -l {0} + run: rm -rf _build/html _build/.doctrees # Build Assets (Download Notebooks, PDF via LaTeX) - name: Build PDF from LaTeX shell: bash -l {0}