globalize.now kasutamine Next.js'iga
Seadistage rahvusvahelistamine Next.js rakenduses vähem kui viie minutiga.
Next.js'il on esmaklassiline i18n tugi teekide kaudu nagu next-intl ja next-i18next, kuid need teegid eeldavad koodibaaasi, millel on tõlkevõtmed juba olemas. globalize.now on samm enne: see võtab Next.js rakenduse, mis on täis kodeeritud inglise keelt, ja toodab võtmed, lokaalsuse failid ja refaktoriseeritud komponendid, mida next-intl (või mis tahes käitusaja teek) saab serveerida.
Eeltingimused
- Next.js projekt (App Router või Pages Router)
- Git hoidla
- Node.js 18+
- Valitud i18n käitusaja teek (next-intl soovitatav)
Kuidas seadistada globalize.now'i koos Next.js'iga
Paigaldage oma käitusaja teek
Lisage next-intl või teek, mida eelistate, nii et rakendus saab käitusajal lokaalsusepõhiseid sõnumeid laadida.
npm install next-intlKonfigureerida next-intl'i põhiline marsruutimine
Juhtmestik vahendajad, pakkujad ja marsruudi segmendid, nagu kirjeldatud next-intl dokumentatsioonis, või jätke see samm vahele, kui olete selle juba lõpetanud.
Käivitage Globalize oskuste paigaldaja
Next.js projekti juurest paigaldage oskused, et agent saaks teie marsruutimise seadistusega joondada.
npx skills add globalize-now/globalize-skills --allKinnitage next-intl tuvastamine
Laske agendil kontrollida, et pakkujad ja sõnumi teed vastavad konventsioonidele, mida globalize.now ootab Next.js'ile.
Vaadake üle soovitatud lokaalsuse faili paigutus
Kontrollige soovitatud sõnumite kataloogi ja failinimesid, nii et need järgivad sõnumite-lokaalsuse-kohta mustrit, mille valisite.
Refaktoriseerige literaalid tõlkekutseteks
Heakskiidu uuendused, mis asendavad manustatud inglise keele t() või samaväärsete abijatega, mis on juhtmestikud teie pakkujale.
Lükake Git'i
Ühendage haru ja lükake, nii et globalize.now saaks tõlkeid sünkroonis hoida järgnevate Giti push'ide korral.
Levinud probleemid
next-intl ootab spetsiifilist sõnumi struktuuri
Lahendus: globalize.now tuvastab automaatselt next-intl konventsiooni ja kirjutab JSON'i, mis vastab teie konfigureeritud lokaalsuse kaustatele, vähendades käsitsi ümbermuutmist.
Mul on juba mõned tõlgitud stringid – kas globalize.now need üle kirjutab?
Lahendus: Olemasolevad võtmed säilivad võimaluse korral ja uued literaalid lisatakse järk-järgult, nii et tõlkijad ei kaota eelmist tööd.
Sageli esitatud küsimused
Kas globalize.now töötab next-intl'i ja next-i18next'iga?
Jah. globalize.now keskendub hoidla struktuurile – võtmed, JSON kataloogid ja komponendi kutsesaidid – samas kui next-intl või next-i18next jätkab sõnumite laadimist käitusajal. Valige käitusaja, mis sobib teie marsruutimismudeliga; globalize.now kohandab oma väljundit sellele valikule. Te käivitate siiski npx skills add globalize-now/globalize-skills üks kord projekti käivitamise kohta, kui te tahtlikult oskusi värskendada.
Kas globalize.now toetab nii App Router'it kui ka Pages Router'it?
Jah. Agendi oskused tuvastavad teie kasutatava marsruutija stiili ja joondavad eraldamise õige paigutuse failidega, marsruudi käsitlejatega ja pakkujatega. globalize.now ei asenda Next.js marsruutimist; see tagab, et neid marsruute läbivad stringid on võtmestatud. Pärast seadistamist viitavad nii App Router serveri komponendid kui ka kliendi komponendid samadele lokaalsuse failidele, mida teie käitusaja ootab.
Kas saan kasutada globalize.now'i Next.js rakenduses, millel on juba osaline i18n?
Jah. Osutage agendile hoidlale ja see laiendab olemasolevaid sõnumite kimpusid, täites lüngad, kus literaalid jäävad. See on tavaline, kui ainult turunduslehed tõlgiti esmalt. globalize.now ühendab uued võtmed ilma vanemaid tõlkeid kõrvale heitmata, nii et meeskonnad saavad migreerida ekraani kaupa.
Kas globalize.now käsitleb serveri komponente ja kliendi komponente erinevalt?
globalize.now kirjutab literaalid ümber ükskõik millisele abijale, mida teie stack kasutab iga piiri jaoks, austades Next.js reegleid selle kohta, kus haagid ja pakkujad võivad käivituda. JSON väljund jääb jagatud serveri ja kliendi kimpude vahel, nii et te ei duplitseeri katalooge. Te järgite siiski Next.js dokumentatsiooni kliendi komponentide märkimiseks, kui interaktiivsus seda nõuab.
Kuidas integreeritakse globalize.now Next.js'i staatilise genereerimisega?
Lokaalsed failid asuvad Gitis, nii et `next build` jätkab sama JSON-i pakkimist, mida teie SSG või SSR marsruudid juba next-intl kaudu importivad. globalize.now ei muuda staatilist genereerimise müügiliin, välja arvatud tagades, et stringid pärinevad andmefailidest, mitte literaalidest. Kui uus koopia saadetakse, värskendab järgmine Git push tõlkeid enne järgmist juurutamist.
Kas peaksin installima next-intl enne käsu npx skills add globalize-now/globalize-skills käivitamist?
next-intl installimine esmalt on ideaalne, kui teate juba, et see on teie käitusaeg, sest agent saab pakkujad kohe juhtida. Kui te pole veel raamatukogu valinud, saate siiski käivitada npx skills add globalize-now/globalize-skills—oskused aitavad virna soovitada—kuid võite seadistuse uuesti käivitada pärast sõltuvuste installimist. Mõlemad teed lõpevad võtmetega, mis on Gitis registreeritud ja sünkroonimine push-il.
Proovige globalize.now-i koos Next.js-iga
Alustage oma projekti juurest:
npx skills add globalize-now/globalize-skills --all