Files
Dylan Carr c318048d7d Build: move the shared build system to Kazarov (#163)
* Build: check out scripts with LF line endings

* Build: replace the build scripts with Kazarov

* Port: rename PC_OVERRIDE to Kazarov's PORT_OVERRIDE

* Build: build the PS2 executables through Kazarov's CMake modules

* Scripts: remove unused tooling

* Build: update Kazarov

* Build: update Kazarov

* Build: run the port without a disc when its data exists, reject the old REGION variable, and lock the shared Windows dependencies

* Build: update Kazarov

* Port: serialise game data extraction across configurations

* Build: update Kazarov

* Port: hold a shared data lock while the game runs

* Port: refuse to start on data another configuration re-extracted

* Build: update Kazarov
2026-10-11 19:03:41 +11:00

76 lines
2.0 KiB
YAML

# Doxygen documentation, published to GitHub Pages.
#
# Needs no disc and no private submodule: doxygen reads ps2/src/ and ps2/include/
# only, never ps2/asm/. No game data is downloaded, stored or uploaded here.
#
# Pages must also be enabled once by hand, at Settings -> Pages -> Source ->
# "GitHub Actions"; this workflow alone does not turn it on.
name: Documentation
on:
push:
branches: [master]
pull_request:
workflow_dispatch:
permissions:
contents: read
# Never let two deployments race; queue rather than cancel, so a push that
# lands mid-deploy still publishes.
concurrency:
group: pages
cancel-in-progress: false
jobs:
build:
runs-on: ubuntu-26.04
steps:
- name: Check out the repository
uses: actions/checkout@v7
with:
submodules: true
- name: Check out the Doxygen Awesome theme
uses: actions/checkout@v7
with:
repository: jothepro/doxygen-awesome-css
ref: v2.5.0
path: doxygen-awesome-css
- name: Generate the documentation
run: |
tools/kazarov/bin/kazarov shell sh -c '
doxygen 2>/tmp/warnings.txt
cat /tmp/warnings.txt
test ! -s /tmp/warnings.txt
'
- name: Upload the documentation
uses: actions/upload-pages-artifact@v5
with:
# OUTPUT_DIRECTORY in the Doxyfile, with HTML_OUTPUT flattened into
# it, so this is the site root.
path: doxygen
deploy:
# Pull requests build the documentation to prove it still generates, but
# only master is published.
if: github.ref == 'refs/heads/master' && github.event_name != 'pull_request'
needs: build
runs-on: ubuntu-26.04
permissions:
pages: write
id-token: write
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v5