1. Purpose
This document demonstrates how SIDECAR can extend a clean TEXTv1.2 source without mixing visual or rich-document details into the narrative text.
The source text stays simple. The richer behavior is delegated to the sidecar layer.
1.1 Supported Concept
The sidecar layer can inject richer elements into selected sections while the text source keeps only sections, paragraphs, and simple lists.
The same mechanism can also reclassify a block range into another document object when that is more expressive than plain narrative paragraphs.
1.2 Supported Selector Families
This section summarizes the selector families used by the current injector design.
Selectors are attached to a target section and then place or transform richer content relative to paragraphs, lists, notes, or block ranges.
2. Example Injection Targets
This chapter contains deliberately simple source text so the rendered example can visibly show what comes from TEXT and what comes from SIDECAR.
2.1 Admonition After Paragraph
The first paragraph is plain source text.
The second paragraph is also plain source text and acts as a stable anchor for a note inserted after paragraph two.
2.2 Figure, Code, and Table
This paragraph introduces a figure example.
This paragraph introduces a code block example.
injections:
- id: example
type: figure
target:
section: "2.2"
after_paragraph: 0
This paragraph introduces a table example.
| Capability | Example |
|---|---|
| Admonition | after_paragraph |
| Figure | after_paragraph |
| Code block | after_paragraph |
| Table | after_paragraph |
| Reclassify | start_block + end_block |
2.3 Reclassification Example
This last paragraph stays outside the wrapped range and should remain a normal paragraph.
3. Notes
The best way to understand SIDECAR is to compare the clean source with the rendered result.
A good demo keeps the text source readable while the sidecar shows how richer structure can be added around it.