How arty3/journal works
Journal is a static public project-and-research publication. Authors add Markdown/MDX entries with metadata; the site validates and renders them, then presents a landing page, sorted and filterable listings, individual entries, tag views, and RSS/Atom feeds. Date parsing and entry utilities form the shared domain layer. The excerpts establish collection validation, date and feed logic, and Markdown plugin configuration; links to unsampled page implementations are shown as unverified where needed.
Main entry points: entries.ts Entry metadata · content.config.ts Entry collection · index.astro Entry listing · astro.config.mjs Markdown rendering
Components 20
Entry authoring
- Entry files
src/content/entries
Content processing
- Entry collection
src/content.config.ts - Markdown rendering
astro.config.mjs - Lazy images
src/lib/rehypeLazyImages.mjs - Math text fixes
src/lib/rehypeMathTextUnderscores.mjs - Date utilities
src/lib/dates.ts - Entry metadata
src/lib/entries.ts - Semantic tag colors
src/lib/tagColors.ts - Embedding cache
src/data/tag-embeddings.json
Journal experience
- Landing page
src/pages/index.astro - Entry listing
src/pages/entries/index.astro - Entry detail
src/pages/entries/[id].astro - Tag archive
src/pages/tags/[tag].astro - Entry list
src/components/EntryList.astro - Entry controls
src/components/EntryControls.astro - Base layout
src/layouts/Base.astro
Other components
- Journal author
- Feed readers
Connections 20
- Journal author → Entry files: writes
README.md - Entry files → Entry collection: loads entries
src/content.config.ts - Entry collection → Date utilities: validates dates
src/content.config.ts - Entry collection → Entry metadata: provides entries
- Entry metadata → Date utilities: uses date rules
src/lib/entries.ts - Markdown rendering → Lazy images: registers plugin
astro.config.mjs - Markdown rendering → Math text fixes: registers plugin
astro.config.mjs - Entry metadata → RSS feed: supplies entries
src/pages/rss.xml.ts - Entry metadata → Atom feed: supplies entries
src/pages/atom.xml.ts - Entry metadata → Landing page: provides latest entry
- Entry metadata → Entry listing: sorts entries
- Entry metadata → Entry detail: provides metadata
- Entry metadata → Tag archive: provides tagged entries
- Entry listing → Entry list: renders entries
- Entry listing → Entry controls: offers filters
- Entry detail → Markdown rendering: renders body
- Tag archive → Semantic tag colors: uses tag hues
- Semantic tag colors → Embedding cache: reads and writes
src/lib/tagColors.ts - RSS feed → Feed readers: publishes feed
README.md - Atom feed → Feed readers: publishes feed
src/pages/atom.xml.ts