Kevin Burnett 3efe74450c
Diataxis docs (#2204)
* wip

* script

* script

* script

* script

* add keywords

* new structure

* fix links

* remove tmp doc

* combine bpmn terms and glossary

* rename

* update faq

* faq

* fix screenshot link

* remove keywords from index

* tags

* add tags

* rm tmp

* add back text

* dup text

* improve homepage

* remove dup

* unhose

* remove taxi

* only ignore w/ autobuild

---------

Co-authored-by: burnettk <burnettk@users.noreply.github.com>
2025-01-03 14:46:27 -08:00

33 lines
949 B
Bash
Executable File

#!/usr/bin/env bash
function error_handler() {
>&2 echo "Exited with BAD EXIT CODE '${2}' in ${0} script at line: ${1}."
exit "$2"
}
trap 'error_handler ${LINENO} $?' ERR
set -o errtrace -o errexit -o nounset -o pipefail
run_ci="false"
if grep -qE -- "--ci\>" <<<"$@"; then
run_ci="true"
fi
rm -rf _build/html
sphinx_command="sphinx-autobuild"
# must ignore generated dir with sphinx-autobuild or it becomes recursive
additional_args="--ignore '**/_tags/*'"
if [[ "$run_ci" == "true" ]]; then
sphinx_command="sphinx-build"
additional_args=""
fi
#>> sphinx-build --help 2>&1 | grep -E '^ +\-[aWn]\>'
# -a write all files (default: only write new and changed
# -j N build in parallel with N processes where possible
# -n nit-picky mode, warn about all missing references
# -W turn warnings into errors
"$sphinx_command" . _build/html -W -a -n -j auto $additional_args