speech

Verbosity

Per-role behavior of each verbosity preset (see Preferences), from src/preferences/verbosityTables.ts, generated by npm run generate-verbosity-tables. Under "custom", skip/contextualize from SpeechPreferences replace both tables.

Roles in interruptionRoles (abbreviation, biblioref, glossref, noteref, pagebreak) are never skipped by a preset; where they’re read is set by interruptions, under every preset.

Skipped roles

A skipped role is dropped with its whole subtree β€” content and announcement both. Roles not listed are never skipped by a preset.

| Role | none | few | some | most | | β€” | β€” | β€” | β€” | β€” | | aside | βœ“ | βœ“ | βœ“ | | | audio | βœ“ | | | | | bibliography | βœ“ | βœ“ | βœ“ | | | cell | βœ“ | βœ“ | | | | columnheader | βœ“ | βœ“ | | | | details | βœ“ | βœ“ | | | | endnotes | βœ“ | βœ“ | βœ“ | | | figure | βœ“ | | | | | glossary | βœ“ | βœ“ | βœ“ | | | image | βœ“ | | | | | landmarks | βœ“ | βœ“ | βœ“ | βœ“ | | loa | βœ“ | βœ“ | βœ“ | βœ“ | | loi | βœ“ | βœ“ | βœ“ | βœ“ | | lot | βœ“ | βœ“ | βœ“ | βœ“ | | lov | βœ“ | βœ“ | βœ“ | βœ“ | | pullquote | βœ“ | βœ“ | βœ“ | | | row | βœ“ | βœ“ | | | | rowheader | βœ“ | βœ“ | | | | table | βœ“ | | | | | toc | βœ“ | βœ“ | βœ“ | βœ“ | | video | βœ“ | | | |

Contextualized roles

A contextualized role gets an announcement from the contextualization catalog; its content plays either way. none contextualizes nothing. Shape is the catalog’s (see inline vs block); for table, the cell gives the shape spoken at that level.

| Role | Shape | few | some | most | | β€” | β€” | β€” | β€” | β€” | | abstract | block | | | βœ“ | | acknowledgments | block | | | βœ“ | | afterword | block | | | βœ“ | | appendix | block | | | βœ“ | | aside | block | | | βœ“ | | audio | inline | βœ“ | βœ“ | βœ“ | | backlink | β€” | | | βœ“ | | bibliography | block | | | βœ“ | | biblioref | inline | | | βœ“ | | blockquote | inline | | βœ“ | βœ“ | | chapter | block | | βœ“ | βœ“ | | colophon | inline | | | βœ“ | | complementary | block | | | βœ“ | | conclusion | block | | | βœ“ | | cover | inline | | βœ“ | βœ“ | | credit | inline | | | βœ“ | | credits | block | | | βœ“ | | dedication | inline | | | βœ“ | | definition | inline | | | βœ“ | | details | block | | βœ“ | βœ“ | | endnotes | block | | | βœ“ | | epigraph | inline | | | βœ“ | | epilogue | block | | | βœ“ | | errata | block | | | βœ“ | | example | block | | | βœ“ | | figure | inline | βœ“ | βœ“ | βœ“ | | footnote | block | | | βœ“ | | foreword | block | | | βœ“ | | glossary | block | | | βœ“ | | glossref | inline | | | βœ“ | | heading1 | inline | | | βœ“ | | heading2 | inline | | | βœ“ | | heading3 | inline | | | βœ“ | | heading4 | inline | | | βœ“ | | heading5 | inline | | | βœ“ | | heading6 | inline | | | βœ“ | | image | inline | βœ“ | βœ“ | βœ“ | | index | block | | | βœ“ | | introduction | block | | | βœ“ | | list | block | | | βœ“ | | listItem | inline | | | βœ“ | | math | inline | βœ“ | βœ“ | βœ“ | | noteref | β€” | | | βœ“ | | notice | inline | | βœ“ | βœ“ | | pagebreak | inline | | | βœ“ | | pagelist | block | | | βœ“ | | part | inline | | βœ“ | βœ“ | | preface | block | | | βœ“ | | preformatted | β€” | | βœ“ | βœ“ | | prologue | block | | | βœ“ | | pullquote | inline | | | βœ“ | | qna | block | | βœ“ | βœ“ | | row | inline | | βœ“ | βœ“ | | rowheader | inline | | βœ“ | βœ“ | | separator | inline | | | βœ“ | | subtitle | inline | | βœ“ | βœ“ | | summary | inline | | | βœ“ | | table | inline/block | inline | block | block | | term | inline | | | βœ“ | | tip | inline | | βœ“ | βœ“ | | video | inline | βœ“ | βœ“ | βœ“ |

β€”: no catalog entry, so the role stays silent unless one is supplied via contextualization.contextualizations.

cell and rowheader are exceptions: when not skipped, they always use their header/value wording, whatever the preset or contextualize.

Override a level’s table shape, or set shapes under "custom", with contextualizationOverrides.shapes.