diff --git a/.github/workflows/publish-documentation.yaml b/.github/workflows/publish-documentation.yaml new file mode 100644 index 000000000..acc1c2e43 --- /dev/null +++ b/.github/workflows/publish-documentation.yaml @@ -0,0 +1,43 @@ +name: documentation + +on: + repository_dispatch: + workflow_dispatch: + +permissions: + contents: write + +jobs: + docs: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - name: Install Python + uses: actions/setup-python@v5 + with: + python-version: 3.9 + - name: Install Sphinx + run: | + sudo apt-get update + sudo apt-get install sphinx-doc -y + sudo apt-get install sphinx-common -y + - name: Install Poetry + uses: abatilo/actions-poetry@v2 + with: + poetry-version: 1.8.3 + - name: Run poetry install + run: poetry install --with docs + - name: Create new documentation + run: | + pip install sphinx-rtd-theme==2.0.0 + sphinx-apidoc -o docs/sphinx src/codeflare_sdk "**/*test_*" --force + mkdir docs/sphinx/_static + make clean -C docs/sphinx + make html -C docs/sphinx + - name: Deploy to GitHub Pages + uses: peaceiris/actions-gh-pages@v3 + with: + publish_branch: sphinx-documentation + github_token: ${{ secrets.GITHUB_TOKEN }} + publish_dir: sphinx/_build/ + force_orphan: true