docs: add note and example on how to reuse a sidebar for a page

[mcanouil]

This pull request adds a note and example to the documentation on how to reuse a sidebar for a page. It explains how to specify the sidebar ID in the front matter of a page or in the _metadata.yml file to include a specific sidebar. An example is provided to demonstrate how to include the tutorials sidebar on a page.

• Quarto Blog: How to enable sidebar only in posts that have multiple pages? quarto-cli#10707
• Giving different sidebar contents in subdirectories quarto-cli#8117

[cderv]

/deploy-preview

[github-actions]

🚀 Deployed on https://deploy-preview-1329.quarto.org

[cderv]

Before merging, just to clarify: My understanding from https://deploy-preview-1329.quarto.org/docs/websites/website-navigation.html#hybrid-navigation is that the correct sidebar should be set on all page listed in contents

  sidebar:
    - id: <id>
      contents: 
        # navigation items

Isn't this working ?

I mean setting explicitly sidebar in .qmd files shouldn't be needed, and if it is not working it seems like an issue to me 🤔

[mcanouil]

Where do you see that any contents listed in a sidebar get the sidebar?

Edit: i see but it's not in the part you linked.

A sidebar with an id or title will only be applied to pages within the contents of the sidebar or pages that specify the sidebar id.

This PR is here to illustrate how to add a specific sidebar to any page/directory, regardless of if the page itself is listed in that sidebar, i.e., how to use the defined ID. (edit: thus the second part of the quoted sentence from the documentation).

Edit: i need to move the addition to below the quoted part above. 33bdc4e

[cderv]

I find it illustrated in the note, but you found a better place yet.
It is also in Charles' answer at quarto-dev/quarto-cli#8117 (reply in thread)

This PR is here to illustrate how to add a specific sidebar to any page/directory

I know. I wanted to be sure we are not missing an issue but thinking it was a documentation problem only.

Both way work, and using sidebar on document is not documented so it should be definitly as Charle explained it.

Using sidebar inside a document is only useful for content not listed in quarto yaml though.

[cderv]

/deploy-preview

[github-actions]

🚀 Deployed on https://deploy-preview-1329.quarto.org

[cderv]

So I understand no specific issue with sidebar dectection, and just documentation addition! Awesome. I struggled in the past to fix a sidebar id issue, and feared there was a new one 😅

[github-actions]

Successfully created backport PR for prerelease:

• [Sync to prerelease] docs: add note and example on how to reuse a sidebar for a page #1538

[mcanouil]

So I understand no specific issue with sidebar dectection, and just documentation addition! Awesome. I struggled in the past to fix a sidebar id issue, and feared there was a new one 😅

None that I am aware of.