Перейти к содержанию

title: PO: экспорт и импорт

PO export/import

Эти команды нужны для обмена с PO/CAT workflow. PO не является канонической моделью RimLoc-проекта и не нужен, если перевод выполняется прямо в desktop-приложении.

Export PO

Используйте export-po, когда нужен единый handoff для Poedit, другого CAT или внешнего переводчика.

rimloc-cli export-po \
  --root ./Mods/MyMod \
  --out-po ./work/MyMod.ru.po \
  --lang ru

В актуальных сборках полезны:

  • --source-lang / --source-lang-dir;
  • повторяемый --tm-root для старого root-based reuse;
  • --game-version;
  • --include-all-versions.

Перед handoff:

rimloc-cli validate --root ./Mods/MyMod

Validate PO

rimloc-cli validate-po --po ./work/MyMod.ru.po --strict

Это проверяет проблемы именно handoff-формата, например placeholders.

Import PO

Импортируйте в отдельную рабочую копию/выходное дерево.

Сначала dry-run:

rimloc-cli import-po \
  --po ./work/MyMod.ru.po \
  --mod-root ./work/MyMod-copy \
  --lang ru \
  --dry-run \
  --report

Только после проверки плана запускайте запись без --dry-run.

Частые опции:

  • --backup;
  • --incremental;
  • --only-diff;
  • --single-file;
  • --format text|json.

Не импортируйте в оригинальный Workshop source

Новая product-модель считает game/Workshop/source read-only. Для CLI-экспериментов используйте working copy или отдельное output-дерево.

Не используете PO?

Это нормально.

  • Desktop project editing не требует PO.
  • build-mod --from-root собирает готовое translated Languages-дерево.
  • Другие interchange formats должны оставаться адаптерами вокруг той же canonical project model.

См. Build Mod и Начало работы.