Optimize Quarto build: remove R, cache Python docs, disable execution, exclude _source, scope lightbox

nibalizer · ampcode-com · nibalizer · commit 35c5d6e6bfda · 2026-02-18T03:59:34.000Z
- Remove unused R setup from all 3 deploy workflows (0 R code blocks exist) - Cache Python API docs by validmind-library SHA (skip Poetry+install on cache hit) - Cache Quarto _site/_freeze/.quarto output with config-aware cache keys - Add execute: false + freeze: true globally to prevent accidental notebook execution - Add render: ['!_source/'] to exclude cloned repos from Quarto project scan - Disable lightbox globally, enable only on 21 pages that actually use it Co-authored-by: amp <amp@ampcode.com> Amp-Thread-ID: https://ampcode.com/threads/T-019c6ed2-7b81-763a-a6f8-0df84b9b6531
diff --git a/.github/workflows/deploy-docs-prod.yaml b/.github/workflows/deploy-docs-prod.yaml
@@ -59,15 +59,25 @@ jobs:
         with:
           version: ${{ vars.QUARTO_VERSION }}
 
-      - name: Setup R environment
-        uses: ./.github/actions/setup-r
+      - name: Get validmind-library SHA
+        id: lib-sha
+        run: echo "sha=$(git -C site/_source/validmind-library rev-parse HEAD)" >> $GITHUB_OUTPUT
+
+      - name: Cache Python library docs
+        id: cache-python-docs
+        uses: actions/cache@v4
+        with:
+          path: site/validmind
+          key: python-docs-${{ steps.lib-sha.outputs.sha }}
 
       - name: Install Poetry
+        if: steps.cache-python-docs.outputs.cache-hit != 'true'
         run: |
           curl -sSL https://install.python-poetry.org | python3 -
           echo "$HOME/.local/bin" >> $GITHUB_PATH
 
       - name: Generate Python library docs
+        if: steps.cache-python-docs.outputs.cache-hit != 'true'
         run: |
           cd site/_source/validmind-library
           make install && make quarto-docs
@@ -84,6 +94,17 @@ jobs:
           cp -r site/_source/release-notes/releases site
           rm -f site/releases/backend-releases.qmd site/releases/cmvm-releases.qmd
 
+      - name: Cache Quarto site output
+        uses: actions/cache@v4
+        with:
+          path: |
+            site/_site
+            site/_freeze
+            site/.quarto
+          key: quarto-site-production-${{ hashFiles('site/_quarto.yml', 'site/_quarto-production.yml', 'site/theme.scss', 'site/styles.css', 'site/**/_sidebar.yaml', 'site/**/_sidebar.yml', 'site/_extensions/**') }}-${{ github.sha }}
+          restore-keys: |
+            quarto-site-production-${{ hashFiles('site/_quarto.yml', 'site/_quarto-production.yml', 'site/theme.scss', 'site/styles.css', 'site/**/_sidebar.yaml', 'site/**/_sidebar.yml', 'site/_extensions/**') }}-
+
       - name: Render prod docs site
         run: |
             cd site
diff --git a/.github/workflows/deploy-docs-staging.yaml b/.github/workflows/deploy-docs-staging.yaml
@@ -59,15 +59,25 @@ jobs:
         with:
           version: ${{ vars.QUARTO_VERSION }}
 
-      - name: Setup R environment
-        uses: ./.github/actions/setup-r
+      - name: Get validmind-library SHA
+        id: lib-sha
+        run: echo "sha=$(git -C site/_source/validmind-library rev-parse HEAD)" >> $GITHUB_OUTPUT
+
+      - name: Cache Python library docs
+        id: cache-python-docs
+        uses: actions/cache@v4
+        with:
+          path: site/validmind
+          key: python-docs-${{ steps.lib-sha.outputs.sha }}
 
       - name: Install Poetry
+        if: steps.cache-python-docs.outputs.cache-hit != 'true'
         run: |
           curl -sSL https://install.python-poetry.org | python3 -
           echo "$HOME/.local/bin" >> $GITHUB_PATH
 
       - name: Generate Python library docs
+        if: steps.cache-python-docs.outputs.cache-hit != 'true'
         run: |
           cd site/_source/validmind-library
           make install && make quarto-docs
@@ -84,6 +94,17 @@ jobs:
           cp -r site/_source/release-notes/releases site
           rm -f site/releases/backend-releases.qmd site/releases/cmvm-releases.qmd
 
