binario/exampleSite/content/post/translation.md
2019-01-16 14:15:51 -05:00

1.7 KiB

title description date tags
Translation Support With Hugo i18n possibilities, you can easily have a website in your language. This article explains how to translate and change language in Hugo's generated site. 2019-01-12
Translation
i18n
Hugo

With Hugo i18n possibilities, you can easily have a website in your language. This Hugo theme is ready to be translated into other languages. You can create a special file that contains translated text to show the visitor instead of English.

Translating the Theme

  1. Create a folder named /i18n/ in your Hugo site's root
  2. Create a file <LANG-CODE>.yaml inside /i18n folder. Language files <LANG-CODE>.yaml should be named according to RFC 5646 with names such as en-US.yaml, fr.yaml, de.yaml, etc.
  3. Copy a reference template to your translation from <THEME>/i18n/en.yaml file
  4. Translate all available translation strings into chosen language

For example, to create German translation, create a file /i18n/de.yaml in the folder of your Hugo site, copy reference template from <THEME>/i18n/en.yaml file and translate all available translation strings.

Changing Site Language in Hugo

To use the translations, just set a correct value for defaultContentLanguage in site config file:

{{< highlight toml >}} defaultContentLanguage = "en" # de / fr / other lang code... {{< /highlight >}}

In other words, this field determines which i18n file to use.

Contributing Translation

If you want to upload your translation in the theme master repository, feel free to create a pull request.

More Information