Markdown представляет собой язык разметки, который позволяет форматировать текст с помощью простых, интуитивно понятных символов прямо в обычном тексте. В отчеты Stimulsoft добавлен специальный компонент для создания текста с разметкой Markdown. Компонент полностью поддерживает официальную спецификацию CommonMark 0.31.2. Настройка компонента выполняется в его редакторе и при помощий свойств компонента.

 

Чтобы добавить в отчет компонент Markdown, выполните следующие действия:

strel11 Выберите компонент Markdown на Инструментарии (Toolbox) или на вкладке Вставить (Insert) в группе Компоненты (Components);

strel11 Разместите компонент на странице отчета или в любом другом месте отчета.

 

Параметры Markdown доступны в редакторе компонента и через его свойства. Чтобы вызвать редактор:

strel11 Дважды щелкните по компоненту Markdown;

strel11 Либо выделите компонент Markdown и выберите команду Редактировать (Design) в контекстном меню.

 

Информация

 

Ознакомиться с примерами оформления текста в разметке Markdown можно в соответствующей главе.

 

 

 

Редактор Markdown

В редакторе компонента Markdown команды форматирования текста представлены в виде элементов управления. Это позволяет быстро и легко форматировать текст, включая вставку таблиц, гиперссылок, списков и т. д. Также в редакторе есть панель предпросмотра, на которой отображается отформатированный текст.

 

 

img_1 Кнопка Жирный (Bold). Оборачивает выделенный текст в ** для выделения полужирным.

img_2 Кнопка Наклонный (Italic). Оборачивает выделенный текст в * для выделения курсивом.

img_3 Кнопка Зачеркнутый (Strikeout). Оборачивает выделенный текст в ~~ для зачеркивания.

img_4 Кнопка Код (Code). Оформляет выделенный текст как строчный код с помощью `, а многострочное выделение — как блок кода в ```.

