# wiki-i18n

Правило wiki-i18n контролирует переводы статической вики на китайский, вьетнамский, корейский и испанский языки при правках HTML и скриптов проекта.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 1198 у репозитория
- Автор: hoangsonww
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/HEAD/.claude/rules/wiki-i18n.md
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/wiki-i18n

## Что делает

Правило задаёт регламент обновления статической вики проекта в `wiki/index.html`. Английский текст служит первоисточником в DOM, а клиентские скрипты подменяют строки на лету. Любой новый видимый фрагмент должен одновременно получать переводы на упрощённый китайский (`zh`), вьетнамский (`vi`), корейский (`ko`) и испанский (`es`), иначе интерфейс останется наполовину английским.

Текст разбит на уровни: короткие метки и заголовки добавляются в словарь `T` внутри `wiki/script.js`, а основной текст страниц попадает в `wiki/i18n-content.js` с нормализацией пробелов в `innerHTML`. Атрибуты вроде `alt` или `aria-label` вынесены в `ATTRIBUTE_TRANSLATIONS`. Правило запрещает переводить имена файлов, CLI-флаги, переменные окружения и код.

Изменение структуры селекторов ломает тесты: `client/tests/wiki-i18n.test.ts` парсит файл `wiki/script.js` регулярными срезами исходника, поэтому менять форматирование объявлений нельзя. Для проверки разметки требуется запускать headless Chrome или Vitest.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/rules/wiki-i18n.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/wiki-i18n.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/wiki-i18n.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/wiki-i18n.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/wiki-i18n.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/HEAD/.claude/rules/wiki-i18n.md

## Когда брать
- синхронизировать переводы вики на четыре языка в одном коммите
- предотвратить выпадение непереведённых блоков в английский фолбэк
- сохранить разметку карточек карусели и подписей к скриншотам
- избежать поломки тестов при обновлении словарей перевода

## Примеры запросов агенту
- Обнови описание модуля в wiki/index.html и добавь переводы во все словари по правилу wiki-i18n
- Добавь новую карточку в карусель фич вики с соблюдением лимитов длины текста
- Проверь покрытие переводов через тесты вики перед коммитом

## Похожие
- [i18n-expert](https://affpapa.org/nevibecode/skills/i18n-expert.md) — скилл · 2800 установок
- [i18n-localization](https://affpapa.org/nevibecode/skills/travisjneuman-i18n-localization.md) — скилл · 143 установки
- [vtex-io-messages-and-i18n](https://affpapa.org/nevibecode/skills/vtex-io-messages-and-i18n.md) — скилл · 1200 установок
- [nuxt-i18n](https://affpapa.org/nevibecode/skills/nuxt-i18n.md) — скилл · 741 установка
- [internationalization-i18n](https://affpapa.org/nevibecode/skills/aj-geddes-internationalization-i18n.md) — скилл · 648 установок
- [i18n-agent](https://affpapa.org/nevibecode/mcp/i18n-agent.md) — MCP-сервер

Из того же набора: [hoangsonww/claude-code-agent-monitor](https://affpapa.org/nevibecode/by/hoangsonww/claude-code-agent-monitor.md) — 155 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
