Иллюстрация

Иллюстрация показывает одно изображение с обязательным альтернативным текстом и необязательной подписью. Пропорции можно закрепить без искажения файла.

Общий пример

Общий примерMarkdown

Markdown

content_copyCopy

:::figure {ratio=16/9 fit=cover}
![Интерфейс документации](../../assets/docara-screen.png)

Широкая иллюстрация заполняет область 16:9.
:::

Соотношение сторон

Заполнение

fit=cover заполняет всю область и при необходимости обрезает края. fit=contain показывает изображение целиком и подходит для знаков и схем.

Показать целикомMarkdown

Markdown

content_copyCopy

:::figure {ratio=1/1 fit=contain}
![Знак Docara](../../assets/docara-mark.svg)

Знак показан целиком внутри квадратной области.
:::

Вызов

:::figure {ratio=4/3 fit=cover}
![Схема сборки](../../assets/docara-flow.png)

Короткая подпись дополняет изображение.
:::

Альтернативный текст описывает смысл изображения, а не его оформление. Подпись не заменяет alt-текст; не используйте блок для нескольких изображений.