quản trị

leji.org được dịch như thế nào

Bản dịch có sự hỗ trợ của AI agent. Nếu có khác biệt, trang tiếng Anh là bản có hiệu lực. Nếu bạn thấy vấn đề nào trong văn bản, rất mong bạn mở một issue hoặc gửi một pull request.

leji.org được viết bằng tiếng Anh rồi dịch sang từng ngôn ngữ. Trang này ghi lại bản nào có hiệu lực khi hai bản khác nhau, một bản dịch được làm ra sao, thuật ngữ của nó dựa vào những nguồn tham chiếu nào, và cách báo một chỗ sai.

Bản tiếng Anh là bản có hiệu lực

Mọi trang đều được viết bằng tiếng Anh trước. Một trang đã dịch là bản dịch của trang tiếng Anh đó và nói rõ điều này ngay dưới tiêu đề; nếu hai bản khác nhau thì bản tiếng Anh có hiệu lực. Các bản dịch của bản đặc tả chỉ mang tính tham khảo: văn bản chuẩn tắc là bản tiếng Anh trên nhánh 1.0 đã đóng băng, và mỗi trang đặc tả đã dịch đều mang một dải thông báo nói rõ điều đó.

Một bản dịch được làm ra sao

Các trang được soạn bản nháp bằng một quy trình có agent hỗ trợ, rồi được phê duyệt từng trang trước khi phát hành. Hai engine xem xét độc lập, không engine nào tham gia soạn trang đó, sẽ kiểm tra mức trung thành với bản tiếng Anh, thuật ngữ đối chiếu với bảng thuật ngữ của ngôn ngữ đó, và độ trôi chảy; trang chỉ được phát hành khi cả hai cùng đồng ý.

Thuật ngữ

Mỗi ngôn ngữ giữ một bảng thuật ngữ cho những thuật ngữ mà Leji dùng. Khi một thuật ngữ đã có cách dịch quen thuộc trong bản dịch do con người thực hiện của một dự án mã nguồn mở nổi tiếng, bảng thuật ngữ sẽ theo cách dịch đó hoặc ghi lại một ngoại lệ kèm lý do. Những nguồn tham chiếu này chỉ để hỗ trợ, không bao giờ là nguồn. Danh sách dưới đây được cập nhật khi các bản dịch của những dự án đó xuất hiện hay biến mất.

Tiếng Trung giản thể

• MDN Web Docs (zh-CN)
• Tài liệu Kubernetes (zh-cn)
• Pro Git (zh)
• GitHub Docs (zh)
• Tài liệu Python 3 (zh-cn)
• Vue.js (zh)
• Vite (zh)
• React (zh-hans)
• TypeScript (zh)
• Keep a Changelog (zh-CN)
• Semantic Versioning (zh-CN)
• Hugging Face Agents Course (zh-CN)

Tiếng Nhật

• Pro Git (ja)
• GitHub Docs (ja)
• Tài liệu và bảng thuật ngữ Kubernetes (ja)
• MDN Web Docs (ja)
• React (ja)
• Vue (ja)
• Tài liệu Python (ja)
• Python Packaging User Guide (ja)
• WCAG 2.1 (ja, WAIC)
• Nội dung chung của các bản đặc tả W3C (ja)
• W3C (ja)
• Keep a Changelog (ja)
• Semantic Versioning (ja)
• Vite (ja)
• Rails Guides (ja)
• OpenStack Security Guide (ja)

Tiếng Bồ Đào Nha (Brazil)

• Pro Git (pt-br)
• GitHub Docs (pt)
• Tài liệu Kubernetes (pt-br)
• Tài liệu Python (pt-br)
• MDN Web Docs (pt-BR)
• Bản dịch WCAG 2.0 được W3C uỷ quyền (pt-br)
• Tài liệu Django (pt-br)
• Tài liệu React (pt-br)
• Tài liệu Astro (pt-br)
• Keep a Changelog (pt-BR)
• Trang TypeScript (pt)
• Tài liệu Vue (pt)

Tiếng Tây Ban Nha

• Pro Git (es)
• Bản địa hoá tiếng Tây Ban Nha của Git (po/es.po)
• Tài liệu và bảng thuật ngữ Kubernetes (es)
• MDN Web Docs (es)
• Tài liệu Python (es)
• Tài liệu React (es)
• Keep a Changelog (es)
• Semantic Versioning (es)
• Conventional Commits (es)
• Open Source Guides (es)
• GitHub Docs (es)
• Tài liệu Astro (es)

Tiếng Việt

• Bản địa hoá tiếng Việt của Git (po/vi.po)
• Tài liệu và bảng thuật ngữ Kubernetes (vi)
• Semantic Versioning 2.0.0 (vi)
• Tài liệu Vue.js (vi, Vue 2)
• The Twelve-Factor App (vi)
• Contributor Covenant 2.1 (vi)
• Bản địa hoá GNOME GTK (po/vi.po)
• Các bản dự thảo tiêu chuẩn quốc gia Việt Nam (từ vựng văn bản tiêu chuẩn)
• Wikipedia tiếng Việt (nguồn phụ)

Giữ cho khỏi lỗi thời

Mỗi trang đã dịch đều ghi lại nó đi theo bản sửa đổi nào của nguồn tiếng Anh. Ở mỗi lần build có một bước kiểm tra khiến chính lần build đó thất bại nếu có bản dịch nào tụt lại sau nguồn của nó, nên một bản dịch đã phát hành không bao giờ cũ hơn bản tiếng Anh mà nó dịch. Bản sửa đổi này chỉ được ghi lại, không hiển thị ra.

Báo một chỗ sai

Mỗi trang đã dịch đều có hai đường dẫn ngay dưới tiêu đề: một đường mở issue với ngôn ngữ và trang đã điền sẵn, đường kia mở chính tệp nguồn của trang để gửi pull request. Bản một trang của bản đặc tả là ngoại lệ: nó được ghép từ nhiều tài liệu chứ không phải từ một tài liệu, nên đường dẫn mở issue nằm ở dải thông báo trên đầu trang, còn đường dẫn sửa nằm cạnh từng đầu đề tài liệu. Một chỗ sửa được xem xét như mọi thay đổi khác và được đưa vào bản phát hành kế tiếp.

Những gì không được dịch

Tên lệnh, cờ, đường dẫn, khoá JSON và các ví dụ mã đều giữ nguyên tiếng Anh; phần chú thích bên trong một ví dụ mã thì được dịch. Bản thân các tệp JSON Schema và các route markdown thô cũng giữ nguyên tiếng Anh.