Enscribe
Open in playground ↗
Aside

The author steps aside in their own secondary voice — notes, boxed asides, and disclosure.

<aside> General Usage

Semantic role: aside. Compiles to eHTML <aside>.

Registers:

  • Canonical: <aside>
<aside | A side note about the elephant.>
Minipage 35.
<aside type=warning .important | Be careful here.>
Minipage 36.
<aside type=callout |
This is a multi-line callout.

It can contain multiple paragraphs and other content like
<strong | emphasis> and inline references.
>
Minipage 37.
 Arguments
attribute kind values / default notes
type kwarg note sidebar callout warning tip info caution Optional classification of the aside’s role.
title kwarg Optional title rendered at the top of the aside (the frameable title-top convention, #31).
caption kwarg Optional caption rendered at the foot of the aside (frameable caption-bottom convention, #31), with the “Box N.” label folded in when numbered.
+numbered / -numbered flag default off Whether this aside is numbered.
+border / -border flag default on Frameable surface (#31).
<details> General Usage

Semantic role: details. Compiles to eHTML <details>.

Registers:

  • Canonical: <details>
<details>
  <summary | More background>
  Additional context for the curious reader. The summary is the
  visible heading; this body shows when the disclosure is opened.
</details>
More background

Additional context for the curious reader. The summary is the visible heading; this body shows when the disclosure is opened.

Minipage 38.

The canonical shape: a <summary> for the visible heading, followed by the disclosure body. The body is recursively parsed as prose / block content.

<details +open>
  <summary | Always-expanded section>
  This disclosure is expanded by default.
</details>
Always-expanded section

This disclosure is expanded by default.

Minipage 39.

The +open boolean kwarg expands the disclosure by default. Maps to HTML’s standard open attribute.

 Arguments
attribute kind values / default notes
open kwarg true false HTML’s open attribute on <details>.
<endnotes> General Usage

Semantic role: endnotes. Compiles to eHTML <endnotes>.

Registers:

  • Canonical: <endnotes>
<note> General Usage

Semantic role: note. Compiles to eHTML <note>.

Registers:

  • Canonical: <note>
Some text<note | A substantive note about the text.>.

Some text1.

  1. 1

    A substantive note about the text.

    ↩
Minipage 40.
A claim<note placement=foot | A footnote.>.

A claim1.

  1. 1

    A footnote.

    ↩
Minipage 41.
A definition<note position=margin | A margin note.>.

A definition11

A margin note.

.

  1. 1

    A margin note.

    ↩
Minipage 42.
 Arguments
attribute kind values / default notes
placement kwarg end foot margin (default end) The note’s position — one note type, three positions.
position kwarg end foot margin Alias for “placement” (same values, same data-note-placement output).
type kwarg substantive technical editorial translator other (default substantive) Optional classification.
<note-list> General Usage

Semantic role: note-list. Compiles to eHTML <note-list>.

Registers:

  • Canonical: <note-list>
 Arguments
attribute kind values / default notes
type kwarg end-notes chapter-notes footnotes-collected other (default end-notes)
<summary> General Usage

Semantic role: summary. Compiles to eHTML <summary>.

Registers:

  • Canonical: <summary>
<summary | More background>
More background
Minipage 43.

The visible heading of a <details> disclosure. Appears as a child of <details>.

<summary | Click to reveal the <em | hidden> details>
Click to reveal the hidden details
Minipage 44.

Inline markup in a summary. The recursive-content pass parses the pipe content normally.