remove spinx-mutlibuild

Author: gilesknap

.github/workflows/docs.yml

@@ -1,4 +1,3 @@
-
 name: Docs CI
 
 on:
@@ -7,63 +6,40 @@ on:
 
 jobs:
   build:
+    name: "Docs CI"
     runs-on: ubuntu-latest
 
     steps:
       - name: Checkout Source
         uses: actions/checkout@v2
         with:
-          # require all of history to see all tagged versions' docs
+          # require history to get back to last tag for version number of branches
           fetch-depth: 0
+          submodules: true
 
       - name: Set up Python
         uses: actions/setup-python@v2
         with:
-          python-version: "3.7"
-
-      - name: Install Packages
-        # Can delete this if you don't use graphviz in your docs
-        run: sudo apt-get install graphviz
+          python-version: "3.9"
 
       - name: Install Python Dependencies
         run: |
           pip install pipenv
           pipenv install --dev --deploy --python $(which python) && pipenv graph
-
-      - name: Deploy index
-        # We pin to the SHA, not the tag, for security reasons.
-        # https://docs.github.com/en/free-pro-team@latest/actions/learn-github-actions/security-hardening-for-github-actions#using-third-party-actions
-        uses: peaceiris/actions-gh-pages@bbdfb200618d235585ad98e965f4aafc39b4c501  # v3.7.3
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: .github/pages
-          keep_files: true
-
-      - name: Checkout gh-pages
-        # As we already did a deploy of gh-pages above, it is guaranteed to be there
-        # so check it out so we can selectively build docs below
-        uses: actions/checkout@v2
-        with:
-          ref: gh-pages
-          path: build/html
-
-      - name: Maybe use sphinx-multiversion
-        # If we are building main or a tag we will publish
-        if: github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags')
-        # So use the args we normally pass to sphinx-build, but run sphinx-multiversion
-        run: mv $(pipenv --venv)/bin/sphinx-multiversion $(pipenv --venv)/bin/sphinx-build
-
       - name: Build Docs
         run: pipenv run docs
 
+      - name: Move to versioned directory
+        # e.g. master or 0.1.2
+        run: mv build/html ".github/pages/${GITHUB_REF##*/}"
+
       - name: Publish Docs to gh-pages
-        # Only main and tags are published
-        if: github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags')
+        # Only master and tags are published
+        if: "${{ github.repository_owner == 'dls-controls' && (github.ref == 'refs/heads/master' || startsWith(github.ref, 'refs/tags')) }}"
         # We pin to the SHA, not the tag, for security reasons.
-        # https://docs.github.com/en/free-pro-team@latest/actions/learn-github-actions/security-hardening-for-github-actions#using-third-party-actions
+        # https://docs.github.com/en/actions/learn-github-actions/security-hardening-for-github-actions#using-third-party-actions
         uses: peaceiris/actions-gh-pages@bbdfb200618d235585ad98e965f4aafc39b4c501  # v3.7.3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: build/html
-          keep_files: true
-
+          publish_dir: .github/pages
+          keep_files: true

Pipfile

@@ -11,10 +11,7 @@ mypy = "*"
 atomicwrites = "*"
 typing-extensions = "*"
 importlib-metadata = "*"
-# Switch to main repo after PR https://github.com/Holzhaus/sphinx-multiversion/pull/64 is merged
-sphinx-multiversion = {editable = true,git = "https://github.com/dls-controls/sphinx-multiversion.git",ref = "only-arg"}
-# List wheel here to make sure we make the same version to make wheels on gitlab and github CI
-wheel = "0.33.1"
+
 # Test and docs dependencies
 pytest-cov = "*"
 pytest-mypy = "*"