diff --git a/.gitignore b/.gitignore index ec740ac..756e66c 100644 --- a/.gitignore +++ b/.gitignore @@ -44,3 +44,8 @@ DEPLOY.md # Mise: локальный бинарь mise (bootstrap.sh / bootstrap.ps1) /.mise/ +# Сайт документации: сборка, venv, копия javadoc +site/ +docs/.venv/ +docs/apidocs/ + diff --git a/mise.toml b/mise.toml index bdd62d3..88ee1e9 100644 --- a/mise.toml +++ b/mise.toml @@ -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/", +]