docs.yml

name: Deploy Sphinx documentation to Pages

on:
  push:
    branches: [main, ghpages]

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: "pages"
  cancel-in-progress: true

jobs:
  build:
    runs-on: ubuntu-20.04

    steps:
      - name: Checkout repository
        uses: actions/checkout@v2

      - name: Set up Python
        uses: actions/setup-python@v2
        with:
          python-version: '3.x'

      - name: Print current working directory
        run: |
          echo "Current working directory:"
          pwd

      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          pip install sphinx pydata_sphinx_theme

      - name: Build documentation
        run: |
          cd docs
          make html

      - name: List files for debugging
        run: |
          echo "Listing all files and directories after build:"
          find "$(pwd)" -type d -print
          find "$(pwd)" -type f -print

      - name: Upload documentation
        uses: actions/upload-artifact@v2
        with:
          name: built-docs
          path: docs/_build/html

  deploy:
    runs-on: ubuntu-20.04
    needs: build

    steps:
      - name: Checkout repository
        uses: actions/checkout@v2

      - name: Download documentation
        uses: actions/download-artifact@v2
        with:
          name: built-docs
          path: ./built-docs

      - name: List downloaded documentation
        run: |
          echo "Listing contents of downloaded built-docs:"
          find "$(pwd)/built-docs" -type d -print
          find "$(pwd)/built-docs" -type f -print

      - name: Deploy to GitHub Pages
        id: deployment
        uses: sphinx-notes/pages@v3
        with:
          documentation_path: 'tmp/sphinxnotes-pages'
          publish: 'true'