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.
Unstructured abstract (the default). Single paragraph of summary prose.
<affiliation>Compiles to eHTML <affiliation>.
<author>
<name | Jane Goodall>
<affiliation | Anthropic>
</author>
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>.
<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 />
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>
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>
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>
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>
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>
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>
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 paper begins.
*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>
The common case. Pipe content becomes the name string.
<orcid>Compiles to eHTML <orcid>.
<author>
<name | Jane Goodall>
<orcid | 0000-0002-1825-0097>
</author>
Bare 16-digit ORCID — the canonical form.
<publication-date>Compiles to eHTML <publication-date>.
<meta>
<publication-date | 2024-03-15>
</meta>
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>
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>
<title>Compiles to eHTML <title>.
<meta>
<title | The Effect of Elephants on Climate>
</meta>
Inside <article>, <title> in <meta> becomes <article-title>.
<version>Compiles to eHTML <version>.
<meta>
<version | 1.0.0>
</meta>
Semantic version. Other formats are equally valid as a free-form string.