How lyravoid/shirone works
Shirone is an Astro/Svelte personal-blog theme: visitors read server-rendered posts and browse personal collections, while authors configure the site and provide Markdown/MDX content. The main rendering path runs from authored content through Markdown enhancements into pages and interactive components; related capabilities include search, feeds, AI-friendly text endpoints, theming, and optional integrations. Paths and relationships use the README and supplied source index/excerpts; unsampled feature internals are represented at subsystem level rather than inferred in detail.
Main entry points: pages Rendered pages · siteConfig.ts Site configuration · components UI components · llms.txt.ts LLM text endpoint
Components 29
Content and publishing
- Posts and MDX
src/content.config.ts - Markdown pipeline
src/plugins/markdown - Post discovery
src/utils/article-discovery.ts
Reader experience
- Rendered pages
src/pages - UI components
src/components
Theme platform
- Site configuration
src/config/siteConfig.ts - Config overlays
src/utils/config-overlay.ts - Astro integration
src/integration/index.ts - Route registration
src/integration/routes.ts - Font integration
src/integration/fonts.ts - Config contracts
src/types/config.ts - Interface locales
src/i18n/languages - Translation runtime
src/i18n/translation.ts - Sidebar contracts
src/types/sidebarConfig.ts
Personal collections
- Collection sections
src/components/organisms - Collection data
src/data - Music configuration
src/config/musicConfig.ts - Music sidebar player
src/components/organisms/music/MusicSidebarClient.svelte - Music runtime
src/utils/music - Music contracts
src/types/musicConfig.ts
Feeds and discovery
- Full-text search
src/components/organisms/Search.svelte - RSS feed
src/pages/rss.xml.ts - Sitemap output
src/config/sitemapFilter.ts - LLM configuration
src/config/llmsConfig.ts - LLM text generator
src/utils/llms-utils.ts - LLM text endpoint
src/pages/llms.txt.ts - Full-text endpoint
src/pages/llms-full.txt.ts
Other components
- Site author
- Site visitor
Connections 30
- Site author → Posts and MDX: writes
README.md - Site author → Site configuration: configures
README.md - Posts and MDX → Markdown pipeline: processes
README.md - Markdown pipeline → Rendered pages: renders into
README.md - Site visitor → Rendered pages: browses
README.md - Site configuration → Config overlays: supports overlays
- Config overlays → Site configuration: resolves settings
- Astro integration → Route registration: registers routes
src/integration/index.ts - Astro integration → Font integration: configures fonts
src/integration/index.ts - Astro integration → Site configuration: loads settings
src/integration/index.ts - Site configuration → Config contracts: uses contracts
- Rendered pages → UI components: renders interface
README.md - Rendered pages → Post discovery: lists articles
README.md - Rendered pages → RSS feed: serves feed
README.md - Rendered pages → Sitemap output: provides sitemap
README.md - UI components → Full-text search: includes search
README.md - Site visitor → Full-text search: searches posts
README.md - Rendered pages → LLM text endpoint: serves text index
src/pages/llms.txt.ts - LLM text endpoint → Post discovery: loads articles
src/pages/llms.txt.ts - LLM text endpoint → LLM configuration: reads settings
src/pages/llms.txt.ts - LLM text endpoint → LLM text generator: generates text
src/pages/llms.txt.ts - Rendered pages → Full-text endpoint: serves full text
README.md - UI components → Collection sections: presents collections
README.md - Collection sections → Collection data: uses collection data
- Music sidebar player → Music runtime: loads runtime
src/components/organisms/music/MusicSidebarClient.svelte - Music sidebar player → Music configuration: receives options
src/components/organisms/music/MusicSidebarClient.svelte - Music configuration → Music contracts: uses contract
src/config/musicConfig.ts - Music sidebar player → Sidebar contracts: uses sidebar contract
- Translation runtime → Interface locales: selects translations
src/i18n/translation.ts - UI components → Translation runtime: localizes interface