Cấu hình i18n cho Overleaf
Tài liệu này mô tả cách cấu hình quốc tế hóa (i18n) cho một phiên bản Overleaf tự triển khai.
- Chạy phiên bản Overleaf của mình với một ngôn ngữ cố định duy nhất, hoặc
- Bật nhiều ngôn ngữ, cho phép người dùng chuyển đổi ngôn ngữ một cách linh hoạt, tương tự như
www.overleaf.com.
Cấu hình một ngôn ngữ
Ngôn ngữ của trang được cấu hình bằng biến môi trườngOVERLEAF_SITE_LANGUAGE.
Các mã ngôn ngữ được hỗ trợ bao gồm:
en- Tiếng Anh (mặc định)es- Tiếng Tây Ban Nhapt- Tiếng Bồ Đào Nhade- Tiếng Đứcfr- Tiếng Phápcs- Tiếng Sécnl- Tiếng Hà Lansv- Tiếng Thụy Điểnit- Tiếng Ýtr- Tiếng Thổ Nhĩ Kỳzh-CN- Tiếng Trung (giản thể)no- Tiếng Na Uyda- Tiếng Đan Mạchru- Tiếng Ngako- Tiếng Hànja- Tiếng Nhậtpl- Tiếng Ba Lanfi- Tiếng Phần Lan
config/variables.env:
config/variables.env
Cấu hình nhiều ngôn ngữ
Để cho phép người dùng chuyển đổi ngôn ngữ mà không cần đăng xuất, phiên bản Overleaf của bạn phải được cấu hình để phục vụ các ngôn ngữ khác nhau dựa trên tên miền. Phần này giả định rằng:- Tên miền chính của bạn là
overleaftest.com - Bạn có một chứng chỉ TLS wildcard (ví dụ:
*.overleaftest.com) - Bạn không sử dụng
localhost(vì nó không hỗ trợ định tuyến ngôn ngữ dựa trên tên miền con)
dev-overleaf.com.
1
Cấu hình TLS Proxy (Nginx)
TLS reverse proxy của bạn phải chuyển tiếp header Dưới đây là một ví dụ cấu hình Nginx:
Host gốc để Overleaf có thể xác định người dùng đã truy cập tên miền ngôn ngữ nào.Hãy đảm bảo có chỉ thị sau:2
Cấu hình Cookie Domain
Để tránh việc người dùng bị đăng xuất khi chuyển đổi ngôn ngữ, cookie phải được chia sẻ giữa các tên miền con ngôn ngữ.Thêm dòng sau vào Điều này đảm bảo rằng cookie xác thực có hiệu lực cho tất cả các tên miền con thuộc
config/variables.env:config/variables.env
overleaftest.com.3
Ánh xạ ngôn ngữ – tên miền
Tiếp theo, xác định cách các mã ngôn ngữ được ánh xạ tới tên miền con bằng
Với cấu hình này:
OVERLEAF_LANG_DOMAIN_MAPPING.Ví dụ cấu hình
config/variables.env
https://www.overleaftest.com→ Giao diện tiếng Anhhttps://cn.overleaftest.com→ Giao diện tiếng Trung giản thể
4
Chuyển hướng tên miền gốc (apex)
Cuối cùng, chuyển hướng tên miền gốc (
overleaftest.com) đến tên miền ngôn ngữ mặc định (www.overleaftest.com).Hỏi & Đáp
Nút chuyển đổi ngôn ngữ nằm ở đâu?
Nút chuyển đổi ngôn ngữ nằm ở đâu?
Trả lời: Nút ngôn ngữ (biểu tượng dịch) nằm ở chân trang, ví dụ ở cuối danh sách dự án. Nút này không hiển thị trong trình soạn thảo.Nút chỉ xuất hiện khi
OVERLEAF_LANG_DOMAIN_MAPPING ánh xạ từ hai ngôn ngữ trở lên, như mô tả trong Cấu hình nhiều ngôn ngữ. Khi chỉ đặt OVERLEAF_SITE_LANGUAGE, toàn bộ trang dùng một ngôn ngữ đó và không có nút nào.Việc chọn một ngôn ngữ sẽ mở cùng trang đó trên tên miền của ngôn ngữ tương ứng, ví dụ cn.overleaftest.com. Lựa chọn này không được lưu thành cài đặt người dùng.Tại sao một ngôn ngữ trong bộ chọn lại mở http://127.0.0.1:3000?
Tại sao một ngôn ngữ trong bộ chọn lại mở http://127.0.0.1:3000?
Trả lời:
OVERLEAF_LANG_DOMAIN_MAPPING không có khóa www. Ánh xạ này được hợp nhất vào ánh xạ mặc định, vốn có một mục www cho tiếng Anh với địa chỉ nội bộ http://127.0.0.1:3000. Nếu ánh xạ của bạn chỉ dùng các khóa khác, chẳng hạn cn và en, mục mặc định đó sẽ được giữ lại và xuất hiện trong bộ chọn.Hãy thêm khóa www với địa chỉ của OVERLEAF_SITE_URL, bỏ mục thứ hai cho cùng một ngôn ngữ, rồi chạy bin/up -d:
