Produkto tekstai tampa paruošti lokalizacijai tada, kai eilutės pirmiausia sujungiamos į vieną šaltinį: tekstų, išsimėčiusių po komponentus kaip literalai, perrašymu paruošti lokalizacijai neįmanoma, nes nėra sutarto šaltinio, kurį būtų galima versti. Aiškumo darbas, glosarijai ir stiliaus gairės — visa tai svarbu, bet atsiperka tik tada, kai eilutės laikomos viename kataloge. Šiame puslapyje — žingsnių seka tokia tvarka, kuri veikia.

Dauguma patarimų šia tema prasideda nuo antrojo žingsnio. Jie liepia rašyti paprasta kalba, vengti idiomų ir suteikti vertėjams kontekstą — visa tai geri patarimai, tačiau jų neįmanoma pritaikyti, kol tas pats pranešimas jūsų komponentuose egzistuoja penkiomis šiek tiek skirtingomis formomis. Apibrėžimai ir argumentai, kodėl kodo bazė turėtų būti produkto tekstų tiesos šaltinis, pateikti straipsnyje kodu paremti produkto tekstai. Šis puslapis — praktinė veiksmų tvarka.

Ką reiškia „paruošta lokalizacijai“?

Tai reiškia, kad vertėjas ar vertimo įrankis gali gauti jūsų tekstus ir atlikti tikslų vertimą nieko nespėliodamas. Tam reikia trijų sąlygų: kiekviena eilutė egzistuoja lygiai vienoje sutartoje vietoje, kiekviena eilutė sako vieną aiškią mintį, o ją verčiantis žmogus gali suprasti, kur ir kaip ji naudojama.

Šias tris sąlygas pritaikyti vėliau nėra vienodai lengva. Aiškesnę formuluotę galima patobulinti eilutė po eilutės. Kontekstą galima pridėti kaip pastabas. Bet „lygiai viena sutarta vieta“ yra struktūrinė sąlyga. Jei jos nėra, kitos dvi neturi prie ko stabiliai prisikabinti: negalite patobulinti eilutės, kurios dvynė gyvena kitame faile, ir negalite pažymėti pranešimo, neturinčio vieno adreso.

Kodėl šaltinis riboja vertimo kokybę?

Todėl, kad vertimas yra išvestinis darbas, o išvestinis darbas paveldi visus to, iš ko išvestas, trūkumus. Vertimas perkelia šaltinio dviprasmybes į kiekvieną tikslinę kalbą, taip pat ir nenuoseklumą. Jei šaltinyje viename ekrane parašyta „Sign in“, kitame „Log in“, o trečiame „Login“, dabar kiekvienoje kalboje turite tris terminus, išverstus atskirai, ir nėra kaip pasakyti, kuris iš jų numatytasis.

Dėl to įprastas sprendimas — vertimų tobulinimas — taiso ne tą galą. Kiekviena pridėta kalba padidina netvarkingo šaltinio kainą. Vieną kartą sutvarkius šaltinį, jis sutvarkomas visur, įskaitant kalbas, kurių dar nepridėjote.

Šiai pagrindinei problemai yra suteiktas pavadinimas. Tekstų dreifas (copy drift) — tai vartotojui matomo teksto nukrypimas nuo patvirtinto šaltinio skirtingose vietose ir laikui bėgant, kai nėra vieno tiesos šaltinio. Kas yra tekstų dreifas aptaria jo priežastis. Lokalizacijoje tai tampa brangu, nes dreifas nukopijuojamas į kiekvieną kalbą.

Kodėl išsimėčiusių tekstų neįmanoma paruošti lokalizacijai?

Nes nėra ką perduoti. Literalas komponento viduje nėra vienetas, kurį galėtų paimti vertimo žingsnis. Jis sumaišytas su žymėjimu ir logika, gali būti sudėtas iš fragmentų, o tas pats sakinys gali egzistuoti keliuose failuose su smulkiais skirtumais, kurių niekas nesirinko.

Šių literalų perrašymas vietoje to nepakeičia. Galite padaryti kiekvieną aiškesnį ir vis tiek neturėti katalogo, sutarto sąrašo, ką produktas sako, ir būdo žinoti, ar radote visus. Rezultatas — tvarkingesnis tekstas tose pačiose išsimėčiusiose vietose.

