diff --git a/docs/websites/website-navigation.qmd b/docs/websites/website-navigation.qmd index a3e7f2e749..a7cc822903 100644 --- a/docs/websites/website-navigation.qmd +++ b/docs/websites/website-navigation.qmd @@ -179,7 +179,14 @@ Here are all of the options available for side navigation: | `collapse-level` | Whether to show sidebar navigation collapsed by default. The default is 2, which shows the top and next level fully expanded (but leaves the 3rd and subsequent levels collapsed). | | `pinned` | Always show a title bar that expands to show the sidebar at narrower screen widths (true or false). Defaults to false, and uses [headroom.js](https://wicky.nillia.ms/headroom.js/) to automatically show the navigation bar when the user scrolls up on the page. | -A single `sidebar` item without an `id` or `title` will result in a global sidebar applied to all pages. 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. +A single `sidebar` item without an `id` or `title` will result in a global sidebar applied to all pages. 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. + +To use a specific sidebar on a page or a group of pages, specify the `sidebar` ID in the front matter of the page or in the `_metadata.yml` file. +For example, to include the tutorials sidebar on a page, add the following to the page's front matter: + +```yaml +sidebar: +``` For more information on controlling the appearance of the side navigation using HTML themes, see [HTML Themes - Navigation](/docs/output-formats/html-themes.qmd#navigation). If you need to control the width of the sidebar, see [Page Layout - Grid Customization](/docs/output-formats/page-layout.qmd#grid-customization). @@ -376,7 +383,6 @@ website: title: "Reference" contents: # navigation items - ``` ## Breadcrumbs