• KB Home
  • Статья с блоками — тестирование asciidoc

Статья с блоками — тестирование asciidoc

В этой статье мы посмотрим примеры разметки инфо-блоков и изображений.

Блоки

Возможны очень простые блоки. Будем придерживаться трёх видов, которыми обычно пользуемся в WordPress: Tip, Info, Warning.

Это обычная информационная нота. В WordPress такой блок называется KB Info.
Это — важная нота или нота-предупреждение. В WordPress такой блок называется KB Warning.
Это — подсказка. В WordPress такой блок называется KB Tip.

Также возможные более сложные ноты в adoc, но возможны ли они в переносе в WordPress? Например, такая:

Какая-то расширенная нота.

Список:
  • 1

  • 2

  • 3

Какая-то ещё информация.

Изображения

Изображения могут идти просто по тексту, как отдельный элемент (отдельный блок Image в WordPress), так и как часть текста, inline image. Второй вариант очень важен для нас: мы часто используем изображения кнопок, чтоб было понятно, о чём идёт речь, а также скриншоты в статьях. Конечно, можно разрывать список каждый раз, когда вставляем изображение (потому что в WordPress изображения это отдельный блок), но это смотрится странно и нелепо в аутпуте, поэтому для демонстрации шагов мы как правильно используем inline изображения.

Обычное изображение

Обычное изображение в разметке использует два двоеточия.

image::image-1.png

Inline изображение

Inline изображение в разметке использует одно двоеточие.

  1. Шаг 1

  2. Шаг 2
    image:image-2.jpg

  3. Шаг 3

  4. Шаг 4 — в нём inline изображение кнопки image:image-3.png