Multilingual

The Relearn theme works with Hugo’s multilingual mode.

It supports many languages, including right-to-left languages.

Supported languages
  • Arabic
  • Simplified Chinese
  • Traditional Chinese
  • Czech
  • Dutch
  • English
  • Finnish
  • French
  • German
  • Hindi
  • Hungarian
  • Indonesian
  • Italian
  • Japanese
  • Korean
  • Persian
  • Polish
  • Portuguese
  • Romanian
  • Russian
  • Spanish
  • Swahili
  • Turkish
  • Vietnamese

Translation by File Name

Here’s how to make your site multilingual using translations by file name:

  1. Set up languages in your hugo.toml file:

    hugo.
    defaultContentLanguage = 'en'

[languages]
  [languages.en]
    languageCode = 'en'
    languageName = 'English'
    title = 'My Website'
    weight = 1

  [languages.pir]
    languageCode = 'art-x-pir'
    languageDirection = 'rtl'
    languageName = 'Pirrratish'
    title = 'Arrr, my Website'
    weight = 2
    defaultContentLanguage: en
languages:
  en:
    languageCode: en
    languageName: English
    title: My Website
    weight: 1
  pir:
    languageCode: art-x-pir
    languageDirection: rtl
    languageName: Pirrratish
    title: Arrr, my Website
    weight: 2
    {
   "defaultContentLanguage": "en",
   "languages": {
      "en": {
         "languageCode": "en",
         "languageName": "English",
         "title": "My Website",
         "weight": 1
      },
      "pir": {
         "languageCode": "art-x-pir",
         "languageDirection": "rtl",
         "languageName": "Pirrratish",
         "title": "Arrr, my Website",
         "weight": 2
      }
   }
}

  2. Duplicate your content files and add language codes to their file names:

    ├── content
│   ├── log
│   │   ├── first-day
|   |   |   ├── _index.en.md
|   |   |   └── _index.pir.md
│   │   ├── second-day
|   |   |   ├── index.en.md
|   |   |   └── index.pir.md
│   │   ├── third-day.en.md
│   │   ├── third-day.pir.md
│   │   ├── _index.en.md
│   │   └── _index.pir.md
│   ├── _index.en.md
│   └── _index.pir.md
├── themes
│   └── hugo-theme-relearn
│       └── ...
└── hugo.toml

Translation by Content Directory

The theme also support translations by content directory which can be configured in a similar way.

  1. Set up languages in your hugo.toml file:

    hugo.
    defaultContentLanguage = 'en'

[languages]
  [languages.en]
    contentDir = 'content/en'
    languageCode = 'en'
    languageName = 'English'
    title = 'My Website'
    weight = 1

  [languages.pir]
    contentDir = 'content/pir'
    languageCode = 'art-x-pir'
    languageDirection = 'rtl'
    languageName = 'Pirrratish'
    title = 'Arrr, my Website'
    weight = 2
    defaultContentLanguage: en
languages:
  en:
    contentDir: content/en
    languageCode: en
    languageName: English
    title: My Website
    weight: 1
  pir:
    contentDir: content/pir
    languageCode: art-x-pir
    languageDirection: rtl
    languageName: Pirrratish
    title: Arrr, my Website
    weight: 2
    {
   "defaultContentLanguage": "en",
   "languages": {
      "en": {
         "contentDir": "content/en",
         "languageCode": "en",
         "languageName": "English",
         "title": "My Website",
         "weight": 1
      },
      "pir": {
         "contentDir": "content/pir",
         "languageCode": "art-x-pir",
         "languageDirection": "rtl",
         "languageName": "Pirrratish",
         "title": "Arrr, my Website",
         "weight": 2
      }
   }
}

  2. Duplicate your content files into separate directories named by their language code:

    ├── content
│   ├── en
|   │   ├── log
|   │   │   ├── first-day
|   |   |   |   └── _index.md
|   │   │   ├── second-day
|   |   |   |   └── index.md
|   │   │   ├── third-day.md
|   │   │   └── _index.md
|   │   └── _index.md
│   ├── pir
|   │   ├── log
|   │   │   ├── first-day
|   |   |   |   └── _index.md
|   │   │   ├── second-day
|   |   |   |   └── index.md
|   │   │   ├── third-day.md
|   │   │   └── _index.md
|   │   └── _index.md
|   ├── themes
|   │   └── hugo-theme-relearn
|   │       └── ...
|   └── hugo.toml

Search Settings

Check the search configuration for multilingual options.

Turn Off Language Switching

Option By default the theme shows a language switcher in the lower part of the menu.

To disable the language switcher set disableLanguageSwitchingButton=true

hugo.
[params]
  disableLanguageSwitchingButton = true
params:
  disableLanguageSwitchingButton: true
{
   "params": {
      "disableLanguageSwitchingButton": true
   }
}