How weiving24/mizuki works
Mizuki is an Astro static-blog template. The main reader journey is browsing published posts, using search or categories to find one, then reading it with navigation aids; RSS and special pages provide additional content views. The tree and README establish these capabilities, but many page and content implementations were not sampled, so those links are documented at subsystem level. Sampled source supports the music-player and navigation wiring shown below; other relationships are limited to explicit README statements or source-index references.
Main entry points: content.config.ts Post content · swup-manager.ts Page transitions · musicPlayerStore.ts Music player state · translation.ts Translations
Components 23
Content and discovery
- Post content
src/content.config.ts - Content utilities
src/utils/content-utils.ts - Post search
src/components/organisms/navigation/Search.svelte - Categories and tags
src/components/widgets/categories
Pages and feeds
- Archive page
src/components/features/archive - Special pages
src/components/features - RSS and Atom
src/pages - Calendar data API
src/pages/api/calendar-data.json.ts
Reader experience
- Table of contents
src/utils/tocManager.ts - Comments
src/config/commentConfig.ts - Page transitions
src/scripts/swup-manager.ts - Transition setup
src/scripts/core/swup-config.ts - Transition hooks
src/scripts/core/swup-hooks.ts - Sidebar music UI
src/components/widgets/music-sidebar/SidebarMusicClient.svelte - Music player state
src/stores/musicPlayerStore.ts - Playlist and audio
src/components/widgets/music-player/hooks/usePlaylist.ts
Configuration and runtime
- Navigation settings
src/config/navBarConfig.ts - Site settings
src/config/siteConfig.ts - Sidebar composition
src/utils/widget-manager.ts - Translations
src/i18n/translation.ts - Language catalogs
src/i18n/languages - Navigation utilities
src/utils/navigation-utils.ts
Other components
- Blog reader
Connections 18
- Blog reader → Post content: reads posts
README.md - Blog reader → Post search: searches posts
README.md - Blog reader → Categories and tags: browses topics
README.md - Blog reader → Archive page: views archive
README.md - Blog reader → Special pages: visits pages
README.md - Blog reader → RSS and Atom: subscribes to
README.md - Post content → Content utilities: processed by
- Post content → Table of contents: gets navigation
README.md - Post content → Comments: may enable
README.md - Blog reader → Calendar data API: requests calendar
- Page transitions → Transition setup: uses setup
src/scripts/swup-manager.ts - Page transitions → Transition hooks: uses hooks
src/scripts/swup-manager.ts - Page transitions → Navigation utilities: uses navigation
src/scripts/swup-manager.ts - Sidebar composition → Site settings: reads configuration
src/utils/widget-manager.ts - Sidebar music UI → Music player state: controls player
src/components/widgets/music-sidebar/SidebarMusicClient.svelte - Music player state → Site settings: reads player settings
src/stores/musicPlayerStore.ts - Playlist and audio → Translations: localizes messages
src/components/widgets/music-player/hooks/usePlaylist.ts - Translations → Language catalogs: selects catalog
src/i18n/translation.ts