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](https://gohugo.io/content-management/multilingual/).

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

## Translation by File Name

Here's how to make your site multilingual using [translations by file name](https://gohugo.io/content-management/multilingual/#translation-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:

    ````plaintext
    ├── 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](https://gohugo.io/content-management/multilingual/#translation-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:

    ````plaintext
    ├── 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](configuration/sidebar/search#mixed-language-support) 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.

If you want to have more control, where the language switcher is positioned or you want to configure a different icon, see the [chapter on sidebar configuration](configuration/sidebar/menus#defining-sidebar-menus).

To disable the language switcher set `disableLanguageSwitchingButton=true`

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