# Detour 365

Website for the **Detour 365** Bible study project and podcast.

**Live site:** [williamslider.com/detour365](https://williamslider.com/detour365/)  
**GitHub Pages:** [wslider.github.io/detour365](https://wslider.github.io/detour365/)

Detour 365 is a Bible study built around finding God’s path in everyday life—through the wisdom, mysteries, and narratives of Scripture. The site is the public home for weekly studies, the podcast, verse of the day, archives, and episode stats.

## Listen & watch

- [Spotify](https://open.spotify.com/show/4pPy7ulDhZZjPmnqhcijOd)
- [YouTube — Detour 365 Podcast](https://youtube.com/playlist?list=PL8R2K5XKZ16PmOpxBkGxx3rex23EqVKZr)

## Pages

| Page | Purpose |
| --- | --- |
| [`index.html`](index.html) | Home: Proverbs 3:5–6, latest YouTube episode, verse of the day, this week’s study |
| [`about.html`](about.html) | Timeline of the ministry (Detour 239 → Detour 365) |
| [`archives.html`](archives.html) | Episode archive driven by `data/podcast.json` |
| [`stats.html`](stats.html) | Charts of books, literary types, and episode counts |

## Project story (short)

- **2017** — Detour 239 YouTube channel begins  
- **2019** — In-person study starts at Breckenridge Chapel, Louisville, KY  
- **2020** — Group keeps meeting through the shutdowns  
- **2023** — Chapel closes; the work becomes **Detour 365** (live Proverbs 3:5–6 each day); podcast launches on Spotify  
- **2024** — Hybrid in-person / online studies; full episodes on YouTube; *Humanity of God* series  
- **2025–** — Ongoing weekly studies

## Tech stack

Static site. No frontend framework and no server at request time.

- **HTML / CSS / vanilla JS** — pages in the repo root; styles in `css/`; ES modules in `js/`
- **JSON / CSV content** — `data/daily.json` (verse of the day), `data/podcast.json` (episodes), `data/bible_books.csv` (book metadata)
- **Latest YouTube video** — channel RSS via rss2json, then an embed (`js/youtube.js`)
- **Verse share image** — hidden card + html2canvas in `js/daily.js` (PNG download; Web Share API on mobile)
- **Episode charts** — `python/stats.py` with pandas, matplotlib, and seaborn → `plots/`
- **Hosting** — Cloudflare Workers Static Assets (`wrangler.jsonc`) and GitHub Pages
- **Observability** — enabled in Wrangler (foundation for public traffic stats later)

## Repo layout

detour365/ ├── index.html, about.html, archives.html, stats.html ├── css/ ├── js/ │ ├── script.js │ ├── utils.js │ ├── daily.js # verse of the day + share image │ ├── latestEpisode.js │ ├── thisWeek.js │ ├── youtube.js │ ├── archives.js │ └── about.js ├── data/ │ ├── daily.json │ ├── podcast.json │ ├── bible_books.csv │ └── podcast.ipynb ├── images/ ├── plots/ # generated by python/stats.py ├── python/ │ └── stats.py ├── requirements.txt └── wrangler.jsonc

## Local preview

No build step.

```bash
python3 -m http.server 8080

Visit http://localhost:8080.

Update content

1. Episodes — add or edit entries in data/podcast.json.
2. Verse of the day — update data/daily.json.
3. Stats charts — after episode data changes:

python3 -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python python/stats.py

Commit updated files under plots/.

Deploy

npx wrangler deploy

GitHub Pages can serve the same static files from main. Prefer one canonical URL (https://williamslider.com/detour365/) in meta tags and image paths.

Planned updates

Verse of the day image
Today “Share Verse as Image” snapshots a hidden card with html2canvas, always on the same trail photo, then downloads a PNG (and tries native share on phones). Next version should preview the card first, offer square and story sizes, pull an optional background from daily.json, draw text on a real canvas (more reliable than a DOM screenshot), use canonical williamslider.com image URLs, and fall back to copy-text if share fails.

Website traffic on Stats
stats.html is study stats only (books, literary types, episode count). Plan: cookieless Cloudflare Web Analytics on the live site, a scheduled export to data/traffic.json (totals only—no visitor IDs), and a second section on Stats for page views and top paths. Keep ministry charts and traffic charts labeled separately.

Contributing

This is a personal ministry site. Useful PRs: typos, episode metadata, accessibility, verse-card layout, or traffic aggregation.

1. Branch from main
2. Keep the public site static and dependency-light
3. Do not commit API tokens or analytics secrets

License & copyright

Site content © William Slider.
Scripture quotations follow the translations credited on the site and in episode notes (NIV / ESV / WEB as used).

---

Trust in the Lord with all your heart
and lean not on your own understanding;
in all your ways submit to him,
and he will make your paths straight.
— Proverbs 3:5–6 (NIV)