Tài liệu
Cài đặt ban đầu là bắt buộc
Trước khi sử dụng XLIFF Translator, bạn cần cấu hình ứng dụng Angular của mình cho việc quốc tế hóa.
Bắt đầu với XLIFF Translator
Chọn kho lưu trữ
Sau khi kết nối với một nhà cung cấp Git:
Để kết nối, hãy tạo một Mã truy cập cá nhân với các phạm vi sau:
- repo
- read:org
Lấy token của bạn tại đây: Settings > Developer settings > Personal access tokens > Tokens (classic) > Generate new token
- Chọn nhà cung cấp: Chọn từ GitHub, GitLab hoặc Bitbucket
- Cấu hình quyền truy cập: Tạo và cung cấp các token phù hợp
- Lưu cấu hình của bạn: Nhập mã token của bạn và lưu kết nối
Github
Tạo một Mã truy cập cá nhân với repo, và repo:org phạm vi.
GitLab
Tạo một Mã truy cập cá nhân với api, read_repository, và write_repository scopes.
Bitbucket
Tạo một Mật khẩu Ứng dụng với quyền truy cập repository:read và quyền truy cập repository:write.
Quản lý kho lưu trữ
Chọn kho lưu trữ
Sau khi kết nối với một nhà cung cấp Git:
- Đi tới trang của nhà cung cấp nơi danh sách các kho chứa của bạn được liệt kê
- Duyệt và chọn kho lưu trữ chứa dự án Angular của bạn với các tệp XLIFF
- Xác định nhánh để làm việc (mặc định thường là nhánh chính)
Tùy chọn dịch thuật
Đánh giá và Hoàn thiện
Xem xét yêu cầu kéo lại
Sau khi quá trình dịch hoàn tất:
- Xem lại pull request đã tạo trong nhà cung cấp Git của bạn
- Kiểm tra nội dung đã dịch để xác minh tính chính xác
- Thực hiện bất kỳ điều chỉnh cần thiết nào trực tiếp trong các tệp XLIFF
- Gộp yêu cầu kéo để cập nhật cơ sở mã chính của bạn với các bản dịch
Quy trình làm việc này cho phép bạn giữ bản dịch trong hệ thống kiểm soát phiên bản của mình và tuân thủ các thực hành đánh giá mã chuẩn cho các cập nhật bản dịch.
Mẹo để Dịch Hiệu Quả
- Chạy các bản dịch thường xuyên trong quá trình phát triển để tránh những cụm nội dung chưa được dịch lớn.
- Tạo một nhánh riêng biệt cho việc dịch thuật để giữ chúng tách biệt với phát triển tính năng
- Đảm bảo mã nguồn của bạn có ngữ cảnh rõ ràng cho các đơn vị phiên dịch để cải thiện chất lượng phiên dịch AI.
- Luôn luôn xem xét các bản dịch do AI tạo ra, đặc biệt là đối với nội dung quan trọng đối diện với người dùng
- Sử dụng các mẫu tệp cụ thể để nhắm đến việc dịch cho một ngôn ngữ tại một thời điểm.
Tài nguyên bổ sung
Tài liệu i18n của Angular
Tài liệu chính thức của Angular về quốc tế hóa.
ng-extract-i18n-merge
Công cụ chính thức để trích xuất và gộp các bản dịch i18n trong một bước duy nhất.
Angular i18n CLI
CLI tool to simplify Angular i18n configuration and locale management.
Làm việc với văn bản được đánh dấu
Tìm hiểu về các tính năng i18n nâng cao như số nhiều và lựa chọn.
Quy trình dịch thuật
Dự đoán
Trước khi thực hiện dịch, bạn có thể ước lượng quy mô và độ phức tạp của nhiệm vụ:
- Chọn kho lưu trữ mà bạn muốn làm việc cùng
- Nhấp vào "Estimate" để phân tích các tệp XLIFF của bạn
- Cấu hình các tùy chọn ước tính:
- Nhánh: Chọn nhánh chứa các tệp XLIFF của bạn
- Mẫu Tệp: Mặc định là "xlf" để tìm kiếm tất cả các tệp XLIFF. Sử dụng các mẫu cụ thể như "ru.xlf" để chỉ nhắm vào các tệp tiếng Nga.
- Trạng thái dịch: Chọn các đơn vị dịch nào để bao gồm (mặc định là "mới" để tập trung vào nội dung chưa dịch)
- Xem kết quả ước lượng hiển thị số lượng các đơn vị dịch cần xử lý
Tại sao ước lượng?
Quá trình ước lượng giúp bạn hiểu:
- Số lượng chính xác các đơn vị dịch cần xử lý
- Sẽ cần bao nhiêu tín chỉ (1 đơn vị dịch = 1 tín chỉ)
- Thời gian ước lượng cần thiết (mỗi đơn vị dịch mất khoảng 10-20 giây để xử lý)
Quan trọng: Các dự án dịch thuật lớn với hàng trăm đơn vị dịch có thể mất nhiều thời gian. Hãy lên kế hoạch cho phù hợp.
Dịch thuật
Chạy một bản dịch có hỗ trợ AI là một quy trình riêng biệt so với việc ước lượng:
- Chọn kho chứa tệp XLIFF của bạn
- Nhấp vào "Dịch" để bắt đầu quá trình
- Cấu hình các tùy chọn dịch:
- Branch: Chọn nhánh nguồn
- File Pattern: Chỉ định các tệp XLIFF nào cần dịch
- Translation State: Chọn các đơn vị dịch để xử lý (ví dụ: "mới", "cần dịch")
- Target State: Định nghĩa trạng thái mà bạn muốn đặt cho các đơn vị đã dịch (ví dụ: "đã dịch", "cuối cùng")
- Bắt đầu quá trình dịch
Bạn sẽ được đưa ra mô-đun tùy chọn dịch như đã trình bày trước đó trong phần "Chọn Kho lưu trữ".
Quy trình dịch thuật
Trong quá trình dịch, XLIFF Translator:
- Nhân bản kho dự án của bạn
- Nhận diện các tệp XLIFF phù hợp với mẫu của bạn
- Phân tích từng đơn vị dịch và ngữ cảnh của nó trong mã nguồn
- Gửi hướng dẫn dịch cho động cơ AI với ngữ cảnh liên quan
- Cập nhật các tệp XLIFF với các bản dịch
- Tạo một pull request với các thay đổi (nếu đã cấu hình)