hugo-theme-relearn/docs/content/configuration/sitemanagement/multilingual/_index.en.md

+++ categories = ["howto"] description = "How to set up a multilingual site" options = ["disableLanguageSwitchingButton"] title = "Multilingual" weight = 2 +++

The Relearn theme works with Hugo's multilingual mode.

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

{{% expand "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 {{% /expand %}}

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:

   {{< multiconfig file=hugo >}} defaultContentLanguage = 'en'

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

   [languages.pir] weight = 2 languageName = 'Pirrratish' languageCode = 'art-x-pir' languageDirection = 'rtl' title = 'Arrr, my Website' {{< /multiconfig >}}

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:

   {{< multiconfig file=hugo >}} defaultContentLanguage = 'en'

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

   [languages.pir] weight = 2 languageName = 'Pirrratish' languageCode = 'art-x-pir' languageDirection = 'rtl' contentDir = 'content/pir' title = 'Arrr, my Website' {{< /multiconfig >}}

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

{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} By default the theme shows a language switcher in the lower part of the menu.

To disable the language switcher set disableLanguageSwitchingButton=true

{{< multiconfig file=hugo >}} [params] disableLanguageSwitchingButton = true {{< /multiconfig >}}