Skip to content

Blog tags, pagination and feed link, documentation versions selector - #5

Merged
ArnaudLigny merged 4 commits into
mainfrom
feat/blog-versions
Oct 20, 2026
Merged

ArnaudLigny merged 4 commits into
mainfrom
feat/blog-versions

Conversation

@ArnaudLigny

Copy link
Copy Markdown
Member

Stacked on #4 (itself stacked on #3): merge them first (this PR will then target main).
Blog pagination requires Cecilapp/Cecil#2543 (pagination opt-in). The README contains a Cecil X.Y placeholder for the version including it.

Changes

Blog

  • Tags: tags front matter variable (the tags taxonomy is enabled by the theme), displayed on posts and in the list of posts, linked to the term pages (posts listed like the blog), all tags listed in /tags/ with their number of pages.
  • Pagination of the list of posts: pagination stays disabled globally (no duplicated /page/2/ pages for the homepage and the documentation), and is enabled in the front matter of the blog section:
    pagination:
      enabled: true
      max: 5
  • Feed link ("Subscribe to the feed") on the list of posts and the term pages.
  • List cards: stretched title link (the tags are links, a card can no longer be a link itself), border color in the dark theme (blog and default lists).

Documentation

  • Versions selector: versions option (name and URL of each version, e.g. other deployments) and version (current one, default: the first one), displayed in a dropdown next to the site title, and in the mobile sidebar.
  • The language selector dropdown becomes a generic dropdown (CSS utility and closing script in the layout), used by both selectors.
  • Documentation home listed at the top of the sidebar.

Other

  • branch-alias: dev-main → 6.x-dev (latest release is 5.0.0, main contains breaking changes).
  • README screenshots updated.
  • README and French translations updated.

Demo

  • Tagged posts, a third post, blog paginated by 2.
  • Versions selector (main and 5.0).

Tests

  • Demo built with the Cecil pagination opt-in branch: blog paginated (/blog/page/2/), no paginated pages for the homepage and the documentation, term pages and /tags/ generated.
  • Browser check (Playwright), light and dark themes: blog list and page 2, post, term page, tags page, versions dropdown, documentation home in the sidebar.
  • No warning in the build.

🤖 Generated with Claude Code

@ArnaudLigny
ArnaudLigny added this pull request to stack #6 October 20, 2026 22:11
Base automatically changed from refactor/review-follow-up to main October 20, 2026 22:12
ArnaudLigny and others added 4 commits October 21, 2026 00:12
The latest release is 5.0.0, and the main branch contains breaking changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- `versions` option (name and URL of each version, e.g. other deployments) and
  `version` (current one): displayed in a dropdown next to the site title, and
  in the mobile sidebar
- the language selector dropdown becomes a generic `dropdown` (CSS utility and
  closing script in the layout), used by both selectors
- the documentation home page is listed at the top of the sidebar

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- tags: `tags` front matter variable (`tags` taxonomy enabled), displayed on
  posts and in the list of posts, linked to the term pages (listed like blog
  posts), all tags listed in `/tags/`
- pagination of the list of posts, enabled in the front matter of the blog
  section (`pagination.enabled: true`, requires Cecil with pagination opt-in)
- link to the feed of the list of posts
- list cards: stretched title link (tags are links), border in dark theme
- demo: tagged posts, a third post and pagination of the blog

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ArnaudLigny
ArnaudLigny merged commit 526b1ae into main Oct 20, 2026
3 checks passed
@ArnaudLigny
ArnaudLigny deleted the feat/blog-versions branch October 20, 2026 22:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant