wu-sheng opened a new pull request, #849:
URL: https://github.com/apache/skywalking-website/pull/849
Centralizes blog topics into a single data file, replaces the search-based
filter on the blog index with a topic sidebar, generates the per-topic colors
from data, ships `/tags/<term>/` taxonomy pages, and remaps every blog post's
frontmatter onto the canonical 11 labels.
## Highlights
### Single source of truth: `data/blog_topics.yml`
Each entry has `name`, EN `intro`, CN `intro_zh`, and `color { bg / fg /
border }`. Adding a 12th topic is one append to this file — no template or SCSS
changes required.
The data file drives:
- Sidebar topic cards on `/blog/` and `/zh/` (description, count, link to
`/tags/<term>/`).
- The `<style>` block emitted by `layouts/partials/blog-topic-styles.html`
containing one `.blog-label[data-label="X"]` rule per topic (included from
`blog/baseof.html`, `zh/baseof.html`, `tags/baseof.html`).
- Per-topic ordering on the sidebar (YAML order, skipping topics with zero
posts).
### Blog index — sidebar + chronological grid
- Hero, then a right "Browse topics" sidebar with one compact card per topic
(colored chip, count, intro). Each card opens `/tags/<term>/`.
- Main column is the year-grouped post grid; pagination dropped here (tag
pages paginate at 12 instead).
- Below 992px the sidebar collapses above the grid as a horizontal
scroll-snap row.
### Blog detail page
- Shadowed `themes/docsy/layouts/blog/content.html`: the theme's plain "Tags
| Tracing, Metrics" list is replaced with inline colored `.blog-label` pills
above the body, each linking to `/tags/<term>/`.
- Right sidebar holds only the TOC (tags moved inline). Column widths
rebalanced from `col-xl-10` / `col-xl-2` → `col-xl-9` / `col-xl-3` and the
`td-toc` `border-left` removed, so the natural prose-to-TOC gap no longer reads
as a blank vertical strip.
- Polished `.td-toc` styling under `.td-blog` (uppercase label, brand-blue
active TOC item, left-border accent), supports one extra nesting depth, hides
the empty Docsy `.td-page-meta` div.
### Tag taxonomy pages
- New `layouts/tags/baseof.html` + `layouts/tags/term.html` render
`/tags/<term>/` in the same visual language as the blog list.
- Hero shows the colored chip + "Posts tagged …" title + back link, then a
card grid paginated at 12.
- Pages are filtered to `Section == "blog"` so docs frontmatter `tags:`
can't bleed in.
### Content remap to the canonical 11
- **EN** — every post in `content/blog/*` (82 files) rewritten to use only
`Release, AI, Tracing, Metrics, Logging, Profiling, Storage, Agents, Cloud
Native, Engineering, Community`. Max 3 tags per post, deduped, most-specific
kept.
- **CN** — same remap on `content/zh/*` (31 of 94 files actually changed).
Final tag distributions:
```
EN: Community 27 · Agents 17 · Profiling 14 · Tracing 13 · Cloud Native 12 ·
Engineering 10 · Metrics 10 · Storage 8 · Release 7 · Logging 4 · AI 4
CN: Agents 11 · Tracing 10 · Profiling 6 · Storage 6 · Engineering 6 ·
Cloud Native 5 · Community 5 · Metrics 4 · AI 4 · Release 2 · Logging 1
```
## Verification
- `hugo` builds clean (4589 EN pages + CN), no template errors.
- Verified: `/blog/` renders 11 sidebar cards with data-driven intros;
`/zh/` mirrors with `intro_zh`; `/blog/<post>/` shows inline colored pills
(theme's "Tags |" list gone); `/tags/profiling/` and `/tags/community/`
(largest, paginated) render correctly.
--
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]
