binario/exampleSite/content/post/translation/index.md
vimux 8f25203787
Update exampleSite content
* Add featured image to "Translation Support" page
* Optimize featured-images/featured.png
* Rearrange pages by changing date (tricky, but simple way)
2019-09-24 11:24:36 -04:00

1.8 KiB

title description date tags featured
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-09-22
Translation
i18n
Hugo
alt previewOnly
Translation support true

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