globalize.now lietošana ar Next.js
Iestatiet internacionalizāciju Next.js lietotnē mazāk nekā piecās minūtēs.
Next.js ir pirmās klases i18n atbalsts caur bibliotēkām, piemēram, next-intl un next-i18next, bet šīs bibliotēkas sagaida kodbase ar tulkošanas atslēgām jau vietā. globalize.now ir solis pirms: tas ņem Next.js lietotni pilnu ar kodētu angļu valodu un ražo atslēgas, lokalizācijas failus un refaktorētos komponentus, ko next-intl (vai jebkura runtime bibliotēka) var kalpot.
Priekšnoteikumi
- Next.js projekts (App Router vai Pages Router)
- Git repozitorijs
- Node.js 18+
- Izvēlēta i18n runtime bibliotēka (next-intl ieteikts)
Kā iestatīt globalize.now ar Next.js
Instalējiet savu runtime bibliotēku
Pievienojiet next-intl vai bibliotēku, ko jūs vēlaties, lai lietotne varētu ielādēt katras lokales ziņojumus runtime.
npm install next-intlKonfigurējiet pamata next-intl maršrutēšanu
Savienojiet middleware, sniedzējus un maršruta segmentus, kā aprakstīts next-intl dokumentācijā, vai izlaidiet šo soli, ja jūs to jau pabeigāt.
Palaidiet Globalize prasmju instalētāju
No Next.js projekta saknes instalējiet prasmes, lai agentu varētu saskaņot ar jūsu maršrutēšanas iestatīšanu.
npx globalize-skillsApstipriniet next-intl atklāšanu
Ļaujiet agentam pārbaudīt, ka sniedzēji un ziņojumu ceļi atbilst konvencijām, ko globalize.now sagaida Next.js.
Pārskatiet piedāvāto lokalizācijas failu izkārtojumu
Pārbaudiet ieteikto ziņojumu direktoriju un failu nosaukumus, lai tie sekotu ziņojumiem-uz-lokali modelim, ko jūs izvēlējāties.
Refaktorējiet literāļus uz tulkošanas izsaukumiem
Apstipriniet atjauninājumus, kas aizstāj iegulto angļu valodu ar t() vai līdzīgiem palīgiem, kas savienoti ar jūsu sniedzēju.
Nosūtiet uz Git
Sapludināt filiāli un nosūtīt, lai globalize.now varētu turēt tulkojumus sinhronizētus nākamajā Git push.
Bieži problēmas
next-intl sagaida specifiku ziņojumu struktūru
Risinājums: globalize.now automātiski atklāj next-intl konvenciju un raksta JSON, kas atbilst jūsu konfigurētajām lokales mapēm, samazinot manuālu pārveidošanu.
Man jau ir daži tulkoti virknes — vai globalize.now tos pārrakstīs?
Risinājums: Esošās atslēgas tiek saglabātas, kad iespējams, un jaunos literāļus pievieno pakāpeniski, lai tulkotāji nezaudētu iepriekšējo darbu.
Bieži uzdotie jautājumi
Vai globalize.now darbojas ar next-intl un next-i18next?
Jā. globalize.now fokusējas uz repozitorija struktūru — atslēgas, JSON katalogus un komponenta izsaukuma vietas — kamēr next-intl vai next-i18next turpina ielādēt ziņojumus runtime. Izvēlieties jebkuru runtime, kas atbilst jūsu maršrutēšanas modelim; globalize.now pielāgo savu izvadi šai izvēlei. Jūs joprojām palaidīsit npx globalize-skills vienu reizi uz projekta bootstrap, ja vien jūs neparedzēti neatsvaidzināt prasmes.
Vai globalize.now atbalsta gan App Router, gan Pages Router?
Jā. Aģenta prasmes atpazīst jūsu izmantoto maršrutēšanas stilu un saskaņo ekstrakciju ar pareizajiem izkārtojuma failiem, maršruta apstrādātājiem un sniedzējiem. globalize.now neatstāj Next.js maršrutēšanu; tas nodrošina, ka virknes, kas plūst caur šiem maršrutiem, ir atslēgtas. Pēc iestatīšanas gan App Router servera komponenti, gan klienta komponenti atsaucas uz tiem pašiem lokāles failiem, ko jūsu izpildlaiks sagaida.
Vai es varu izmantot globalize.now ar Next.js lietotni, kurai jau ir daļēja i18n?
Jā. Norādiet aģentam uz repozitoriju, un tas paplašinās esošos ziņojumu komplektus, aizpildot spraugas, kur paliek burtiski teksti. Tas ir bieži, ja vispirms tika tulkoti tikai mārketinga lapas. globalize.now apvieno jaunas atslēgas, neatmetot vecākos tulkojumus, tāpēc komandas var migrēt ekrānu pa ekrānam.
Vai globalize.now atšķirīgi apstrādā servera komponentus un klienta komponentus?
globalize.now pārraksta burtiskos tekstus uz jebkuru palīgu, ko jūsu steks izmanto katrai robežai, ievērojot Next.js noteikumus par to, kur var darboties āķi un sniedzēji. JSON izvade paliek kopīga servera un klienta komplektiem, tāpēc jūs nedublējat katalogus. Jūs joprojām sekojat Next.js dokumentācijai, lai atzīmētu klienta komponentus, kad interaktivitāte to prasa.
Kā globalize.now integrējas ar Next.js statisko ģenerēšanu?
Lokāles faili atrodas Git, tāpēc `next build` turpina iepakot to pašu JSON, ko jūsu SSG vai SSR maršruti jau importē caur next-intl. globalize.now nemaina statiskās ģenerēšanas cauruļvadu, izņemot to, ka nodrošina, ka virknes nāk no datu failiem, nevis no burtiskiem tekstiem. Kad jauns saturs tiek nosūtīts, vēl viens Git push atsvaidzina tulkojumus pirms nākamā izvietošanas.
Vai man jāinstalē next-intl pirms npx globalize-skills palaišanas?
next-intl instalēšana vispirms ir ideāla, ja jūs jau zināt, ka tas ir jūsu izpildlaiks, jo aģents var nekavējoties savienot sniedzējus. Ja vēl neesat izvēlējies bibliotēku, jūs joprojām varat palaist npx globalize-skills — prasmes palīdz ieteikt steku — bet jūs varat atkārtoti palaist iestatīšanu pēc atkarību instalēšanas. Abi ceļi beidzas ar atslēgām, kas ievietotas Git, un sinhronizāciju uz push.
Izmēģiniet globalize.now ar Next.js
Sāciet no sava projekta saknes:
npx globalize-skillsAtgriezieties sākumlapā, lai iegūtu produkta kontekstu un cenas →