mirror of
https://github.com/odiecay/chronicle-ps4.git
synced 2026-10-25 06:01:34 +01:00
* 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
76 lines
2.0 KiB
YAML
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
|