You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 9600943
Browse filesBrowse the repository at this point in the historyBrowse files
summary: Blog 0.4.0 adds a browse panel to every blog page, for filtering posts by category, keyword, year and month, and combining them.
6
+
tags: [blog]
7
+
category: Releases
8
+
---
9
+
10
+
# Blog 0.4: browse by category and date
11
+
12
+
[Blog](/plugins/blog/) 0.4.0 lets readers find posts by what they are about and when they were written. Every blog page gets a browse panel above its posts, with a row of categories, a row of keywords and an archive of years and months. There is nothing to turn on: the rows fill in from the `category`, `tags` and `date` your posts already have.
13
+
14
+
The [Browse Demo](/plugins/blog/browse/) has example posts in three categories over two years, so every row has something to try.
15
+
16
+
-**Filters combine.** Pick a category, then a keyword, then a year: each one narrows the posts further, and each has its own URL, such as `?category=design&tag=ux` or `?month=2026-10`.
17
+
-**Counts follow the view.** Every chip counts the posts it would show with the other filters kept, and dims when it would show none, so you know where a click leads before you make it.
18
+
-**Years open into months.** Choose a year to see its months, then a month. Click it again to step back out to the year.
19
+
-**Easy to undo.** The active filters show above the posts, each with its own ×, beside "Show all posts".
20
+
-**Categories everywhere.** A post's category shows above its title on cards and in its byline, linked to its blog filtered by it.
21
+
22
+
Blog pages can also group posts by month (`groupBy: month`), and keep to some categories (`categories: [Engineering]`), as `::: blog-posts` blocks can.
23
+
24
+
One rename: `sticky` is now `pinned`, to match the Pinned badge it shows, and `stickyLimit` is now `pinLimit`. The old names still work. See [Browsing](/plugins/blog/#browsing-categories-keywords-and-dates) for the details.
title: 'Blog 0.5: a browse panel for blogs of any size'
3
+
blog:
4
+
date: 2026-10-21T09:19:57-04:00
5
+
summary: Blog 0.5.0 keeps the browse panel short on phones and on blogs with hundreds of keywords, and leaves out rows that can't narrow the posts.
6
+
tags: [blog]
7
+
category: Releases
8
+
---
9
+
10
+
# Blog 0.5: a browse panel for blogs of any size
11
+
12
+
[Blog](/plugins/blog/) 0.5.0 reworks the browse panel that 0.4.0 added, so it stays out of the way of the posts, whether a blog has three keywords or three hundred.
13
+
14
+
-**One line per row on phones.** Each row scrolls sideways instead of wrapping, so on a phone the panel takes a few lines, not half the screen.
15
+
-**The most used first.** Categories and keywords are ranked by how many posts use them. A row shows its first 8 categories or 12 keywords, then "+N more", which opens the full list alphabetically. A row of more than 30 gets a field to narrow it as you type.
16
+
-**Only rows that help.** A row that can't narrow the posts is left out. [This blog](/blog/) shows only its keywords now: every post so far is a release, so a Releases chip would choose nothing.
17
+
-**Lighter.** The panel is a flat toolbar instead of a card, with the "Subscribe" link at the end of its first row, and chips are easier to tap on touch screens.
18
+
19
+
The [Browse Demo](/plugins/blog/browse/) sets `tagLimit: 5`, so you can open "+3 more" there. New settings: `categoryLimit`, `tagLimit` and `tagMinCount`. See [Browsing](/plugins/blog/#browsing-categories-keywords-and-dates) for the details.
Copy file name to clipboardExpand all lines: docs/plugins/auto-sidebar/index.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -77,7 +77,7 @@ A line that starts with a dot is a setting for the folder, not an entry. Every s
77
77
78
78
### Sorting
79
79
80
-
This site's [blog](/blog/) sidebar lists sticky posts first, then the rest newest first. Its whole `.sidebar` file (the `.link` line is for [Auto Navbar](/plugins/auto-navbar#settings)):
80
+
This site's [blog](/blog/) sidebar lists pinned posts first, then the rest newest first. Its whole `.sidebar` file (the `.link` line is for [Auto Navbar](/plugins/auto-navbar#settings)):
81
81
82
82
<<< @/blog/.sidebar{txt}
83
83
@@ -92,11 +92,11 @@ This site's [blog](/blog/) sidebar lists sticky posts first, then the rest newes
92
92
- Dates and numbers compare as dates and numbers, so `2` sorts before `10`.
93
93
- Dates can carry a time: `2026-10-20`, `2026-10-20 14:30`, `2026-10-20T14:30:00`, or either with an offset (`-04:00`, `Z`). Pages from the same day sort by their times, and a date alone counts as the start of its day. A time without an offset is read as UTC, so the order is the same on every build machine; write offsets if your pages mix time zones.
94
94
- Several keys, separated by commas, sort by the first and break ties with the
95
-
next: `.sort: blog.sticky desc, date desc` puts sticky blog posts on top,
95
+
next: `.sort: blog.pinned desc, date desc` puts pinned blog posts on top,
96
96
each group newest first.
97
97
- Pages without a value go last for that key, in either direction, and are
98
98
ordered by the next key. A `false` value counts as no value, so pages with
99
-
`sticky: false` sort with those that don't say. Final ties go by name.
99
+
`pinned: false` sort with those that don't say. Final ties go by name.
100
100
- A subfolder sorts by its landing page's frontmatter.
101
101
- Only entries the file doesn't list are sorted. Listed entries keep their place, so the overview above stays first.
102
102
- A setting covers its own folder, not the folders below it. The `sort` option sets an order for every folder; a folder's own `.sort` still wins.
@@ -144,12 +144,12 @@ index.md:All releases
144
144
145
145
Numbers in versions compare as numbers, so `1.10.0` sorts above `1.9.0`, which sorting by file name gets wrong. Pre-releases don't follow version rules, though: `2.0.0-beta.1` sorts above `2.0.0`. If you publish betas, sort by `date desc` instead.
146
146
147
-
**A blog.**Sticky posts first, then the newest posts, cut to ten. Posts can give a date (`2026-10-20`) or a date and time (`2026-10-20 14:34`), and the newest is on top either way. This site's [blog](/blog/) does exactly this with the [Blog](/plugins/blog/) plugin:
147
+
**A blog.**Pinned posts first, then the newest posts, cut to ten. Posts can give a date (`2026-10-20`) or a date and time (`2026-10-20 14:34`), and the newest is on top either way. This site's [blog](/blog/) does exactly this with the [Blog](/plugins/blog/) plugin:
0 commit comments