Bạn biết tôi qua Upwork? Nếu bạn biết tôi qua Upwork và muốn sử dụng dịch vụ, vui lòng liên hệ qua Upwork. Tin nhắn từ khách Upwork gửi ngoài Upwork sẽ không được trả lời.
Ghi chú bản địa hóa🌏 Bản địa hóa

Bản địa hóa SvelteKit sang tiếng Việt: Paraglide JS, hooks và ICU

Bản địa hóa SvelteKit sang tiếng Việt với Paraglide JS: tạo cấu trúc một lệnh, cấu hình locale vi, middleware hooks và ICU không có số nhiều riêng biệt.

Dao Huy (Lucas)7 phút đọc8 mục
Bản địa hóa SvelteKit sang tiếng Việt: Paraglide JS, hooks và ICU

💡 Để bản địa hóa ứng dụng SvelteKit sang tiếng Việt với Paraglide JS: chạy npx sv add paraglide, thêm vi vào mảng languageTags trong project.inlang/settings.json, cấu hình middleware trong hooks.server.ts và nhập các hàm message có kiểu dữ liệu. Tiếng Việt chỉ có một dạng số nhiều ICU (other), nên chuỗi số nhiều chỉ cần một nhánh duy nhất. Chuỗi tiếng Việt thường dài hơn tiếng Anh 10-20%.

Ý chính

  • Chạy npx sv add paraglide để tạo toàn bộ cấu trúc Paraglide JS + SvelteKit chỉ với một lệnh. CLI tự động tạo project.inlang/settings.json, thư mục messages/ và kết nối Vite plugin.
  • Thêm vi vào mảng languageTags trong project.inlang/settings.json. Tạo messages/vi.json với các bản dịch tiếng Việt dùng cùng message ID như locale gốc.
  • Tiếng Việt có một dạng số nhiều CLDR: other. Tất cả message ICU số nhiều chỉ cần một nhánh, không cần dạng one riêng biệt.
  • Dùng paraglideMiddleware trong hooks.server.ts và hook reroute deLocalizeUrl trong hooks.ts để có URL tiền tố locale và inject locale đúng khi SSR.
  • Chuỗi tiếng Việt thường dài hơn tiếng Anh 10-20%. Kiểm tra tất cả nhãn nút và mục điều hướng ở viewport 375px và 390px. Bộ font web phải bao gồm đầy đủ khối Unicode tiếng Việt (U+1EA0-U+1EF9).

Bản địa hóa SvelteKit sang tiếng Việt thực sự cần những gì?

Bản địa hóa ứng dụng SvelteKit sang tiếng Việt bao gồm bốn vấn đề riêng biệt: quản lý message, định tuyến theo locale, định dạng số và ngày tháng, và kiểm tra bố cục. Đây là các vấn đề độc lập - bạn có thể giải quyết từng vấn đề mà không cần vấn đề khác chặn tiến độ.

Paraglide JS xử lý quản lý message và định tuyến theo locale. JavaScript Intl API xử lý định dạng với locale vi-VN. Kiểm tra bố cục là bước thủ công phát hiện các vấn đề về font và độ dài chuỗi đặc trưng của tiếng Việt.

Server-side rendering của SvelteKit đặt ra yêu cầu bổ sung: locale phải được phát hiện theo từng request trên server và truyền xuống client. Middleware của Paraglide xử lý điều này qua hooks.server.ts.

Tại sao Paraglide JS là thư viện i18n được khuyến nghị cho SvelteKit?

Paraglide JS biên dịch các file message thành các hàm ESM có kiểu dữ liệu tại thời điểm build. Các bundler hiện đại sau đó tree-shake các hàm message không dùng, chỉ gửi code của locale đang hoạt động xuống trình duyệt. Kết quả là bundle nhỏ hơn so với các thư viện tra cứu từ điển khi chạy.

SvelteKit chính thức chọn Paraglide JS làm giải pháp i18n được khuyến nghị qua Svelte CLI. Chạy npx sv add paraglide tự động xử lý toàn bộ cấu trúc: Vite plugin, file inlang project, hooks và thư mục messages mẫu.

Các thư viện thay thế vẫn hoạt động tốt. Typesafe-i18n và svelte-i18n là các lựa chọn trưởng thành có hỗ trợ tiếng Việt. Nhưng với dự án SvelteKit mới, Paraglide là khuyến nghị first-party từ đội ngũ Svelte.

Làm thế nào để cấu hình Paraglide JS cho tiếng Việt trong SvelteKit?

Cài đặt gồm bốn bước. Tất cả file nên được chỉnh sửa bằng công cụ hỗ trợ UTF-8 để bảo toàn dấu tiếng Việt.

