Kā pievienot i18n lietotnei, kas veidota ar GitHub Copilot?

Pievienojiet izpildlaika i18n bibliotēku, tad konvertējiet tekstus, ko Copilot jau ir uzrakstījis, un pēc tam nepieļaujiet jaunu tekstu rašanos. Solis, kurā lielākā daļa komandu kļūdās, ir pēdējais, jo repozitorija instrukciju fails nesasniedz visas vietas, no kurām Copilot raksta kodu. Tērzēšana un kodēšanas aģents to nolasa. Iebūvētā automātiskā pabeigšana — nē. globalize.now ir AI darbināta lokalizācijas infrastruktūra, kas kodabāzi konvertē vienreiz un izveido atslēgas un lokalizācijas failus, ko lasa jūsu i18n bibliotēka.

Kāpēc Copilot joprojām raksta burtiskus tekstus pēc instrukciju faila pievienošanas?

Tāpēc, ka instrukciju fails nav iekļauts ātrākajā ceļā. VS Code dokumentācija skaidri norāda, ka pielāgotās instrukcijas netiek ņemtas vērā iebūvētajiem ieteikumiem, ko saņemat rakstīšanas laikā. Tas ir režīms, kurā lielākā daļa cilvēku pavada lielāko dienas daļu.

Tātad jūsu uzrakstītais likums ir īsts un attiecas, kad tērzēšanā uzdodat Copilot jautājumu vai uzticat uzdevumu kodēšanas aģentam. Tas neattiecas, kad rakstāt JSX tagu un nospiežat Tab uz pelēkotā ieteikuma. Abas darbības rada apstiprinātu kodu. Tikai viena no tām ir izlasījusi jūsu likumu.

Kuras Copilot vietas nolasa jūsu instrukcijas?

Trīs vietas raksta kodu jūsu repozitorijā, un tās uzvedas atšķirīgi.

Kodēšanas aģents ir draudzīgākais no trim variantiem šīs problēmas risināšanai. Jūs piešķirat tam uzdevumu (issue), tas strādā fonā un atver melnraksta pull request, tāpēc rezultāts nonāk vietā, kur recenzents jau tāpat skatās. Iebūvētie ieteikumi nonāk bez jebkādiem kontrolpunktiem.

Kā iestatīt i18n Copilot projektā?

Vispirms izvēlieties izpildlaika bibliotēku, ko prasa jūsu ietvars (framework). next-intl priekš Next.js App Router, react-i18next jebkurai citai React lietotnei, Lingui — ja vēlaties kompilēšanas laika iegūšanu un PO katalogus. Mēs salīdzinājām šīs trīs iespējas rakstā next-intl vs react-i18next vs Lingui.

Copilot nav tik cieši piesaistīts konkrētam ietvaram kā Lovable vai Bolt, tāpēc bibliotēkas izvēle patiešām ir jūsu ziņā. Kas nav atklāts, ir secība. Instalējiet bibliotēku, konvertējiet jau esošos tekstus un tikai tad domājiet par novēršanu. Novēršanas likums, kas uzrakstīts kodabāzei, kura joprojām ir 90 procenti burtiska angļu valoda, jums neko nedod izmērīšanai.

Kam vajadzētu būt failā .github/copilot-instructions.md?

Repozitorija instrukciju fails šajā ceļā tiek automātiski atklāts un piemērots tērzēšanas pieprasījumiem darbvietā. GitHub pati iesaka katru instrukciju paturēt īsu un pašpietiekamu, izskaidrot pamatojumu un izlaist visu, ko jau piespiedu kārtā ievieš linteris. i18n sadaļa, kas seko šim padomam, ir neliela\Pēdējā rindiņa ir svarīgāka, nekā šķiet.

## User-facing text

- User-facing text belongs in the message catalog, never in a component literal.
- Use the translation function from our i18n library for every visible string.
- Reason: a literal cannot be translated and does not show up as a missing key,
  so it ships silently in one language.
- Add new English values to the source catalog only. Never hand-edit other locales.
- Not user-facing: test names, log lines, error codes, internal constants.

