globalize.now izmantošana ar Next.js
Iestatiet internacionalizāciju Next.js lietotnē mazāk nekā piecās minūtēs.
Next.js piedāvā izcilu i18n atbalstu, izmantojot tādas bibliotēkas kā next-intl un next-i18next, taču šīm bibliotēkām nepieciešama kodabāze, kurā tulkošanas atslēgas jau ir izveidotas. globalize.now ir solis pirms tam: tas pārveido Next.js lietotni, kas pilna ar burtisku angļu valodas tekstu, atslēgās, lokalizācijas failos un pārstrukturētās komponentēs, kuras var apkalpot next-intl (vai jebkura cita izpildlaika bibliotēka).
Priekšnoteikumi
- Next.js projekts (App Router vai Pages Router)
- Git repozitorijs
- Node.js 18+
- Izvēlēta i18n izpildlaika bibliotēka (ieteicams next-intl)
Kā iestatīt globalize.now ar Next.js
Instalējiet savu izpildlaika bibliotēku
Pievienojiet next-intl vai citu vēlamo bibliotēku, lai lietotne varētu ielādēt katras valodas ziņojumus izpildlaikā.
npm install next-intlKonfigurējiet pamata next-intl maršrutēšanu
Sasaistiet middleware, providerus un maršruta segmentus, kā aprakstīts next-intl dokumentācijā, vai izlaidiet šo soli, ja tas jau ir izdarīts.
Palaidiet Globalize prasmju instalētāju
No Next.js projekta saknes direktorijas instalējiet prasmes, lai aģents varētu pielāgoties jūsu maršrutēšanas iestatījumiem.
npx skills add globalize-now/globalize-skills --allApstipriniet next-intl noteikšanu
Ļaujiet aģentam pārbaudīt, vai provideri un ziņojumu ceļi atbilst konvencijām, ko globalize.now sagaida Next.js projektos.
Pārskatiet piedāvāto lokalizācijas failu izkārtojumu
Pārbaudiet ieteikto ziņojumu direktoriju un failu nosaukumus, lai tie atbilstu jūsu izvēlētajam katras valodas ziņojumu modelim.
Pārveidojiet burtiskus tekstus par tulkošanas funkciju izsaukumiem
Apstipriniet izmaiņas, kas aizstāj iekļauto angļu valodas tekstu ar t() vai līdzvērtīgām palīgfunkcijām, kas sasaistītas ar jūsu provideri.
Veiciet push uz Git
Apvienojiet zaru un veiciet push, lai globalize.now varētu saglabāt tulkojumus sinhronizētus turpmākajos Git push.
Biežākās problēmas
next-intl sagaida noteiktu ziņojumu struktūru
Risinājums: globalize.now automātiski nosaka next-intl konvenciju un izveido JSON failus, kas atbilst jūsu konfigurētajām lokalizācijas mapēm, samazinot nepieciešamību pēc manuālas pārstrukturēšanas.
Man jau ir daži iztulkoti teksti — vai globalize.now tos pārrakstīs?
Risinājums: Esošās atslēgas tiek saglabātas, kad vien iespējams, un jauni burtiski teksti tiek pievienoti pakāpeniski, lai tulkotāji nezaudētu iepriekš paveikto darbu.
Biežāk uzdotie jautājumi
Vai globalize.now darbojas ar next-intl un next-i18next?
Jā. globalize.now koncentrējas uz repozitorija struktūru — atslēgām, JSON katalogiem un komponenšu izsaukuma vietām —, savukārt next-intl vai next-i18next turpina ielādēt ziņojumus izpildlaikā. Izvēlieties jebkuru izpildlaika bibliotēku, kas atbilst jūsu maršrutēšanas modelim; globalize.now pielāgo savu izvadi šai izvēlei. Jums joprojām jāpalaiž npx skills add globalize-now/globalize-skills vienu reizi katra projekta sākotnējā iestatīšanā, ja vien apzināti neatjaunināt prasmes.
Vai globalize.now atbalsta gan App Router, gan Pages Router?
Jā. Aģenta prasmes nosaka jūsu izmantoto maršrutētāja veidu un pielāgo teksta izgūšanu atbilstošajiem izkārtojuma failiem, maršruta apstrādātājiem un provideriem. globalize.now neaizstāj Next.js maršrutēšanu; tas nodrošina, ka teksti, kas plūst caur šiem maršrutiem, tiek atslēgoti. Pēc iestatīšanas gan App Router servera komponentes, gan klienta komponentes atsaucas uz tiem pašiem lokalizācijas failiem, ko sagaida jūsu izpildlaika bibliotēka.
Vai varu izmantot globalize.now ar Next.js lietotni, kurā jau ir daļējs i18n atbalsts?
Jā. Norādiet aģentam repozitoriju, un tas paplašinās esošās ziņojumu pakotnes, aizpildot robus, kur vēl saglabājušies burtiski teksti. Tas ir izplatīts gadījums, kad sākotnēji tika tulkotas tikai mārketinga lapas. globalize.now apvieno jaunās atslēgas, nezaudējot vecākos tulkojumus, tāpēc komandas var migrēt pa ekrāniem soli pa solim.
Vai globalize.now atšķirīgi apstrādā servera komponentes un klienta komponentes?
globalize.now pārveido burtiskus tekstus atbilstoši palīgfunkcijai, ko jūsu tehnoloģiju kopa izmanto katrai robežai, ievērojot Next.js noteikumus par to, kur var darboties hooks un provideri. JSON izvade paliek kopīga gan servera, gan klienta pakotnēm, tāpēc jums nav jādublē katalogi. Jūs joprojām sekojat Next.js dokumentācijai, atzīmējot klienta komponentes gadījumos, kad nepieciešama interaktivitāte.
Kā globalize.now integrējas ar Next.js statisko ģenerēšanu?
Lokalizācijas faili atrodas Git repozitorijā, tāpēc `next build` turpina iekļaut to pašu JSON, ko jūsu SSG vai SSR maršruti jau importē caur next-intl. globalize.now nemaina statiskās ģenerēšanas plūsmu, izņemot to, ka nodrošina, lai teksti nāktu no datu failiem, nevis burtiskiem ierakstiem kodā. Kad tiek izlaists jauns saturs, kārtējais Git push atjauno tulkojumus pirms nākamās izvietošanas.
Vai man jāinstalē next-intl pirms npx skills add globalize-now/globalize-skills palaišanas?
Vispirms instalēt next-intl ir ideāli, ja jau zināt, ka tas būs jūsu izpildlaika bibliotēka, jo aģents var uzreiz sasaistīt providerus. Ja vēl neesat izvēlējies bibliotēku, joprojām varat palaist npx skills add globalize-now/globalize-skills — prasmes palīdzēs ieteikt piemērotu tehnoloģiju kopu —, taču pēc atkarību instalēšanas iestatīšanu, iespējams, vajadzēs atkārtot. Abos gadījumos rezultāts ir atslēgas, kas iekļautas Git repozitorijā, un sinhronizācija pie katra push.
Izmēģiniet globalize.now kopā ar Next.js
Sāciet no sava projekta saknes direktorijas:
npx skills add globalize-now/globalize-skills --allAtgriezieties sākumlapā, lai iegūtu informāciju par produktu un cenām →