Enscribe
Quotation & sourcing

Others’ words, and pointers at sources — quotation, citation, cross-reference, and links.

<a>

Compiles to eHTML <a>.

See <a https://example.com/docs | the documentation>.

See the documentation.

Minipage 20.

The positional URL form — the target is the first argument, the pipe content is the link text. The most common authoring path. (Markdown [text](url) is not an enscribe idiom; it renders as literal text.)

<bib-entry>

Compiles to eHTML <bib-entry>.

<bibliography>

Compiles to eHTML <bibliography>.

<blockquote>

Compiles to eHTML <blockquote>.

<quote | A short quotation.>

A short quotation.

Minipage 21.

The <quote> shorthand expands to <blockquote> at eHTML.

<cite>

Compiles to eHTML <cite>.

The argument is supported by data <cite goodall2024>.

The argument is supported by data .

Minipage 22.

A simple citation. The resolver renders the citation according to the document-level style. For author-year style, this becomes “(Goodall 2024)”. For numbered style, “[1]”. The actual rendered text is generated by the citation resolver, not written by the author.

<doi>

Compiles to eHTML <doi>.

<meta>
  <doi | 10.1234/example.2024>
</meta>
10.1234/example.2024
Minipage 23.

Bare DOI as the typical authoring form.

<q>

Compiles to eHTML <q>.

She said <q | hello> in passing.

She said hello in passing.

Minipage 24.

Browsers automatically render <q> with quotation marks. Authors do not include quotation marks in the content.

<ref>

Compiles to eHTML <ref>.

See <ref @fig:scatter> for details.

See ??ref: fig:scatter?? for details.

Minipage 25.

Canonical form: @id prefix (@ references; # would declare an id on the <ref> itself). The ref-resolution plugin replaces the <ref> node with a __ref-marker before hast conversion. The handler then renders an <a> element with computed text. Prefix word is lowercase, from the DEFAULT_PREFIXES dictionary keyed by id prefix.