1  #!/bin/bash
 2  # Build PyOD docs locally.
 3  #
 4  # Usage:
 5  #   bash docs/build.sh          # Build once
 6  #   bash docs/build.sh clean    # Clean build
 7  #   bash docs/build.sh watch    # Auto-rebuild on change (requires sphinx-autobuild)
 8  #
 9  # Dependencies (install once):
10  #   pip install sphinxcontrib-bibtex furo sphinx-rtd-theme sphinx-autobuild
11  
12  set -e
13  cd "$(dirname "$0")"
14  
15  MODE="${1:-build}"
16  
17  case "$MODE" in
18      clean)
19          rm -rf _build
20          echo "Cleaned _build/"
21          ;;
22      watch)
23          exec sphinx-autobuild . _build/html --open-browser --port 8000
24          ;;
25      build|*)
26          python -m sphinx -b html . _build/html
27          echo
28          echo "Built docs. Open: docs/_build/html/index.html"
29          ;;
30  esac