FAQ: reframe tool-search item as complementary, add decoupling benefits #37

	name: Publish Docs

	on:
	push:
	branches:
	- main

	permissions:
	contents: write

	jobs:
	deploy:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v6

	- name: Configure Git Credentials
	run: \|
	git config user.name github-actions[bot]
	git config user.email 41898282+github-actions[bot]@users.noreply.github.com

	- uses: actions/setup-python@v6
	with:
	python-version: 3.x

	- run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV

	- name: Cache Material Theme Assets
	uses: actions/cache@v5
	with:
	key: mkdocs-material-${{ env.cache_id }}
	path: .cache
	restore-keys: \|
	mkdocs-material-

	- name: Install Dependencies
	run: pip install -r requirements-docs.txt

	- name: Build site
	run: mkdocs build # outputs to ./site

	# === Password protection (StatiCrypt) ===
	# To REMOVE protection later: delete this step and change the deploy
	# step's path from "encrypted/site" back to "site". Nothing else changes.
	# Requires repo secret STATICRYPT_PASSWORD (Settings > Secrets > Actions).
	- name: Encrypt site (StatiCrypt)
	env:
	STATICRYPT_PASSWORD: ${{ secrets.STATICRYPT_PASSWORD }}
	run: npx --yes staticrypt@3 site -r -d encrypted --remember 30 --short -s 9f2b7c1ae4d6580b3c2f1e8a7d4c9b06
	# === end password protection ===

	- name: Deploy to GitHub Pages
	run: ghp-import --no-jekyll --push --force --branch gh-pages --cname ards.io -m "Deploy ${{ github.sha }}" encrypted/site

Navigation Menu