В этой статье мы посмотрим примеры разметки инфо-блоков и изображений.
Блоки
Возможны очень простые блоки. Будем придерживаться трёх видов, которыми обычно пользуемся в WordPress: Tip, Info, Warning.
Это обычная информационная нота. В WordPress такой блок называется KB Info. |
Это — важная нота или нота-предупреждение. В WordPress такой блок называется KB Warning. |
Это — подсказка. В WordPress такой блок называется KB Tip. |
Также возможные более сложные ноты в adoc, но возможны ли они в переносе в WordPress? Например, такая:
Какая-то расширенная нота. Список:
Какая-то ещё информация. |
Изображения
Изображения могут идти просто по тексту, как отдельный элемент (отдельный блок Image в WordPress), так и как часть текста, inline image. Второй вариант очень важен для нас: мы часто используем изображения кнопок, чтоб было понятно, о чём идёт речь, а также скриншоты в статьях. Конечно, можно разрывать список каждый раз, когда вставляем изображение (потому что в WordPress изображения это отдельный блок), но это смотрится странно и нелепо в аутпуте, поэтому для демонстрации шагов мы как правильно используем inline изображения.
Обычное изображение
Обычное изображение в разметке использует два двоеточия.
image::image-1.png
Inline изображение
Inline изображение в разметке использует одно двоеточие.
-
Шаг 1
-
Шаг 2
image:image-2.jpg -
Шаг 3
-
Шаг 4 — в нём inline изображение кнопки image:image-3.png