From f87435e24a330dd1bddb04539d238c9bcc807fcd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?nh=C3=A2m=20qu=E1=BB=91c=20hu=C3=A2n?= Date: Sun, 25 Oct 2026 19:27:47 +0700 Subject: [PATCH 1/5] feat(i18n): add Vietnamese (vi) language support MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add 'vi' (Tiếng Việt / Vietnamese) to LanguageCode, LocaleCode, and the languages map. Enables docs.github.com/vi endpoint. Locale: vi-vn · hreflang: vi · redirect: /vn Org: github.com/nlp-labs-vietnam --- src/languages/lib/languages.ts | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/src/languages/lib/languages.ts b/src/languages/lib/languages.ts index cc7cf5007df3..9f9db383ef8b 100644 --- a/src/languages/lib/languages.ts +++ b/src/languages/lib/languages.ts @@ -4,7 +4,7 @@ // Client-safe definitions avoid fs and path; server code that needs directories // imports languages-server.ts. -export type LanguageCode = 'en' | 'es' | 'ja' | 'pt' | 'zh' | 'ru' | 'fr' | 'ko' | 'de' +export type LanguageCode = 'en' | 'es' | 'ja' | 'pt' | 'zh' | 'ru' | 'fr' | 'ko' | 'de' | 'vi' export type LocaleCode = | 'en' | 'es-es' @@ -15,6 +15,7 @@ export type LocaleCode = | 'fr-fr' | 'ko-kr' | 'de-de' + | 'vi-vn' export interface Language { name: string @@ -112,6 +113,15 @@ export const languages: Languages = { locale: 'de-de', firstArchivedVersion: '3.3', }, + vi: { + name: 'Vietnamese', + nativeName: 'Tiếng Việt', + code: 'vi', + hreflang: 'vi', + redirectPatterns: [/^\/vn/], + locale: 'vi-vn', + firstArchivedVersion: '3.12', + }, } Object.freeze(languages) From 09e842a20392d584e1a54c45774ede4829af27d8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?nh=C3=A2m=20qu=E1=BB=91c=20hu=C3=A2n?= Date: Sun, 25 Oct 2026 19:27:49 +0700 Subject: [PATCH 2/5] docs(vi): scaffold Vietnamese (vi-vn) translation directory --- translations/vi-vn/README.md | 51 ++++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 translations/vi-vn/README.md diff --git a/translations/vi-vn/README.md b/translations/vi-vn/README.md new file mode 100644 index 000000000000..7d9b75bde086 --- /dev/null +++ b/translations/vi-vn/README.md @@ -0,0 +1,51 @@ +# Bản dịch Tiếng Việt — GitHub Docs (vi-vn) + +Thư mục này chứa bản dịch tiếng Việt của tài liệu GitHub Docs. + +## Cấu trúc + +``` +translations/vi-vn/ +├── content/ ← Bản dịch Markdown của content/ (EN) +└── data/ ← Bản dịch data/ variables và reusables +``` + +## Trạng thái dịch + +- **Ngôn ngữ:** Tiếng Việt (Vietnamese) +- **Mã ngôn ngữ:** `vi` +- **Locale:** `vi-vn` +- **Endpoint:** `https://docs.github.com/vi` +- **Người khởi xướng:** [@Dennis-nham](https://github.com/Dennis-nham) · NLP Labs Vietnam +- **Tổ chức:** [@nlp-labs-vietnam](https://github.com/nlp-labs-vietnam) + +## Cách đóng góp + +1. Xem danh sách bài chưa dịch tại [GitHub Discussions](https://github.com/github/docs/discussions) +2. Nhận bài dịch: comment vào discussion tương ứng +3. Dịch file `.md` trong `content/` — giữ nguyên frontmatter, code block, và Liquid tags +4. Gửi PR vào repo dịch riêng (khi GitHub tạo private translation repo cho `vi-vn`) + +## Quy tắc dịch thuật + +| Thuật ngữ EN | Tiếng Việt chuẩn | +|---|---| +| repository | kho lưu trữ / repository | +| pull request | pull request (giữ nguyên) | +| branch | nhánh | +| commit | commit (giữ nguyên) | +| merge | hợp nhất | +| fork | fork (giữ nguyên) | +| issue | vấn đề / issue | +| workflow | quy trình làm việc | +| action | hành động / Action | +| release | phát hành | +| tag | thẻ | +| milestone | mốc quan trọng | +| collaborator | cộng tác viên | + +## Liên hệ + +- **Email:** enterprise@nlpgroup.vn +- **GitHub:** [@Dennis-nham](https://github.com/Dennis-nham) +- **Org:** [@nlp-labs-vietnam](https://github.com/nlp-labs-vietnam) From a7f77926982ab57d36ae782dc7589bb39efbe4a2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?nh=C3=A2m=20qu=E1=BB=91c=20hu=C3=A2n?= Date: Sun, 25 Oct 2026 19:27:51 +0700 Subject: [PATCH 3/5] docs(vi): add Vietnamese index page (docs.github.com/vi) --- translations/vi-vn/content/index.md | 30 +++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 translations/vi-vn/content/index.md diff --git a/translations/vi-vn/content/index.md b/translations/vi-vn/content/index.md new file mode 100644 index 000000000000..18e7d126ac85 --- /dev/null +++ b/translations/vi-vn/content/index.md @@ -0,0 +1,30 @@ +--- +title: 'Tài liệu trợ giúp {% data variables.product.github %}' +featuredLinks: + gettingStarted: + - /get-started/git-basics/set-up-git + - /authentication/connecting-to-github-with-ssh + - /repositories/creating-and-managing-repositories + - /get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax + popular: + - /pull-requests/reference/pull-requests + - /authentication + - /copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/get-ide-code-suggestions + - /get-started/git-basics/managing-remote-repositories + - /pages +redirect_from: + - /github +versions: + fpt: '*' + ghes: '*' + ghec: '*' +children: + - search + - get-started + - account-and-profile + - subscriptions-and-notifications + - authentication + - repositories + - admin + - billing +--- From e232d17e1c8148857caf4274e7b43c7703bce8a8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?nh=C3=A2m=20qu=E1=BB=91c=20hu=C3=A2n?= Date: Sun, 25 Oct 2026 19:27:53 +0700 Subject: [PATCH 4/5] =?UTF-8?q?docs(vi):=20add=20Vietnamese=20get-started?= =?UTF-8?q?=20section=20(B=E1=BA=AFt=20=C4=91=E1=BA=A7u=20v=E1=BB=9Bi=20Gi?= =?UTF-8?q?tHub)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../vi-vn/content/get-started/index.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 translations/vi-vn/content/get-started/index.md diff --git a/translations/vi-vn/content/get-started/index.md b/translations/vi-vn/content/get-started/index.md new file mode 100644 index 000000000000..8b1f5afa1258 --- /dev/null +++ b/translations/vi-vn/content/get-started/index.md @@ -0,0 +1,19 @@ +--- +title: Bắt đầu với GitHub +shortTitle: Bắt đầu +intro: 'Tìm hiểu cách bắt đầu xây dựng, vận chuyển và duy trì phần mềm với {% data variables.product.prodname_dotcom %}.' +versions: + fpt: '*' + ghes: '*' + ghec: '*' +children: + - /start-your-journey + - /onboarding + - /git-basics + - /using-github + - /writing-on-github + - /exploring-projects-on-github + - /working-with-subversion-on-github + - /importing-your-projects-to-github + - /archiving-your-work-on-github +--- From e0b7ba4ca92ac171678b14d3cb2d8f71959c8d0c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?nh=C3=A2m=20qu=E1=BB=91c=20hu=C3=A2n?= Date: Sun, 25 Oct 2026 19:27:55 +0700 Subject: [PATCH 5/5] docs(vi): add Vietnamese UI strings for header, footer, search, article --- translations/vi-vn/data/ui.yml | 37 ++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 translations/vi-vn/data/ui.yml diff --git a/translations/vi-vn/data/ui.yml b/translations/vi-vn/data/ui.yml new file mode 100644 index 000000000000..3424a364af23 --- /dev/null +++ b/translations/vi-vn/data/ui.yml @@ -0,0 +1,37 @@ +# Chuỗi giao diện người dùng — Tiếng Việt (vi-vn) +# Được tạo bởi: @Dennis-nham · NLP Labs Vietnam +# Ngày: 2025 + +header: + github_docs: "Tài liệu GitHub" + search_placeholder: "Tìm kiếm tài liệu..." + language_picker: "Ngôn ngữ" + +footer: + terms: "Điều khoản" + privacy: "Bảo mật" + security: "Bảo mật thông tin" + status: "Trạng thái" + docs: "Tài liệu" + contact: "Liên hệ" + manage_cookies: "Quản lý cookie" + do_not_share: "Không chia sẻ thông tin cá nhân" + +article: + contents: "Mục lục" + edit_on_github: "Chỉnh sửa trên GitHub" + scroll_to_top: "Lên đầu trang" + feedback_positive: "Bài viết có hữu ích không?" + feedback_yes: "Có" + feedback_no: "Không" + was_this_helpful: "Bài viết này có hữu ích không?" + +search: + label: "Tìm kiếm tài liệu" + results: "Kết quả tìm kiếm" + no_results: "Không tìm thấy kết quả cho" + search_again: "Tìm kiếm lại" + +errors: + page_not_found: "Không tìm thấy trang" + try_search: "Thử tìm kiếm để tìm nội dung bạn cần."