Build Documentation #515
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
########################################################################################### | |
# Build the documentation using mkdocs | |
# This will update the gh-pages branch which in return triggers the pages-build-deployment | |
# Action (provided by Github, not editable) | |
# That action will publish it to https://jomjol.github.io/AI-on-the-edge-device-docs | |
########################################################################################### | |
name: Build Documentation | |
on: | |
push: | |
branches: | |
- main | |
schedule: | |
- cron: "0 0 * * *" | |
jobs: | |
build-documentation: | |
runs-on: ubuntu-latest | |
# Steps represent a sequence of tasks that will be executed as part of the job | |
steps: | |
- name: Cache PIP | |
uses: actions/cache@v4 | |
with: | |
path: ~/.cache/pip | |
key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }} | |
restore-keys: | | |
${{ runner.os }}-pip- | |
# Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it | |
- uses: actions/checkout@v4 | |
with: | |
fetch-depth: 0 | |
- uses: actions/setup-python@v5 | |
- run: | | |
pip install --upgrade pip && pip install mkdocs mkdocs-gen-files mkdocs-awesome-pages-plugin mkdocs-material mkdocs-enumerate-headings-plugin | |
git config user.name 'github-actions[bot]' | |
git config user.email 'github-actions[bot]@users.noreply.github.com' | |
- name: Generate Parameter Page | |
run: | | |
cd param-docs | |
# Fetch the parameter pages from the main repo | |
git clone https://github.com/jomjol/AI-on-the-edge-device.git | |
python concat-parameter-pages.py | |
- name: Store Documentation in the gh-pages branch so it gets pushed to the website | |
run: mkdocs gh-deploy |