Todėl pirmasis žingsnis yra ne redagavimas, o rinkimas: surinkite kiekvieną vartotojui matomą eilutę į vieną katalogą, vienos šaltinio kalbos, saugykloje, o komponentuose nurodykite jas raktais. Darykite tai nekeisdami formuluočių. Šio etapo tikslas — išsiaiškinti, ką produktas šiuo metu teigia, įskaitant vietas, kurios viena kitai prieštarauja.

Kaip surinkti eilutes?

Pirmiausia perkelkite jas į katalogą, o tobulinkite tik paskui. Šios tvarkos yra dvi priežastys. Mišrus etapas, kai perrašote formuluotes kartu su perkėlimu, paslepia pakeitimus ir nuo peržiūrėtojų, ir nuo jūsų. O kai viskas yra viename faile, dublikatai ir beveik identiški variantai nebelieka nematomi: jie atsiduria vienas šalia kito, o tvarkymas tampa vieno failo skaitymu.

Praktiškai:

  • Pasirinkite vieną katalogą kiekvienai šaltinio kalbai, saugykloje. Tai pagrindinė tekstų kopija, kurią gali skaityti ir žmonės, ir įrankiai. Kaip jį išdėstyti ir pavadinti raktus, aprašyta straipsnyje kaip išlaikyti UI tekstų nuoseklumą visoje kodo bazėje; tai tas pats katalogas, todėl tas puslapis yra struktūros šaltinis, o čia to nekartosime.
  • Pakeiskite literalus nuorodomis į raktus. Kiekviena eilutė, kurią gali perskaityti vartotojas, įskaitant mygtukų užrašus, klaidų pranešimus, tuščias būsenas, paaiškinimus užvedus žymeklį ir prieinamumo tekstus — jie dažniausiai pamirštami.
  • Išlaikykite sakinius vientisus. Jei pranešimas sudaromas sujungiant fragmentus, padarykite jį vienu įrašu su kintamaisiais, kad vertėjo matomas vienetas sutaptų su vartotojo skaitomu vienetu. Žodžių tvarka kalbose skiriasi, o kode sudėtas sakinys jos negali atitikti.
  • Kol kas nekeiskite formuluočių. Atsispirkite pagundai. Rasite nevykusių vietų — užsirašykite jas ir eikite toliau.

Jei šis sąrašas atrodo kaip mėnuo kruopštaus darbo didelėje kodo bazėje, tai sąžininga šio žingsnio kaina ir priežastis, kodėl dauguma komandų čia sustoja.

Ką daryti, kai eilutės jau viename kataloge?

Dabar įprasti patarimai pagaliau turi ką veikti. Turint vieną katalogą, kiekvienas iš šių darbų tampa vienu etapu, o ne paieška:

  1. Pašalinkite dublikatus ir beveik identiškus variantus. Kiekvienam pranešimui pasirinkite patvirtintą formuluotę ir nukreipkite visus naudojimus į ją.
  2. Įtvirtinkite terminus, kurie niekada negali kisti. Funkcijų pavadinimai, pagrindinių veiksmų žymimi veiksmažodžiai, žodžiai, kurių nusprendėte nenaudoti. Užrašykite juos vieną kartą. Tai jūsų terminų žodynas, ir jis trumpas.
  3. Rašykite aiškiai. Vartokite veikiamąją rūšį, venkite idiomų ir juokų, kurie remiasi vienos kalbos žodžių žaismu, o akronimus išskleiskite ten, kur juos galima suprasti klaidingai. Kiekviena eilutė sako vieną dalyką.
  4. Suteikite vertėjams kontekstą. Pastaba, kur eilutė rodoma ir ką reiškia kintamasis. Trumpos eilutės, tokios kaip „Post“ ar „Order“, yra klasikinė spąstų vieta: daiktavardis ar veiksmažodis, o tikslinėje kalboje kiekvienam gali prireikti skirtingo žodžio.
  5. Numatykite ilgio rezervą. Išverstas tekstas dažnai yra ilgesnis už šaltinį, todėl kurkite maketus, kurie nesudėtų, kai užrašas pailgėja. Tai vertinkite kaip dizaino apribojimą, o ne kaip skaičių, pagal kurį planuojama.

Kiekvienas žingsnis greitas, nes katalogas yra vienintelė vieta, kur tai vyksta. Be katalogo tie patys penki žingsniai virsta penkiomis paieškomis po visą kodo bazę, ir niekada nežinote, kada baigėte.

Ką reikia išspręsti prieš renkantis vertimo tiekėją ar įrankį?

