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
Danish
Dutch
English
Finnish
French
German
Hindi
Hungarian
Indonesian
Italian
Japanese
Korean
Persian
Polish
Portuguese
Romanian
Russian
Spanish
Swahili
Turkish
Ukrainian
Vietnamese

Translat'n by File Name

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

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
      }
   }
}

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.

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
      }
   }
}

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.

If ye want t' have more control, whar' th' language switcher be positioned or ye want t' configure a different ay'con, see th' chapter on sidebar configurat'n.

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

hugo.

[params]
  disableLanguageSwitchingButton = true

params:
  disableLanguageSwitchingButton: true

{
   "params": {
      "disableLanguageSwitchingButton": true
   }
}