diff --git a/.github/workflows/doc.yml b/.github/workflows/doc.yml new file mode 100644 index 0000000..368602a --- /dev/null +++ b/.github/workflows/doc.yml @@ -0,0 +1,45 @@ +name: deploy-book + +# Only run this when the master branch changes +on: + push: + branches: + - main + +# This job installs dependencies, builds the book, and pushes it to `gh-pages` +jobs: + deploy-book: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + + # Install dependencies + - name: Set up Python 3.8 + uses: actions/setup-python@v2 + with: + python-version: 3.8 + + - name: Run image + uses: abatilo/actions-poetry@v2 + with: + poetry-version: 1.4.2 + + - name: Install dependencies + run: | + poetry install + + - name: Sphinx APIDoc + run: | + poetry run sphinx-apidoc -f -o jupyter-book/_api/ ai2_kit/ --separate + + # Build the book + - name: Build the book + run: | + poetry run jupyter-book build jupyter-book/ + + # Push the book's HTML to github-pages + - name: GitHub Pages action + uses: peaceiris/actions-gh-pages@v3.6.1 + with: + github_token: ${{ secrets.GITHUB_TOKEN }} + publish_dir: jupyter-book/_build/html \ No newline at end of file