Конфигурация (rimloc.toml)¶
RimLoc читает значения по умолчанию из файла настроек, чтобы не повторять флаги команд каждый раз.
Где ищется файл
- 1) ./rimloc.toml
— рядом с местом запуска команд (высший приоритет)
- 2) $HOME/.config/rimloc/rimloc.toml
Флаги команд всегда перекрывают значения из конфигурации.
Минимальный пример
source_lang = "English"
target_lang = "Russian"
game_version = "1.5"
list_limit = 100
Полный пример (скопируйте и отредактируйте под себя)
source_lang = "English"
target_lang = "Russian"
game_version = "1.5"
list_limit = 100
[export]
source_lang_dir = "English"
include_all_versions = false
# tm_root = "./Mods/MyMod/Languages/Russian"
[import]
keep_empty = false
backup = true
single_file = false
incremental = true
only_diff = true
report = true
lang_dir = "Russian"
[build]
name = "RimLoc Translation"
package_id = "yourname.rimloc.translation"
rw_version = "1.5"
lang_dir = "Russian"
dedupe = true
# from_root_versions = ["1.4", "1.5"]
[diff]
out_dir = "./logs/diff"
strict = false
[health]
lang_dir = "Russian"
strict = false
# only = ["encoding-detected"]
# except = ["unexpected-doctype"]
[annotate]
comment_prefix = "EN:"
strip = false
backup = true
[init]
overwrite = false
[schema]
out_dir = "docs/assets/schemas"
Как это влияет на команды
- source_lang
/ target_lang
/ game_version
— общие дефолты (если флаги не заданы).
- export
— для export-po
.
- import
— для import-po
(с --dry-run
всё равно печатает план).
- build
— для build-mod
(name/packageId/version/lang_dir).
- diff
и health
— для diff-xml
и xml-health
.
- annotate
— для annotate
(префикс, strip, backup).
- init
— для init
(overwrite).
- schema
— куда сохранять JSON‑схемы.
Советы
- Храните файл рядом с репозиторием мода — команда будет работать одинаково у всей команды.
- Длинные пути берите в кавычки.
- Начинайте с --dry-run
, чтобы увидеть, как настройки влияют на план действий.