From 9402f8a4b7c16120653c87c509727b7fd653fd47 Mon Sep 17 00:00:00 2001
From: Carl Pearson <cwpearson@users.noreply.github.com>
Date: Thu, 2 May 2024 08:23:57 -0600
Subject: [PATCH] Fix macOS docs build (#2190)

* Fix docs build

* try docs fix

* make sphinx available at config time
---
 .github/workflows/docs.yml | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 04a1ba74b2..1646300e81 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -16,9 +16,11 @@ jobs:
       - name: Install Dependencies
         run: |
           brew install doxygen
-          python3 -m pip install sphinx -v "sphinx==6.2.1"
-          python3 -m pip install breathe
-          python3 -m pip install sphinx-rtd-theme
+          python3 -m venv .venv
+          . .venv/bin/activate
+          pip install sphinx -v "sphinx==6.2.1"
+          pip install breathe
+          pip install sphinx-rtd-theme
           sphinx-build --version
           doxygen --version
 
@@ -52,8 +54,10 @@ jobs:
         working-directory: kokkos/build
         run: make -j2 install
 
+      # sphinx needs to be available at configure time for the target to be generated
       - name: configure_kokkos_kernels
         run: |
+          . .venv/bin/activate
           mkdir -p kokkos-kernels/{build,install}
           cd kokkos-kernels/build
           cmake \
@@ -81,5 +85,7 @@ jobs:
          fi
 
       - name: build_kokkos_kernels_sphinx
-        working-directory: kokkos-kernels/build
-        run: make Sphinx
+        run: | 
+          . .venv/bin/activate
+          cd kokkos-kernels/build
+          make Sphinx