Skip to content

Commit 34dea8a

Browse files
committed
docs: generate and stage Javadoc during docs build
1 parent d3f6f1a commit 34dea8a

3 files changed

Lines changed: 10 additions & 1 deletion

File tree

‎.gitignore‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,4 +8,5 @@ tpch-data/
88
.claude
99
docs/superpowers
1010
docs/build/
11+
docs/source/_extra/
1112
docs/venv/

‎docs/build.sh‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,14 @@ set -e
2222
cd "$(dirname "$0")"
2323

2424
rm -rf build
25+
rm -rf source/_extra
26+
27+
# Generate Javadoc from the repo root. javadoc:javadoc triggers
28+
# generate-sources, which fetches upstream protos via wget.
29+
(cd .. && ./mvnw -q -DskipTests javadoc:javadoc)
30+
31+
mkdir -p source/_extra
32+
cp -R ../target/reports/apidocs source/_extra/api
2533

2634
if [ -d venv ]; then
2735
# shellcheck disable=SC1091

‎docs/source/conf.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@
3232
}
3333

3434
templates_path = ["_templates"]
35-
exclude_patterns = []
35+
exclude_patterns = ["_extra"]
3636

3737
html_theme = "pydata_sphinx_theme"
3838
html_theme_options = {

0 commit comments

Comments
 (0)