Tutorial 5 Localization bo

སློབ་ཚན་ 5 · ས་གནས་ཅན།（i18n）

🌎 སྐད་ཡིག: བོད་ཡིག — སྐད་ཡིག་ 33 ཚང་མར་གཟིགས།

དམིགས་ཡུལ། LockedIn CLI ཡིས་སྐད་ཡིག་ 33 ཇི་ལྟར་ཤེས་པ་རྟོགས་ཤིང་། ལས་ཚབ་ལ་གཞན་གཅིག་སྣོན་དུ་འཇུག་པའི་སྦྱོང་བརྡར་བྱེད། ས་གནས་ཅན་ནི་ལས་ཚབ་ལ་འཚམ་ཤོས་ཀྱི་ལས་འགན་ཞིག་ཡིན། རྩིས་ཐབས་ལྟར་སྤྲོད་ཆོག་ཅིང་། ཚོད་ལྟའི་སྒོ་སྲུང་། བཀོད་པའི་སྒྲིག་ལམ། བརྡ་སྤྲོད་ཞིབ་བཤེར་བཅས་ཀྱི་ཚད་བཀག་ངོ་མ་ཡོད།

← སློབ་ཚན་ 4 བཀོད་ཚིག་དང་ཞིབ་བཤེར། · གཙོ་ངོས།

---

འདིར་“ས་གནས་ཅན”་གྱི་དོན།

CLI སི་པན་སྐད། ཧིན་དི། ཉི་ཧོང་སྐད། ཀྲུང་ཡིག་སྟབས་བདེ། ཡང་ན་ནང་འཛུགས་སྐད་ཡིག་གང་རུང་དུ་རྒྱུག་ན་མཐོང་བ་ཚང་མ་འགྱུར། འགོ་འཛུགས། help རེའུ་མིག བཀའ་བརྡ་རེ་རེའི་ཐོན་འབྲས། ཁ་བརྡའི་ཐུན། ཐ་ན་ཁྲིམས་ཀྱི་ཡི་གེ་ཆུང་ངུ་ཡང་།

lockedin --lang bo post
LOCKEDIN_LANG=hi lockedin
lockedin --lang zh aura

སྐད་ཡིག་འགོ་འཛུགས་སྐབས་རང་འགུལ་ངོས་འཛིན་བྱེད། སྔོན་ཐོབ་གོ་རིམ།

1. --lang flag（--lang bo། --lang=fr། -l ja）
2. LOCKEDIN_LANG ཁོར་ཡུག་འགྱུར་གྲངས།
3. locale（LC_ALL / LC_MESSAGES / LANG། དེ་ནས་ OS/runtime locale）
4. རྒྱ་ཡིག་ཕྱི་མའི་གདམ་ག

normalizeLang() ཡིས་རྒྱུན་དུ locale ཡི་གཙོ་བོའི་ཆ་རྟགས་སྤྱོད། de-DE ཡིས་ de འདེམས། tlh ཡིས་ནོར་ནས་ tl མི་འདེམས། fil དང་ tgl གཉིས་ tl ལ། nb དང་ nn གཉིས་ no ལ། in ནི་ id ལ། iw ནི་ he ལ་སྦྲེལ། pt-BR / pt_BR གིས་ས་ཁུལ་ཨང་འདེམས་ཤིང་ pt ནི་ཕྱིར་མཐུད་བྷ་ར་ཟིལ་པོར་ཅུ་གྷལ་སྐད་ཡིན། གཉིས་ཀས་ pools/UI གཅིག་སྤྱོད། en-SG / en_SG ནི་སིང་ག་ཕོར་དབྱིན་སྐད་དང་ en ནི་དབྱིན་སྐད། Hong Kong ཀྲུང་ཡིག་སྲོལ་རྒྱུན་ཡང་དེ་ལྟར་ཡིན། zh-HK། zh_HK.UTF-8། zh-Hant-HK གསུམ་གྱིས་ zh-HK འདེམས། zh དང་ཀྲུང་གོ་སྐམ་སའི་རྟགས་ཀྱིས་ zh འདེམས།

