# Language With the help of contributors, templates are localized into more than 60 languages, making it easy to create documentation sites in your preferred language. ## Configuration ### Site language You can set the site language in your configuration file with: ```toml [project.theme] language = "en" ``` ```yaml theme: language: en ``` HTML5 only allows to set a [single language per document](), which is why Zensical only supports setting a canonical language for the entire project. The following languages are supported: 1. 🇿🇦 **Afrikaans** `af` Complete 2. 🇦🇱 **Albanian** `sq` Complete 3. 🇦🇪 **Arabic** `ar` Complete 4. 🇦🇲 **Armenian** `hy` Complete 5. 🇦🇿 **Azerbaijani** `az` Complete 6. 🇲🇾 **Bahasa Malaysia** `ms` Complete 7. 🇪🇸 **Basque** `eu` Complete 8. 🇧🇾 **Belarusian** `be` Complete 9. 🇧🇩 **Bengali (Bangla)** `bn` Complete 10. 🇧🇬 **Bulgarian** `bg` Complete 11. 🇲🇲 **Burmese** `my` [27 translations missing]() 12. 🇪🇸 **Catalan** `ca` Complete 13. 🇨🇳 **Chinese (Simplified)** `zh` Complete 14. 🇹🇼 **Chinese (Taiwanese)** `zh-TW` Complete 15. 🇨🇳 **Chinese (Traditional)** `zh-Hant` Complete 16. 🇭🇷 **Croatian** `hr` Complete 17. 🇨🇿 **Czech** `cs` Complete 18. 🇩🇰 **Danish** `da` Complete 19. 🇳🇱 **Dutch** `nl` Complete 20. 🇺🇸 **English** `en` Complete 21. 🇪🇺 **Esperanto** `eo` Complete 22. 🇪🇪 **Estonian** `et` Complete 23. 🇫🇮 **Finnish** `fi` Complete 24. 🇫🇷 **French** `fr` Complete 25. 🇪🇸 **Galician** `gl` Complete 26. 🇬🇪 **Georgian** `ka` [27 translations missing]() 27. 🇩🇪 **German** `de` Complete 28. 🇬🇷 **Greek** `el` Complete 29. 🇮🇱 **Hebrew** `he` Complete 30. 🇮🇳 **Hindi** `hi` Complete 31. 🇭🇺 **Hungarian** `hu` Complete 32. 🇮🇸 **Icelandic** `is` Complete 33. 🇮🇩 **Indonesian** `id` Complete 34. 🇮🇹 **Italian** `it` Complete 35. 🇯🇵 **Japanese** `ja` Complete 36. 🇮🇳 **Kannada** `kn` Complete 37. 🇰🇷 **Korean** `ko` Complete 38. 🇮🇶 **Kurdish (Soranî)** `ku-IQ` [13 translations missing]() 39. 🇱🇻 **Latvian** `lv` Complete 40. 🇱🇹 **Lithuanian** `lt` Complete 41. 🇱🇺 **Luxembourgish** `lb` Complete 42. 🇲🇰 **Macedonian** `mk` Complete 43. 🇲🇳 **Mongolian** `mn` Complete 44. 🇳🇴 **Norwegian Bokmål** `nb` Complete 45. 🇳🇴 **Norwegian Nynorsk** `nn` Complete 46. 🇮🇷 **Persian (Farsi)** `fa` Complete 47. 🇵🇱 **Polish** `pl` Complete 48. 🇵🇹 **Portuguese** `pt` Complete 49. 🇧🇷 **Portuguese (Brasilian)** `pt-BR` Complete 50. 🇷🇴 **Romanian** `ro` Complete 51. 🇷🇺 **Russian** `ru` Complete 52. 🇮🇳 **Sanskrit** `sa` Complete 53. 🇷🇸 **Serbian** `sr` Complete 54. 🇷🇸 **Serbo-Croatian** `sh` Complete 55. 🇱🇰 **Sinhalese** `si` [25 translations missing]() 56. 🇸🇰 **Slovak** `sk` Complete 57. 🇸🇮 **Slovenian** `sl` Complete 58. 🇪🇸 **Spanish** `es` Complete 59. 🇸🇪 **Swedish** `sv` Complete 60. 🇵🇭 **Tagalog** `tl` [3 translations missing]() 61. 🇮🇳 **Tamil** `ta` Complete 62. 🇮🇳 **Telugu** `te` Complete 63. 🇹🇭 **Thai** `th` Complete 64. 🇹🇷 **Turkish** `tr` Complete 65. 🇺🇦 **Ukrainian** `uk` Complete 66. 🇵🇰 **Urdu** `ur` Complete 67. 🇺🇿 **Uzbek** `uz` Complete 68. 🇻🇳 **Vietnamese** `vi` Complete 69. 🏴󠁧󠁢󠁷󠁬󠁳󠁿 **Welsh** `cy` Complete ### Site language selector If your documentation is available in multiple languages, a language selector pointing to those languages can be added to the header. Alternate languages can be defined via configuration: ```toml [project.extra] alternate = [ { name = "English", link = "/en/", lang = "en" }, { name = "Deutsch", link = "/de/", lang = "de" }, ] ``` ```yaml extra: alternate: - name: English link: /en/ # (1)! lang: en - name: Deutsch link: /de/ lang: de ``` The following properties are required for each alternate language: **`alternate.name`** This value of this property is used inside the language selector as the name of the language and must be set to a non-empty string. **`alternate.link`** This property must be set to an absolute link, which might also point to another domain or subdomain not necessarily generated with Zensical. If it includes a domain part, it's used as defined. Otherwise the domain part of the [`site_url`]() as set in your configuration is prepended to the link. **`alternate.lang`** This property must contain an [ISO 639-1 language code]() and is used for the `hreflang` attribute of the link, improving discoverability via search engines. ### Directionality While many languages are read `ltr` (left-to-right), Zensical also supports `rtl` (right-to-left) directionality which is deduced from the selected language, but can also be set with: ```toml [project.theme] direction = "ltr" ``` ```yaml theme: direction: ltr ``` Click on a tile to change the directionality: `ltr` `rtl` ## Customization ### Custom translations If you want to customize some of the translations for a language, just follow the guide on [theme extension]() and create a new partial in the `overrides` folder. Then, import the [translations]() of the language as a fallback and only adjust the ones you want to override: ```html {% import "partials/languages/de.html" as language %} {% import "partials/languages/en.html" as fallback %} {% macro override(key) %}{{ { "source.file.date.created": "Erstellt am", "source.file.date.updated": "Aktualisiert am" }[key] }}{% endmacro %} {% macro t(key) %}{{ override(key) or language.t(key) or fallback.t(key) }}{% endmacro %} ``` 1. Note that `en` must always be used as a fallback language, as it's the default theme language. 2. Check the [list of available languages](), pick the translation you want to override for your language and add them here. ```toml [project.theme] language = "custom" ``` ```yaml theme: language: custom ```