Skip to content

force jupyter notebook to run workflow #5

force jupyter notebook to run workflow

force jupyter notebook to run workflow #5

name: autogenerate docs from tutorials
on:
# Triggers the workflow on push but only for the main branch
push:
branches: [ auto-doc-generation ]
paths: ['**.ipynb']
jobs:
docs-from-tutorials:
runs-on: ubuntu-latest
steps:
# Check out repo and set up Python
- name: Check out the repository
uses: actions/checkout@v4
with:
lfs: true
# Use cached python and dependencies, install poetry
- name: "Setup Python, Poetry and Dependencies"
uses: packetcoders/action-setup-cache-python-poetry@main
with:
python-version: 3.8
poetry-version: 1.2.2
- name: Install jupyter
run: poetry install -E notebook
- name: Install pandoc
run: sudo apt-get install pandoc
# Execute and convert notebooks
- name: execute notebooks
run: find $GITHUB_WORKSPACE/tutorial -type f -name "*.ipynb" -exec poetry run jupyter-nbconvert --execute --to notebook --inplace {} \;
- name: convert notebooks to rst and save to docs
run: find $GITHUB_WORKSPACE/tutorial -type f -name "*.ipynb" -exec poetry run jupyter-nbconvert --to rst --output-dir $GITHUB_WORKSPACE/tdocs/tutorial {} \;
- name: Commit changes
uses: EndBug/add-and-commit@v9
with:
default_author: github_actions
message: 'Updating tutorial rsts for docs'
add: $GITHUB_WORKSPACE/docs/tutorial/