From 187938c4db4dc43c73c94c3beedcf4ddf0b4fc7a Mon Sep 17 00:00:00 2001 From: Pjandro Date: Sun, 22 Nov 2026 21:39:08 +0300 Subject: [PATCH] =?UTF-8?q?build:=20mise-=D0=B7=D0=B0=D0=B4=D0=B0=D1=87?= =?UTF-8?q?=D0=B8=20docs-*=20=D0=B8=20gitignore=20=D1=81=D0=B0=D0=B9=D1=82?= =?UTF-8?q?=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - docs-install/docs-serve/docs-build/docs-javadoc/docs-deploy; публикация: javadoc → strict-build → rsync в ~/srv/wordpdf-docs (:9012). - gitignore: site/, docs/.venv/, docs/apidocs/. --- .gitignore | 5 +++++ mise.toml | 30 ++++++++++++++++++++++++++++++ 2 files changed, 35 insertions(+) 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/", +]