<image>
The <image> tag embeds an image in a document. It can reference an external
file with @source or include code-generated content such as a
<latex-image> or <asymptote> block.
Most non-decorative images should include a <description>
or <shortdescription>, and many images are wrapped
in a <figure>.
Syntax
Variants
There are 3 variants of <image>.
Attributes
| Attribute | Required? | Values |
|---|---|---|
archive = "…" | optional | string |
component = "…" | optional | string |
decorative = "…" | optional | "no" |
margins = "…" | optional | string |
width = "…" | optional | string |
xml:id = "…" | optional | string |
Children
The following may appear as children:<asymptote> <description> <latex-image> <mermaid> <pf:prefigure> <sageplot> <shortdescription> Parents
This element may appear as an immediate child of the following elements:<abstract> <acknowledgement> <activity> <algorithm> <answer> <appendix> <article> <aside> <assemblage> <biographical> <biography> <case> <chapter> <claim> <colophon> <computation> <conclusion> <convention> <corollary> <data> <example> <exercise> <exploration> <fact> <feedback> <figure> <gi> <headnote> <hint> <historical> <identity> <insight> <introduction> <investigation> <lemma> <li> <note> <observation> <page> <paragraphs> <postlude> <preface> <prelude> <problem> <project> <prompt> <proof> <proposition> <question> <remark> <section> <sidebyside> <solution> <stack> <statement> <subsection> <subsubsection> <task> <technology> <theorem> <warning> <worksheet> Attributes
| Attribute | Required? | Values |
|---|---|---|
archive = "…" | optional | string |
component = "…" | optional | string |
decorative = "…" | optional | "no" |
margins = "…" | optional | string |
rotate = "…" | optional | string |
source = "…" | required | string |
width = "…" | optional | string |
xml:id = "…" | optional | string |
Children
The following may appear as children:<description> <shortdescription> Parents
This element may appear as an immediate child of the following elements:<abstract> <acknowledgement> <activity> <algorithm> <answer> <appendix> <article> <aside> <assemblage> <biographical> <biography> <case> <chapter> <claim> <colophon> <computation> <conclusion> <convention> <corollary> <data> <example> <exercise> <exploration> <fact> <feedback> <figure> <gi> <headnote> <hint> <historical> <identity> <insight> <introduction> <investigation> <lemma> <li> <note> <observation> <page> <paragraphs> <postlude> <preface> <prelude> <problem> <project> <prompt> <proof> <proposition> <question> <remark> <section> <sidebyside> <solution> <stack> <statement> <subsection> <subsubsection> <task> <technology> <theorem> <warning> <worksheet> Attributes
| Attribute | Required? | Values |
|---|---|---|
decorative = "…" | optional | "no" |
pg-name = "…" | optional | string |
width = "…" | optional | string |
Children
The following may appear as children:<description> <latex-image> <shortdescription> Parents
This element may appear as an immediate child of the following elements:<hint> <solution> <statement> Examples
<image source="images/triangle.png" width="55%">
<description>
<p>A right triangle with legs labeled 3 and 4.</p>
</description>
</image><image width="50%">
<description>
<p>A circle centered at the origin with radius 2.</p>
</description>
<latex-image>
\begin{tikzpicture}
\draw (0,0) circle (1.5cm);
\end{tikzpicture}
</latex-image>
</image>