How alonenannan/halo-theme-ethereal works
Ethereal is a configurable Halo 2 blog theme: visitors browse Halo-rendered pages, with client-side controls and effects enhancing the experience. The README documents broad layout, banner, sidebar, theme, and visual capabilities; sampled source confirms the app initializer’s page-change work, Halo API search, and photo-gallery helpers. Some feature implementations are unsampled, so those branches reflect documented capabilities and use the README as relationship evidence.
Main entry points: app.ts Client Initializer · setting-utils.ts Setting Utilities · photos-gallery-lightbox.ts Photo Gallery · pages Page Routes
Components 19
Page Rendering
- Page Routes
src/pages - Page Layouts
src/layouts - Page Components
src/components
Visitor Experience
- Client Initializer
src/scripts/app.ts - Content Search
src/components/Search.svelte - Halo Search API
- Scroll Behavior
src/utils/scroll-manager.ts - Banner Effects
src/utils/banner-sync.ts - Profile Status
src/utils/profile-status.ts - Link Handling
src/utils/external-link-redirect.ts
Theme Configuration
- Color Scheme
src/components/LightDarkSwitch.svelte - Display Settings
src/components/widget/DisplaySettings.svelte - Setting Utilities
src/utils/setting-utils.ts - Theme Configuration
src/utils/theme-config.ts
Media Features
- Photo Gallery
src/utils/photos-gallery-lightbox.ts - Gallery Data
src/utils/photos/gallery-data.ts - Photo Info Panel
src/utils/photos/gallery-info-panel.ts
Other components
- Visitor
- Halo 2
Connections 21
- Visitor → Halo 2: requests pages
README.md - Halo 2 → Page Routes: renders theme routes
README.md - Page Routes → Page Layouts: use layouts
- Page Layouts → Page Components: compose interface
README.md - Visitor → Content Search: enters keywords
src/components/Search.svelte - Content Search → Halo Search API: fetches matches
src/components/Search.svelte - Client Initializer → Scroll Behavior: initializes scrolling
src/scripts/app.ts - Client Initializer → Banner Effects: syncs banner
src/scripts/app.ts - Client Initializer → Photo Gallery: initializes gallery
src/scripts/app.ts - Client Initializer → Link Handling: initializes links
src/scripts/app.ts - Visitor → Color Scheme: changes scheme
README.md - Color Scheme → Setting Utilities: applies scheme
src/components/LightDarkSwitch.svelte - Visitor → Display Settings: adjusts display
README.md - Display Settings → Setting Utilities: updates preferences
src/components/widget/DisplaySettings.svelte - Setting Utilities → Theme Configuration: uses configuration
- Visitor → Photo Gallery: opens photos
README.md - Photo Gallery → Gallery Data: reads photo data
src/utils/photos-gallery-lightbox.ts - Photo Info Panel → Gallery Data: reads photo metadata
src/utils/photos/gallery-info-panel.ts - Visitor → Profile Status: changes status
README.md - Profile Status → Theme Configuration: reads status settings
src/utils/profile-status.ts - Visitor → Banner Effects: views banner effects
README.md