Docs

fix(aur): force system-scope service unit path with --no-user-service #607

	name: Docs

	on:
	push:
	branches: [main]
	pull_request:

	permissions:
	contents: read
	pages: write
	id-token: write

	concurrency:
	group: pages-${{ github.event.pull_request.number \|\| github.ref }}
	cancel-in-progress: true

	jobs:
	build:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v4

	- name: Install system dependencies
	run: sudo apt-get update && sudo apt-get install -y libusb-1.0-0-dev

	- uses: mlugg/setup-zig@v2
	with:
	version: 0.15.2

	- name: Install mdbook
	run: \|
	curl -sSL https://github.com/rust-lang/mdBook/releases/download/v0.4.40/mdbook-v0.4.40-x86_64-unknown-linux-gnu.tar.gz \
	\| tar xz -C /usr/local/bin

	- name: Build padctl
	run: zig build

	- name: Validate all device configs
	run: \|
	for f in devices/*/.toml devices/*.toml; do
	[ -f "$f" ] \|\| continue
	zig-out/bin/padctl --validate "$f"
	done

	- name: Generate device reference pages
	run: \|
	mkdir -p docs/src/devices
	for f in devices/*/.toml devices/*.toml; do
	[ -f "$f" ] \|\| continue
	zig-out/bin/padctl --doc-gen --config "$f" --output docs/src/devices
	done

	- name: Build mdbook
	run: mdbook build docs/

	- name: Upload Pages artifact
	if: github.ref == 'refs/heads/main'
	uses: actions/upload-pages-artifact@v3
	with:
	path: docs/book

	deploy:
	if: github.ref == 'refs/heads/main'
	needs: build
	runs-on: ubuntu-latest
	environment:
	name: github-pages
	url: ${{ steps.deployment.outputs.page_url }}
	steps:
	- name: Deploy to GitHub Pages
	id: deployment
	uses: actions/deploy-pages@v4

Navigation Menu