Разметка с помощью парсера Simple

Simple — это облегчённый синтаксис разметки, который предназначен для создания контролируемого HTML-кода. Парсер Simple призван упростить написание HTML-кода и входит в состав MaxSite CMS в виде плагина parser_simple (активируйте его перед использованием).

Simple не является обязательным для использования, но мы его рассматриваем сейчас, поскольку во многих модулях главной он используется для разметки кода. Поэтому сейчас вы можете лишь бегло ознакомиться с данной статьёй, а когда встретите simple-код, то вернётесь для более глубокого изучения.

Для изучения Simple вы можете создать новую запись (даже как черновик), где в Основных опциях записи выберите «Обработчик HTML»: Simple.

Основные правила

Simple, как и многие другие разметки, обрабатывает каждую строчку индивидуально — она завершается переносом строки (Enter), как и привычные тексты.

В начале строки указывается «код», на основании которого и будет сгенерирован HTML.

Заголовки

H(1..6)-заголовки указываются в одной строке. Код указывается в её начале.

h1 заголовок
h2 заголовок
h3 заголовок
h4 заголовок
h5 заголовок
h6 заголовок

Этот simple-код будет преобразован в HTML:

<h1>заголовок</h1>
<h2>заголовок</h2>
<h3>заголовок</h3>
<h4>заголовок</h4>
<h5>заголовок</h5>
<h6>заголовок</h6>

Горизонтальня линия HR

Линия указывается в виде

hr

Результат:

<hr>

Цитаты BLOCKQUOTE

Цитата BLOCKQUOTE может быть создана с помощью однострочного кода:

bqq цитата

либо с помощью двойного bq (с обязательным закрывающим):

bq 
	цитата 
/bq

В обоих случаях это создаст HTML:

<blockquote>цитата</blockquote>

Абзац P

Для указания тэга абзаца P, используется символ подчеркивания _.

_ текст
_ текст
_ текст

Результат:

<p>текст</p>
<p>текст</p>
<p>текст</p>

Символ _ выбран исходя из того, что доступен в любой раскладке клавиатуры.

Блок DIV

Тэг DIV может быть создан с помощью двойного кода div :

div
	текст
/div

либо одиночного с помощью __ (двойное подчеркивание):

__ текст

Результат:

<div>текст</div>

Тэги с обязательным закрывающим тэгом

Следующие simple-коды двойные:

Списки UL/OL/LI

Элементы списка можно указать в нескольких вариантах:

ul
	li Список
	li Список
/ul

ol
	li Список
	li Список
/ol

ul
	* Список
	* Список
/ul

ol
	* Список
	* Список
/ol

Списки DL/DT/DD

Элементы dl-списка строятся так:

dl
	dt Термин 1
	dd Определение термина 1
  
	dt Термин 2
	dd Определение термина 2
/dl

Этот simple-код будет преобразован в HTML:

<dl>
	<dt>Термин 1</dt>
	<dd>Определение термина 1</dd>
	<dt>Термин 2</dt>
	<dd>Определение термина 2</dd>
</dl>

Указание CSS-классов

Можно задать произвольный css-класс в виде скобок:

_(класс) Текст
h1(класс) Заголовок
ul(класс)
div(класс)
__(класс1 класс2) Текст

Указание атрибута style

HTML-style указывается во вторых скобках:

_(класс)(стили) Текст
h1(класс)(стили) Заголовок
div(класс)(стили)
section(класс)(стили)
__()(стили) Текст

Блочные simple-коды в одной строке

Несколько блочных тэгов можно задавать в одной строке через ||.

div(layout-center-wrap) || div(layout-wrap)
	текст
/div || /div

Строчные коды

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

текст _курсив EM_ текст
текст __курсив I__ текст

текст *полужирный STRONG* текст
текст **полужирный B** текст

текст @код CODE@ текст

В случаях, когда код находится в начале текста, указывайте два пробела:

__(t-red) *Текст* (не сработает)
__(t-green)  *Текст* (сработает)

Текст без обработки

Если какой-то текст нужно разместить без обработки Simple, то его следует разместить так:

<!-- nosimple --> текст без обработки <!-- /nosimple -->

Автоматическая расстановка абзацев

Если текст в основном содержит тэги абзацев P, то можно заключить такой текст в psimple, чтобы парсер автоматически расставил абзацы по переносу строки. Например:

[psimple]
Hello 1
Hello 2
<hr>
__ Hello 3
_ Hello 4
Hello 5
[/psimple]

Результат:

<p>Hello 1</p>
<p>Hello 2</p>
<hr>
<div>Hello 3</div>
<p>Hello 4</p>
<p>Hello 5</p>

Сжатие HTML-кода

В процессе работы парсер Simple может создавать дополнительные переносы в HTML-коде. Это нормально и не создаёт проблем. Однако, если вы стремитесь к оптимизации своего сайта, то можете отметить опцию Основные настройки → Служебное → Сжатие HTML-кода страниц.