Skip to content

Website Updates (#246) #142

Website Updates (#246)

Website Updates (#246) #142

Workflow file for this run

name: Documentation
on:
push:
branches:
- master
workflow_dispatch:
jobs:
docs:
name: Build & Publish
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
# We build doxygen from source because of
# https://github.com/doxygen/doxygen/issues/9016
- name: Build Doxygen
run: |
sudo apt install cmake ninja-build graphviz graphviz
git clone https://github.com/doxygen/doxygen.git ../doxygen
cmake -S ../doxygen -B ../doxygen/build -G Ninja
sudo ninja -C ../doxygen/build install
- name: Build Documentation
run: |
pip3 install fypp
cmake -S . -B build -G Ninja --install-prefix=$(pwd)/build/install -D MFC_DOCUMENTATION=ON
ninja -C build install
- name: Publish Documentation
run: |
set +e
git ls-remote "${{ secrets.DOC_PUSH_URL }}" -q
if [ "$?" -ne "0" ]; then exit 0; fi
set -e
git config --global user.name 'MFC Action'
git config --global user.email '<>'
git clone "${{ secrets.DOC_PUSH_URL }}" ../www
rm -rf ../www/*
mv build/install/docs/mfc/* ../www/
git -C ../www add -A
git -C ../www commit -m "Docs @ ${GITHUB_SHA::7}" || true
git -C ../www push
# DOC_PUSH_URL should be of the format:
# --> https://<username>:<token>@github.com/<username>/<repository>