Skip to content
Development
Skill

/localization

Локализация конфигурации 1С: НСтр/NStr, языки, переводы интерфейса и форматирование. Используй для подготовки к другому языку или проверки многоязычного кода и метаданных.

From plugin
unica
25350 skills1 MCP

Claude Code

$ npx -y skills add IngvarConsulting/unica --skill localization --agent claude-code

SKILL.md

localization.SKILL.md
name: localization
description: "Локализация конфигурации 1С: НСтр/NStr, языки, переводы интерфейса и форматирование. Используй для подготовки к другому языку или проверки многоязычного кода и метаданных."

Локализация 1С

Определи целевые языки, проверь пользовательские тексты и сохрани существующие переводы. Отделяй выполненные изменения от аудита и шагов, для которых публичная поверхность ещё не предоставляет операции.

Языки и представления

`Language.Name` — имя объекта, `LanguageCode` — код вроде `ru` или `en`. `Configuration.DefaultLanguage` ссылается на объект языка; например, `Language.Русский` само по себе не сообщает его код. `ScriptVariant` выбирает язык BSL, а не язык интерфейса. `LocaleCode` региональных настроек управляет форматами чисел, дат и Булево отдельно от выбора текста через НСтр.

Начни с `unica.view {}` и выданного корня конфигурации. В его свойствах `properties.defaultLanguage` и ветви `Language` проверь основной язык и состав. Если деталь языка показывает только `kind`, а `LanguageCode` не выдаётся, проверь другие доступные исходные данные задачи, затем уточни недостающие коды у пользователя. Не выводи код из имени объекта или языка переписки. Расширение имеет собственный языковой профиль; внешние обработки и отчёты при выполнении используют языки открывшей их конфигурации. Для скалярных многоязычных значений внешнего артефакта writer Unica выбирает явный `ru` по умолчанию: собственного `DefaultLanguage` у такого набора нет. Это не выбирает язык выполняющей базы.

Для подготовки к английскому составь перечень существующих и целевых кодов, основного языка, доступных переводов и пробелов. Добавление языка предполагает уникальный код, регистрацию в конфигурации и заполнение интерфейсных текстов. Выполняй его только при наличии соответствующей операции в текущем `Can`. Отсутствующая операция остаётся незавершённым шагом подготовки.

Полнота переводов по выбранным языкам — проверка качества проекта. Для НСтр и интерфейсных строк нет общего требования равенства всех наборов кодов: в интерфейсных текстах могут остаться переводы удалённых языков. Не удаляй их без поручения. Объявленные языковые страницы макетов проверяй по отдельным правилам ресурса.

НСтр в коде

`НСтр(ИсходнаяСтрока, КодЯзыка)` / `NStr` возвращает строку. Второй аргумент — необязательная строка с кодом языка, не числовой индекс; массива переводов функция не возвращает. Без второго аргумента выбирается язык пользователя; справка описывает результат на языке пользователя либо основном языке конфигурации. Не используй непроверенный fallback вместо проверки полноты.

