63Active IASP terms
17Axis A delivery roles
40Axis B modifiers
23Styled note variants
End-to-End Demonstrations
1. IASP Core Showcase (demo/essay-on-attentive-reading.md): Exercises Axis A delivery roles, Axis B compositions, .include fragment splicing, {{meta:version}} placeholders, stage guards, and AI disclosure sidecars.
Open Rendered HTML Essay →
View Clean Markdown (no HTML tags)
View Ghost CMS Markdown
Build & Open Screen PDF
2. Six-Server Authoring Interoperability Demo (demo/interoperability-essay.md): Co-authored across terminology-mcp, holdings-mcp, corpus-mcp, quote-mcp, zotero-mcp, and iasp-mcp with verified Calibre quotes (<!-- quote <id> -->), BetterBibTeX --citeproc citations, and compositional IASP wrappers.
Compose Layered Intent (delivery.modifier)
Test any combination of Axis A delivery roles, Axis B modifiers, and build hints (e.g. note.insight.major, sidebar.example, bridge.reflection.pre-pagebreak).
Resolved tokens: .note + .insight + .major
Valid IASP composition
Delivery role `note`: Ancillary content tied to a point, but not necessarily a formal footnote. The most-composed role: the build recognises a fixed set of note variants (see the 'Note variants' collection), each with its own box style, written note.<variant>. Modifier `insight` (exposition-and-support): Moment of realization or reframing. As a note variant (note.insight) it renders with an asterism row. Modifier `insight-major` (exposition-and-support): Build extension (note.insight.major, badge strip). An insight given more weight than the asterism form. Build modifier `.major` (marker): Composes with note.insight (note.insight.major) to promote the asterism row to a full badge strip.
Brace fence (canonical)
::: {.note .insight .major}
...
:::Shorthand fence
::: note.insight.major
...
:::Heading attribute
## Heading Title {.note .insight .major}- EPUB / HTML
Div with epub:type="note", CSS class .note.insight.major, glyph ⁂- XeLaTeX PDF
\begin{notebox} with \notevariantinsightmajor- Ghost Markdown
- HTML <div> (#dce8f5 background, #2a5fa5 border) with "⁂ INSIGHT" badge
Note Variants Palette (note.<variant>)
Each variant in the note-variants profile set renders with its own box environment in XeLaTeX, CSS custom properties in EPUB/HTML, and inline-styled HTML card in Ghost.
💡
::: note.idea
LaTeX:
notebox · inline-glyph
⁂ INSIGHT
::: note.insight
LaTeX:
notebox · asterism-row
⁂ INSIGHT
::: note.insight.major
LaTeX:
notebox · badge-strip
⚠ WARNING
::: note.warning
LaTeX:
noteboxwarning · badge-strip
› BREADCRUMB
::: note.breadcrumb
LaTeX:
noteboxbreadcrumb · badge-strip
⇥
::: note.transition
LaTeX:
noteboxtransition · inline-glyph
⚙ USAGE
::: note.usage
LaTeX:
noteboxusage · badge-strip
∞ INTEGRATION
::: note.integration
LaTeX:
noteboxintegration · badge-strip
⚖ RESPONSIBILITY
::: note.responsibility
LaTeX:
noteboxresponsibility · badge-strip
⟲ REFLEXIVE
::: note.reflexive
LaTeX:
noteboxreflexive · badge-strip
⊕ SYNTHESIS
::: note.synthesis
LaTeX:
noteboxsynthesis · badge-strip
◊ DISCLOSURE
::: note.disclosure
LaTeX:
noteboxdisclosure · badge-strip
◇ AI DISCLOSURE
::: note.ai
LaTeX:
noteboxdisclosure · badge-strip
⇢ NAVIGATION
::: note.navigation
LaTeX:
noteboxnavigation · badge-strip
⇢ ORIENTATION
::: note.orientation
LaTeX:
noteboxnavigation · badge-strip
— BRIDGE
::: note.bridge
LaTeX:
noteboxbridge · badge-strip
⇆
::: note.contrast
LaTeX:
noteboxcontrast · inline-glyph
✕ MISUSE
::: note.misuse
LaTeX:
noteboxmisuse · badge-strip
🔍 DIAGNOSTIC
::: note.diagnostic
LaTeX:
noteboxdiagnostic · badge-strip
∎ CLOSING NOTE
::: note.closing
LaTeX:
noteboxclosing · badge-strip
⊢ METHODOLOGY
::: note.methodology
LaTeX:
noteboxmethodology · badge-strip
◉ CONTEXT
::: note.context
LaTeX:
noteboxcontext · badge-strip
◎ SCOPE
::: note.scope
LaTeX:
noteboxscope · badge-strip
☐ CHECKLIST
::: note.checklist
LaTeX:
noteboxchecklist · badge-strip
◈ PRELUDE
::: note.prelude
LaTeX:
noteboxprelude · ornamentAxis A — Delivery Roles
How a passage relates to the surrounding narrative flow. Listed in delivery-order reading order, followed by build extensions.
| Slug / Notation | Role | Scope Note | Set |
|---|---|---|---|
front-matter, frontmatter |
front-matter | Material framing the work (preface, introduction, etc.). | delivery-order core |
series |
series | Optional super-division above parts; use only if helpful. Naming is configurable (see Part Naming). | delivery-order core |
part |
part | Major thematic division. | delivery-order core |
chapter |
chapter | Primary unit of argument. | delivery-order core |
section |
section | Subdivision within a chapter. | delivery-order core |
interlude |
interlude | Intentional pause or tonal shift. | delivery-order core |
bridge |
bridge | Transitional connective text. Also used as a note variant (note.bridge, lavender badge) to stitch concepts together inside a chapter or appendix. In builds a bridge maps to ARIA role complementary and accepts .pre-pagebreak / .post-pagebreak. | delivery-order core note-variants |
sidebar, aside |
sidebar | Optional digression or parallel track. Common compositions: sidebar.example, sidebar.background. Builds map it to epub:type aside and ARIA role complementary; .sidebar-block gives the full-width badge form. | delivery-order core |
note |
note | Ancillary content tied to a point, but not necessarily a formal footnote. The most-composed role: the build recognises a fixed set of note variants (see the 'Note variants' collection), each with its own box style, written note.<variant>. | delivery-order core |
footnote |
footnote | Localized ancillary content. Example composition: footnote.counterpoint. | delivery-order core |
endnotes, footnotes |
endnotes | Deferred ancillary content. The build's 'footnotes' class maps to doc-endnotes. | delivery-order core |
appendix |
appendix | Material outside the main narrative flow. | delivery-order core |
backmatter |
back-matter | Build extension. Material closing the work after the main narrative (bibliography, index, colophon, etc.); counterpart to front-matter. | |
callout |
callout | Build extension. A short aside lifted out of the flow with a light border-left treatment. | |
epigraph |
epigraph | Build extension. A quotation set at the head of a part, chapter or section. | |
epigraph-inline |
epigraph-inline | Build extension. An epigraph set within the running text rather than as a heading block. | |
sidebar-inline |
sidebar-inline | Build extension. A sidebar that sits inside the prose, with a glyph on its first line rather than a badge header. |
Axis B — Modifiers
What kind of rhetorical, expository, stance-signaling, or navigational work a passage is doing.
| Notation | Group | Scope Note | Sets |
|---|---|---|---|
claim |
argument-and-reasoning | Supporting assertion. | core |
contrast |
argument-and-reasoning | Build extension (note.contrast, inline ⇆ glyph). A short compare/contrast clarification between frameworks. | note-variants |
counterpoint |
argument-and-reasoning | Alternative or opposing view. | core |
implication |
argument-and-reasoning | Consequence of an argument. | core |
integration |
argument-and-reasoning | Build extension (note.integration, teal ∞ badge). Guidance on integrating or synthesising across frameworks. | note-variants |
provocation |
argument-and-reasoning | Intentionally unsettling prompt. | core |
qualification |
argument-and-reasoning | Limitation or nuance. | core |
reflection |
argument-and-reasoning | Interpretive or contemplative pause. Example: bridge.reflection. | core |
synthesis |
argument-and-reasoning | Integration of ideas. As a note variant (note.synthesis, green ⊕ badge): a block that integrates multiple strands into a single takeaway. | core note-variants |
thesis |
argument-and-reasoning | Central claim. Example: section.thesis, to mark a major move. | core |
analogy |
exposition-and-support | Comparative explanation. | core |
background |
exposition-and-support | Contextual grounding. Example composition: sidebar.background. | core |
case-study |
exposition-and-support | Extended real-world instance. | core |
checklist |
exposition-and-support | Build extension (note.checklist, teal ☐ badge). Indicative checklists, verification criteria or structured evidence markers. | note-variants |
context |
exposition-and-support | Build extension (note.context, warm slate ◉ badge). Contextual framing that sets the scene or establishes background. | note-variants |
definition |
exposition-and-support | Clarification of a term. Also usable alone as a block (::: definition, green glossary frame). Example composition: note.definition. | core |
diagnostic |
exposition-and-support | Build extension (note.diagnostic, blue 🔍 badge). Pattern-recognition checklists and diagnostic callouts. | note-variants |
example |
exposition-and-support | Concrete illustration. Also usable alone as a block (::: example, blue accent frame). Example composition: sidebar.example. | core |
gloss |
exposition-and-support | Brief explanatory note. | core |
idea |
exposition-and-support | Build extension (note.idea, inline 💡 glyph). A suggestion or generative thought offered in passing. | note-variants |
insight |
exposition-and-support | Moment of realization or reframing. As a note variant (note.insight) it renders with an asterism row. | core note-variants |
insight.major |
exposition-and-support | Build extension (note.insight.major, badge strip). An insight given more weight than the asterism form. | note-variants |
methodology |
exposition-and-support | Build extension (note.methodology, indigo ⊢ badge). Explains how the analysis is conducted. | note-variants |
usage |
exposition-and-support | Build extension (note.usage, steel-blue ⚙ badge). Guidance on how to apply a framework or idea. | note-variants |
breadcrumb |
reader-navigation | Pointer back to where an idea was introduced or forward to where it continues. note.breadcrumb (named as a common pattern in IASP Core) renders with a directional chevron; add .badge for the BREADCRUMB label. | note-variants |
closing |
reader-navigation | Build extension (note.closing, muted ∎ badge). Closing-note and endcap reflections. | note-variants |
navigation |
reader-navigation | Build extension (note.navigation, teal ⇢ badge). Reader-navigation breadcrumbs and orientation guides. The docs also list note.orientation for the same purpose, but iasp-semantics.lua has no 'orientation' variant, so it currently renders as a plain note. | note-variants |
prelude |
reader-navigation | Build extension (note.prelude). An opening note that prepares the reader for what follows. | note-variants |
transition |
reader-navigation | Build extension (note.transition, inline ⇥ glyph). Hand-off moments, scene shifts or narrative pivots. | note-variants |
assumption |
reader-signals-and-stance | Declared premise. | core |
caution |
reader-signals-and-stance | Advice against overreach. | core |
disclosure |
reader-signals-and-stance | Build extension (note.disclosure, violet ◊ badge). Transparency notes: assumptions, limits, or what is being disclosed. | note-variants |
limitation |
reader-signals-and-stance | Known constraint. | core |
misuse |
reader-signals-and-stance | Build extension (note.misuse, red ✕ badge). Flags common misreadings or warns against weaponizing a framework. | note-variants |
notice |
reader-signals-and-stance | Important framing information. | core |
reflexive |
reader-signals-and-stance | Build extension (note.reflexive, slate ⟲ badge). Reflexive cautions: the author or reader turning the analysis on themselves. | note-variants |
responsibility |
reader-signals-and-stance | Build extension (note.responsibility, amber ⚖ badge). Responsibility or accountability framing. | note-variants |
scope |
reader-signals-and-stance | Build extension (note.scope, warm copper ◎ badge). Delimits boundaries, applicability or evidentiary thresholds. | note-variants |
uncertainty |
reader-signals-and-stance | Epistemic humility. | core |
warning |
reader-signals-and-stance | Risk, harm or moral alert. As a note variant (note.warning) it renders with a warning badge. | core note-variants |
Profile Concept Sets (from terminology-mcp)
| Set | Ordered | Members | Description |
|---|---|---|---|
coreIASP Core |
No | 33 | The terms defined in IASP Core (Semantic Vocabulary §6–7): twelve delivery roles and twenty-one modifiers. Everything else in the scheme is a build extension or a grouping concept. |
delivery-orderDelivery roles in reading order |
Yes | 12 | IASP Core delivery roles in the order Semantic Vocabulary §6 lists them: framing, structural divisions from largest to smallest, connective and parallel text, then ancillary material. |
note-variantsNote variants |
No | 23 | Modifiers the build recognises after note (note.<variant>), each with its own box environment and badge or glyph: the keys of NOTE_VARIANT_CONFIG in iasp_tooling/lua/iasp-semantics.lua. Other modifiers composed with note still render, as a plain note box. |