Multilingual Mode

Doks is fully prepared for multilingual and i18n support.

On this page

Demo

  • Available soon

Configuration

Enable

In ./config/_default/params.toml, enable Multilinguage Mode:

  1. [options]
  2.   ..
  3.   multilingualMode = true
  4.   ..

Set languages

In ./config/_default/config.toml, set languages:

  1. # Multilingual
  2. defaultContentLanguage = "en"
  3. disableLanguages = ["de", "nl"]
  4. # defaultContentLanguageInSubdir = true

Set language settings

In ./config/_default/languages.toml, set language settings (for each language):

  1. [en]
  2.   languageName = "English"
  3.   contentDir = "content/en"
  4.   weight = 10
  5.   [en.params]
  6.     languageISO = "EN"
  8. [de]
  9.   languageName = "German"
  10.   contentDir = "content/de"
  11.   weight = 15
  12.   [de.params]
  13.     languageISO = "DE"

Set menu entries

In ./config/_default/menus/menus.<ISO country code lowercase>.toml (so, e.g. in ./config/_default/menus/menus.en.toml), set menu entries (for each language).

Set translation strings

In ./i18n/<ISO country code lowercase>.toml (so, e.g. in ./i18n/en.toml), set translation strings (for each language).

Add content

In ./content.<ISO country code lowercase>/ (so, e.g. in ./content/en/), add content (for each language).

Build content

The content is build automatically with npm run start or npm run build.

  1. ..
  2. Start building sites …
  3. hugo v0.88.1-5BC54738+extended windows/amd64 BuildDate=2021-09-04T09:39:19Z VendorInfo=gohugoio
  5.                    | EN | DE | NL
  6. -------------------+----+----+-----
  7.   Pages            | 29 |  7 | 24
  8.   Paginator pages  |  0 |  0 |  0
  9.   Non-page files   |  1 |  0 |  0
  10.   Static files     | 89 | 89 | 89
  11.   Processed images |  0 |  0 |  0
  12.   Aliases          |  2 |  0 |  0
  13.   Sitemaps         |  2 |  1 |  1
  14.   Cleaned          |  0 |  0 |  0
  16. Built in 985 ms
  17. ..

Switch content

Multilingual Support

The language switch is part of the global navigation (available on all pages).

  • If the current page is available in the newly selected language, the corresponding page in the newly selected language is shown.
  • If the current page is not available in the newly selected language, the homepage of the newly selected language is shown.

Resources