Pēdējā rindiņa ir svarīgāka, nekā šķiet. Likumi, kas tiek piemēroti pārmērīgi, tiek ignorēti, un likums, kas liek aģentam ietīt žurnāla ziņojumus, iemācīs tam, ka visa sadaļa ir troksnis. Ja jums vēl vispār nav instrukciju faila, VS Code var to izveidot uz jūsu kodabāzes pamata ar init komandu tērzēšanā — tas ir labāks sākumpunkts nekā tukšs fails.

Vai ceļam specifisks instrukciju fails var darboties labāk?

Jā, un šis ir vienīgais mehānisms, kas Copilot ir, bet citu redaktoru likumu failiem nav. Faili ar galotni .instructions.md, kas glabājas mapē .github/instructions, savā sākumdaļā (frontmatter) satur applyTo glob un tiek ielādēti tikai tad, kad aģents skar atbilstošu failu.

---
name: 'UI strings'
description: 'String handling rules for components'
applyTo: '**/*.{jsx,tsx}'
---
Every visible string in this file must come from the catalog.
Key format is feature.element.state, lowerCamelCase.
If you add a key here, add its English value to the source catalog in the same change.

Likuma piesaiste komponentu failiem to padara ticamu. Tas iedarbojas tur, kur atrodas lietotājam redzamais teksts, un klusē jūsu API maršrutos un migrācijas skriptos. Ja jums repozitorija saknē jau ir AGENTS.md vai CLAUDE.md, Copilot tos lasa arī kā pastāvīgi aktīvas instrukcijas, tāpēc komandai, kas izmanto vairākus aģentus, nav vajadzīgs atsevišķs fails katram rīkam.

Kas notver tekstus, ko instrukcijas palaiž garām?

Lint likums CI, jo tas ir vienīgais slānis šajā ķēdē, kas noraida būvējumu (build). Instrukcijas maina iespējamību; kļūdaina pārbaude maina iznākumu. Mēs detalizēti izklāstījām šo piespiedu izpildes slāni rakstā kāpēc AI aģenti turpina pievienot burtiskus tekstus, un šis iestatījums bez izmaiņām attiecas arī uz Copilot repozitoriju.

Copilot specifiskais papildinājums ir pull request. Repozitorija instrukcijas attiecas gan uz Copilot koda pārskatīšanu, gan tērzēšanu, tāpēc tas pats fails, kas veido ģenerēšanu, veido arī pārskata komentārus kodēšanas aģenta melnraksta PR. Tas dod vienu kontrolpunktu, ko iebūvētā automātiskā pabeigšana nevar apiet — tas ir tuvākais, kas pastāv risinājumam šī raksta sākumā minētajai problēmai.

Nekas no tā neatceļ jau esošo parādu repozitorijā, un nekas no tā neaizpilda lokalizācijas failu. Burtiska teksta pamanīšana pārskatā jums pasaka, ka teksts trūkst. Kādam joprojām jāizveido tam atslēga, jātulko un jāuztur pārējās valodas, lai tās nesāktu atpalikt.

Kur šajā visā iekļaujas globalize.now?

Tajā slānī, kas rada katalogu — daļā, ko nedara ne jūsu i18n bibliotēka, ne instrukciju fails. Jūs pievienojat repozitoriju lietotnē, un tā vienreiz konvertē kodabāzi, aizstājot burtiskos tekstus ar atslēgām un ģenerējot lokalizācijas failus. Pēc šīs vienreizējās konvertēšanas push darbi tulko jaunās kataloga vienības, ko ievieš jūsu commit.

Output is JSON or PO, so the catalogs land in the shape your runtime library already reads. The same approach covers the other agentic editors: Claude Code and Cursor hit the same wall from a different direction, and there is a step-by-step version for a Next.js codebase in adding i18n to an AI-built Next.js app. The developer docs cover the conversion in more detail, and plans are on the pricing page.

Īsumā

Uzrakstiet instrukciju failu, piesaistiet ceļam specifisku likumu saviem komponentu failiem un pievienojiet lint likumu CI, lai plaisa starp to, kas Copilot tika teikts, un to, ko Copilot uzrakstīja, kļūtu par sarkanu build, nevis par nosūtītu angļu valodas tekstu. Tad vienreiz konvertējiet uzkrāto parādu, lai likumam būtu kas konsekvents, ko aizsargāt.