Bước 1 - Tạo cấu trúc: Chạy lệnh Svelte CLI addon để tạo toàn bộ cấu trúc dự án:

npx sv add paraglide

Lệnh này tạo project.inlang/settings.json, kết nối Vite plugin vào vite.config.ts và tạo messages/en.json làm file locale gốc.

Bước 2 - Thêm locale tiếng Việt. Trong project.inlang/settings.json, thêm vi vào mảng languageTags:

{ "languageTags": ["en", "vi"], "baseLocale": "en" }

Bước 3 - Tạo messages/vi.json với các chuỗi tiếng Việt. Dùng cùng message ID như file locale gốc. Dấu tiếng Việt phải được lưu dạng UTF-8 NFC:

{ "greeting": "Xin chào, {name}!", "items_in_cart": "{count} sản phẩm trong giỏ hàng", "checkout_button": "Thanh toán" }

Bước 4 - Thêm middleware vào src/hooks.server.ts và hook reroute vào src/hooks.ts:

// hooks.server.ts
import type { Handle } from '@sveltejs/kit/hooks';
import { paraglideMiddleware } from '$lib/paraglide/server';
export const handle: Handle = ({ event, resolve }) =>
  paraglideMiddleware(event.request, ({ request: localizedRequest }) =>
    resolve({ ...event, request: localizedRequest }));

// hooks.ts
import type { Reroute } from '@sveltejs/kit/hooks';
import { deLocalizeUrl } from '$lib/paraglide/runtime';
export const reroute: Reroute = ({ url }) => deLocalizeUrl(url).pathname;

Định dạng tiếng Việt: ngày tháng, số và tiền tệ

Paraglide xử lý chuỗi nào hiển thị. JavaScript Intl API xử lý cách số, ngày tháng và tiền tệ hiển thị. Dùng mã locale vi-VN cho cả ba:

  • Ngày tháng: new Intl.DateTimeFormat('vi-VN', { dateStyle: 'short' }).format(date) trả về DD/MM/YYYY. Người dùng Việt Nam mong đợi thứ tự ngày trước.
  • Số: new Intl.NumberFormat('vi-VN').format(1500000) trả về 1.500.000. Dấu chấm là dấu phân cách hàng nghìn; dấu phẩy là dấu thập phân.
  • Tiền tệ (VND): new Intl.NumberFormat('vi-VN', { style: 'currency', currency: 'VND' }).format(250000) trả về 250.000 ₫. VND không có đơn vị thập phân.
  • Sắp xếp: Thứ tự bảng chữ cái tiếng Việt khác với ASCII. Dùng new Intl.Collator('vi').compare cho bất kỳ danh sách nào được sắp xếp phía client. Bảng chữ cái tiếng Việt có 29 chữ cái cơ sở.

Những vấn đề bố cục nào cần lưu ý với chuỗi tiếng Việt?

Chuỗi tiếng Việt thường dài hơn tiếng Anh 10-20% trong nhãn UI và văn bản điều hướng. Độ dài tăng do các từ đa âm tiết và hạt ngữ pháp không có tương đương trong tiếng Anh.

Chạy qua danh sách kiểm tra này trước khi ra mắt ứng dụng SvelteKit tiếng Việt:

  • Kiểm tra tất cả văn bản nút và nhãn điều hướng ở viewport 375px và 390px.
  • Xác minh phủ sóng font: tiếng Việt dùng dấu phụ kết hợp với sáu dấu thanh. Bộ font web chỉ cho Latin cơ bản có thể bỏ sót ký tự tiếng Việt. Thêm dải Unicode tiếng Việt: U+0102-0103, U+0110-0111, U+1EA0-1EF9.
  • Đặt lang="vi" trên phần tử <html> gốc. Template app.html của SvelteKit hỗ trợ placeholder %lang% mà Paraglide điền vào khi request.
  • Áp dụng overflow-wrap: break-word trong CSS gốc. Văn bản tiếng Việt ngắt ở dấu cách giữa các âm tiết, nhưng thuật ngữ kỹ thuật dài có thể tràn container hẹp.
  • Chuẩn hóa tất cả chuỗi tiếng Việt sang NFC. Dấu tiếng Việt có thể mã hóa theo NFC precomposed hoặc NFD decomposed - trông giống nhau nhưng không bằng nhau khi so sánh chuỗi. Dùng str.normalize('NFC') với mọi chuỗi tiếng Việt do người dùng nhập.

Tự làm hay thuê chuyên gia: ranh giới thực tế cho ứng dụng SvelteKit tiếng Việt

