Updates section navigation

[h-enk]

Summary

Brief explanation of the proposed changes.

• Sidebar
• Auto generate section menu (default), or
• Configure section menu (partly automated):

[[sidebar_docs]]
  name = "Start here"
  pageRef = "/docs/start-here"
  weight = 10

[[sidebar_docs]]
  name = "Guides"
  pageRef = "/docs/guides"
  weight = 20

[[sidebar_docs]]
  name = "Reference"
  pageRef = "/docs/reference"
  weight = 30

Sections are not collapsed (default), override per section in the frontmatter of the section's _index.md:

---
sidebar:
  collapsed: true
---

Works with:

pnpm run create --kind docs guides

Basic example

Include a basic example, screenshots, or links.

Motivation

Why are we doing this? What use cases does it support? What is the expected outcome?

More robust, simplified, and powerful code with more features and easier expandability possibilities for for example badges, icons, and target attribute.

Checks

• Read Create a Pull Request
• Supports all screen sizes (if relevant)
• Supports both light and dark mode (if relevant)
• Passes npm run test

[kosssi]

Maybe I don't have understand but this parameter is not used site.Params.doks.menu.section.collapsibleSidebar?

[h-enk]

Correct. Now, when no sidebar_<section> menu entries are found, Doks automatically generates a sidebar based on the filesystem structure of your documentation — no parameter needed. The new setup is a lot smarter and more robust.

[kosssi]

Thanks for your response, I don't understand how can I get the same design like this (without colapse) before this commit :

not like this (last version)

I don't want colapse menu ;)

[kosssi]

I understand my issue better. This commit changes the design since it is no longer possible to have a menu without <details> without overload the layout, if I'm not mistaken?

Before sidebar/auto-default-menu.html allowed it ;)

[h-enk]

Yes, that's correct. So. if you'd like to keep the old design you could copy https://github.com/gethyas/doks-core/blob/v1.3.0/layouts/partials/sidebar/auto-default-menu.html and paste as layouts/partials/sidebar/section-menu.html

And, make sure to check/update for the old styling — add overrides in assets/scss/common/_custom.scss

[h-enk]

Or, you could override the new render method https://github.com/gethyas/doks-core/blob/v1.4.1/layouts/partials/sidebar/render-section-menu.html and strip out the details-summary part

[kosssi]

I don't want to deviate too much from Doks otherwise it will complicate the update.

I especially wanted you to be aware if you hadn't seen the problem ;)

[h-enk]

I understand that — thanks