Multi language configuration

[ahalma]

Describe the bug

I'm adapting the default hinode template to support multiple langues, but content does not show correctly. It must be a misconfiguration instead of a bug, but could use help to pinpoint it.

To reproduce

Steps to reproduce the behavior:

hugo.toml:

languageCode = "en-us"
defaultContentLanguage = "en"
defaultContentLanguageInSubdir = true

content:

content
├── en
│   ├── _index.md
│   └── about.md
└── nl
    ├── _index.md
    └── about.md

languages.toml:

[en]
languageName = "English"
contentDir = "content/en"
weight = 1
[en.params.head]
tagline = "My Project"
[en.params.social]
title = "Follow me"
caption = "The latest news"
[en.params.footer]
# license = "Licensed under Creative Commons (<a href='https://creativecommons.org/licenses/by-nc-sa/4.0/' class='link-secondary' target='_blank' rel='noopener noreferrer'>CC BY-NC-SA 4.0</a>)."

[nl]
languageName = "Nederlands"
contentDir = "content/nl"
languageCode = "nl"
weight = 2
[nl.params.head]
tagline = "Mijn Project"
[nl.params.social]
title = "Volg me"
caption = "Het laatste nieuws"
[nl.params.footer]

When starting the site, the language menu shows, but the content is from both languages.

And the Dutch page shows no content:

Expected behavior

Content separated by language.

Log file

                   | EN  | NL   
-------------------+-----+------
  Pages            |  18 |   6  
  Paginator pages  |   0 |   0  
  Non-page files   |   0 |   0  
  Static files     | 104 | 104  
  Processed images |  12 |   0  
  Aliases          |   6 |   0  
  Cleaned          |   0 |   0  

Built in 719 ms
Environment: "development"
Serving pages from disk
Web Server is available at http://localhost:1313/ (bind address 0.0.0.0) 

Host environment

Please complete the following information where applicable.

• Hinode version:v0.14.0
• Host OS: macOS Ventura 14.6.1
• Node version: v22.6.0
• @gethinode/[email protected]
• hugo v0.134.1

Hugo environment

Copy the output of hugo env or npm run env here.

> @gethinode/[email protected] env
> hugo env

hugo v0.134.1-2f89169baa87a9db47e288b60705f4e99e21a945+extended darwin/arm64 BuildDate=2024-09-05T10:17:50Z VendorInfo=gohugoio
GOOS="darwin"
GOARCH="arm64"
GOVERSION="go1.23.0"
github.com/sass/libsass="3.6.6"
github.com/webmproject/libwebp="v1.3.2"

[ahalma]

It seems the language paths are nested...

[markdumay]

Just by looking at the config, does it help if you delete the following line?

languageCode = "nl"

[ahalma]

I removed that line, but the problem remains...

Could it be related to #1134 ?
Then enableLanguageSelectionStorage could play a role...
I tried all permutations of the following parameters to explore if it solves the issue, but that is not the case unfortunately.

defaultContentLanguageInSubdir = true | false
enableLanguageSelectionStorage = true | false

[markdumay]

Does it help if you disable the content mount in hugo.toml?

[module]
  # [[module.mounts]]
  #   source = "content"
  #   target = "content"

[ahalma]

Yes! That improves the situation substantially!

The proper content is now available when selecting a language. Also the URLs make sense.

The menu items and the footer for the other language don't show, however.

English (correct):

Dutch (missing elements):

To be sure: I cloned the template and just added to /content. I did not provide translations in /i18n.

[markdumay]

Great! You will need to define the Dutch translations to get the menu and footer working.

You need to add entries for [nl] in languages.toml, similar to [en]:

[en]
    [en.params.social]
        title = "Follow me"
        caption = "The latest news"

Next you need to create a new file menus/menu.nl.toml, using menus/menu.en.toml as reference:

[[main]]
  name = "Home"
  pageRef = "/"
  weight = 10

[[main]]
  name = "Tags"
  pageRef = "/tags"
  weight = 20

[[social]]
  name = "LinkedIn"
  pre = "fab linkedin"
  url = "https://linkedin.com/"
  weight = 10

[[social]]
  name = "GitHub"
  pre = "fab fa-github"
  url = "https://github.com/"
  weight = 20

[[social]]
  name = "Medium"
  pre = "fab medium"
  url = "https://medium.com/"
  weight = 30

[ahalma]

That did the trick! I'm confident to embark on my Hinode adventure now. I owe you a beer!

[markdumay]

Enjoy the theme!

[markdumay]

I revised the documentation too - see https://gethinode.com/docs/configuration/languages/.