How chinaeaa/shirone works
Shirone is an Astro blog theme for publishing long-form writing and curated personal collections. Authors configure the site and provide Markdown/MDX content; Astro renders pages server-side, with theme components supplying the reading experience and collection views. Markdown extensions, search, feeds, and AI-friendly text endpoints extend the publishing workflow. The README documents the major capabilities, while the sampled source confirms selected configuration, route-registration, music-player, and LLM-text relationships; connections for unsampled page implementations are therefore limited to documented behavior.
Main entry points: content.config.ts Blog content · pages Site pages · index.ts Astro integration · llms.txt.ts LLM text endpoints
Components 23
Publishing
- Blog content
src/content.config.ts - Content queries
src/utils/content-utils.ts - Site pages
src/pages - Personal collections
src/data - RSS and sitemap
src/pages/rss.xml.ts
Theme Experience
- Theme components
src/components - Translations
src/i18n - Music sidebar
src/components/organisms/music/MusicSidebarClient.svelte - Music runtime
src/utils/music/music-runtime.ts
Theme Platform
- Site settings
src/config/siteConfig.ts - Feature settings
src/config - Config overlays
src/utils/config-overlay.ts - Astro integration
src/integration/index.ts - Route discovery
src/integration/routes.ts - Font integration
src/integration/fonts.ts - LLM settings
src/config/llmsConfig.ts - Music settings
src/config/musicConfig.ts
Content Extensions
- Markdown pipeline
src/utils/markdown-processor.mjs - Markdown extensions
src/plugins/markdown - Full-text search
src/components/organisms/Search.svelte - LLM text endpoints
src/pages/llms.txt.ts - LLM text generation
src/utils/llms-utils.ts
Other components
- Site author
Connections 21
- Site author → Site settings: configures
README.md - Site author → Blog content: writes
README.md - Site settings → Config overlays: merges overrides
- Feature settings → Config overlays: merges overrides
src/config/llmsConfig.ts - Astro integration → Route discovery: registers routes
src/integration/index.ts - Astro integration → Site settings: loads settings
src/integration/index.ts - Astro integration → Font integration: configures fonts
src/integration/index.ts - Blog content → Content queries: queries posts
- Blog content → Markdown pipeline: renders Markdown
README.md - Markdown pipeline → Markdown extensions: applies extensions
README.md - Site pages → Content queries: reads posts
src/pages/llms.txt.ts - Site pages → Theme components: renders with
README.md - Site pages → Personal collections: presents collections
README.md - Theme components → Translations: uses translations
- Full-text search → Blog content: indexes content
README.md - RSS and sitemap → Blog content: publishes posts
README.md - LLM text endpoints → LLM settings: reads settings
src/pages/llms.txt.ts - LLM text endpoints → Content queries: loads posts
src/pages/llms.txt.ts - LLM text endpoints → LLM text generation: generates text
src/pages/llms.txt.ts - Music sidebar → Music settings: uses options
src/components/organisms/music/MusicSidebarClient.svelte - Music sidebar → Music runtime: loads runtime
src/components/organisms/music/MusicSidebarClient.svelte