Šaltinį ir peržiūros eigą. Tiekėjas ar įrankis išverčia tai, ką jam pateikiate. Pateikite tvarkingą katalogą ir trumpą terminų žodynėlį — ir jis galės atlikti kokybišką darbą. Pateikite išsimėčiusius literalus — ir mokėsite už nenuoseklumų vertimą, o paskui dar kartą už jų taisymą kiekvienoje kalboje.

Pirmiausia nuspręskite tris dalykus. Kuris failas yra tiesos šaltinis. Kas tvirtina formuluotės pakeitimą. Ir kaip pakeista ar nauja eilutė patenka į vertimą: rankiniu būdu, skriptu ar pull request'u, kuris ateina jau su vertimais. Paskutinis variantas padeda vertimams neatsilikti nuo šaltinio — apie šią problemą rašoma straipsnyje kodėl vertimų failai praranda sinchronizaciją.

Kas pasikeičia, kai tekstai jau laikomi saugykloje?

Lokalizacija nustoja būti atskiru projektu. Kai katalogas yra saugykloje, nauja ar pakeista eilutė atsiranda kaip eilutė diff'e, jos vertimus galima sukurti ir peržiūrėti per tą patį pull request'ų procesą kaip ir kodą, ir niekam nereikia eksportuoti skaičiuoklės failo ir tikėtis, kad jis grįš tvarkingas.

Štai kodėl kodo bazėje tekstų nuoseklumo palaikymas ir jų paruošimas lokalizacijai yra tas pats veiksmas. Abu priklauso nuo vieno sutarto šaltinio. Atlikite darbą vieną kartą — ir gausite abu rezultatus. Komandos, kurios kuria su DI programavimo įrankiais, tai pajunta anksčiau, nes agentas tyliai perrašys formuluotę ar vėl įves literalą, nebent tam užkirs kelią katalogas ir lint taisyklė; šį atvejį aptaria kaip neleisti DI programavimo agentams perrašyti jūsų UI tekstų.

Kur tinka globalize.now

globalize.now yra kodu paremta tekstų valdymo sistema su įtaisyta lokalizacija, o aukščiau aprašytą vieno šaltinio žingsnį ji atlieka už jus. Programoje prijungiate GitHub arba GitLab saugyklą. Skenavimas išsiaiškina, kas joje yra. Jei eilutės yra literalai komponentų viduje, vienkartinė konversija perkelia jas į katalogą ir pakeičia raktų nuorodomis, o jei i18n sąrankos nėra — ją prideda; jei jau naudojate biblioteką, pavyzdžiui, next-intl, react-i18next, i18next ar Lingui, ji dirba su tuo, ką turite. Rezultatas pateikiamas kaip pull request atskiroje šakoje, todėl pirmasis katalogas praeina būtent tokią peržiūrą, kaip aprašyta aukščiau. Vėliau naujas šaltinio eilutes, kurias pridedate, išverčia push užduotys, atidarančios pull request su rezultatu. Saugykla lieka vieninteliu tiesos šaltiniu, o esamos i18n sąrankos vadove aprašyta, ką skenavimas randa, kai sąranka jau yra.

Dirbame, kad ta pati disciplina galiotų marketingo svetainėje, nukreipiamajame (landing) puslapyje ir produkte iš vieno šaltinio. Tai kryptis, kuria judame, o ne tai, ką galima nusipirkti šiandien. Kainos pateiktos kainų puslapyje.

Tvarka trumpai

  1. Surinkite kiekvieną vartotojui matomą eilutę į vieną katalogą saugykloje. Nekeiskite formuluočių.
  2. Išlaikykite sakinius vientisus ir kiekvieną eilutę nurodykite raktu.
  3. Pašalinkite dublikatus ir vieną kartą pasirinkite patvirtintą formuluotę.
  4. Parašykite trumpą glosarijų terminų, kurie niekada nekinta.
  5. Redaguokite aiškumui ir pridėkite vertėjams skirtas konteksto pastabas.
  6. Nuspręskite, kas tvirtina formuluotes ir kaip pakeistos eilutės patenka į vertimą.
  7. Tik tada rinkitės arba keiskite vertimo tiekėją ar įrankį.

Jei pirmasis žingsnis atrodo kaip mėnuo darbo, prijunkite saugyklą, perskaitykite sistemos siūlomą planą ir peržiūrėkite jos atidarytą pull request'ą.

globalize.now paverčia užkoduotą programos tekstą į vertimui paruoštus lokalės failus ir juos atnaujina, kai jūs diegiate naujus pakeitimus.

Išbandyti globalize.now nemokamai