Skip to main content

i18n Skills

AI команде за проверу и обухватање i18n текстова

Проблем

Ваша база кода има 500 директно уписаних текстова расутих по компонентама, шаблонима и приказима. Ручно обухватање захтева дане заморног проналажења и замене. Чак и после обухватања пропуштате подељене реченице које се нарушавају на немачком, логику множине која не ради на арапском и напуштене кључеве који непотребно повећавају датотеке локала.

Ручно i18n обухватање подложно је грешкама: програмери пропуштају подељене реченице, нарушавају множине тернарним операторима и остављају директно уписане текстове у рубним случајевима. Ове грешке испливају тек после превођења, када је њихово исправљање 10 пута скупље.

Решење

Две AI slash команде које обављају цео i18n ток рада. Покрените /i18n-review да проверите код без измена, а затим /i18n-wrap да све аутоматски исправите. Обе команде откривају Ваш радни оквир, разумеју формат датотека локала и проверавају измене пре commit корака.

/i18n-review

Провера само за читање која проналази подељене реченице, неисправне множине, необухваћене текстове и некоришћене кључеве. Никада не мења Ваш код.

/i18n-wrap

Аутоматски обухвата директно уписане текстове исправном функцијом за превођење, генерише семантичке кључеве, ажурира датотеке локала и проверава build.

Команда /i18n-review

Команда за преглед обавља проверу базе кода само за читање. Скенира сваку датотеку у потрази за i18n проблемима и прави извештај по приоритетима са тачним локацијама датотека и предлозима исправки. Ваш код се никада не мења.

Terminal
/i18n-review src/
/i18n-review src/ --framework=next-intl

Шта проверава

  • Подељене реченице: спојени позиви t() који нарушавају ред речи у другим језицима
  • Прекомерно обухватање: технички текстови, CSS класе, URL адресе и вредности набрајања погрешно обухваћени функцијом t()
  • Недовољно обухватање: видљиви текстови корисничког интерфејса, као што су ознаке дугмади, наслови и поруке о грешкама, остају директно уписани
  • Проблеми са множином: тернарни оператори или провере === 1 уместо исправне ICU синтаксе множине
  • Некоришћени кључеви: кључеви превода дефинисани у датотекама локала, али нигде наведени у коду
  • Директно уписане вредности формата: датуми, валуте и бројеви који не користе Intl форматере
Команда за преглед служи искључиво за читање. Покрећите је колико год често желите током развоја или у CI/CD pipeline системима без ризика од нежељених измена.

Команда /i18n-wrap

Команда wrap аутоматски обухвата директно уписане текстове исправном функцијом за превођење за Ваш радни оквир. Открива Вашу i18n библиотеку, генерише семантичке кључеве груписане по компоненти или функционалности, ажурира датотеке локала и проверава да ли build и даље пролази.

Terminal
/i18n-wrap src/components/
/i18n-wrap src/ --framework=react-i18next

Шта ради

  • Откривање радног оквира: препознаје Вашу i18n библиотеку и њену функцију за превођење (t, $t, $_, gettext итд.)
  • Генерисање семантичких кључева: прави смислене кључеве као што су nav.signIn и errors.notFound уместо генеричких ознака
  • Ажурирање датотека локала: додаје нове кључеве у датотеку изворног локала у исправном формату (JSON, YAML, PO итд.)
  • Валидација build процеса: покреће Ваше build, lint и test команде након обухватања како би открила регресије
Команда wrap проверава сваку измену покретањем build процеса и скупа тестова. Ако нешто не успе, аутоматски враћа измене.

Подржани радни оквири

Обе команде аутоматски откривају радни оквир на основу зависности пројекта. Можете и изричито да га наведете ознаком --framework. Ево 10 подржаних радних оквира са њиховим функцијама за превођење и форматима множине.

Радни оквирФункција за превођењеФормат множине
react-i18nextt()key_one / key_other
next-intlt()ICU {count, plural, ...}
vue-i18n$t()Pipe syntax | singular | plural
angular i18n$localizeICU {count, plural, ...}
svelte-i18n$_()ICU {count, plural, ...}
flutter intlS.of(context)Intl.plural()
djangogettext / _()ngettext()
rails i18nt()count key
laravel__() / @langtrans_choice()
swiftNSLocalizedString.stringsdict

Инсталација

Копирајте датотеке команди у свој директоријум .claude/commands/. То је све — без зависности и конфигурације. Команде су обичне Markdown датотеке које сваки AI помоћник за програмирање може да изврши.

Terminal
mkdir -p .claude/commands
cp commands/i18n-review.md .claude/commands/
cp commands/i18n-wrap.md .claude/commands/
Ово су стандардне датотеке slash команди. Одмах раде у Claude Code окружењу и могу се прилагодити другим AI помоћницима за програмирање који подржавају прилагођене команде.

Примери употребе

React пројекат

Прегледајте React апликацију која користи react-i18next, а затим обухватите све директно уписане текстове. Команде откривају react-i18next у датотеци package.json и користе исправну функцију t() и формат множине key_one/key_other.

React Project
# Review a React project for i18n issues
/i18n-review src/ --framework=react-i18next

# Wrap all hardcoded strings automatically
/i18n-wrap src/components/ --framework=react-i18next

# Result: t() calls inserted, keys added to en/translation.json

Django пројекат

Проверите Django шаблоне и приказе у потрази за i18n проблемима, а затим обухватите текстове функцијом gettext. Команде откривају Django у датотеци settings.py и користе _() за једноставне текстове и ngettext() за множине.

Django Project
# Review Django templates and views
/i18n-review myapp/ --framework=django

# Wrap hardcoded strings with gettext
/i18n-wrap myapp/templates/ --framework=django

# Result: _() calls inserted, .po file updated

Повезани водичи за радне оквире

Водич за React i18nВодич за Next.js i18nВодич за iOS локализацијуВодич за Android локализацију

Испробајте i18n Agent сада

Пустите датотеку за превођење овде

JSON, YAML, PO, XML, CSV, Markdown, Properties

или кликните за избор

Циљни језици

Регистрација није потребнаТренутна процена

Честа питања