ཐུན་བར་དུ་སྒྱུར་བ — /language panel། /language（aliases /lang, /languages） ཡིས་སྐད་ཡིག་ 33 ཨང་གི་གོ་རིམ་དང་རང་རང་གི་ཡི་གེར་སྟོན། /language el ཡིས་ཐུན་ལྷག་མའི་སྐད་བརྗེ། གལ་ཆེ་བ་ནི་ཕྱིར་ཐོན་ལམ་ཡིན། སྐད་བརྗེས་རྗེས་བརྙན་ཡོལ་སྐད་གསར་པས་བསྐྱར་འབྲི་ཞིང་། སྔོན་གྱི་སྐད་ཡིག་གིས་ /language en དང་ཐེངས་རྗེས་མར་ lockedin --lang en ཞེས་ཕྱིར་ལོག་ཐབས་སྟོན། དེས་ 日本語 འམ་ ಕನ್ನಡ ནང་མི་འགག --lang དང་ LOCKEDIN_LANG མི་འགྱུར། /a11y ལྟར་འདི་ནི་ལག་ཆ་ངོ་མ་ཡིན།

བསམ་ཚུལ། སྐད་ཡིག་སྒྲོམ།

སྒྱུར་ཆོག་པའི་ཡི་གེ་ཚང་མ་སྐད་ཡིག་རེའི་bundle ནང་ཡོད།

{ meta: { lang: 'bo', name: 'བོད་ཡིག', dir: 'ltr' },
  pools: { HOOKS: [ /* ཁྱོན་ 25 */ ], LESSONS: [ /* ... */ ], /* ... */ },
  ui:    { buzzwordDensity: 'ཚིག་སྙན་གྱི་སྟུག་ཚད། ', /* རྟགས་དང་མགོ་བརྗོད */ } }

• pools ནི་ལེའུ་ 2 ནང་གི་ནང་དོན་ཐོ་གཞུང་།
• ui ནི་བརྙན་ཡོལ་གྱི་རྟགས། མགོ་བརྗོད། དཔེ་གཞི་ཆུང་ངུ་།

