RimLoc¶
RimLoc помогает моддерам RimWorld поддерживать переводы в актуальном состоянии, проверять их и готовить к передаче переводчикам.
Начать перевод Конфигурация (rimloc.toml)
🚀 Быстрый старт¶
Новичкам — сюда: getting-started.md. Там пошаговый гайд, примеры команд и советы.
Зачем нужен RimLoc?¶
- За один запуск собирает все строки из
Languages/*/{Keyed,DefInjected}. - Не допускает проблемных релизов, заранее находя дубликаты, пустые значения и ошибки плейсхолдеров.
- Экспортирует и импортирует пакеты PO/CSV, удобные для переводчиков.
- Может собрать переводческий мод напрямую из готового
.poфайла. - CLI уже локализован (английский и русский) и использует стек Fluent.
Команды в двух словах¶
См. обзор CLI: cli/index.md. Полные страницы с примерами: Scan · Validate · Validate PO · Export/Import · Build Mod.
Основные команды¶
| Команда | Что делает | Примечание |
|---|---|---|
scan |
Собирает строки из XML. | Добавьте --out-csv или --out-json, чтобы сохранить файл вместе с выводом. |
validate |
Находит дубликаты, пустоты и ошибки плейсхолдеров. | --format json удобно подключать к CI, --source-lang задаёт базовый язык. |
validate-po |
Сравнивает плейсхолдеры в msgid/msgstr PO. |
Флаг --strict превращает предупреждения в ошибки. |
export-po |
Формирует единый PO-файл. | Требуются --root и --out-po; добавьте --lang, чтобы заполнить заголовок. |
import-po |
Записывает обновления из PO обратно в XML. | --dry-run показывает изменения, --single-file складывает всё в _Imported.xml. |
build-mod |
Собирает самостоятельный мод-перевод из .po. |
--dry-run печатает план, --package-id и --rw-version легко кастомизировать. |
Что дальше?¶
- Прочитайте обзор CLI, чтобы узнать об опциях и примерах.
- Переходите напрямую: Сканирование · Проверка · Проверка PO · Экспорт / Импорт · Сборка мода
- Обновляйте документацию локально через
mkdocs serve, редактируя файлы вdocs/en/иdocs/ru/.
Помогите перевести RimLoc
Хотите видеть RimLoc на своём языке? Загляните в раздел Localization. Перевод можно сделать прямо через веб‑редактор GitHub без локальной настройки.
Где находится исходный код CLI?
Бинарные файлы лежат в crates/rimloc-cli, а фикстуры для экспериментов — в каталоге test/.
Вклад в документацию¶
Нашли неточность или хотите добавить пример? Отредактируйте страницу на GitHub или загляните в гайд AGENTS.md.