initial commit

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

@@ -0,0 +1,155 @@
++++
+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
+- 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.
+
+To disable the language switcher set `disableLanguageSwitchingButton=true`
+
+{{< multiconfig file=hugo >}}
+[params]
+  disableLanguageSwitchingButton = true
+{{< /multiconfig >}}

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

@@ -0,0 +1,8 @@
++++
+categories = ["howto"]
+description = "How to set up a multilingual site"
+options = ["disableLanguageSwitchingButton"]
+title = "Multilingual"
+weight = 2
++++
+{{< piratify >}}