Enscribe
Declarations & metadata

Statements about the work, not part of its discourse — titles, contributors, provenance, and configuration.

<abstract>

Compiles to eHTML <abstract>.

<abstract |
This paper presents new evidence that elephant populations
significantly affect regional climate patterns through their
role in shaping vegetation and carbon storage.
>

This paper presents new evidence that elephant populations significantly affect regional climate patterns through their role in shaping vegetation and carbon storage.

Minipage 56.

Unstructured abstract (the default). Single paragraph of summary prose.

<affiliation>

Compiles to eHTML <affiliation>.

<author>
  <name | Jane Goodall>
  <affiliation | Anthropic>
</author>
Jane Goodall Anthropic
Minipage 57.

Simple author affiliation. The affiliation sits as a sub-element of <author>, parallel to other rich-author-metadata elements (<orcid>, <email>).

<article-subtitle>

Compiles to eHTML <article-subtitle>.

<article-title>

Compiles to eHTML <article-title>.

<author>

Compiles to eHTML <author>.

<author | Jane Goodall>
Jane Goodall
Minipage 58.

Backward-compatible casual form (carried forward from before the structured-interface reconciliation). The pipe content sits as text content of <author>; it is NOT lifted to a <name> child — authors who want the structured shape use the kwarg form below or the child-tag form. JATS export reads the name string either way.

<book-part-subtitle>

Compiles to eHTML <book-part-subtitle>.

<book-part-title>

Compiles to eHTML <book-part-title>.

<book-subtitle>

Compiles to eHTML <book-subtitle>.

<book-title>

Compiles to eHTML <book-title>.

<config>

Compiles to eHTML <config>.

<config citation-style=author-year number-sections=true />
Minipage 59.

The authoring form for <config> is kwargs. Settings are read at the discovery pass into the configuration registry; the element itself produces no body output (it renders as an empty <config>).

<date>

Compiles to eHTML <date>.

<date | 2024-03-15>
2024-03-15
Minipage 60.

A bare <date> is UNTYPED (no data-date-type) — an authoring date is “when you wrote it” (like the date on a letter), not a publication date (cf. Quarto/Pandoc/Bookdown preamble date slots). Use an explicit type= (e.g. <date type=publication | …>) for a typed date. (#325)

<editor>

Compiles to eHTML <editor>.

<editor | The Editor>
The Editor
Minipage 61.

Casual form — the pipe content is the editor’s name (text content, not lifted to a <name> child), mirroring <author | …>.

<email>

Compiles to eHTML <email>.

<author>
  <name | Jane Goodall>
  <email | jane@example.org>
</author>
Jane Goodall jane@example.org
Minipage 62.

Author contact email. Common in journal article metadata for the corresponding author (see also the +corresponding boolean kwarg on <author>).

<keywords>

Compiles to eHTML <keywords>.

<meta>
  <keywords | elephants, conservation, climate, carbon storage>
</meta>
elephants, conservation, climate, carbon storage
Minipage 63.

Comma-separated keyword list — the simpler and more common authoring form. The exporter splits on commas when emitting JATS.

<lang>

Compiles to eHTML <lang>.

<meta>
  <lang | en-US>
</meta>
en-US
Minipage 64.

BCP 47 language tag. The eHTML form preserves the value as a child element of <meta>; downstream consumers (the JATS exporter, the render-mode lowering) project it where each format expects.

<license>

Compiles to eHTML <license>.

<meta>
  <license href="https://creativecommons.org/licenses/by/4.0/" | CC BY 4.0>
</meta>
CC BY 4.0
Minipage 65.

License name with canonical URL.

<meta>

Compiles to eHTML <meta>.

<meta type=article>
  <title | The Effect of Elephants on Climate>
  <author | Jane Goodall>
  <date | 2024-03-15>
</meta>

<section | Introduction>
The paper begins.
The Effect of Elephants on Climate Jane Goodall 2024-03-15
Introduction

The paper begins.

Minipage 66.

*Author writes <meta type=article> at the top with no <article> wrapper. The structural plugin reads type=article and generates:

  • the <article> container
  • <article-front> wrapping the original <meta>
  • <article-body> wrapping the section content <title> is promoted to <article-title> as the first child of <meta>. <meta> itself survives in the output, inside <article-front>.*
<name>

Compiles to eHTML <name>.

<author>
  <name | Jane Goodall>
</author>
Jane Goodall
Minipage 67.

The common case. Pipe content becomes the name string.

<orcid>

Compiles to eHTML <orcid>.

<author>
  <name | Jane Goodall>
  <orcid | 0000-0002-1825-0097>
</author>
Jane Goodall 0000-0002-1825-0097
Minipage 68.

Bare 16-digit ORCID — the canonical form.

<publication-date>

Compiles to eHTML <publication-date>.

<meta>
  <publication-date | 2024-03-15>
</meta>
2024-03-15
Minipage 69.

ISO 8601 publication date — the preferred form.

<section-subtitle>

Compiles to eHTML <section-subtitle>.

<section-title>

Compiles to eHTML <section-title>.

<sub-section-subtitle>

Compiles to eHTML <sub-section-subtitle>.

<sub-section-title>

Compiles to eHTML <sub-section-title>.

<sub-sub-section-subtitle>

Compiles to eHTML <sub-sub-section-subtitle>.

<sub-sub-section-title>

Compiles to eHTML <sub-sub-section-title>.

<subject>

Compiles to eHTML <subject>.

<meta>
  <subject | Ecology of large mammals>
</meta>
Ecology of large mammals
Minipage 70.

Free-form subject. Common for general-interest documents.

<subtitle>

Compiles to eHTML <subtitle>.

<meta>
  <title | The Effect of Elephants on Climate>
  <subtitle | A Multi-Year Field Study in Tanzania>
</meta>
The Effect of Elephants on Climate A Multi-Year Field Study in Tanzania
Minipage 71.
<title>

Compiles to eHTML <title>.

<meta>
  <title | The Effect of Elephants on Climate>
</meta>
The Effect of Elephants on Climate
Minipage 72.

Inside <article>, <title> in <meta> becomes <article-title>.

<version>

Compiles to eHTML <version>.

<meta>
  <version | 1.0.0>
</meta>
1.0.0
Minipage 73.

Semantic version. Other formats are equally valid as a free-form string.