42 lines
1.1 KiB
YAML
42 lines
1.1 KiB
YAML
name: Deploy docs
|
|
|
|
on:
|
|
push:
|
|
branches: [main]
|
|
tags: ['*.*.*']
|
|
workflow_dispatch:
|
|
|
|
env:
|
|
SITE_SLUG: coursebank
|
|
CRATE: coursebank
|
|
|
|
jobs:
|
|
deploy:
|
|
runs-on: pixi-build-rust
|
|
env:
|
|
CARGO_TARGET_DIR: /opt/cargo-target/${{ gitea.repository }}
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
|
|
- name: Build the API docs
|
|
env:
|
|
RUSTDOCFLAGS: "--html-before-content ${{ gitea.workspace }}/scripts/docs-banner.html"
|
|
run: |
|
|
pixi install --locked
|
|
pixi run doc-build
|
|
|
|
- name: Redirect the channel root to the crate page
|
|
run: |
|
|
printf '%s\n' "<!doctype html><meta http-equiv=\"refresh\" content=\"0; url=${CRATE}/\">" > target/doc/index.html
|
|
|
|
- name: Publish the channel to /srv/www
|
|
run: |
|
|
case "${{ gitea.ref }}" in
|
|
refs/tags/*) channel=release ;;
|
|
*) channel=nightly ;;
|
|
esac
|
|
bash scripts/publish-docs.sh "$channel"
|
|
|
|
- name: Point the site root at the latest release, else nightly
|
|
run: bash scripts/redirect-docs.sh
|