Документация
Docs/ru/reference/text-format/index.md
Справочник текста и локализации
Сгенерированный справочник. Не редактируйте его напрямую. Обновите
BuildTools/TextFormatInterface.json, затем выполнитеpython BuildTools/docs_text_format.py --write.
| Индекс | Синтаксис | Языки | Текст прототипов | Runtime | Проверка | Канонический JSON | Руководство |
Этот справочник описывает переиспользуемый контракт движка для текстовых пакетов, языков, текста прототипов, runtime lookup и встроенных цветов. Конкретные каталоги игровых пакетов и formatter-ы lexem принадлежат проекту.
Состояние контракта
| Поле | Значение |
|---|---|
| Стабильность | experimental |
| Политика поддержки | Контракт генерируется для закреплённой ревизии движка. Проекты владеют языковой политикой, каталогами пакетов, процессом перевода, семантическими соглашениями о ключах и любым игровым formatter-ом lexem или аргументов. |
| Исходный manifest | BuildTools/TextFormatInterface.json |
| Дайджест контракта | 85212eb8b0cd9addf3004e707478457679e362084025b40e5d28b97cc0745e87 |
| Имя исходного файла | <TextPack>.<Language>.fotxt |
| Имя запечённого файла | <ResourcePack>.<TextPack>.<Language>.fotxt-bin |
| Исходная запись | {Key1}{Key2}{Text} |
| Справочник | Записи | Назначение |
|---|---|---|
| Синтаксис | 7 | Исходные поля в фигурных скобках, идентичность ключей, многострочный текст и варианты. |
| Языки | 10 | Выбор имени файла, значения по умолчанию, повторное запекание и нормализация. |
| Текст прототипов | 8 | Грамматика $Text, наследование, маршрутизация пакетов и декодирование. |
| Runtime | 8 методов / 2 правил рендеринга | Script lookup, переключение языка, граница сервера и цветовые теги. |
Граница
Включено:
- имена файлов .fotxt, синтаксис полей в фигурных скобках, многострочные значения, структурированные ключи и повторяющиеся варианты
- порядок BakeLanguages, инкрементальное повторное запекание, нормализация языков при запекании и имена бинарных выходов
- поля $Text прототипов, наследование, маршрутизация выходных пакетов, декодирование escape-последовательностей и валидация
- клиентские и серверные поверхности script lookup, переключение языка и встроенные цветовые теги рендерера
Исключено:
- языковые приоритеты проекта, владение переводами, терминология и политика готовности релиза
- проектные lexem, подстановка аргументов, синтаксис случайного выбора, форматирование диалогов и обёртки чата
- конкретные имена пакетов кроме пяти пакетов текста прототипов, генерируемых движком
- выбор шрифта, layout, shaping и общий GUI authoring