57 lines
1.7 KiB
YAML
57 lines
1.7 KiB
YAML
name: Doc
|
|
|
|
on:
|
|
push:
|
|
branches:
|
|
- master
|
|
release:
|
|
types: [published]
|
|
|
|
jobs:
|
|
build-and-publish-doc:
|
|
name: Build and publish documentation
|
|
runs-on: ubuntu-22.04
|
|
|
|
steps:
|
|
- name: Checkout
|
|
uses: actions/checkout@v3
|
|
with:
|
|
submodules: recursive
|
|
fetch-depth: 0 # fetch all branches and tags
|
|
- name: Install doxygen
|
|
run: |
|
|
sudo apt-get install -y doxygen
|
|
- name: Download & install zydoc
|
|
run: |
|
|
wget -O zydoc.tar.gz https://github.com/zyantific/zydoc/releases/download/v0.3.2/zydoc_v0.3.2_x86_64-unknown-linux-musl.tar.gz
|
|
tar xfv zydoc.tar.gz
|
|
mv zydoc /usr/local/bin
|
|
- name: Clone Doxygen theme
|
|
run: >-
|
|
git clone
|
|
--depth=1 --branch=v2.1.0
|
|
https://github.com/jothepro/doxygen-awesome-css.git
|
|
/tmp/doxy-theme
|
|
- name: Generate documentation
|
|
run: >-
|
|
zydoc
|
|
--repo .
|
|
--output-dir doc.zydis.re
|
|
--config-ref master
|
|
--doxyfile ./Doxyfile
|
|
--refs 'refs/heads/master'
|
|
--refs 'refs/tags/.*'
|
|
--exclude-refs 'refs/tags/v1.*'
|
|
--extra-css /tmp/doxy-theme/doxygen-awesome.css
|
|
--extra-css /tmp/doxy-theme/doxygen-awesome-sidebar-only.css
|
|
- name: Publish documentation
|
|
uses: cpina/github-action-push-to-another-repository@v1.5
|
|
env:
|
|
SSH_DEPLOY_KEY: ${{ secrets.DOCS_ZYDIS_RE_SSH_DEPLOY_KEY }}
|
|
with:
|
|
source-directory: 'doc.zydis.re'
|
|
destination-github-username: 'zyantific'
|
|
destination-repository-name: 'doc.zydis.re'
|
|
user-name: zydis-doc-bot
|
|
user-email: doc-bot@zydis.re
|
|
target-branch: main
|