✨ Enhancement: Special sidebar behaviour for pages for pages without sidebar item

[benjagm]

Is your feature request related to a problem? Please describe

We have some pages without sidebar item that needs to be shown, however when we show those pages it results in a sidebar with all sections collapsed. For example, the page https://json-schema.org/md-style-guide produces:

This is not ideal and we would like to find a better way to interact with the sidebar for those pages.

Describe the solution you'd like

Ideally, we'd like to define a new property in the header metadata in the page markdown to specify the parent page to be highlighted in the sidebar.

For example, if we define this new property as parentNav adding the relative path for a page without sidebar item like https://json-schema.org/md-style-guide:

---
title: Markdown Style Guide
parentNav: /overview/what-is-jsonschema
---

The expected result is to highlight /overview/what-is-jsonschema in the sidebar when accessing that page. See image below:

Describe alternatives you've considered

I think this will require:

• Define the new property in the markdown metadata.
• Define a mechanism to read that property in the typescript code reading the markdown.
• Modify DocLink function in the sidebar logic to support highlighting the referred item.

Additional context

No response

Are you working on this?

No

[pavanydg]

@benjagm I would like to work on this.

[benjagm]

@benjagm I would like to work on this.

Thanks a lot for your support!! Please go ahead!

[DhairyaMajmudar]

@pavanydg any progress on this ? Or any help needed ?

[pavanydg]

@DhairyaMajmudar sorry for the delay. I was working on another issue in tour site. Will update about the progress within 2 days.

[DhairyaMajmudar]

@DhairyaMajmudar sorry for the delay. I was working on another issue in tour site. Will update about the progress within 2 days.

No worries, pls. take your time

[pavanydg]

@DhairyaMajmudar so when we open this page https://json-schema.org/md-style-guide we should highlight overview/what-is-json-shema in sidebar right? I should implement only this much right?

[DhairyaMajmudar]

@DhairyaMajmudar so when we open this page https://json-schema.org/md-style-guide we should highlight overview/what-is-json-shema in sidebar right? I should implement only this much right?

yep, also pls. check for such more pages whose direct link is not given in the sidebar :)