Produkta teksti kļūst gatavi lokalizācijai, kad tiem vispirms izveido vienotu avotu: komponentēs izkaisītus burtiskus tekstus nevar sagatavot lokalizācijai, tos pārrakstot, jo nav saskaņota avota, ko tulkot. Skaidrības darbs, glosāriji un stila ceļveži ir svarīgi, taču tie atmaksājas tikai tad, kad teksti atrodas vienā katalogā. Šajā lapā ir aprakstīta darbību secība, kas darbojas.
Lielākā daļa padomu par šo tēmu sākas ar otro soli. Tajos ieteikts rakstīt vienkāršā valodā, izvairīties no idiomām un dot tulkotājiem kontekstu — tie visi ir labi padomi, taču nevienu no tiem nevar izpildīt, kamēr viens un tas pats paziņojums jūsu komponentēs pastāv piecās nedaudz atšķirīgās formās. Definīciju un pamatojumu, kāpēc produkta tekstu patiesības avotam jābūt koda bāzei, meklējiet rakstā par koda līmenī pārvaldītiem produkta tekstiem. Šajā lapā ir aprakstīta praktiskā darbību secība.
Ko nozīmē “gatavs lokalizācijai”?
Tas nozīmē, ka tulkotājam vai tulkošanas rīkam var nodot jūsu tekstus un tas varēs izveidot precīzu versiju bez minēšanas. Tam nepieciešami trīs nosacījumi: katrs teksts eksistē tieši vienā saskaņotā vietā, katrs teksts pasaka vienu skaidru domu, un tulkotājs var saprast, kur un kā tas tiek lietots.
Šos trīs nosacījumus nav vienlīdz viegli nodrošināt vēlāk. Skaidru formulējumu var uzlabot pa vienam tekstam. Kontekstu var pievienot kā piezīmes. Taču “tieši viena saskaņota vieta” ir strukturāls nosacījums. Ja tā trūkst, abiem pārējiem nav stabila pamata: nevar uzlabot tekstu, kura dublikāts atrodas citā failā, un nevar pievienot piezīmes paziņojumam, kuram nav vienas adreses.
Kāpēc avots ierobežo tulkojuma kvalitāti?
Tāpēc, ka tulkojums ir atvasināts darbs, un atvasināts darbs pārmanto visus avota trūkumus. Tulkojums katrā mērķa valodā pārmanto gan avota neskaidrību, gan nekonsekvenci. Ja avotā vienā ekrānā ir “Sign in”, citā — “Log in”, bet trešajā — “Login”, katrā valodā iegūstat trīs terminus, kas tulkoti neatkarīgi, un nav iespējams pateikt, kurš no tiem ir paredzētais.
Tāpēc arī ierastais risinājums — tulkojumu slīpēšana — risina problēmu no nepareizā gala. Katra pievienotā valoda palielina nelabota avota izmaksas. Ja avotu izlabo vienreiz, tas ir izlabots visur, arī valodās, kuras vēl neesat pievienojuši.
Šai pamatproblēmai ir nosaukums. Tekstu novirze (copy drift) ir situācija, kad lietotājam redzams teksts atšķiras no sava apstiprinātā avota dažādās vietās un laika gaitā, jo nav vienota patiesības avota. Kas ir tekstu novirze apraksta tās cēloņus. Lokalizācijā tā kļūst dārga, jo novirze tiek pārnesta uz katru valodu.
Kāpēc izkaisītus tekstus nevar sagatavot lokalizācijai?
Jo nav ko nodot tālāk. Burtiski ierakstīts teksts komponentē nav vienība, ko tulkošanas solis varētu paņemt. Tas ir sajaukts ar marķējumu un loģiku, tas var būt salikts no fragmentiem, un viens un tas pats teikums var atrasties vairākos failos ar nelielām atšķirībām, ko neviens nav apzināti izvēlējies.
Šo burtisko tekstu pārrakstīšana uz vietas to nemaina. Katru no tiem var padarīt skaidrāku, bet joprojām nebūs ne kataloga, ne saskaņota saraksta ar visu, ko produkts saka, ne iespējas pārliecināties, vai esat atradis visus. Rezultāts ir sakārtotāks teksts tajās pašās izkaisītajās vietās.
Tāpēc pirmais solis nav rediģēšanas darbs. Tas ir savākšanas darbs: ievietojiet katru lietotājam redzamo tekstu vienā katalogā, vienā avota valodā, repozitorijā, un atsaucieties uz to no komponentēm pēc atslēgas. Dariet to, nemainot formulējumu. Šīs kārtas mērķis ir noskaidrot, ko produkts šobrīd saka, ieskaitot daļas, kas runā viena otrai pretī.
Kā jūs savācat tekstus?
Vispirms pārvietojiet tos katalogā, un uzlabojiet tikai pēc tam. Šai secībai ir divi iemesli. Jaukta kārta, kad pārformulējat, kamēr pārvietojat, paslēpj izmaiņas gan no pārskatītājiem, gan no jums pašiem. Un, kad viss ir vienā failā, dublikāti un gandrīz dublikāti vairs nav neredzami: tie atrodas blakus, un sakopšana kļūst par viena faila izlasīšanu.
Praktiski:
- Izvēlieties vienu katalogu katrai avota valodai, repozitorijā. Tas ir ieraksts, ko spēj nolasīt gan cilvēki, gan rīki. Kā to sakārtot un nosaukt atslēgas, aprakstīts rakstā kā uzturēt UI tekstu konsekvenci visā koda bāzē; tas ir tas pats katalogs, tāpēc tā lapa ir izkārtojuma atsauce, un šeit to neatkārtojam.
- Aizstājiet burtiskos tekstus ar atslēgu atsaucēm. Katrs teksts, ko lietotājs var izlasīt, ieskaitot pogu uzrakstus, kļūdu ziņojumus, tukšos stāvokļus, rīkpadomus un pieejamības tekstus, kas parasti paliek pēdējie.
- Saglabājiet teikumus veselus. Ja ziņojums tiek veidots, savienojot fragmentus, izveidojiet vienu ierakstu ar mainīgajiem, lai tulkotāja redzamā vienība būtu tā pati, ko lasa lietotājs. Vārdu secība dažādās valodās atšķiras, un kodā salikts teikums to nevar ievērot.
- Vēl nepārformulējiet. Pretojieties tam. Jūs atradīsit neveiklos tekstus — pierakstiet tos un ejiet tālāk.
Ja šis saraksts izklausās pēc mēneša rūpīga darba lielā koda bāzē, tā ir godīga šī soļa cena un iemesls, kāpēc lielākā daļa komandu šeit iestrēgst.
Ko darīt, kad teksti ir vienā katalogā?
Tagad pazīstamajiem padomiem beidzot ir uz ko attiecināties. Ar vienu katalogu katrs no tiem kļūst par vienu izpildes kārtu, nevis meklēšanu pa visu kodu:
- Noņemiet dublikātus un gandrīz dublikātus. Katram ziņojumam izvēlieties apstiprināto formulējumu un novirziet uz to visus lietojumus.
- Nofiksējiet terminus, kas nedrīkst mainīties. Funkciju nosaukumi, darbības vārdi galvenajām darbībām, vārdi, ko esat nolēmuši nelietot. Pierakstiet tos vienreiz. Tas ir jūsu glosārijs, un tas ir īss.
- Rakstiet skaidri. Lietojiet darāmo kārtu, izvairieties no idiomām un joku, kas balstās vienas valodas vārdu spēlē, atšifrējiet akronīmus, ko var pārprast. Katrs teksts pasaka vienu domu.
- Sniedziet tulkotājiem kontekstu. Pievienojiet piezīmi par to, kur teksts parādās un ko mainīgais apzīmē. Īsi teksti, piemēram, “Post” vai “Order”, ir klasiskas lamatas: lietvārds vai darbības vārds, un mērķa valodai katram var būt vajadzīgs cits vārds.
- Ņemiet vērā garumu. Tulkotais teksts bieži ir garāks par avotu, tāpēc veidojiet izkārtojumus, kas nesabrūk, kad uzraksts kļūst garāks. Uztveriet to kā dizaina ierobežojumu, nevis kā skaitli, uz kuru balstīt plānošanu.
Katrs solis ir ātrs, jo katalogs ir vienīgā vieta, kur tas notiek. Bez kataloga tie paši pieci soļi ir pieci meklējumi pa visu koda bāzi, un jūs nekad nezināt, kad esat pabeidzis.
Kas jānokārto pirms tulkošanas pakalpojumu sniedzēja vai rīka izvēles?
Avots un pārskatīšanas gaita. Pakalpojumu sniedzējs vai rīks tulko to, ko tam dodat. Ja dodat tīru katalogu un īsu glosāriju, tas var paveikt labu darbu. Ja dodat izkaisītus burtiskus tekstus, jūs maksāsit par nekonsekvenču tulkošanu un pēc tam vēlreiz par to labošanu katrā valodā.
Vispirms izlemiet trīs lietas. Kurš fails ir patiesības avots. Kas apstiprina formulējuma izmaiņas. Un kā mainīts vai jauns teksts nonāk tulkošanā: ar roku, ar skriptu vai ar pull request, kas pienāk kopā ar tulkojumiem. Pēdējais ir tas, kas neļauj tulkojumiem atpalikt no avota — problēma aprakstīta rakstā kāpēc tulkojumu faili zaudē sinhronizāciju.
Kas mainās, kad teksti jau atrodas repozitorijā?
Lokalizācija vairs nav atsevišķs projekts. Kad katalogs ir repozitorijā, jauns vai mainīts teksts parādās kā rinda diff skatā, tā tulkojumus var izveidot un pārskatīt tajā pašā pull request plūsmā kā kodu, un nevienam nav jāeksportē izklājlapa un jāceras, ka tā atgriezīsies kārtībā.
Tāpēc koda bāzē tekstu konsekvences nodrošināšana un to sagatavošana lokalizācijai ir viena un tā pati darbība. Abas balstās uz vienu saskaņotu avotu. Veiciet darbu vienreiz, un iegūsiet abus rezultātus. Komandas, kas strādā ar AI kodēšanas rīkiem, to izjūt ātrāk, jo aģents klusi pārformulēs vai atkal ieviesīs burtisku tekstu, ja tam ceļā nestāv katalogs un lint noteikums; šo gadījumu aptver raksts kā neļaut AI kodēšanas aģentiem pārrakstīt jūsu UI tekstus.
Kur iederas globalize.now
globalize.now ir koda līmenī integrēta tekstu pārvaldības sistēma ar iebūvētu lokalizāciju, un iepriekš aprakstīto apvienošanu vienā avotā tā izdara jūsu vietā. Jūs lietotnē pieslēdzat GitHub vai GitLab repozitoriju. Skenēšana noskaidro, kas tur ir. Ja teksti ir burtiski komponentēs, vienreizēja konvertēšana pārvieto tos aiz atslēgām katalogā un pievieno i18n iestatījumus, ja to nav; ja jau lietojat bibliotēku, piemēram, next-intl, react-i18next, i18next vai Lingui, sistēma strādā ar jūsu esošo risinājumu. Rezultāts pienāk kā pull request savā zarā, tāpēc pirmais katalogs iziet tieši to pārskatīšanu, kas aprakstīta iepriekš. Pēc tam jūsu pievienotos jaunos avota tekstus tulko push darbi, kas atver pull request ar rezultātu. Repozitorijs paliek vienīgais patiesības avots, un ceļvedis esošam i18n soli pa solim parāda, ko skenēšana atrod, kad iestatījumi jau ir.
Mēs strādājam pie tā, lai šī pati disciplīna darbotos visā mārketinga vietnē, nosēšanās lapā un produktā no viena avota. Tas ir mūsu attīstības virziens, nevis kaut kas, ko var iegādāties šodien. Cenas ir cenu lapā.
Secība īsumā
- Savāciet katru lietotājam redzamo tekstu vienā katalogā repozitorijā. Nepārformulējiet.
- Saglabājiet teikumus veselus un atsaucieties uz katru tekstu pēc atslēgas.
- Noņemiet dublikātus un vienreiz izvēlieties apstiprināto formulējumu.
- Uzrakstiet īsu glosāriju ar terminiem, kas nekad nemainās.
- Rediģējiet skaidrai valodai un pievienojiet konteksta piezīmes tulkotājiem.
- Nosakiet, kas apstiprina formulējumu un kā mainītie teksti nonāk tulkošanā.
- Tikai tad izvēlieties vai nomainiet tulkošanas pakalpojumu sniedzēju vai rīku.
Ja pirmais solis izskatās pēc mēneša darba, pieslēdziet repozitoriju, izlasiet plānu, ko tas piedāvā, un pārskatiet pull request, ko tas atver.
globalize.now pārvērš burtiski ierakstītus lietotnes tekstus tulkošanai gatavos lokalizācijas failos un pastāvīgi tos atjaunina līdz ar katru jauno versiju.
Izmēģiniet globalize.now bez maksas