Are there any best practices for bilingual documentation? Or will a section on bilingual practices be added to the documentation in the future?

[Fengzdadi]

I'm trying to make my blog bilingual, but I've run into tons of problems.
For instance, I'm following Hugo's multilingual guide, but I keep encountering minor issues when implementing it in my stack. One example: my menu includes a “Photo” option. It works perfectly in the English environment, but in the zh-cn environment, clicking it fails to redirect, and the photo doesn't load correctly either. I'm not sure if there's an issue with how I wrote the TOML:

[[languages.en.menu.main]]
identifier = “photos”
name = “Photos”
pageRef = “/photos”
weight = 5
[languages.en.menu.main.params]
icon = “photo”

Everything else works fine (though similar issues cropped up earlier too—no clue how they magically resolved themselves LOL).

[CaiJimmy]

Shouldn't it be languages.zh-cn.menu.main.params? I'm not sure if that's the issue here.

[Fengzdadi]

sorry about that; I pasted the wrong code

# Only here is there a problem
[[languages.zh-cn.menu.main]]
identifier = 'photos'
name = '照片'
pageRef = '/photos'          
weight = 5
[languages.zh-cn.menu.main.params]
icon = "photo"

# This part is correct
[[languages.zh-cn.menu.main]]
identifier = "about"
name = "关于我"
pageRef = "/about"        
weight = 6
[languages.zh-cn.menu.main.params]
icon = "user"

The English segment is functional, but the Chinese segment is generating invalid clicks.

What's even stranger is that all other Chinese segments are correct—only this one is problematic.

So I feel strange as well, so I want to find a good practice that can help me to build up!

[Fengzdadi]

It's kind of like it's OK when i rename _index.md to index.md. Do you know what happened?
I think I should use _index.md here, maybe is it because there are no layout parameters like “photos” or “gallery”?

[CaiJimmy]

The correct filename should be index.md, because you are creating a new page called archives, and archives/index.md is the file that defines this page bundle.

_index.md is a special type of file used in Hugo for pages like sections. (See https://gohugo.io/content-management/organization/#index-pages-_indexmd)