Book

Implement Cancel Safety using `CmdExecution` and blocks #539

	on:
	push:
	branches:
	- main
	pull_request:
	branches:
	- '**'

	name: Book

	jobs:
	publish_book:
	name: Peace Book
	runs-on: ubuntu-latest
	timeout-minutes: 10
	steps:
	- uses: actions/checkout@v3
	- uses: dtolnay/rust-toolchain@stable

	- name: 'Install `wasm-pack`'
	uses: jetli/[email protected]
	with:
	version: 'v0.11.1'

	- name: mdbook-graphviz Cache
	id: mdbook_graphviz_cache
	uses: actions/cache@v3
	with:
	path: ~/.cargo/bin/mdbook-graphviz
	key: ${{ runner.os }}-mdbook-graphviz

	- name: Setup Graphviz
	uses: ts-graphviz/setup-graphviz@v1

	- run: cargo install mdbook-graphviz
	if: steps.mdbook_graphviz_cache.outputs.cache-hit != 'true'

	# When updating this, also update ci.yml
	- name: 'Example: download (WASM)'
	# The following no longer works, because the AWS SDK uses tokio with UDP features enabled:
	# for example in $(ls examples)
	run: \|
	for example in download
	do wasm-pack build \
	--target web \
	--out-dir "../../doc/src/examples/pkg" \
	--release \
	"examples/${example}" \
	--features 'error_reporting'
	done

	# Build and publish book
	- name: Install `mdbook`
	uses: peaceiris/actions-mdbook@v1
	with:
	mdbook-version: latest

	- run: mdbook build doc

	# Note: `test` doesn't work with the examples' inlined HTML.
	# - run: mdbook test doc

	# We do want to include the built wasm files.
	- run: rm -f ./doc/book/examples/pkg/.gitignore

	- name: Publish to `gh-pages`
	if: ${{ github.ref == 'refs/heads/main' }}
	uses: peaceiris/actions-gh-pages@v3
	with:
	github_token: ${{ secrets.GITHUB_TOKEN }}
	publish_dir: ./doc/book
	force_orphan: true

Provide feedback