+      - name: Cache Quarto site output
+        uses: actions/cache@v4
+        with:
+          path: |
+            site/_site
+            site/_freeze
+            site/.quarto
+          key: quarto-site-staging-${{ hashFiles('site/_quarto.yml', 'site/_quarto-staging.yml', 'site/theme.scss', 'site/styles.css', 'site/**/_sidebar.yaml', 'site/**/_sidebar.yml', 'site/_extensions/**') }}-${{ github.sha }}
+          restore-keys: |
+            quarto-site-staging-${{ hashFiles('site/_quarto.yml', 'site/_quarto-staging.yml', 'site/theme.scss', 'site/styles.css', 'site/**/_sidebar.yaml', 'site/**/_sidebar.yml', 'site/_extensions/**') }}-
+
       - name: Render staging docs site
         run: |
             cd site
diff --git a/.github/workflows/validate-docs-site.yaml b/.github/workflows/validate-docs-site.yaml
@@ -59,15 +59,25 @@ jobs:
       with:
         version: ${{ vars.QUARTO_VERSION }}
 
-    - name: Setup R environment
-      uses: ./.github/actions/setup-r
+    - name: Get validmind-library SHA
+      id: lib-sha
+      run: echo "sha=$(git -C site/_source/validmind-library rev-parse HEAD)" >> $GITHUB_OUTPUT
+
+    - name: Cache Python library docs
+      id: cache-python-docs
+      uses: actions/cache@v4
+      with:
+        path: site/validmind
+        key: python-docs-${{ steps.lib-sha.outputs.sha }}
 
     - name: Install Poetry
+      if: steps.cache-python-docs.outputs.cache-hit != 'true'
       run: |
         curl -sSL https://install.python-poetry.org | python3 -
         echo "$HOME/.local/bin" >> $GITHUB_PATH
 
     - name: Generate Python library docs
+      if: steps.cache-python-docs.outputs.cache-hit != 'true'
       run: |
         cd site/_source/validmind-library
         make install && make quarto-docs
@@ -84,6 +94,17 @@ jobs:
         cp -r site/_source/release-notes/releases site
         rm -f site/releases/backend-releases.qmd site/releases/cmvm-releases.qmd
 
+    - name: Cache Quarto site output
+      uses: actions/cache@v4
+      with:
+        path: |
+          site/_site
+          site/_freeze
+          site/.quarto
+        key: quarto-site-development-${{ hashFiles('site/_quarto.yml', 'site/_quarto-development.yml', 'site/theme.scss', 'site/styles.css', 'site/**/_sidebar.yaml', 'site/**/_sidebar.yml', 'site/_extensions/**') }}-${{ github.sha }}
+        restore-keys: |
+          quarto-site-development-${{ hashFiles('site/_quarto.yml', 'site/_quarto-development.yml', 'site/theme.scss', 'site/styles.css', 'site/**/_sidebar.yaml', 'site/**/_sidebar.yml', 'site/_extensions/**') }}-
+
     - name: Render demo docs site
       run: |
           cd site
diff --git a/site/_quarto.yml b/site/_quarto.yml
@@ -4,6 +4,9 @@
 
 project:
   type: website
+  render:
+    - "**"
+    - "!_source/**"
 
 metadata-files:
   # - _drafts.yaml
@@ -267,8 +270,12 @@ format:
     link-external-icon: true
     callout-appearance: simple
     link-external-filter: '^https:\/\/(docs\.validmind\.ai|docs-staging\.validmind\.ai|docs-demo\.vm\.validmind\.ai)\/.*'
-    lightbox: true
+    lightbox: false
 
 filters:
   - tachyons
   - preview
+
+execute:
+  enabled: false
+  freeze: true
diff --git a/site/about/contributing/style-guide/conventions.qmd b/site/about/contributing/style-guide/conventions.qmd
@@ -4,6 +4,9 @@
 # SPDX-License-Identifier: AGPL-3.0 AND ValidMind Commercial
 title: "Conventions"
 date: last-modified
+format:
+  html:
+    lightbox: true
 ---
 
 A message can only make an impact when it is received, so presentation is (almost) everything.
diff --git a/site/releases/2024/2024-dec-06/release-notes.qmd b/site/releases/2024/2024-dec-06/release-notes.qmd
@@ -1,6 +1,9 @@
 ---
 title: "December 6, 2024"
 date: 2024-12-06
+format:
+  html:
+    lightbox: true
 aliases: 
   - /releases/2024-dec-06/release-notes.html
 filters:
diff --git a/site/training/_metadata.yml b/site/training/_metadata.yml
@@ -6,3 +6,4 @@ format:
   html:
     page-layout: full
     css: assets/training.css
+    lightbox: true
