PetroNet SystemDocumentation
Clients

Орчуулга

2 min readdocs/TRANSLATION.mdEdit on GitHub

Долоон хэл, гурван давхарга, нэг үүсгэгч. Цөмийн frontend-ийн src/shared/i18n ба scripts/i18n-translate.mjs-ийн кодоос уншиж бичигдсэн.

This page has not been translated yet — it is shown in Mongolian, the language it is written in.

Баримтын төв


01Долоон хэл

Монгол + НҮБ-ын албан ёсны зургаан хэл (араб, хятад, англи, франц, орос, испани). Монгол нь эх сурвалж, бусад нь орчуулга. Монгол ба англи үргэлж байна; бусад тав нь төхөөрөмж бүр дээр асаадаг (Тохиргоо → Харагдах байдал) бөгөөд сонгосон үед л татагдана.

Жагсаалт нь дур зоргоор биш, олон улсын байгууллагуудын хэрэглэдэг жишигт тулгуурласан — тиймээс найм дахь хэл нэмэх нь файл нэмэх биш, бодлого өөрчлөх ажил.

Бүтээгдэхүүний танилцуулга монгол, англи хоёр хэлээр. Техникийн баримт бүр олон хувилбартай байх албагүй.

02Гурван давхарга

ДавхаргаХаанаХэрхэн шалгагдах
Цөмийн тольsrc/shared/i18n/core.tsКомпиляцын үед — TranslationKey
Аппын тольregisterDictionary(appId, …)Ажиллах үед — энгийн мөр
Overlaysrc/shared/i18n/locales/<хэл>/Дутуу түлхүүр англи руу унана

Цөмийн түлхүүрийн үсгийн алдаа нь build алдаа хэвээр. Аппын түлхүүр нь мөр — өөр репод амьдардаг апп энэ репогийн мэддэггүй үгсийг өгдөг тул өөр байх аргагүй. t() хоёуланг нь авна.

Өмнө нь толь нь index.tsx дотор 25 import, 25 spread-ээс баригддаг нэг объект байсан ба хажууд нь тус бүр ~1381 мөртэй таван overlay файл байв. Апп нэмэх нь тэднийг бүгдийг засахыг шаарддаг байсан — хүн бүр дундын толь хүссэндээ биш, аппын үгс очих өөр газар байгаагүйд.

Бүртгэлийн дараалал хамаагүй: t() нь хайлт бүрд бүртгэлээс уншдаг, нэгтгэсэн объектыг барьж авдаггүй.

03Үүсгэгч

sh
npm run i18n:translate -- --locale fr           # юу өөрчлөгдөхийг харуулнаnpm run i18n:translate -- --locale fr --write   # src/shared/i18n/locales/fr.ts бичнэ

Платформ Gemini-тэй аль хэдийн ярьдаг (copilot, орчуулгын панель); энэ нь тэр л загварыг интерфэйс дээрээ, хүсэлт бүрд биш build-ийн үед хэрэглэж байгаа хэрэг. Хүсэлт бүрд орчуулах нь дэлгэц бүр дээр латенси, мөнгө төлж, зочилсон болгонд арай өөр үг авна гэсэн үг.

Гурван дүрэм:

  1. Хэзээ ч дарж бичихгүй. Зөвхөн overlay-д дутуу түлхүүрүүд илгээгдэнэ — хүний засвар үүрд үлдэнэ, дахин ажиллуулах нь үргэлж аюулгүй.
  2. Placeholder зохиохгүй. {name} зэрэг нь гаралт дээр шалгагдаж, алдсан эсвэл нэрийг нь өөрчилсөн орчуулга хаягдана — таарахаа больсон placeholder нь хэрэглэгчид шууд хаалт болж харагдана.
  3. Техникийн нэрсэд хүрэхгүй — tenant, RBAC, OAuth2, eID, SKU, e-Barimt зэрэг нь бүтээгдэхүүний үгсийн сан, зохиол биш.

Гаралт нь ноорог. Интерфэйсийн машин орчуулга нь хянахад хангалттай сайн, уншаагүйгээр гаргахад тохиромжгүй байх хангалттай олон удаа буруу байдаг — overlay бүрийн толгойд ч тэгж бичигдсэн.

04Хуудасны хэл

Monгол агуулгатай хуудсыг <html lang="en"> гэж зарлавал Chrome түүнийг автоматаар «орчуулж», брэндийн нэрийг ч өөрчилнө. Хэлээ зөв зарлана.

Was this page helpful?Your answer helps improve the docs.
    DEV · Хөгжүүлэлтийн орчин