Docs Menu Sorting Broke

[CaiB]

Hello!

I'm trying to update my website from Doks 0.1.2 to the latest (0.4.3), however I'm encountering an issue with the docs pages left navigation sidebar. It appears to have lost its sorting after the update. I copied the content and menu.toml over directly, so I expected it'd keep that, but on the new version the sorting seems somewhat random, and is different in different languages (but it's not alphabetic).

E.g. from config/_default/menus/menus.en.toml:

[[docs]]
  name = "General"
  weight = 10
  identifier = "general"
  url = "/docs/general/"

[[docs]]
  name = "Sources"
  weight = 50
  identifier = "sources"
  url = "/docs/sources/"

[[docs]]
  name = "Controllers"
  weight = 90
  identifier = "controllers"
  url = "/docs/controllers/"

...

Result:

I couldn't find any information on a new way to do this, did something change I need to adapt to?

[roheclassic]

Basically, the order in which the doc menus appear is controlled by each content file (index.md, _index.md).
menu.toml controls the order of the menu list at the top of the page.

How about adjusting weight of _index.md under general,sources,controllers?

[CaiB]

Hmm, the docs say that the way I'm doing it is correct: https://getdoks.org/docs/how-to/pages-and-menus/menus/#add-to-docs-menu
I tried adding a weight value into the _index.md header, but that didn't seem to do anything.

[roheclassic]

What's the following parameter in params.toml?
(It is true by default in v.0.4.3, and Auto generated menus feature works.)

[menu]
  [menu.section]
    auto = true     <------*
    collapsibleSidebar = true

If it is true, you can change it to false, and it maybe works as expected.
(Sorry if it's wrong. I'm not familiar with the behavior of older versions.)

[roheclassic]

Or, this problem maybe related to #596, #601.
(It's identifier mismatch between menus.toml and index.md, etc.)

[CaiB]

Setting auto = false in params.toml under [menu.section] fixed the issue, and it's now working as expected. Thank you!

I'd recommend adding a quick mention of that setting on the above doc page to hopefully prevent people from missing that setting in the future :)