[Feature] Nested Category

[TatsukiMengChen]

Type of change

• Bug fix (a non-breaking change that fixes an issue)
• New feature (a non-breaking change that adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Other (please describe):

Checklist

• I have read the CONTRIBUTING document.
• I have checked to ensure that this Pull Request is not for personal changes.
• I have performed a self-review of my own code.
• My changes generate no new warnings.

Related Issue

[Feature]: 添加多级分类 #580

Changes

Implemented nested category functionality to support hierarchical article classification:

• Article categorization system upgrade: Modified the category field in article frontmatter to support multi-level category structures using / separator (e.g., A/B/C)
• Sidebar category component refactoring:
  • Added CategoryBranch.astro component for rendering category tree structure
  • Added CategoryItem.astro component for rendering individual category items
  • Refactored Categories.astro component to support collapsible nested category display
• Archive page functionality enhancement: Updated ArchivePanel.svelte component to support filtering and displaying articles by nested categories
• Utility function optimization: Enhanced category processing logic in content-utils.ts to support parsing and filtering of multi-level categories

How To Test

Testing steps:

1. Create test articles with different category levels:

   • First level: category: A
   • Second level: category: A/B
   • Third level: category: A/B/C

2. Sidebar category component testing:

   • Visit any page and check the sidebar category component
   • Verify categories are displayed correctly in hierarchical structure
   • Test expand/collapse functionality of the category tree

3. Archive page testing:

   • Navigate to /archive page
   • Click on different category levels
   • Verify that filtering results correctly display articles from the selected category and its subcategories

4. Compatibility testing:

   • Verify that existing single-level category functionality still works properly
   • Confirm that old and new category formats can coexist

Screenshots

Created three test articles for functionality validation using categories A, A/B, and A/B/C:

Sidebar Category Component

Archive Page Category Filtering

Filter by category A (shows articles from A and all its subcategories)

Filter by category A/B (shows articles from A/B and its subcategories)

Filter by category A/B/C (shows only articles from this category)

Additional Notes

• This feature is fully backward compatible and will not affect existing single-level category usage
• Category filtering uses prefix matching mechanism - selecting a parent category will display articles from all subcategories
• UI design maintains consistency with existing theme styles and supports responsive layout

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
fuwari-yags	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Aug 10, 2025 3:40pm