tiagobento opened a new pull request, #60:
URL: https://github.com/apache/incubator-kie-website/pull/60
Restructures the blog so it can absorb the historical Drools, jBPM and
OptaPlanner archives, and upgrades Docusaurus to unblock that.
## Blog
**Sidebar grouped by year, collapsible.** Year grouping is stock behaviour in
Docusaurus 3.10, but upstream renders each year as a plain `<div>`, which
stops
being navigable at archive scale. `BlogSidebar/Content` is swizzled to wrap
the
groups in `<details>`. Open by default: the most recent year, plus whichever
year holds the post being read.
**Tags as sections.** `blog/tags.yml` defines a curated taxonomy — one family
for components (Drools, jBPM, OptaPlanner, Kogito, SonataFlow, Tools), one
for
post kinds (Releases, Deep Dives, Community, Tutorials) — each with a
description that renders on its landing page. `onInlineTags: "throw"` makes
an
undeclared tag a build failure, so the tag pages stay a curated set of
sections
rather than accumulating one-off keywords. The four existing posts move off
the
old ad-hoc tags (`apache`, `10`, `kie`), and a "Browse by tag" link in the
blog's
right-hand rail makes the tag index reachable from `/blog`.
Components with no posts yet are declared but generate no pages until the
archives arrive.
**Excerpt-only post list.** No post had a truncation marker, so `/blog`
rendered
every post in full. Each now has a `<!-- truncate -->` after its opening
paragraph, and the `<h1>` that duplicated the frontmatter title is gone.
`onUntruncatedBlogPosts: "throw"` keeps it that way.
Also: the sidebar title reads "All posts" and links back to `/blog`,
headings in
the 10.2 editors post are sentence case, and author bylines render in the
body
colour instead of the primary — the blog list was carrying a lot of orange.
## Docusaurus 3.0.1 -> 3.10.2
A prerequisite, not a drive-by: `themeConfig.blog.sidebar.groupByYear`, the
`tags` file option and `onInlineTags` do not exist in 3.0.1. Pins are exact,
as
before. `docusaurus-lunr-search` installs and runs against 3.10 unchanged.
## Notes for reviewers
- Retagging retires the old tag URLs
(`/blog/tags/{apache,10,kie,editors,bpmn,
dmn,scesim,modernization,tooling}`). `plugin-client-redirects` is already
in
the build if we want to map them.
- **Merge-order hazard with the component hotsites work.** That branch's
`DocBreadcrumbs` swizzle imports `useSidebarBreadcrumbs`/`useDocsSidebar`
from
`@docusaurus/theme-common/internal`, which 3.10.2 no longer exports; they
now
live in `@docusaurus/plugin-content-docs/client`. Git reports a clean merge
and the build then fails. The two-line fix should go on that branch
regardless of which lands first. A `src/css/custom.css` conflict is also
expected there — both sides append at EOF, mechanical.
- `yarn build` and `yarn typecheck` pass on this branch as rebased onto
`main`.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
