KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

a-physical-book

★ 75 Open GitHub ↗

For National Novel Generation Month 2017

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# A Physical Book
### For <a href="https://github.com/NaNoGenMo/2017">National Novel Generation Month 2017</a>
Liza Daly

_A Physical Book_ makes a digitized book “physical” by rendering it in a simulated space where properties like gravity, friction, and velocity all apply. The program randomly perturbs the letters, then takes a snapshot at a point in time, re-assembling the images into a new, “un-digitized” book.

The raw, uncorrected scanned text of _<a href="https://publicdomainreview.org/collections/the-up-to-date-sandwich-book-400-ways-to-make-a-sandwich-1909/">The Up-To-Date Sandwich Book: 400 Ways to Make a Sandwich (1909)</a>_ is re-imagined as this 251 page (50,964 words) book:

### Usage

Install dependencies and run the dev server:

```
npm install
npm run dev
```

To build the library for embedding in another site:

```
npm run build
```

This produces ESM and UMD bundles in `dist/`. Import and call `createPhysicalBook`:

```js
import { createPhysicalBook } from 'a-physical-book'

const game = createPhysicalBook('#container', {
  text: 'Your plain text here...',  // text content to render
  effect: 'splatter'                // effect name (optional, random if omitted)
})
```

Available effects: `normal`, `splatter`, `squish`, `bump`, `rain`, `wind`, `spin`, `springy`, `crunch`, `slantLeft`, `slantRight`, `splitX`, `splitY`, `drift`. If no effect is specified, one is chosen at random. You can also import `effectNames` for the full list.

### Implementation
_A Physical Book_ uses the web-based game engine <a href="https://phaser.io">Phaser CE</a>. Each page of the book is rendered into an invisible `<div>` (to produce correct leading and line-height), then copied into the Phaser game world with each letter instantiated as a distinct addressable sprite.

For each page, one of a dozen transformations is applied to give the text varying physical properties, such as mass, acceleration, collision, or spin.

On page load, the provided text is rendered, the transformation is assigned, and the world is allowed to run. A Selenium wrapper script calls all 500 pages in succession, taking a screenshot at a random point in the animation:

The final book is rendered in a two-page spread PDF.

<a href="nanogenmo2017-lizadaly-small.pdf">Small 30 page sample</a>.

<a href="https://www.dropbox.com/s/lphwafia5qskokt/nanogenmo2017-lizadaly.pdf?dl=0">Full 50,000+ word, 250 page PDF</a> (55MB)

In a hilarious bit of recursion, it is also being hosted on <a href="https://archive.org/details/a_physical_book_liza_daly">The Internet Archive</a>, where the book scan originated.

a-physical-book

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README