How mega7306626007/global-digest works
Global Digest is a daily, static newspaper assembled from RSS feeds and published on GitHub Pages. Its main workflow fetches and parses articles, filters and ranks them into category editions, then renders a self-contained page for readers. The page also offers search, filtering, theme selection, bookmarks, trending stories, and a newsletter form. The sampled source is partial, so internal stages and reader features are mapped to the single supported source file; uncertain implementation-level wiring is omitted.
Main entry points: build_site.py Fetch feeds · daily.yml Daily build and publish
Components 21
Feed ingestion
- Fetch feeds
build_site.py - Parse articles
build_site.py
Editorial selection
- Deduplicate
build_site.py - Rank stories
build_site.py - Select editions
build_site.py - Validate images
build_site.py
Build and publication
- Render newspaper
build_site.py - Daily build and publish
.github/workflows/daily.yml - GitHub Pages
Reader experience
- Newspaper page
build_site.py - Search and filter
build_site.py - Theme and bookmarks
build_site.py - Trending and saved
build_site.py - Newsletter form
build_site.py
Other components
- Daily schedule
- RSS publishers
- Weather service
- Exchange-rate service
- Reader
- Formspree
- Original publishers
Connections 22
- Daily schedule → Daily build and publish: schedules
- Daily build and publish → Fetch feeds: runs build
- RSS publishers → Fetch feeds: provide feeds
- Fetch feeds → Parse articles: returns feeds
- Parse articles → Deduplicate: provides articles
- Deduplicate → Rank stories: passes stories
- Rank stories → Select editions: ranks stories
- Select editions → Validate images: selects stories
- Fetch feeds → Weather service: requests weather
- Fetch feeds → Exchange-rate service: requests rates
- Render newspaper → Select editions: renders editions
- Validate images → Render newspaper: provides images
- Daily build and publish → Render newspaper: builds page
- Daily build and publish → GitHub Pages: publishes dist
- GitHub Pages → Reader: serves page
- GitHub Pages → Newspaper page: serves edition
- Reader → Search and filter: searches and filters
- Reader → Theme and bookmarks: sets preferences
- Reader → Trending and saved: opens sidebar
- Reader → Newsletter form: submits email
- Newsletter form → Formspree: opens signup
- Newspaper page → Original publishers: links to stories