Documentation OpenEdition

08. Styling figures

Temps de lecture : 3 minutes

0:00 4:42
Keywords: ,
Goals:
  • Apply styles to figures in a document for Lodel;
  • Enrich the processed data and make them accessible.

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:
  1. Figure section;
  2. Figure title;
  3. Figure;
  4. Figure alternative text;
  5. Figure caption;
  6. Figure credits.
Commons Publishing StylesDescription Technical tips
¶ Figure section
TEI_figure_start
TEI_figure_end
Section, with start and end tags, to be added for all figures with metadata:
  • ¶ Figure title;
  • ¶ Figure alternative text;
  • ¶ Figure caption;
  • ¶ Figure credits.

Warning: Images anchored to a text will not be displayed properly in Lodel. They must be in line with the text.
  1. Click on Figure section → The ##### FIGURE START ##### and ##### FIGURE END ##### tags are displayed;
  2. Insert the figure between the tags along with the metadata, in the following order, and each within a separate paragraph:
    1. Title styled as ¶ Figure title;
    2. Figure styled as ¶ Normal;
    3. Alternative text styled as ¶ Figure alternative text;
    4. Caption styled as ¶ Figure caption;
    5. Credits styled as ¶ Figure credits.
  • Do not rename the ##### FIGURE START ##### and ##### FIGURE END ##### tags.
¶ Figure title
TEI_figure_title
Title of the figure
  • One paragraph only;
  • Cannot be applied outside of a section;
  • Several titles, including a translated title: place each title within a separate paragraph and allocate a language to the translated title:
    1. Select the relevant translated title;
    2. Click on Add language to style under Tools → A dialogue box opens;
    3. Select the language required;
    4. Click on Validate.
¶ Normal
Normal (under the Text menu)
To display the figure: illustration, image or graph
  1. Click on This device or Pictures (depending on your version of Microsoft Word) → a dialogue box opens;
  2. Insert the figure you want to add;
  3. Click on Ok.
  • One paragraph only;
  • In line with the text (Microsoft Word’s picture formatting option);
  • Several figures in the same section: each figure must be placed in a separate paragraph.

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
  • To add alternative text:
    1. Click on Figure alternative text (in Windows) or Alt Text (on MacOS);
    2. Enter the alternative text.
  • Short text;
  • Place it after the figure;
  • No extra formatting;
  • One paragraph only;
  • Cannot be applied outside of a section;
  • Several figures in the same section: place alternative texts directly under the figure they describe.
¶ Figure caption
TEI_figure_caption
Caption for the figure
  • One paragraph only;
  • Cannot be applied outside of a section.
¶ Figure credits
TEI_figure_credits
Figure credits
  • One paragraph only;
  • Cannot be applied outside of a section.
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 #

Screenshot – A figure section 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.

Screenshot – A figure section with its metadata
Secret Link