build: mise-задачи docs-* и gitignore сайта

- docs-install/docs-serve/docs-build/docs-javadoc/docs-deploy;
  публикация: javadoc → strict-build → rsync в ~/srv/wordpdf-docs (:9012).
- gitignore: site/, docs/.venv/, docs/apidocs/.
This commit is contained in:
Pjandro
2026-11-22 21:39:08 +03:00
parent 0e9266450c
commit 187938c4db
2 changed files with 35 additions and 0 deletions
+5
View File
@@ -44,3 +44,8 @@ DEPLOY.md
# Mise: локальный бинарь mise (bootstrap.sh / bootstrap.ps1)
/.mise/
# Сайт документации: сборка, venv, копия javadoc
site/
docs/.venv/
docs/apidocs/
+30
View File
@@ -54,3 +54,33 @@ run = "npm run dev"
description = "Прод-автотесты; обязателен WORDPDF_BASE_URL (факультативно WORDPDF_API_KEY)"
dir = "prod-autotests"
run = "python -m pip install -q -r requirements.txt && python -m pytest -q ."
[tasks.docs-install]
description = "Зависимости сайта документации: venv docs/.venv + mkdocs-material"
run = [
"[ -d docs/.venv ] || python -m venv docs/.venv",
"docs/.venv/bin/python -m pip install -q -r docs/requirements.txt",
]
[tasks.docs-serve]
description = "Локальный предпросмотр сайта на :8000 (live-reload)"
run = "docs/.venv/bin/mkdocs serve -a 127.0.0.1:8000"
[tasks.docs-build]
description = "Strict-сборка сайта в site/ (битые ссылки/навигация = ошибка)"
run = "docs/.venv/bin/mkdocs build --strict"
[tasks.docs-javadoc]
description = "Javadoc публичного API core в wordpdf-core/target/site/apidocs"
run = "mvn -q -pl wordpdf-core -am javadoc:javadoc"
[tasks.docs-deploy]
description = "Публикация сайта на rpi (:9012): javadoc + strict-build + rsync в ~/srv/wordpdf-docs"
run = [
"mvn -q -pl wordpdf-core -am javadoc:javadoc",
"rm -rf docs/apidocs",
"cp -r wordpdf-core/target/site/apidocs docs/apidocs",
"docs/.venv/bin/mkdocs build --strict",
"install -d /home/pjandro/srv/wordpdf-docs",
"rsync -a --delete site/ /home/pjandro/srv/wordpdf-docs/",
]