Multilingual

Th' Relearrrn theme works wit' Hugo’s multilingual mode.

It supports many languages, includ'n 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

Translat'n by File Name

Here’s how t' make yer ship multilingual us'n translat'ns by file name:

  1. Set up languages 'n yer hugo.toml file:

    hugo.
    defaultContentLanguage = 'en'

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

  [languages.pir]
    languageCode = 'art-x-pir'
    languageDirect'n = '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
    languageDirect'n: 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 yer rrrambl'n files an' add language codes t' their file names:

    ├── rrrambl'n
│   ├── 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

Translat'n by Rrrambl'n Directory

Th' theme also support translat'ns by rrrambl'n directory which can be configured 'n a similar way.

  1. Set up languages 'n yer 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'
    languageDirect'n = '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
    languageDirect'n: 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 yer rrrambl'n files into separate directories named by their language code:

    ├── rrrambl'n
│   ├── 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 Sett'ns

Check th' search configurat'n fer multilingual opt'ns.

Turn Off Language Switch'n

Opt'n By default th' theme shows a language switcher 'n th' lower part o' th' menu.

T' dis'ble th' language switcher set disableLanguageSwitchingButton=true

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