དབྱིན་སྐད་དཔྱད་གཞི་ src/lockedin.js ནང་ཡོད། གཞན་ 32 ནི་ src/content/*.js ནང་། ar, bn, bo, de, el, en-SG, es, eu, fa, fi, fr, he, hi, id, is, it, ja, kn, ms, nl, no, pl, pt, pt-BR, ru, sv, tl, tr, uk, ur, zh, zh-HK （pt-BR ཡིས་ pt ཡི་ pools/UI བསྐྱར་སྤྱོད་ཀྱང་སོ་སོར་ཐོ་འགོད） bundle ཚང་མ་ BUNDLES ནང་ཐོ་འགོད། SUPPORTED_LANGS དེ་དག་གི་ལྡེ་མིག་ནས་བསྐྲུན། renderHelp() ཡིས་ཨང་ཐོ་དེ་པར། UI bundle གང་གིས་ཀྱང་ཐོ་དེ་ཐད་ཀར་མི་འབྲི།

setLang('fr');       // ལས་བྱེད་སྐད་ཡིག་ཧྥ་རན་སིའི bundle ལ་སྟོན།
// L = ལས་བྱེད pools, U = ལས་བྱེད ui
pick(L.HOOKS)        // ཧྥ་རན་སིའི་འགོ་འཛུགས།
U.buzzwordDensity    // "Densité de jargon : "

renderer ཚང་མས་ L དང་ U ཀློག་པ་ལས་ཡི་གེ་ཐད་ཀར་མི་འབྲི། དེས་ setLang གཅིག་གིས་མྱོང་བ་ཆ་ཚང་བརྗེ།

ཉེན་སྲུང་དྲ་བ། key parity

bundle རེ་རེས་དབྱིན་སྐད་དང་གཅིག་པའི་ pools དང་ ui keys ཚང་མ་སྟོན་དགོས།

ཚོད་ལྟས་སྐད་ཡིག་ 33 ཚང་མར་དེ་བཙན་འགེལ། དབྱིན་སྐད་ལ་ UI ཡི་གེ་གསར་པ་སྣོན་ནས་ Ukraine སྐད་ལ་སྒྱུར་མ་ཐུབ་ན་ npm test དམར་པོ་ཆགས་ཤིང་ལྡེ་མིག་ཆད་པ་སྟོན། ཕྱེད་ཙམ་སྒྱུར་བའི་སྐད་ཡིག་ཁུ་སིམ་པོར་སྤྲོད་མི་ཐུབ།

དཀའ་གནད། མཐའ་སྣེའི་བཀོད་པ།

• ཉི་ཧོང་སྐད། ཀྲུང་ཡིག་སྟབས་བདེ། Hong Kong ཀྲུང་ཡིག་སྲོལ་རྒྱུན་གྱིས་ East Asian Wide / Fullwidth ཡིག་འབྲུ་སྤྱོད། vw() ཡིས་དེ་དག་ཀ་བ་གཉིས་སུ་རྩིས། wrap() ཡིས་བར་སྟོང་མེད་པའི་རིང་པོ་བཅད་ནས་ CJK ཡི་གེ་ card དང་སྒྲོམ་ནང་ཉར།
• ཧིན་དི་དང་ཀན་ན་ཌ་ཡིས་ Mn / Me མཉམ་སྦྱོར་རྟགས་སྤྱོད། vw() ཡིས་ཀ་བ་ 0 ལ་རྩིས།
• box() ཡིས་ཐིག་ཕྲེང་སྒྲིལ་རྗེས་ཁ་སྐོང་བས། འཕྲེད་བྱང་རིང་པོས་མཐའ་མི་གཏོར།
• bundle རེ་རེར་ sentenceEnd དང་ listSep（དཔེར་ན་ . / 。, , / 、）ཡོད་པས་ སྦྱར་བའི་ཚིག་རང་བཞིན་ལྡན།

སྐད་གསར་པ་སྣོན་སྐབས་ cardSubtitle། cardMeta། cardFooter ཡིག་རྒྱུན་ མཐོང་ཚད་ཀ་བ་ 60 ལས་མི་བརྒལ། Arabic། Persian། Hebrew། Urdu ཡིས་ meta.dir: 'rtl' བཞག རྒྱུན་དུ bidi control མི་གཏོང་། མཐའ་སྣེས་ལེགས་པོར་རྒྱབ་སྐྱོར་བ་ཤེས་ན་ LOCKEDIN_BIDI=on ཁོ་ནས་མཉམ་སྙོམས isolate སྤར། accessible ཐོན་འབྲས་ཀྱིས་རྟག་ཏུ་དེ་བསུབ། རང་འགུལ་བརྟག་དཔྱད་དང་ཚོད་དཔག་ནམ་ཡང་མ་བྱེད།

གསང་བའི་དཀའ་གནད། སྤྱོད་མཁན་གྱི་མ་བཅོས་པའི་ཞུགས་ཡིག་མཐའ་ཡི་བརྡ་སྤྲོད།

UI དཔེ་གཞི་འགའ་ཤས་ཀྱིས་ {cap} ལྟ་བུའི་གནས་འཛིན་ནང་སྤྱོད་མཁན་གྱི་ཚིག་མ་བཅོས་པ་སྦྱོར། གནས་རེ་རེར་ཐད་ཀར་མ་སྒྱུར། གནས་འཛིན་ནི་མིང་གཙང་མ་མ་ཡིན་པར་ཚིག་གྲུབ་ཆ་ཚང་ཡིན་སྲིད། ཉི་ཧོང་སྐད་ཀྱི་དཔེ་གཞིར་ {cap} རྗེས་ཐད་ཀར་ は བཞག་ན་ཚིག་གྲུབ་ཆ་ཚང་ལ་མི་འཚམ། ཐབས་ལམ་ནི་“དེ་བས་སྒྱུར”་བ་མ་ཡིན་པར། མིང་དུ་བསྒྱུར་བའམ་གནས་འཛིན་སྤོས་ནས་དཔེ་གཞི་བསྐྱར་བཟོ་བ་ཡིན།

✅ ཁྱེད་ཀྱི་ལས་ཚབ་དང་མཉམ་དུ་ཚོད་ལྟ། སྐད་གསར་པ་སྣོན།

Denmark སྐད་（da）སྣོན། src/content/da.js ལ་ { meta, pools, ui } bundle བཟོས། དབྱིན་སྐད་དང་keys གཅིག་པ་ཡིན་ཞིང་ཆ་ཚང་སྒྱུར། ནང་དོན་མཛོད་རེར་ཁྱོན་ 25 དང་ UI ཚང་མ། src/lockedin.js ཡི་ BUNDLES ནང་ da ཐོ་འགོད། --lang da དང་ da-* locale གཉིས་ཀས་དེ་འདེམས། card header ཞེང་ཚད་ནང་ཉར། npm test ལྗང་ཁུ་དགོས་ཤིང་ Denmark སྐད་ཀྱི་ཁས་ལེན་དང་ངོས་འཛིན་ཚོད་ལྟ་སྣོན།

དེ་ནས་ལེའུ་ 3–4 ཡི་རྒྱུན་རྒྱུགས།

1. ཐོག་མར་འཆར་གཞི། “ཨང་རྟགས་མ་འབྲི་གོང་ཡིག་ཆ་གང་བཅོས་པ་དང་དབྱིན་སྐད་ཀྱི་ key parity ཇི་ལྟར་ཉར་བ་བཤད།”
2. ཚོད་ལྟ་སྔོན་ལ། “da ངོས་འཛིན། key parity། Denmark reflect/connect ཁས་ལེན་གྱི་ཕམ་པའི་ཚོད་ལྟ་སྣོན། bundle ད་དུང་མ་བཟོ།”
3. ལག་བསྟར། “bundle ཞིག་ key རེ་རེར་སྒྱུར་ནས་ src/content/da.js བཟོས། ཐོ་འགོད་ནས་ཚོད་ལྟ་ཐོན་པར་བྱོས། སྐབས་བསྟུན་ལ་ pick / shuffle ཁོ་ན།”
4. སྒོ་སྲུང་དང་ཞིབ་བཤེར། npm test། lockedin --lang da post རྒྱུགས། key ཚང་མ་སྒྱུར་རམ། card མཐའ་སྙོམས་སམ། {cap} དང་ཚིག་གྲུབ་མ་བཅོས་པ་འཚམ་མམ།

སྦྱོང་བརྡར་ཆུང་ངུ་།

• “སྐད་ཡིག་ 33 ཚང་མར་ TAGLINE གསར་པ་རེ་སྣོན་ནས་གྲངས་མཉམ་པར་ཉར།”
• “Kannada cardFooter ≤ 60 visible columns ཡིན་མིན་བརྟག་ནས་མཉམ་སྦྱོར་རྟགས་ཇི་ལྟར་ཚད་འཇལ་བ་བཤད།”
• “ja.js ནས་ ui key གཅིག་བསུབས་ན་ཕམ་པའི་ཚོད་ལྟ་སྟོན།”

---

རྗེས་མའི་ལམ།

• src/content/es.js ལ་གཟིགས། དེ་སྐད་ཡིག་གསར་པའི་དཔེ་གཞི་ལེགས་པོ་ཡིན།
• docs/HANDOFF.md ཡི་“Adding a language” བསྐྱར་ཀློག
• བཀའ་བརྡའི་དཔྱད་གཞི། ནང་གི་སྐད་མང་བཞད་གད་ལ་སྤྲོ་བ་བྱོས།

སློབ་ཚན་ཆ་ཚང་འདི་ཡིན། ཁྱེད་ཀྱིས་ད་ཚོད་ལྟའི་སྒོ་སྲུང་འོག་ AI ལས་ཚབ་ལ་ཁྱད་ཆོས་བཟོ་དང་ སྐད་ཡིག་ 33 ལ་ས་གནས་ཅན་བྱེད་དུ་འཇུག་ཐུབ། མོས་མཐུན་ཡོད་དམ། 👇