seo: URL-driven list filters and per-page meta descriptions

[FenjuFu]

Motivation

The projects and events list pages rendered their full dataset once and then filtered it in the browser with an inline display: none script. That works for a human clicking around, but it costs us on SEO:

• Filter state lived only in JS variables, so a filtered view (agent-skills projects, hackathon events) had no URL — it could not be linked, shared, or indexed.
• Several pages emitted no <meta name="description"> of their own and fell back to the site-wide default, so search results showed the same generic snippet for /projects, /events, /adopters, /landscape, /contribute, the policy pages and the blog list pages.
• /events was prerendered at build time, which froze each event's upcoming / ongoing / past badge to whatever the date was when the site was built.

What changed

URL-driven list filters

/projects — category and language filters are now server-rendered links that carry state in the query string (/projects?category=agent-skills&language=TypeScript). Filtering happens on the server; the client-side filter script is gone. Unknown parameter values fall back to all, and an empty result set renders an explicit empty state with a "clear filters" link instead of a blank grid.

/events — same treatment with ?type=meetup / ?type=hackathon etc., and the page switches to prerender = false so each event's status badge is computed at request time rather than at build time.

Canonical URLs already strip the query string (getCanonical uses Astro.url.pathname), so filtered views canonicalize back to the base list page and introduce no duplicate content — they are crawlable and shareable without competing with the canonical page in the index.

Per-page meta descriptions

Added distinct, bilingual descriptions to every page that previously inherited the site-wide default:

Page	Before	After
/projects, /events, /adopters, /landscape, /contribute	site default	page-specific
/cla, /values, /security	site default	page-specific
/blog, /category/<slug>, /tag/<slug>	site default	page/category/tag-specific

MarkdownLayout now forwards a description from its frontmatter into the page metadata, which is what makes the three policy pages possible.

Verification

• astro check — 103 files, 0 errors / 0 warnings / 0 hints
• eslint and prettier clean on the touched files
• Verified against the dev server:
  • /projects?category=agent-skills&language=TypeScript server-renders exactly the intersection (1 card), both chips show active, and no filter script remains in the HTML
  • /events?type=hackathon renders only hackathons with the right chip active
  • <meta name="description"> is page-specific on /projects, /events and /security
  • <link rel="canonical"> on a filtered /projects URL still points at https://opensource.iflytek.com/projects

Notes

No visual redesign — the filter chips keep their existing styling and active/inactive states; they are <a> elements instead of <button> elements. Filtering now costs a navigation instead of an instant DOM toggle, which is the intended trade for having real URLs.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
website	Ready	Preview, Comment	Jul 24, 2026 3:31am

[dongjiang1989]

Thanks @FenjuFu
Great feature.

Need add Changelog to CHANGELOG.md

[FenjuFu]

@dongjiang1989 Thanks for the review. Added the SEO and URL-driven filtering changes to the CHANGELOG.md Unreleased section in commit 8570bb1.

[dongjiang1989]

Please fix CI fail. DCO setting

[dongjiang1989]

Need to check all added English and Chinese descriptions

[dongjiang1989]

Add en description?

[FenjuFu]

Thanks @dongjiang1989! Added the changelog entry under [Unreleased] → Changed in CHANGELOG.md (commit 8570bb1), already pushed to this branch. Ready for another look.