test the doc deployment #72
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: Documentation | |
| on: | |
| push: | |
| branches: | |
| - release # Trigger the workflow when changes are pushed to the release branch | |
| permissions: | |
| contents: write | |
| actions: read | |
| jobs: | |
| build-and-deploy: | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout code | |
| uses: actions/checkout@v4 | |
| with: | |
| fetch-depth: 0 # Fetch all history for all branches and tags | |
| - name: Set up Python | |
| uses: actions/setup-python@v5 | |
| with: | |
| python-version: '3.11' # Ensure the Python version is correct | |
| - name: Install Poetry | |
| run: | | |
| curl -sSL https://install.python-poetry.org | python3 - | |
| echo "$HOME/.local/bin" >> $GITHUB_PATH # Ensure Poetry's bin directory is in PATH | |
| - name: Install dependencies using Poetry | |
| run: | | |
| poetry config virtualenvs.create false # Avoid creating a virtual environment | |
| poetry install # Install dependencies as specified in pyproject.toml | |
| - name: Check Current 'document.yaml' Configuration | |
| run: | | |
| echo "Checking in default docs directory:" | |
| cat docs/document.yaml || echo "No document.yaml in default docs directory." | |
| echo "Checking in alternative directory:" | |
| cat path/to/alternative/document.yaml || echo "No document.yaml in alternative directory." | |
| working-directory: ${{ github.workspace }} | |
| - name: Build documentation using Makefile | |
| run: | | |
| echo "Building documentation from: $(pwd)" | |
| ls -l # Debug: List current directory contents | |
| poetry run make -C docs html # Run Makefile in docs directory to build HTML docs | |
| working-directory: ${{ github.workspace }} | |
| - name: List built documentation | |
| run: | | |
| find ./build/ -type f # List all files in the build directory | |
| working-directory: ${{ github.workspace }}/docs | |
| - name: Create .nojekyll file | |
| run: | | |
| touch .nojekyll # Prevent GitHub Pages from ignoring files that start with an underscore | |
| working-directory: ${{ github.workspace }}/docs/build | |
| - name: Deploy to GitHub Pages | |
| uses: peaceiris/actions-gh-pages@v3 | |
| with: | |
| github_token: ${{ secrets.GITHUB_TOKEN }} # GitHub token for authentication | |
| publish_branch: gh-pages # Target branch for GitHub Pages deployment | |
| publish_dir: ./docs/build/ # Directory containing the built documentation | |
| user_name: github-actions[bot] # Username for the commit | |
| user_email: github-actions[bot]@users.noreply.github.com # Email for the commit | |
| force_orphan: true # Force the use of an orphan branch, removing all previous history | |
| # Uncomment below for debugging purposes | |
| # - name: Debug Output | |
| # run: | | |
| # pwd # Print the current working directory | |
| # ls -l ./build/ # List files in the build directory | |
| # cat ./source/conf.py # Display the Sphinx configuration file | |
| # working-directory: ${{ github.workspace }}/docs/build |