Текст = НСтр("ru = 'Документ %1 не найден';
    |en = 'Document %1 was not found'");
Сообщить(СтрШаблон(Текст, ПредставлениеДокумента));

Ответ = НСтр("ru = 'Да'; en = 'Yes'", "en");

Записи разделяются `;`, код и текст — `=`. В примере текст каждой записи заключён в одинарные кавычки внутри строкового литерала BSL. `|` продолжает многострочный литерал: физический перенос попадает в строку. Здесь перенос разделяет записи языков; перенос внутри кавычек перевода станет частью пользовательского текста. Не разрывай подпись ради ширины исходника.

Локализуй подписи, подсказки, команды, сообщения и показываемые пользователю исключения. Для составного сообщения переводи целую фразу и подставляй значения через `%1`, `%2` и `СтрШаблон`; склейка переведённых слов ломает порядок слов. Именованные `%Параметр%` не являются синтаксисом СтрШаблон. Используй подходящие представления метаданных, когда они уже решают задачу.

Внутренние имена, ключи, коды протоколов и идентификаторы не переводятся; локализованное представление не служит ключом алгоритма. Журнал регистрации не исключается целиком: его тип события и комментарий локализуемы. Для типа события стандарт фиксирует основной язык, чтобы категория не зависела от языка сеанса; комментарий может использовать язык пользователя.

Переводы метаданных через MCP

Многоязычные `Synonym`, `ToolTip` и заголовки хранят пары код → текст. Семантический пример `Synonym`, сверенный с Designer XML 2.20 УТ:

<Synonym xmlns="http://v8.1c.ru/8.3/MDClasses"
         xmlns:v8="http://v8.1c.ru/8.1/data/core">
  <v8:item>
    <v8:lang>ru</v8:lang>
    <v8:content>Валюты</v8:content>
  </v8:item>
</Synonym>

В контексте этого фрагмента `v8` связан с `http://v8.1c.ru/8.1/data/core`. Другой перевод — отдельный `v8:item`. `Comment` — обычная строка, а не такой набор. `Name` также остаётся идентификатором. НСтр применяется в BSL; её вызов, записанный текстом в `Synonym`, не создаёт переводы. XML здесь иллюстрирует формат; изменяет его публичный `unica.apply`.

Читай цель и её `Can.<операция>` по адресам из `view`/`search`. Формы аргументов различаются:

  • `props.set` метаданных принимает `values.Synonym` строкой; член метаданных

использует свой `attribute.set` и опубликованное поле `synonym`. Скаляр относится к основному языку набора, не к языку текущего пользователя. Английская строка при основном `ru` не добавляет перевод `en`.

  • `props.set` корня формы принимает `values.Title` непустой строкой основного языка

с сохранением других переводов или полной картой переводов. Пустая строка удаляет весь заголовок со всеми переводами. Для удаления только одного перевода передай полную непустую карту с остальными языками и непустыми текстами. Последний перевод удаляется пустой строкой `Title`. Поддержку карты проверяй в `Can` этой формы.

  • При создании `Label` через `item.add` его `title` также принимает карту

языков. Это отдельный контракт создания: поддержку карты для изменения существующего элемента, других видов элементов или команд проверяй в соответствующем `Can`, не переноси её с корня формы или нового `Label`.

  • Одна строка `title`/`Synonym` в ответе не доказывает отсутствия других

переводов. Если полный набор не наблюдается, получи его из разрешённых исходных данных задачи до замены карты. Не собирай её из единственной подписи.

Например, когда полный набор загол

Read more
@ingvarconsulting
Ships withunica

Unica (Ю́ника) — плагин для Codex, Claude Code и ZCode для разработки на 1С:Предприятии.

25350 skills1 MCP
Get the whole plugin

Stars on GitHub

Momentum

stars in total
253
Star history of IngvarConsulting/unica on GitHub, a chart by star-history.com

Other skills on unica.

api-design

api-design

Проектирование и ревью API 1С: публичный программный интерфейс, служебный интерфейс, переопределяемые модули, совместимость,…

autonomous-server

autonomous-server

Автономный сервер отладки 1С. Используй когда нужно развернуть или проанализировать локальный автономный контур для отладки…

background-jobs

background-jobs

Фоновые и регламентные задания 1С. Используй когда нужно спроектировать, проверить или диагностировать background jobs,…

bsp-patterns

bsp-patterns

Поиск и применение паттернов БСП. Используй когда задача про длительные операции, профили групп доступа, безопасное хранение,…

cf-edit

cf-edit

Точечное редактирование конфигурации 1С. Используй когда нужно изменить свойства конфигурации, добавить или удалить объект из…

cf-init

cf-init

Создать пустую конфигурацию 1С (scaffold XML-исходников). Используй когда нужно начать новую конфигурацию с нуля

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills2w309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc2w293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react6d252k
@facebook@facebookInstall Skill

Questions about localization.

Which coding agents can use localization?
localization installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.