Toote tekstid muutuvad lokaliseerimisvalmis siis, kui need on esmalt ühte allikasse koondatud: komponentides literaalidena laiali olevaid tekste ei saa ümberkirjutamisega lokaliseerimisvalmis muuta, sest tõlkimiseks pole kokkulepitud allikat. Selgustöö, sõnastikud ja stiilijuhendid on kõik olulised, kuid need tasuvad end ära alles siis, kui stringid asuvad ühes kataloogis. See leht kirjeldab sammude järjekorda nii, nagu see toimib.
Enamik sel teemal antavatest nõuannetest algab teisest sammust. Need soovitavad kirjutada lihtsas keeles, vältida idioome ja anda tõlkijatele kontekst – see kõik on hea nõuanne, kuid sellest pole kasu, kuni üks ja sama sõnum esineb teie komponentides viies veidi erinevas vormis. Taustateabe ja argumendid selle kohta, miks peaks toote tekstide tõeallikas olema koodibaas, leiate artiklist code-native product copy. See leht on praktiline tegevuste järjekord.
Mida tähendab lokaliseerimisvalmis?
See tähendab, et tõlkija või tõlkevahend saab teie teksti kätte ja suudab luua truu versiooni ilma oletamata. Selleks on vaja kolme tingimust: iga string on täpselt ühes kokkulepitud kohas, iga string ütleb ühe selge asja ning tõlkija näeb, kus ja kuidas seda kasutatakse.
Kõiki kolme pole ühtmoodi lihtne tagantjärele parandada. Selget sõnastust saab täiustada string-stringi haaval. Konteksti saab lisada märkustena. Kuid „täpselt üks kokkulepitud koht“ on struktuurne. Kui see puudub, pole kahel ülejäänul millegi stabiilse külge kinnituda: stringi ei saa parandada, kui selle kaksik asub teises failis, ja sõnumit ei saa annoteerida, kui sel pole ühtset aadressi.
Miks piirab lähtetekst tõlke kvaliteeti?
Sest tõlge on tuletatud töö ja tuletatud töö pärib kõik oma allika vead. Tõlge kannab lähteteksti ebaselguse igasse sihtkeelde ning kannab edasi ka ebajärjepidevuse. Kui lähtetekst ütleb ühel ekraanil „Sign in“, teisel „Log in“ ja kolmandal „Login“, on teil nüüd igas keeles kolm terminit, mis on tõlgitud sõltumatult ja mille kohta ei saa öelda, milline on ettenähtud.
Seetõttu tegeleb tavapärane lahendus – tõlgete lihvimine – valesti otsast. Iga lisatav keel korrutab parandamata lähteteksti maksumuse. Lähteteksti ühekordne parandamine parandab selle igal pool, ka keeltes, mida te pole veel lisanud.
Selle aluseks oleval probleemil on nimi. Copy drift ehk tekstide triiv tähendab, et kasutajale nähtav tekst erineb eri pindadel ja ajas oma kinnitatud allikast, kuna ühtset tõeallikat pole. What is copy drift käsitleb põhjusi. Lokaliseerimisel muutub see kalliks, sest triiv kopeeritakse igasse keelde.
Miks ei saa laiali pillutatud tekste lokaliseerimisvalmis muuta?
Sest pole midagi üle anda. Komponendis olev literaal pole üksus, mille tõlkimise samm üles korjata saaks. See on segatud märgenduse ja loogikaga, see võib olla kokku pandud fragmentidest ning sama lause võib esineda mitmes failis väikeste erinevustega, mida keegi pole valinud.
Nende literaalide kohapealne ümberkirjutamine seda ei muuda. Iga neist saab muuta selgemaks ja ikkagi puudub kataloog, kokkulepitud loend sellest, mida toode ütleb, ning võimalus teada, kas olete need kõik üles leidnud. Tulemuseks on korrektsem tekst samades laialipillutatud kohtades.
Esimene samm ei ole seega toimetamistöö, vaid kogumistöö: pane iga kasutajale nähtav string hoidlas ühte kataloogi, ühte lähtekeelde, ja viita neile komponentidest võtmega. Tee seda sõnastust muutmata. Selle etapi eesmärk on selgitada välja, mida toode praegu ütleb, ka need kohad, mis üksteisega vastuollu lähevad.
Kuidas stringe koguda?
Vii need esmalt kataloogi ja paranda neid alles seejärel. Sellel järjekorral on kaks põhjust. Segatud käik, kus sõnastad ümber samal ajal kui viid üle, varjab muudatused nii ülevaatajate kui ka sinu eest. Ja kui kõik on ühes failis, lakkavad duplikaadid ja peaaegu-duplikaadid olemast nähtamatud: need asuvad üksteise kõrval ning puhastamine taandub ühe faili lugemisele.
Praktikas:
- Vali iga lähtekeele jaoks üks kataloog hoidlas. See on põhiversioon, mida saavad lugeda nii inimesed kui ka tööriistad. Kuidas seda üles ehitada ja võtmeid nimetada, on kirjeldatud artiklis how to keep UI copy consistent across a codebase; see on sama kataloog, seega on too artikkel ülesehituse allikas ja siin seda ei korrata.
- Asenda literaalid võtmeviidetega. Iga string, mida kasutaja näeb, sh nuppude sildid, veateated, tühjade olekute tekstid, tööriistavihjed ja ligipääsetavuse tekstid, mis on tavaliselt need mahajääjad.
- Hoia laused tervikuna. Kui sõnum on ehitatud fragmentide liitmisest, tee sellest üks kirje muutujatega, et tõlkijale nähtav üksus oleks sama, mida kasutaja loeb. Sõnajärg erineb keeleti ning koodis kokku pandud lause ei saa seda järgida.
- Ära sõnasta veel ümber. Pea vastu. Leiad kohmakad kohad, märgi need üles ja liigu edasi.
Kui see loend kõlab nagu kuu aega hoolikat tööd suures koodibaasis, on see sammu aus hind ja põhjus, miks enamik tiime siin takerdub.
Mida teha, kui stringid on ühes kataloogis?
Nüüd on tuttaval nõuandel lõpuks, mida rakendada. Ühe kataloogi korral muutub kõik järgnev ühekordseks läbimiseks, mitte jahiks:
- Eemalda duplikaadid ja peaaegu-duplikaadid. Vali iga sõnumi jaoks kinnitatud sõnastus ja suuna kõik kasutuskohad sellele.
- Fikseeri terminid, mis ei tohi kunagi varieeruda. Funktsioonide nimed, põhitoimingute verbid, sõnad, mida oled otsustanud mitte kasutada. Kirjuta need üles üks kord. See on sinu sõnastik ja see on lühike.
- Kirjuta lihtsalt. Aktiivne kõneviis, ei mingeid idioome, ei mingeid nalju, mis sõltuvad ühe keele sõnamängust, akronüümid lahti kirjutatud seal, kus neid võidakse valesti mõista. Iga string ütleb ühe asja.
- Anna tõlkijatele kontekst. Märkus selle kohta, kus string ilmub ja mida muutuja tähistab. Lühikesed stringid nagu „Post“ või „Order“ on klassikaline lõks: nimisõna või tegusõna ning sihtkeel võib vajada kummagi jaoks erinevat sõna.
- Arvesta pikkusega. Tõlgitud tekst on sageli lähtetekstist pikem, seega kujunda paigutused, mis ei lagune, kui silt kasvab. Käsitle seda disainipiirangu, mitte planeeritava arvuna.
Iga samm on kiire, sest kataloog on ainus koht, kus see toimub. Ilma kataloogita on samad viis sammu viis otsinguretke läbi koodibaasi ning sa ei tea kunagi, millal oled valmis.
Mida peaks enne tõlkepartneri või tõlkevahendi valimist paika panema?
Lähtetekst ja ülevaatuse käik. Partner või vahend tõlgib seda, mille talle annate. Andke talle puhas kataloog ja lühike sõnastik ning ta saab teha head tööd. Andke talle hajutatud literaalid ja maksate ebajärjepidevuste tõlkimise eest ning seejärel veel kord nende parandamise eest igas keeles.
Otsustage esmalt kolm asja. Milline fail on tõeallikas. Kes sõnastuse muudatuse kinnitab. Ja kuidas muudetud või uus string tõlkimiseni jõuab: käsitsi, skriptiga või pull requestiga, mis saabub tõlgetega kaasas. Viimane hoiab tõlked lähtetekstist mahajäämast – see probleem on kirjeldatud artiklis why translation files fall out of sync.
Mis muutub, kui tekstid asuvad juba hoidlas?
Lokaliseerimine lakkab olemast eraldi projekt. Kui kataloog on hoidlas, ilmub uus või muudetud string diffi reana, selle tõlkeid saab luua ja üle vaadata samas pull requesti töövoos nagu koodi ning keegi ei pea eksportima arvutustabelit ja lootma, et see tuleb korras tagasi.
Seetõttu on koodibaasis tekstide järjepidevuse hoidmine ja lokaliseerimisvalmiduse hoidmine üks ja sama tegevus. Mõlemad sõltuvad ühest kokkulepitud allikast. Tee töö üks kord ära ja saad mõlemad. Tehisintellekti kodeerimisvahenditega ehitavad tiimid tunnevad seda varem, sest agent sõnastab vaikselt ümber või toob tagasi literaali, kui kataloog ja lint-reegel teda ei takista; seda juhtumit käsitleb how to stop AI coding agents rewriting your UI copy.
Kuhu globalize.now sobib
globalize.now on koodipõhine tekstihaldussüsteem sisseehitatud lokaliseerimisega ja ülaltoodud ühte allikasse koondamise sammu teeb see teie eest ära. Ühendate rakenduses GitHubi või GitLabi hoidla. Skannimine selgitab välja, mis seal on. Kui stringid on komponentides literaalid, viib ühekordne teisendus need võtmete taha kataloogi ja lisab i18n-seadistuse, kui seda pole; kui kasutate juba teeki nagu next-intl, react-i18next, i18next või Lingui, töötab see teie olemasolevaga. Tulemus saabub pull requestina omaette harus, nii et esimene kataloog läbib täpselt eespool kirjeldatud ülevaatuse. Pärast seda tõlgivad teie lisatud uusi lähtestringe push-tööd, mis avavad tulemusega pull requesti. Hoidla jääb ainsaks tõeallikaks ning existing-i18n guide näitab, mida skannimine leiab, kui seadistus on juba olemas.
Ehitame selle poole, et sama distsipliin kehtiks ühest allikast kogu turundussaidil, maandumislehel ja tootes. See on suund, kuhu liigume, mitte midagi, mida täna osta saab. Hinnad on pricing page lehel.
Järjekord lühidalt
- Koonda iga kasutajale nähtav string ühte kataloogi hoidlas. Ära sõnasta ümber.
- Hoia laused tervikuna ja viita igale stringile võtmega.
- Eemalda duplikaadid ja vali kinnitatud sõnastus üks kord.
- Kirjuta lühike sõnastik terminitest, mis ei varieeru.
- Toimeta lihtsa keele suunas ja lisa tõlkijatele konteksti märkused.
- Otsusta, kes sõnastust kinnitab ja kuidas muudetud stringid tõlkimiseni jõuavad.
- Alles seejärel vali või vaheta tõlkepartner või tõlkevahend.
Kui esimene samm näeb välja nagu kuu aega tööd, ühendage hoidla, vaadake läbi selle pakutav plaan ja vaadake üle avatud pull request.
globalize.now muudab rakenduse koodis olevad tekstid tõlkeks valmis lokaale failideks ja hoiab neid ajakohasena, kui sa uusi versioone välja lasid.
Proovi globalize.now tasuta