feat(docs): sidebar follows blog scopes

- config: Auto Sidebar blog option on; Auto Sidebar 0.11.0 and Auto Navbar 0.8.2
- docs: Auto Sidebar Grouping and Blogs sections, blog page notes, scopes demo sidebars sorted by date

Author: jsmith3rd

docs/.vitepress/config.mts

@@ -131,6 +131,9 @@ export default defineConfig({
       excludeFrontmatter,
       ...menuTitleOptions,
       groupTitleFromIndex: true,
+      // Blog folders list posts as their blog pages do: pinned, then newest first, and the main
+      // blog's folder also lists the `scope: site` posts from the section blogs inside it.
+      blog: true,
       // Groups start closed, so @binarynoir/vitepress-sidebar-accordion (in the theme) has a caret to toggle.
       collapsed: true,
     }),

docs/plugins/auto-sidebar/index.md

@@ -72,6 +72,7 @@ A line that starts with a dot is a setting for the folder, not an entry. Every s
 | `.sort: key [asc\|desc], …` | Order the entries this file doesn't list by `key`. Default: `name`.                      |
 | `.limit: n`                 | Show at most `n` of the entries this file doesn't list, after sorting. `0` for no limit. |
 | `.more: Text`               | When `.limit` left entries out, end with a link to the landing page titled `Text`.       |
+| `.group: year\|month\|blog` | Put the entries this file doesn't list in groups. See [Grouping](#grouping).             |
 | `.hide`                     | Hide this folder's own link, but keep showing its children.                              |
 | `.hideall` or `.hide-all`   | Leave this folder and everything under it out of the sidebar.                            |
 
@@ -109,6 +110,27 @@ A folder with hundreds of pages makes a sidebar too long to use, and VitePress s
 - `.more: Older posts` ends the list with a link to the folder's landing page, but only when entries were left out. The blog doesn't need one: its landing page is already listed as "All posts".
 - `.limit: 0` means no limit. The `limit` and `more` options set both for every folder; a folder's own lines win.
 
+### Grouping
+
+`.group: month` puts the entries a `.sidebar` doesn't list into one group per month of their date ("October 2026"), after sorting and `.limit`; `.group: year` into one per year. `.group: blog` groups a main blog's site-wide posts by the section blog they came from (see [Blogs](#blogs)).
+
+- Each group sits where its first entry falls, so with posts newest first, the months run newest first too.
+- The month is the one the date is written in, whatever its offset.
+- Listed entries, subfolders and undated pages stay outside the groups.
+
+### Blogs
+
+With `blog: true`, each [Blog](/plugins/blog/) folder lists the posts its blog page lists. This site turns it on.
+
+- A folder whose landing page is a blog (`blog-index`) and has no `.sort` lists its posts pinned first, then newest first.
+- The main blog's folder (`blog-index: { scope: site }`) also lists every `scope: site` post in the folders it covers, sorted in with its own. So a site-wide post in a section blog shows twice: in its section and in the main blog.
+- Those posts count toward `.limit`, and `.exclude` files and `excludeFrontmatter` hide them like any page.
+- `.group: blog` in the main blog's `.sidebar` puts them in one group per section blog, linked to its page. A section blog whose folder is right inside the main blog's already has its group there, so its posts aren't repeated.
+
+The [Scopes Demo](/plugins/blog/demo/) in this sidebar shows it: its site-wide team post is listed under Scopes Demo and under Team Blog, and the section-only post only under Team Blog. The demo's `.sidebar` keeps the Team Blog group below the posts:
+
+<<< @/plugins/blog/demo/.sidebar{txt}
+
 ### Recipes
 
 `.sort` and `.limit` turn a folder that grows every week into a sidebar that stays short and current. Some realistic setups:
@@ -204,6 +226,7 @@ index.md:All decisions
 | `sort`                | `'name'`       | Order for unlisted entries in every folder, e.g. `'date desc'`. See [Sorting](#sorting).                                                  |
 | `limit`               | `0`            | Most unlisted entries every folder shows, after sorting. See [Limiting](#limiting).                                                       |
 | `more`                | none           | Link text for the landing page when a limit left entries out.                                                                             |
+| `blog`                | `false`        | Follow [Blog](/plugins/blog/#scopes) scopes in blog folders. See [Blogs](#blogs).                                                         |
 | `groupTitleFromIndex` | `false`        | Label a folder's group with its landing page's title.                                                                                     |
 | `verbose`             | `false`        | Log each folder as it is processed.                                                                                                       |
 

docs/plugins/blog/demo/.sidebar

@@ -1,3 +1,4 @@
 index.md:Overview
+# Posts come next, newest first, including the team blog's site-wide post; the team blog goes last.
+...
 team:Team Blog
-example-unsorted-post.md

docs/plugins/blog/demo/team/.sidebar

@@ -1,3 +1 @@
 index.md:Overview
-example-site-post.md
-example-section-post.md

docs/plugins/blog/index.md

@@ -236,7 +236,7 @@ The list goes where `<!-- blog-posts -->` is, or after the page's content if the
 
 Before 0.4.0, these settings were called `sticky` and `stickyLimit`. The old names are still read, so older posts keep working.
 
-To keep pinned posts on top of the sidebar too, sort the blog folder with [Auto Sidebar](/plugins/auto-sidebar/#sorting)'s `.sort` setting, by pinning and then date. This site's blog does:
+To keep pinned posts on top of the sidebar too, turn on [Auto Sidebar](/plugins/auto-sidebar/#blogs)'s `blog` option, or sort the blog folder with its `.sort` setting, by pinning and then date. This site's blog does both:
 
 <<< @/blog/.sidebar{txt}
 
@@ -363,6 +363,8 @@ Scopes decide which blog lists a post.
 
 So a site with only a main blog needs no scope settings at all, and a post inside a section only reaches the main blog when it says `scope: site`. The [Scopes Demo](/plugins/blog/demo/) shows all three cases live.
 
+[Auto Sidebar](/plugins/auto-sidebar/#blogs)'s `blog` option follows the same scopes: a `scope: site` post is listed in its section's folder and in the main blog's folder. A post in a folder with no section blog of its own stays in that folder's group.
+
 ```txt
 docs/
   blog/

package-lock.json

@@ -26,8 +26,8 @@
   "devDependencies": {
     "@binarynoir/vite-plugin-image-fallback": "^0.4.3",
     "@binarynoir/vite-plugin-optimize-images": "^0.2.0",
-    "@binarynoir/vitepress-auto-navbar": "^0.8.1",
-    "@binarynoir/vitepress-auto-sidebar": "^0.10.1",
+    "@binarynoir/vitepress-auto-navbar": "^0.8.2",
+    "@binarynoir/vitepress-auto-sidebar": "^0.11.0",
     "@binarynoir/vitepress-blog": "^0.7.1",
     "@binarynoir/vitepress-broken-links": "^0.1.4",
     "@binarynoir/vitepress-downloads": "^0.1.5",