Snipp được dịch bởi cộng đồng của mình, và chúng tôi rất mong nhận được sự giúp đỡ của bạn. Nếu bạn thông thạo một ngôn ngữ khác, bạn có thể cải thiện các bản dịch hiện có hoặc giúp đưa Snipp đến một ngôn ngữ mới. Hướng dẫn này bao quát mọi điều bạn cần.
Những đóng góp có ý nghĩa giúp bạn nhận huy hiệu Người dịch thuật độc quyền trên hồ sơ Snipp của mình.
Bạn cũng sẽ nhận vai trò Người dịch thuật trong máy chủ Discord của chúng tôi.
Những người đóng góp nhiều có thể nhận Snipp PLUS như một lời cảm ơn.
Nơi tốt nhất để bắt đầu là máy chủ Discord của chúng tôi, nơi những người dịch phối hợp, nhận ngôn ngữ và được trợ giúp. Hãy cho chúng tôi biết bạn muốn làm ngôn ngữ nào để tránh trùng lặp công sức.
Có hai cách để đóng góp bản dịch. Chọn cách phù hợp với bạn, bạn không cần dùng cả hai.
Lựa chọn dễ nhất. Dịch trực tiếp trên trình duyệt mà không cần kiến thức về JSON hay Git. Crowdin hiển thị từng chuỗi trong ngữ cảnh và xử lý định dạng giúp bạn. Được khuyến nghị cho hầu hết người dịch.
Mở CrowdinDành cho lập trình viên quen thuộc với Git. Chỉnh sửa trực tiếp các tệp JSON locale và mở một pull request. Tốt nhất nếu bạn muốn toàn quyền kiểm soát hoặc đang thêm một ngôn ngữ mới.
Mở kho lưu trữMỗi locale là một tệp JSON phẳng. Khóa là một ID ổn định và không bao giờ thay đổi. Giá trị là văn bản hiển thị cho người dùng, và đó là thứ duy nhất bạn dịch:
{
"SETTINGS_PREFS_AUTO_COMPRESSION_LABEL": "Automatic Compression",
"SETTINGS_PREFS_PARTY_MODE_LABEL": "Party Mode"
}Tệp tiếng Anh là nguồn chuẩn. Mọi locale khác đều có chính xác cùng bộ khóa, nên bạn chỉ thay đổi các giá trị.
Không bao giờ thêm, xóa hoặc đổi tên khóa. Khóa mới đến từ mã nguồn của Snipp. Nếu một khóa bị thiếu trong locale của bạn, trang web sẽ quay về tiếng Anh.
Giữ nguyên các placeholder. Văn bản như {count} hoặc {username} được thay thế khi chạy. Giữ chính xác các placeholder giống nhau, dù bạn có thể di chuyển chúng để phù hợp với trật tự từ trong ngôn ngữ của bạn.
Tuân theo quy ước viết hoa. Các nhãn UI ngắn dùng Viết Hoa Đầu Mỗi Từ trong mọi ngôn ngữ. Các câu đầy đủ dùng cách viết hoa câu thông thường cho ngôn ngữ của bạn.
Không dịch các token thương hiệu hoặc kỹ thuật. Giữ nguyên Snipp, Discord, ShareX, URL, API, PLUS và các phần mở rộng tệp.
Giữ JSON hợp lệ. Dùng dấu ngoặc kép, một dấu phẩy sau mỗi mục trừ mục cuối, và không có dấu phẩy thừa ở cuối.
Giữ nguyên khoảng trắng ở đầu và cuối nếu một giá trị có chúng. Chúng là cố ý và được dùng để nối các câu.
Nếu bạn chọn cách GitHub, đây là quy trình. Người dịch trên Crowdin có thể bỏ qua phần này, các thay đổi của bạn được gửi từ trong Crowdin.
Các bản dịch được gửi qua kho i18n trên GitHub theo quy trình fork-và-pull-request chuẩn:
Fork kho lưu trữ, sau đó clone bản fork của bạn và tạo một nhánh mới cho thay đổi của bạn.
Chỉnh sửa tệp locale cho ngôn ngữ của bạn và dịch các giá trị bạn muốn cải thiện.
Chạy script kiểm tra từ thư mục gốc của kho và sửa mọi thứ nó báo cáo trước khi gửi.
Commit, push lên bản fork của bạn và mở một pull request vào nhánh chính. Người bảo trì sẽ xem xét và hợp nhất.
Không thích dùng dòng lệnh? Trình chỉnh sửa web của GitHub cũng hoạt động. Mở tệp locale, nhấp vào biểu tượng bút chì, chỉnh sửa và đề xuất thay đổi của bạn.
Snipp chưa hỗ trợ ngôn ngữ của bạn? Hãy mở một issue trên GitHub đề xuất ngôn ngữ và mã locale của nó, sao chép tệp nguồn tiếng Anh làm điểm khởi đầu, dịch mọi giá trị và mở một pull request. Người bảo trì sẽ đăng ký locale mới trên trang web.
Tham gia máy chủ Discord của chúng tôi để nhận một ngôn ngữ, gặp gỡ những người dịch khác và bắt đầu.