Skip to content

An AI skill that turns books into animated, narrated, interactive web experiences

docs(films): only the shorts kit's chapter.html carries the map lines

yzr82bb9624f03d
diff --git a/.claude/skills/papermorph/references/films/films.md b/.claude/skills/papermorph/references/films/films.md
index 660292b..61998fe 100644
--- a/.claude/skills/papermorph/references/films/films.md
+++ b/.claude/skills/papermorph/references/films/films.md
@@ -35,7 +35,7 @@ Then agree the models ([core/style.md](../core/style.md#models)) and write `book
- `books/<book>/` holds the storyboard (`storyboard.md`, or a short's `chNN-script.md`: outline, beats with what we see, sources), `art/` (`found/` with the downloads and `SOURCES.tsv`, generated pictures and clips, the `prep.py` list, the cost ledger) and `music/`.
- `site/<book>/img/` holds the treated pictures with `art.js` (from `prep.py`), clip sheets with `frames.js` (`frames.py`) and, when used, `lib/lines.js` (`trace.py`). Each `chNN/` has `audio/<lang>/`, `audio/bgm/` and, for a short, `audio/sfx/`.
- The kit's sample beat shows a picture named `first-picture` (a short's: `img/hook-picture.webp`) once it exists. Until a short's picture exists the browser draws a broken image and the console shows one 404, so `shot.py`, which stops on any page error, takes no screenshots. Voice the sample with `tts.py` and open `ch01/` to check the folder works, then replace the narration with the film's script.
-- The music line in `chapter.html` is commented out until the film has its track, and so are the map kit's lines.
+- The music line in `chapter.html` is commented out until the film has its track. A short's `chapter.html` also has the map kit's lines commented out; a documentary's has none, so a documentary with a map copies them from `assets/templates/shorts/chapter.html` (`geo-lite.js` and `map.js` after `film.js`, and the start through `loadGlobe()` when a beat uses the globe).
- A documentary's `index.html` is the picture-book series page in the film's colours and fonts, with a credits section listing every picture and recording from `SOURCES.tsv`; a single film is a series of one. A series of shorts gets a series page later, as any book does; until then the player's home button leads nowhere. Shorts can also live on their long film's page: *Madness and Civilization* lists its shorts at `/madness/#shorts`, and the host's `_redirects` sends `/madness-shorts/` there.
- The film's own recurring pieces go in the book's lib: at the end of a documentary's `film.js`, or in a short's second file loaded after `shorts.js` (*Madness and Civilization*: `lib/madness.js`).