img_5 Кнопка Заголовок 1 (Heading 1). Превращает текущую строку в заголовок первого уровня (#).

img_6 Кнопка Заголовок 2 (Heading 2). Превращает текущую строку в заголовок второго уровня (##).

img_7 Кнопка Заголовок 3 (Heading 3). Превращает текущую строку в заголовок третьего уровня (###).

img_8 Кнопка Маркеры (Bullets). Преобразует выделенные строки в маркированный список (-).

img_9 Кнопка Нумерованный список (Ordered List). Преобразует выделенные строки в нумерованный список (1., 2. ...).

img_10 Кнопка Список задач (Task List). Преобразует выделенные строки в список задач с флажками (- [ ]).

img_11 Кнопка Цитата (Blockquote). Помечает текущую строку как цитату (>).

img_12 Кнопка Вставить ссылку (Insert Link). Вставляет гиперссылку в формате [text](url).

img_13 Кнопка Вставить изображение (Insert Image). Вставляет изображение в формате ![alt](url).

img_14 Кнопка Блок кода (Code Block). Вставляет блок-врезку - > [!NOTE], > [!TIP], > [!IMPORTANT], > [!WARNING] или > [!CAUTION].

img_15 Кнопка Горизонтальная линия (Horizontal Line). Вставляет горизонтальный разделитель (---) на новой строке.

img_16 Кнопка Таблица (Table). Вставляет заготовку таблицы со строкой заголовка и строкой-разделителем.

img_17 Кнопка Выражение (Expression). Вставляет в текст выражение (колонку данных или переменную).

img_18 Поле Тема (Theme). Предоставляет возможность изменить тему оформления панели предпросмотра (например, GitHub Light). Влияет только на предпросмотр, но не на то, как текст выводится в отчете.

img_19 Панель редактора слева. Введите или вставьте здесь исходный текст Markdown.

img_20 Панель просмотра справа. Показывает отформатированный текст в том виде, в каком он появится при просмотре отчета.

 

 

Таблица свойств

Ниже приведен список свойств компонента Markdown.

 

Наименование

Описание

Текст (Text)

Предоставляет возможность указать содержимое компонента Markdown, т.е. исходный текст с разметкой Markdown.

Цвета (Colors)

Группа свойств для настройки оформления отображаемого текста. По умолчанию используются встроенные темы оформления, но с помощью этой группы свойств можно настроить пользовательские темы оформления и форматирования текста.

Редактируемый (Editable)

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

Только текст (Only Text)

Предоставляет возможность отключить обработку разметки Markdown. В этом случае специальные символы выводятся как обычный текст.

Слева (Left)

Отступ текущего компонента от левой границы страницы. Значение указывается в единицах измерения отчета.

Сверху (Top)

Отступ текущего компонента от верхней границы страницы. Значение указывается в единицах измерения отчета.

Ширина (Width)

Ширина текущего компонента. Значение указывается в единицах измерения отчета.

Высота (Height)

Высота текущего компонента. Значение указывается в единицах измерения отчета.

Минимальный размер (Min Size)

Группа свойств, которая предоставляет возможность указать минимальную ширину и высоту для текущего компонента.

Максимальный размер (Max Size)

Группа свойств, которая предоставляет возможность указать максимальную ширину и высоту для текущего компонента.

Граница (Border)

Группа свойств, которая предоставляет возможность настроить отображение границ компонента. Определить можно стороны, которые будут отображаться, цвет границ, толщину и стиль, а также тень компонента.

Кисть (Brush)

Предоставляет возможность изменить тип кисти, цвет и другие настройки кисти для фона компонента в отчете.

Поля (Margins)

Группа свойств, которая предоставляет возможность указать отступы содержимого от границ данного компонента.

Условия (Conditions)

Предоставляет возможность вызвать редактор условного форматирования отчета.

Стиль компонента (Component Style)

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

Использовать стили владельца (Use Parent Styles)

Использует стиль компонента отчета, которому принадлежит текущий компонент.

Привязка (Anchor)

Определяет, как положение текущего компонента будет привязано к размерам компонента-владельца.

Может разрываться (Can Break)

Предоставляет возможность определить, может компонент или не может разрывать содержимое на несколько страниц.

Может расти (Can Grow)

Автоматически увеличивает высоту компонента.

Может сжиматься (Can Shrink)

Автоматически уменьшает высоту компонента.

Стиль стыковки (Dock Style)

Задает режим стыковки текущего компонента с другими.

Доступность (Enabled)

Включает или отключает обработку текущего компонента при построении отчета.

Расти в высоту (Grow to Height)

Автоматически изменяет высоту текущего компонента в зависимости от высоты компонента-владельца.

Взаимодействие (Interaction)

Определяет параметры взаимодействия для текущего компонента при просмотре отчета.

Печатать (Printable)

Определяет поведение компонента при печати — печатать его или нет.

Печатать на (Print On)

Определяет режим печати компонента.

Режим смещения (Shift Mode)

Определяет режим смещения компонента в зависимости от поведения компонента, расположенного выше.

Наименование (Name)

Изменяет наименование текущего компонента.

Псевдоним (Alias)

Изменяет псевдоним текущего компонента.

Ограничения (Restrictions)

Настраивает права использования текущего компонента:

strel11 Параметр Allow Change включает или отключает изменение компонента. Если флажок установлен, текущий элемент можно изменить.

strel11 Параметр Allow Delete включает или отключает удаление компонента.

strel11 Параметр Allow Move разрешает или запрещает перемещение компонента.

strel11 Параметр Allow Resize включает или отключает изменение размеров компонента.

strel11 Параметр Allow Select включает или отключает выбор компонента.

Замок (Locked)

Разрешает или запрещает изменение размеров и перемещение текущего компонента. Если свойство установлено в значение True, текущий компонент нельзя переместить или изменить его размер. Если свойство установлено в значение False, компонент можно перемещать и изменять его размеры.

Связь (Linked)

Привязывает текущее местоположение к странице отчета или другому компоненту. Если свойство установлено в значение True, текущий компонент привязан к текущему местоположению. Если свойство установлено в значение False, компонент не привязан к текущему местоположению.