heterarchy-society/books
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
A curated reading list for the parallel society http://heterarchy.fyi/books
49 commits 1 branch 0 tags 28 MiB
Find a file
Exact
tree e4005f8998
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
Details
Bump @heterarchy-society/atlas to ^1.0.7. 
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-31 06:44:06 +02:00
books Convert book covers to WebP and update index references. 2026-05-31 06:26:19 +02:00
schema Reformat books as dir-based entries with co-located covers. 2026-05-30 20:10:42 +02:00
.gitignore Update dependencies in package.json and bun.lock; add package-lock.json to .gitignore for improved dependency management. 2026-05-26 12:53:53 +02:00
.woodpecker.yml Add trigger-website step to rebuild heterarchy.fyi after deploy. 2026-05-29 14:39:50 +02:00
bun.lock Bump @heterarchy-society/atlas to ^1.0.7. 2026-05-31 06:44:06 +02:00
config.toml Reformat books as dir-based entries with co-located covers. 2026-05-30 20:10:42 +02:00
package.json Bump @heterarchy-society/atlas to ^1.0.7. 2026-05-31 06:44:06 +02:00
README.md Reformat books as dir-based entries with co-located covers. 2026-05-30 20:10:42 +02:00
redirects.yaml Update package.json to specify a commit hash for @heterarchy/atlas dependency; add redirects.yaml for managing canonical IDs of book files. 2026-05-25 10:35:17 +02:00

README.md

Heterarchy Books

A curated library of books for The Heterarchy Society. Each book lives in its own directory; a build script compiles them into static JSON deployed via GitHub Pages.

Adding or editing books

Each book lives in books/{id}/. The directory name becomes the book's ID — use lowercase kebab-case (e.g. sovereign-individual/). Put metadata in index.yaml and the cover image in the same directory as cover.jpg (or .png, .webp, .gif).

Fields:

Field Required Type Description
title yes string Full title of the book
authors yes string[] Author(s); use Name|people-id to link to a people profile
description yes string Short description
language yes string[] Language codes (en, cs, de)
formats yes string[] Available formats (ebook, pdf, web, print)
physical yes boolean Available as a physical copy in the library
links yes object[] Links to read/buy (href + label required, external optional)
cover no string Cover filename in the book directory (e.g. cover.jpg)
year no string Publication year
glossary no string[] Related glossary term IDs
source no object Where the book was sourced from (name + href)

Example (books/sovereign-individual/index.yaml):

cover: cover.jpg
title: The Sovereign Individual
authors:
  - James Dale Davidson
  - William Rees-Mogg
year: "1997"
description: |
  Mastering the Transition to the Information Age.
language: [en]
formats: [ebook]
physical: false
glossary: [self-sovereignty, digital-autonomy]
links:
  - href: https://archive.org/details/the-sovereign-individual
    label: "→ číst na archive.org"
    external: true
source:
  name: Sovereign Engineering
  href: https://sovereignengineering.io/books

Development

bun install
bun run build   # generate dist/ output

Output

The build generates:

  • dist/index.json — all books with metadata
  • dist/books.js — ES module export
  • dist/books/{id}/ — cover images and resized variants
  • dist/history/{id}.json — per-book commit history with diffs
  • dist/changelog.json — all commits with referenced book changes

Deployment

Pushing to main triggers GitHub Actions to build and deploy dist/ to GitHub Pages. Enable Pages in your repository settings with source set to GitHub Actions.