Diplodoc CLI (yfm-docs)

Помимо сборки в HTML есть промежуточный режим: Markdown на входе — Markdown на выходе. В нём подставляются переменные и заголовки, вставляется содержимое включаемых файлов и, главное, проверяются условия видимости разделов.

На этом и держится приём с одним источником: внутренний и публичный репозитории документации — один текст, публичный собирается из него по условиям. Не нужно вести две копии и синхронизировать их руками.

Перевод — отдельная команда, а не сторонний плагин. По умолчанию используется Yandex Translate, поддерживаются и языковые модели: yandexgpt, openai, openrouter, anthropic.

Для работы с переводчиками-людьми есть обмен файлами xliff — то есть документация уезжает в CAT-систему вроде SmartCAT или Weblate и возвращается обратно. Есть предварительная оценка объёма без фактического перевода.

Сборщик умеет упаковываться в один исполняемый файл, внутри которого и он сам, и среда выполнения Node. Файл собирается один раз на машине с интернетом и дальше просто копируется на машины с той же операционной системой.

Это закрывает типичный случай закрытого контура, где ставить Node и тянуть пакеты из сети нельзя.