File size: 955 Bytes
8c9ba62 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 | #!/bin/bash
# Usage:
# ./build_doc.sh # all language and all versions
# ./build_doc.sh --branch xxx # Only current branch
set -euo pipefail
SRC_EN="source"
SRC_ZH="source_zh"
OUT_ROOT="build/html"
OUT_EN="${OUT_ROOT}/en"
OUT_ZH="${OUT_ROOT}/zh"
BRANCH_FILTER=""
if [[ "${1:-}" == "--branch" && -n "${2:-}" ]]; then
BRANCH_FILTER="$2"
echo "[build_doc] Only building branch: ${BRANCH_FILTER}"
fi
build_one () {
local SRC="$1"
local DST="$2"
mkdir -p "${DST}"
if [[ -n "${BRANCH_FILTER}" ]]; then
sphinx-multiversion \
-D smv_branch_whitelist="^(${BRANCH_FILTER})$" \
-D smv_tag_whitelist="^$" \
"${SRC}" "${DST}"
else
sphinx-multiversion "${SRC}" "${DST}"
fi
}
echo "[build_doc] Building zh -> ${OUT_ZH}"
build_one "${SRC_ZH}" "${OUT_ZH}"
echo "[build_doc] Building en -> ${OUT_EN}"
build_one "${SRC_EN}" "${OUT_EN}"
echo "[build_doc] Done. Output at ${OUT_ROOT} (subdirs: en/, zh/)"
|