Công việc kỹ thuật - cài đặt Paraglide, viết hooks, kết nối Intl - hoàn toàn có thể tự thực hiện. Bất kỳ lập trình viên nào cũng có thể làm theo hướng dẫn chính thức Paraglide JS + SvelteKit và chạy được lớp định tuyến trong vài giờ. Dịch máy xử lý các chuỗi UI có cấu trúc như thông báo lỗi, nhãn trường và văn bản trợ giúp với chất lượng chấp nhận được cho hầu hết ứng dụng.

Nơi chuyên gia người Việt bản địa tạo ra sự khác biệt thực sự: giọng điệu UI sản phẩm, nội dung marketing và thuật ngữ chuyên ngành. Tiếng Việt phân biệt văn phong trang trọng (dùng trong ứng dụng chuyên nghiệp) với văn phong thân mật (dùng trong ứng dụng tiêu dùng), và chọn sai sẽ bị người dùng Việt Nam nhận ra ngay. Từ Hán-Việt truyền đạt chuyên môn trong tài chính, y tế và pháp lý - máy dịch thông thường mặc định dùng từ thuần Việt mà các chuyên gia cho là chưa chính xác.

Cách phân chia thực tế: dùng MT cho phần lớn tài liệu trợ giúp, và thuê người review cho 50-100 chuỗi UI mà người dùng gặp trong mỗi phiên. Với sản phẩm B2B mà nhóm mua hàng Việt Nam sẽ đánh giá sản phẩm, nhờ người Việt bản địa kiểm tra toàn bộ UI trước khi ra mắt.

Với dịch thuật chuyên nghiệp từ tiếng Anh sang tiếng Việt cho website và UI SaaS, dịch vụ bản địa hóa website tiếng Việt trên trang này xử lý cả dịch thuật lẫn review kỹ thuật.

Câu hỏi thường gặp

Tiếng Việt có cần chuẩn hóa Unicode đặc biệt trong file message Paraglide không?

Có. Dấu tiếng Việt có thể mã hóa theo NFC precomposed (một code point) hoặc NFD decomposed (ký tự cơ sở cộng dấu kết hợp). Cả hai hiển thị giống nhau nhưng thất bại khi so sánh chuỗi. Lưu tất cả nội dung file message tiếng Việt dạng NFC. Trong JavaScript: str.normalize('NFC').

Nên dùng 'vi' hay 'vi-VN' trong Paraglide?

Dùng vi trong languageTags của Paraglide và làm tiền tố URL. Theo hướng dẫn BCP 47 của W3C, giữ thẻ ngôn ngữ ngắn nhất có thể. Với JavaScript Intl API, vi-VN tường minh hơn và đảm bảo tra cứu dữ liệu định dạng nhất quán, nhưng vi cũng hoạt động với hầu hết thao tác định dạng.

Paraglide xử lý message số nhiều tiếng Việt như thế nào?

Tiếng Việt có một dạng số nhiều CLDR: other. Tất cả số đều ánh xạ đến other vì tiếng Việt dùng danh từ chỉ loại và ngữ cảnh, không dùng biến hình số nhiều. Cú pháp ICU {count, plural, other {# sản phẩm}} bao phủ mọi số lượng. Vẫn có thể dùng selector =0 và =1 cho message trạng thái rỗng đặc biệt.

URL tiền tố locale hoạt động thế nào với Paraglide trong SvelteKit?

Paraglide thêm tiền tố locale vào tất cả URL: trang tiếng Việt được phục vụ tại /vi/duong-dan. Hook reroute trong hooks.ts loại bỏ tiền tố locale để router của SvelteKit thấy đường dẫn chưa được locale hóa. paraglideMiddleware trong hooks.server.ts phát hiện locale từ tiền tố URL và đặt nó cho request hiện tại qua AsyncLocalStorage.

Có thể dùng Paraglide JS với static adapter để xuất trang tĩnh hoàn toàn không?

Được. Paraglide JS hoạt động với @sveltejs/adapter-static. Đặt strategy: ['url', 'baseLocale'] trong config Paraglide Vite plugin và prerender tất cả biến thể locale. Thêm entries: ['/vi/', '/en/', '/zh/', '/fr/'] vào config static adapter để SvelteKit tạo HTML cho mỗi locale. Các hàm message đã biên dịch là ESM tĩnh, không cần server khi chạy.

Nguồn tham khảo

Dao Huy (Lucas)
Dao Huy (Lucas)
Tốt nghiệp Trường Đại học Ngoại ngữ, Đại học Đà Nẵng. Ký cam kết chính xác trên mọi bản dịch có xác nhận (USCIS, IRCC).

Bài viết bởi Đào Huy (Lucas), biên dịch viên và chuyên viên bản địa hóa tiếng Việt (Anh, Trung, Pháp sang Việt). See translation services →

Báo giáWhatsApp