Bản địa hóa chủ đề
Hiển thị chủ đề bằng ngôn ngữ bạn muốn.
Ghi chú
Bản địa hóa chủ đề chỉ dịch các thành phần văn bản của chính chủ đề (chẳng hạn như liên kết "tiếp theo" và "trước đó"), chứ không phải nội dung thực tế của tài liệu của bạn. Nếu bạn muốn tạo tài liệu đa ngôn ngữ, bạn cần kết hợp bản địa hóa chủ đề như mô tả ở đây với plugin quốc tế hóa/bản địa hóa của bên thứ ba.
Cài đặt
Để bản địa hóa chủ đề có hiệu quả, bạn phải sử dụng một chủ đề hỗ trợ nó và bật i18nhỗ trợ (quốc tế hóa) bằng cách cài đặt mkdocs[i18n]:
pip install 'mkdocs[i18n]'
Ngôn ngữ được hỗ trợ
Trong hầu hết các trường hợp, một địa phương được chỉ định bằng chữ viết tắt ISO-639-1 (2 chữ cái) cho ngôn ngữ của bạn. Tuy nhiên, một địa phương cũng có thể bao gồm mã lãnh thổ (hoặc vùng hoặc quận). Ngôn ngữ và lãnh thổ phải được phân tách bằng dấu gạch dưới. Ví dụ, một số địa phương có thể có cho tiếng Anh có thể bao gồm en, en_AU, en_GB, và en_US.
Để biết danh sách các ngôn ngữ được chủ đề bạn đang sử dụng hỗ trợ, hãy xem tài liệu của chủ đề đó.
Cảnh báo
Nếu bạn cấu hình ngôn ngữ địa phương chưa được chủ đề bạn đang sử dụng hỗ trợ, MkDocs sẽ trở về ngôn ngữ địa phương mặc đ ịnh của chủ đề đó.
Cách sử dụng
Để chỉ định ngôn ngữ mà MkDocs nên sử dụng, hãy đặt tham số ngôn ngữ của tùy chọn cấu hình chủ đề thành mã thích hợp.
Ví dụ, để xây dựng mkdocschủ đề bằng tiếng Pháp, bạn sẽ sử dụng nội dung sau trong mkdocs.ymltệp cấu hình của mình:
theme: name: mkdocs locale: fr
Đóng góp bản dịch chủ đề
Nếu chủ đề chưa được dịch sang ngôn ngữ của bạn, bạn có thể đóng góp bản dịch bằng cách sử dụng Hướng dẫn dịch .