8000 GitHub - kiran-brahma/paul-graham-essays · GitHub
[go: up one dir, main page]

Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

8 Commits

Folders and files

Repository files navigation

Paul Graham Essays — EPUB

An automatically-updated EPUB of every essay from paulgraham.com/articles.html.

The latest build is always attached to the Releases page as paul_graham_essays.epub.

What's inside

  • 232 essays, each as its own chapter with a proper table-of-contents entry, so you can jump straight to any essay.
  • Essays appear in the same order as the site (newest first).

How it updates itself

A GitHub Actions workflow (.github/workflows/update-epub.yml) runs every 15 days:

  1. Fetches the essay index from paulgraham.com.
  2. Compares it against the tracker (state.json) and downloads only new or changed essays.
  3. Rebuilds the EPUB.
  4. Commits the essay changes and attaches the EPUB to a new GitHub Release (tagged by date, e.g. v2026.08.25). Same-day reruns refresh the asset.

You can also trigger it manually from the Actions tab (the "Run workflow" button). The EPUB itself is not committed to git — it's a build artifact that lives on the Releases page.

Build locally

python3 -m pip install -r requirements.txt
python3 build_epub.py

The script is idempotent: re-running it only downloads new essays and rebuilds the EPUB.

Project layout

├── build_epub.py           # fetches, extracts, tracks, and builds the EPUB
├── state.json             # tracker of already-downloaded essays (href + hash)
├── essays/                # extracted essay bodies (one .html per essay)
├── requirements.txt       # pinned Python deps (ebooklib)
├── paul_graham_essays.epub # build artifact — attached to Releases, gitignored
└── .github/workflows/     # the scheduled update workflow

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0