Writing a chapter

Writing a chapter

Every chapter follows the same template, in this order, and scripts/check-chapters.py enforces it:

1. Front matter with the title N. Title.
2. An opening paragraph that names the chapter's layer or layers (data, model, interface, practice, culture) and links intro.ipynb#five-layers.
3. Prose sections, with :::{note} Dig deeper notes for optional depth, one :::{admonition} Research spotlight (class spotlight) 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.
4. ## This week's lab: Explore, Reflect, Create with ### Explore (about 30 min), ### Reflect (about 15 min), ### Create (about 45 min).
5. ## A critical look: … with the claim, the evidence, the method, and the limits as line-start bold labels.
6. Chapter summary (a tip admonition), five Questions, :::{seealso} Further reading with a cite key and a visible link per item, and :::{tip} Explore interactively with 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.