📚 Словарь RimLoc¶

Короткие и понятные определения терминов, встречающихся в документации.

Плейсхолдер¶

«Дырка» в тексте, куда игра подставляет переменные значения: числа, имена, предметы. Примеры: %d, %s, {0}, {PAWN_name}. В переводе плейсхолдеры должны полностью совпадать с оригиналом — иначе строка сломается. См. cli/validate_po.md

DefInjected¶

Переводы «вшиты» рядом с XML‑описаниями объектов (ThingDef, RecipeDef и т. п.). Ключ строится по пути к полю: DefType.defName.field. Пример: ThingDef.Beer.label.

Keyed¶

Переводы из отдельного словаря ключей Languages/<Lang>/Keyed/*.xml, где key → текст. Удобно для UI/общих сообщений.

PO (Portable Object)¶

Формат файла перевода, где msgid — оригинальный текст, msgstr — перевод. Удобен для Poedit/CAT. В RimLoc единый .po собирается из DefInjected и Keyed. См. cli/export_import.md

Dry‑run¶

«Сухой прогон» — RimLoc показывает, что собирается сделать (изменить/создать файлы), но ничего не записывает на диск. Полезно перед импортом и сборкой. Флаг --dry-run поддерживают многие команды.

Мод‑перевод¶

Отдельный мод, который содержит только переводы (Languages/Russian и метаданные), — без исходного кода автора. Собирается командой build-mod.

Корень мода (mod root)¶

Папка верхнего уровня мода (есть About/, Defs/, часто Languages/). Пример: ./Mods/MyMod.

Отчёт (`--report`)¶

Режим с подробным перечислением изменений при импорте/сборке — удобно для ревью.

CSV/JSON вывод¶

Машиночитаемые форматы из scan, validate, diff-xml и др. Используются для проверки в CI и анализа.

Язык/локаль (locale)¶

Код языка и культуры, например ru, en, pt-br. В RimLoc используется для выбора папки Languages/<Lang> и заполнения метаданных в .po.

Ключ (key)¶

Идентификатор строки в Keyed или путь для DefInjected. В Keyed это имя узла (например, GreetingHello), в DefInjected — путь вида ThingDef.Beer.label.