Goals:
|
Specifications for figures #
- JPEG or PNG formats required, recommended image resolution of 150 DPI, 7 million pixels at most (width x height, e.g. 2000×3500 or 1000×7000), RGB colour model.
- Important: Do not use the “Save for Web” option, which tends to reduce the quality.
- Credits and licenses: You must enter credits and the phrase “All rights reserved” or “Public domain”, or the license that applies to reuse of the figures (graphs, photos, tables, etc.). In any case, you must cite the author of the figure in the credits.
- Enter the figure sections and corresponding metadata in the following order:
- Figure section;
- Figure title;
- Figure;
- Figure alternative text;
- Figure caption;
- Figure credits.
| Commons Publishing Styles | Description | Technical tips |
|---|---|---|
| ¶ Figure section TEI_figure_start TEI_figure_end | Section, with start and end tags, to be added for all figures with metadata:
Warning: Images anchored to a text will not be displayed properly in Lodel. They must be in line with the text. |
|
| ¶ Figure title TEI_figure_title | Title of the figure |
|
| ¶ Normal Normal (under the Text menu) | To display the figure: illustration, image or graph |
Warning: the document switches to Page mode when you insert figures. To continue styling, switch back to Draft mode. |
| ¶ Figure alternative text TEI_figure_alttext | Required to make the document accessible by providing a written description of the figure |
|
| ¶ Figure caption TEI_figure_caption | Caption for the figure |
|
| ¶ Figure credits TEI_figure_credits | Figure credits |
|
| Alternative text! |
|---|
| To make the figures more accessible to people with health conditions or impairments, the figure needs to be enriched with a short, written description (alternative text) of a long description (descriptive text). When styling figures, alternative texts are preferable. It is a short text, simple in structure (consisting of one paragraph, with no lists, tables, etc.) and with no extra formatting, which describes the visual content (illustration, diagram, graph, map, photo, etc.) and its main characteristics (purpose — decorative or informative, etc.). Source : Éditions Quæ – Guide pour la préparation des textes alternatifs aux images (Guide to preparing alternative texts for pictures), July 2023. |
Figures without metadata #
If figures are inserted into the text without metadata (not advisable), you do not need to use the figure section. The figure is inserted by itself in a paragraph styled as ¶ Normal.
In-text figures #
In-text figures (inserted within and in line with a text) can be added directly in a paragraph, regardless of its type (bullet points, ordered lists, footnotes).
The specifications for in-text figures are as follows: JPEG, PNG or SVG formats, a recommended image resolution of between 12 and 15 pixels in height.
| Using SVG files |
|---|
| Illustrations in SVG format can cause errors during ePub generation, particularly when created using Illustrator; we therefore recommend using them only for inline figures. In all other cases, it is strongly recommended that you use figures in JPG or PNG format. |
Example of a figure with its metadata #

Example of two figures with a single set of metadata #
It is possible to insert several figures in the same section that share the same metadata, i.e.: the same title, caption or credits. However, alternative texts remain unique to each figure in the section.
Please note that a translated title can also be added by specifying its language.
