docs

wip: test build script in CI #53

	name: docs

	# declare default permissions
	permissions: read-all

	on:
	# enable manual run via GitHub UI
	workflow_dispatch:

	# enable trigger via remote call webhook
	repository_dispatch:
	types: update-docs

	# enable run on "standard" updates to main branch
	push:
	branches: ["main"]

	pull_request:
	branches: ["main"]

	env:
	CORE: ./core
	DOCS: ./docs
	DIST: ./docs/dist
	SITE: ./docs/site
	WORK: ./docs/build/work

	jobs:

	build:
	runs-on: ubuntu-latest
	permissions:
	contents: write
	steps:
	- uses: actions/checkout@v4
	with:
	repository: defenseunicorns/pepr
	path: ./core
	fetch-depth: 0 # pull history to get version tags

	- uses: actions/checkout@v4
	with:
	repository: defenseunicorns/pepr-docs
	path: ./docs

	- name: Build the docs!
	run: \|
	SITE=$(realpath "$SITE")
	CORE=$(realpath "$CORE")
	cd "$DOCS"
	npm ci
	npm --workspace build run now -- --site "$SITE" --core "$CORE"

	- name: Commit to source!
	run: \|
	HUGO_OLD=$(realpath "$SITE/hugo.yaml")
	HUGO_NEW=$(realpath "$WORK/hugo.yaml")
	CONT_OLD=$(realpath "$SITE/content/en")
	CONT_NEW=$(realpath "$WORK/content/en")

	rm "$HUGO_OLD"
	cp "$HUGO_NEW" "$HUGO_OLD"

	rm --recursive --force "$CONT_OLD"
	cp --recursive "$CONT_NEW" "$CONT_OLD"

	cd "$DOCS"
	git config user.name "docs.yml"
	git config user.email "<>"
	git add --all

	if ! git diff-index --quiet HEAD; then
	git commit -m "docs.yml"
	git push origin main
	fi

	# - name: Publish the site!
	# run: \|
	# DIST=$(realpath ./docs/dist)
	# ls -la "$DIST"

Provide feedback