Embedded HTML Formatting (markup_fmt integration) #302

	name: Documentation

	on:
	push:
	branches: [main]
	paths:
	- 'docs/**'
	- 'zensical.toml'
	- '.github/workflows/docs.yml'
	pull_request:
	paths:
	- 'docs/**'
	- 'zensical.toml'
	workflow_dispatch:

	permissions:
	contents: read

	jobs:
	build:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v6
	with:
	persist-credentials: false

	- name: Set up Python
	uses: actions/setup-python@v6
	with:
	python-version: '3.12'

	- name: Install Zensical
	run: pip install zensical

	- name: Build documentation
	run: zensical build --clean

	- name: Smoke-test built site
	run: make docs-smoke

	- name: Upload artifact
	uses: actions/upload-artifact@v6
	with:
	name: docs-site
	path: site/

	deploy:
	needs: build
	if: github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
	runs-on: ubuntu-latest
	permissions:
	contents: read
	deployments: write
	steps:
	- name: Download artifact
	uses: actions/download-artifact@v7
	with:
	name: docs-site
	path: site/

	- name: Deploy to Cloudflare Pages
	uses: cloudflare/wrangler-action@v3
	with:
	apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
	accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
	command: pages deploy site --project-name=rumdl-dev

Navigation Menu