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:
@@ -44,3 +44,8 @@ DEPLOY.md
|
||||
# Mise: локальный бинарь mise (bootstrap.sh / bootstrap.ps1)
|
||||
/.mise/
|
||||
|
||||
# Сайт документации: сборка, venv, копия javadoc
|
||||
site/
|
||||
docs/.venv/
|
||||
docs/apidocs/
|
||||
|
||||
|
||||
@@ -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/",
|
||||
]
|
||||
|
||||
Reference in New Issue
Block a user