Quarto Blog: How to enable sidebar only in posts that have multiple pages?

[InvictusNavarchus]

Description

So, I just created a new quarto blog from RStudio. After adding some things, the posts directory looks like this:

├── posts
│   ├── _metadata.yml
│   ├── multiple_pages
│   │   ├── index.qmd
│   │   ├── _metadata.yml
│   │   ├── part1.qmd
│   │   └── part2.qmd
│   └── single_page
│       └── index.qmd

Inside multiple_pages post directory, there are 3 .qmd files. I'd like a sidebar to show pages to part 1 and part 2.

After reading https://quarto.org/docs/websites/website-navigation.html#side-navigation, I tried as follow:
I created a new _metadata.yml right inside that folder with the following metadata to enable sidebar:

website:
  sidebar:
    style: "docked"
    search: true
    contents:
      - text: "Introduction"
        href: index.qmd
      - text: "Part 1"
        href: part1.qmd
      - text: "Part 2"
        href: part2.qmd

Unfortunately, it doesn't work. The sidebar doesn't even appear.

A second issue is, part1.qmd and part2.qmd are listed as an independent posts on the homepage:

Here are the links to both the repo and the live page:

• Repository: https://github.com/InvictusNavarchus/quarto_create_sidebar_inside_posts
• Live Page: https://navarchus.id/quarto_create_sidebar_inside_posts/

Note: This issue is similar to #9782

[mcanouil]

All sidebars must be defined in _quarto.yml and referenced (so you need to set id as shown in the documentation) where you want it.

[mcanouil]

What do you mean "set the id"?
Add id: value as all listed keys for sidebar in the documentation.

If you meant how to reference the id, yes. I'll make a PR to add a note about this.

[InvictusNavarchus]

Well, in #8117, @dragonstyle mentioned that you need to define the sidebar metadata in the page you want the sidebar to appear. The value of sidebar you set there will be the value you'll reference to in the sidebar's id on .quarto.yml. This isn't explained in the documentation.

[InvictusNavarchus]

(replying to your edit) Yes, exactly, how to reference the id.

[mcanouil]

Ok, thanks for the feedback.
I'll make the necessary update to the documentation.

[InvictusNavarchus]

No probs. Thank you too.

[mcanouil]

Pull request is up to add an example on how to reuse a sidebar:

• docs: add note and example on how to reuse a sidebar for a page quarto-web#1329

[InvictusNavarchus]

Thanks!