mirror of
https://github.com/Vateron-Media/XC_VM.git
synced 2026-10-04 04:02:30 +02:00
Divarion_D
bdbcde97c7
CI translation was slow, so move it out of GitHub Actions: docs/ru is now a committed, generated tree refreshed LOCALLY before a release; CI only builds it. - pages.yml: drop the setup-python/cache/translate steps — the workflow now just installs the build toolchain and runs `mkdocs build --strict` on the committed en+ru trees. - .gitignore: stop ignoring docs/ru (now committed); keep site/ + .docs-cache/. - Split deps: docs/requirements.txt = build only (mkdocs-material, static-i18n, used by CI); tools/docs/requirements.txt = translators (local-only). - Makefile: docs-venv installs both; docs-build/docs-serve no longer translate (translation is the deliberate `make docs-translate` release step). - updates_checklist.md: new "Regenerate translated documentation" step (make docs-translate + docs-build, commit docs/ru with the release commit). - Commit the generated docs/ru (37 files, translators/yandex). Rule: edit ONLY docs/en; docs/ru is generated — never hand-edit it.
12 lines
609 B
Plaintext
12 lines
609 B
Plaintext
# Translation dependencies for tools/docs/translate.py — LOCAL only (run before a
|
|
# release via `make docs-translate`; NOT installed or run in CI). Pick per
|
|
# DOCS_TRANSLATE_PROVIDER:
|
|
# translators = free, NO API KEY (web engines: yandex/google/bing/...) — default
|
|
# anthropic = highest quality for structure-heavy Markdown (ANTHROPIC_API_KEY)
|
|
# deepl = DeepL API (DEEPL_AUTH_KEY)
|
|
# noop = copy English verbatim (no dependency)
|
|
|
|
translators>=5.9
|
|
# anthropic>=0.40 # uncomment for DOCS_TRANSLATE_PROVIDER=anthropic
|
|
# deepl>=1.18 # uncomment for DOCS_TRANSLATE_PROVIDER=deepl
|