How lyravoid/mizuki works
Mizuki is an Astro-based static personal-blog template. Its main reader workflow is to browse pages rendered from authored posts and structured personal data, then use search, navigation, and feeds to discover or consume that content. The graph also preserves the documented special pages, Markdown enhancements, SEO outputs, comments, and music player. Several links reflect README-level capabilities rather than inspected call sites; those are cited to the README, and unsampled implementation details are not inferred.
Main entry points: pages Blog pages · navBarConfig.ts Navigation and layout · musicPlayerStore.ts Music player state · siteConfig.ts Site configuration
Components 25
Content and rendering
- Content schema
src/content.config.ts - Post loader
src/loaders/post-loader.ts - Markdown extensions
src/plugins - Personal data
src/data
Reader-facing pages
- Blog pages
src/pages - Special pages
src/components/features - Page APIs
src/pages/api - RSS and Atom
src/pages/rss.xml.ts - SEO outputs
src/pages/og/[...slug].ts
Site experience
- Site search
src/components/organisms/navigation/Search.svelte - Table of contents
src/utils/tocManager.ts - Japanese heading support
src/components/features/toc/utils/japanese-katakana.ts - Navigation and layout
src/config/navBarConfig.ts - Sidebar widgets
src/utils/widget-manager.ts - Page transitions
src/scripts/swup-manager.ts
External integrations
- Comments
src/config/commentConfig.ts - Music player state
src/stores/musicPlayerStore.ts - Audio playback
src/components/widgets/music-player/hooks/useAudioPlayer.ts - Music sidebar UI
src/components/widgets/music-sidebar/SidebarMusicClient.svelte - Optional services
Configuration
- Site configuration
src/config/siteConfig.ts - Config overrides
src/config/overrideLoader.ts - Translations
src/i18n/translation.ts
Other components
- Reader
- Authors
Connections 25
- Authors → Content schema: author content
README.md - Content schema → Post loader: defines posts
- Post loader → Blog pages: loads content
- Blog pages → Reader: renders pages
- Markdown extensions → Blog pages: extends Markdown
README.md - Personal data → Special pages: supplies page data
README.md - Reader → Site search: searches content
README.md - Reader → Navigation and layout: navigates pages
- Reader → Table of contents: navigates headings
README.md - Table of contents → Japanese heading support: uses heading support
src/utils/tocManager.ts - Reader → RSS and Atom: subscribes
README.md - RSS and Atom → Blog pages: reuses Markdown pipeline
README.md - Reader → Page APIs: requests page data
- Blog pages → SEO outputs: provides post metadata
- Reader → Comments: comments on posts
README.md - Comments → Optional services: uses provider
README.md - Reader → Music sidebar UI: controls playback
README.md - Music sidebar UI → Music player state: calls player actions
src/components/widgets/music-sidebar/SidebarMusicClient.svelte - Music player state → Audio playback: controls audio
- Music player state → Optional services: fetches Meting playlist
README.md - Navigation and layout → Site configuration: uses site settings
- Site configuration → Config overrides: loads overrides
src/config/index.ts - Sidebar widgets → Site configuration: uses widget config
src/utils/widget-manager.ts - Navigation and layout → Page transitions: supports transitions
README.md - Reader → Optional services: uses optional integrations
README.md