-
Notifications
You must be signed in to change notification settings - Fork 0
Writing a chapter
Alexander Refsum Jensenius edited this page Sep 5, 2026
·
3 revisions
Every chapter follows the same template, in this order, and scripts/check-chapters.py enforces it:
- Front matter with the title
N. Title. - An opening paragraph that names the chapter's layer or layers (data, model, interface, practice, culture) and links
intro.ipynb#five-layers. - Prose sections, with
:::{note} Dig deepernotes for optional depth, one:::{admonition} Research spotlight(classspotlight) on a RITMO, fourMs or MishMash project. The book is standalone: it does not refer students to other courses, and the sibling courses at the department are named only in the course administration documents. -
## This week's lab: Explore, Reflect, Createwith### Explore (about 30 min),### Reflect (about 15 min),### Create (about 45 min). -
## A critical look: …with the claim, the evidence, the method, and the limits as line-start bold labels. - Chapter summary (a tip admonition), five Questions,
:::{seealso} Further readingwith a cite key and a visible link per item, and:::{tip} Explore interactivelywith the app links.
Draft a chapter in Markdown and convert it with the converter, which makes one cell per ## heading and turns ```{code-cell} python fences into code cells:
python scripts/md2nb.py draft.md book/chapter.ipynb
Executed code cells carry the hide-input tag, and the prose refers to the figure a cell produces, never to the cell. Run the checkers before committing:
python scripts/check-chapters.py
python scripts/check-style.py --files book/chapter.ipynb
Terminology the book holds to: a modality is a kind of data (text, image, audio, video, 3D, motion); "sensory modality" is used for perception; models are multimodal, people are multisensory; audio and video are data, auditory and visual are perception; "audiovisual" is not used except in the project name Audiovisual Rhythms.