Some articles are now offered in multiple languages
In the last few years I have been thinking about publishing at least some articles in English from time to time. So far, however, the technical implementation was too cumbersome for me. But with Hugo it’s done pretty easy, as I noticed today.
The first thing to do is to add the following entries to the configuration file config.toml.
DefaultContentLanguage = "de"
[languages]
[languages.de]
languageName = "Deutsche Version"
weight = 1
[languages.en]
languageName = "English version"
weight = 2
The first line specifies that de is the default language. The rest defines the existing languages, gives them a name and a weighting (the lower the more important).
Now we create a new article. Let’s just call the file manche-artikel-nun-englisch.md. Let’s assume that the article is important enough to be published in English as well. So we create another article and name the file manche-artikel-nun-englisch.en.md. As you can see the title has been extended by a .en. Hugo now automatically understands that the article with .en is the English version and the other one is the German version.
But what if someone opens the German version but doesn’t understand German? There should be a kind of switch available. For this one can use for example the following code.
{{ if .IsTranslated }}
{{ range .Translations }} | {{ .Language.LanguageName }} {{ end}}
{{ end }}
This checks whether the article is also available in another language. If so, a link to the corresponding versions will be shown. If not, nothing is displayed. I put this code on fryboyter.de under the main heading of all articles. If the link “English version” appears at an article, I wrote the article in English as well. Currently one will find this link only at this article for the moment. Gradually there will be more articles in German and English (also older ones) available.
These articles could also be interesting:
- Fryboyter is now generated with Hugo
- Hugo - Remove content from sitemap
- Update Hugo
- Insert date in Sublime Text
- Switched to Complete Feed