From 88d92785ceb3127abadbf51fb2fc4d95434fa2ca Mon Sep 17 00:00:00 2001
From: Ryan Lovett <rylo@berkeley.edu>
Date: Sat, 10 Aug 2024 21:10:03 -0700
Subject: [PATCH] Create en/latest symlink.

Insert a symlink to preserve the old readthedocs paths.
---
 .github/workflows/quarto-docs.yml | 28 ++++++++++++++++++++++++++--
 1 file changed, 26 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/quarto-docs.yml b/.github/workflows/quarto-docs.yml
index a4dfb9d76..b381a5c9a 100644
--- a/.github/workflows/quarto-docs.yml
+++ b/.github/workflows/quarto-docs.yml
@@ -18,10 +18,34 @@ jobs:
       - name: Set up Quarto
         uses: quarto-dev/quarto-actions/setup@v2
 
-      - name: Render and Publish
-        uses: quarto-dev/quarto-actions/publish@v2
+      ## We could render and publish in one step, however we need to, at
+      ## least temporarily, preserve the old en/latest/ paths from the
+      ## readthedocs version. So we render, create the link, then publish.
+      #- name: Render and Publish
+      #  uses: quarto-dev/quarto-actions/publish@v2
+      #  with:
+      #    path: ./docs
+      #    target: gh-pages
+      #  env:
+      #    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Render
+        uses: quarto-dev/quarto-actions/render@v2
+        with:
+          path: ./docs
+          to: html
+
+      - name: Create en/latest symlink
+        run: |
+          mkdir ./docs/_site/en
+          cd docs/_site/en
+          ln -s ../../_site latest
+
+      - name: Publish
+          uses: quarto-dev/quarto-actions/publish@v2
         with:
           path: ./docs
           target: gh-pages
+          render: false
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}