feat(blog): data-driven topics, sidebar, inline pills, taxonomy term pages#849
Merged
Conversation
…pages Topics (name + EN/CN intro + label colors) now live in a single source of truth: data/blog_topics.yml. The sidebar topic cards, inline post pills, generated .blog-label[data-label] color rules and /tags/<term>/ pages are all driven from that file — adding a 12th topic is one edit, no template/SCSS changes required. Blog index (EN + CN) - Hero + right 'Browse topics' sidebar showing one card per topic with its description (data file), post count, and link to /tags/<term>/. - Main column lists all posts grouped by year (pagination removed; the per-tag pages paginate at 12). - Sidebar collapses above the grid as a horizontal scroll-snap row at <=992px. Blog detail page - Shadowed themes/docsy/layouts/blog/content.html: 'Tags | …' link list replaced with inline colored .blog-label pills, each linking to its /tags/<term>/ page. - Right sidebar shows only the TOC (tags moved inline); column widths rebalanced to col-xl-9 + col-xl-3 and the awkward .td-toc border-left removed so the natural prose/TOC gap doesn't read as a blank strip. - Polished .td-toc styling under .td-blog (uppercase label, brand-blue active item, left-border accent on hovered items, +1 nesting depth). - Hidden the empty Docsy .td-page-meta that was leaving a gap above the TOC. Tag taxonomy pages (new) - layouts/tags/baseof.html + layouts/tags/term.html render /tags/<term>/ styled like the blog list, filtered to Section==blog (so docs frontmatter tags can't bleed in), 12 cards per page with pagination. Blog content remap - Every blog post frontmatter (EN: 82 files, CN: 31 of 94) rewritten to use only the canonical 11 labels (Release, AI, Tracing, Metrics, Logging, Profiling, Storage, Agents, Cloud Native, Engineering, Community), max 3 tags per post, deduped.
✅ Deploy Preview for skywalking-website-preview ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.ymlEach entry has
name, ENintro, CNintro_zh, andcolor { bg / fg / border }. Adding a 12th topic is one append to this file — no template or SCSS changes required.The data file drives:
/blog/and/zh/(description, count, link to/tags/<term>/).<style>block emitted bylayouts/partials/blog-topic-styles.htmlcontaining one.blog-label[data-label="X"]rule per topic (included fromblog/baseof.html,zh/baseof.html,tags/baseof.html).Blog index — sidebar + chronological grid
/tags/<term>/.Blog detail page
themes/docsy/layouts/blog/content.html: the theme's plain "Tags | Tracing, Metrics" list is replaced with inline colored.blog-labelpills above the body, each linking to/tags/<term>/.col-xl-10/col-xl-2→col-xl-9/col-xl-3and thetd-tocborder-leftremoved, so the natural prose-to-TOC gap no longer reads as a blank vertical strip..td-tocstyling under.td-blog(uppercase label, brand-blue active TOC item, left-border accent), supports one extra nesting depth, hides the empty Docsy.td-page-metadiv.Tag taxonomy pages
layouts/tags/baseof.html+layouts/tags/term.htmlrender/tags/<term>/in the same visual language as the blog list.Section == "blog"so docs frontmattertags:can't bleed in.Content remap to the canonical 11
content/blog/*(82 files) rewritten to use onlyRelease, AI, Tracing, Metrics, Logging, Profiling, Storage, Agents, Cloud Native, Engineering, Community. Max 3 tags per post, deduped, most-specific kept.content/zh/*(31 of 94 files actually changed).Final tag distributions:
Verification
hugobuilds clean (4589 EN pages + CN), no template errors./blog/renders 11 sidebar cards with data-driven intros;/zh/mirrors withintro_zh;/blog/<post>/shows inline colored pills (theme's "Tags |" list gone);/tags/profiling/and/tags/community/(largest, paginated) render correctly.