Merge remote-tracking branch 'origin/main' #28
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: Build documentation | |
on: | |
push: | |
branches: [ main ] | |
workflow_dispatch: | |
jobs: | |
build: | |
permissions: | |
id-token: write | |
pages: write | |
contents: write | |
runs-on: ubuntu-latest | |
steps: | |
- name: Setup python | |
uses: actions/setup-python@v2 | |
with: | |
python-version: '3.8' | |
- name: Setup Julia | |
uses: julia-actions/setup-julia@v1 | |
with: | |
version: "1" | |
- name: Checkout | |
uses: actions/checkout@v2 | |
with: | |
submodules: 'recursive' | |
fetch-depth: 0 # otherwise, you will failed to push refs to dest repo | |
- name: Setup dependencies | |
run: | | |
sudo apt-get update | |
sudo apt-get install python3-sphinx pandoc doxygen | |
python -m pip install --upgrade pip | |
python -m pip install sphinx_rtd_theme unidecode nbsphinx wheel breathe exhale | |
- name: Build Julia documentation | |
run: | | |
cd CompasToolkit.jl | |
touch src/Constants.jl | |
julia --project=docs -e ' | |
using Pkg | |
Pkg.develop(PackageSpec(path=pwd())) | |
Pkg.instantiate() | |
' | |
julia --project=docs docs/make.jl | |
cp -R docs/build ../docs/julia | |
- name: Build and commit | |
uses: sphinx-notes/pages@v2 | |
with: | |
documentation_path: './docs' | |
- name: Push documentation | |
uses: ad-m/github-push-action@master | |
with: | |
github_token: ${{ secrets.GITHUB_TOKEN }} | |
branch: gh-pages |