Специальные команды

Текстовый редактор CMS RUEN имеет собственный набор специальных команд, дополняющих возможности HTML-кодов и wiki-разметки и дающих расширенные возможности по управлению системой и информацией. Каждая команда находится на отдельной строке текста и начинается с двоеточия, при этом важны регистр и отсутствие пробелов перед самой командой.

Комментарии

В тексте можно оставлять комментарии, для этого в начале строки необходимо ставить два двоеточия или одно двоеточие и пробел, а уже после них размещать комментарий. Выделанная таким образом строка не выводится на странице, но её видно в редакторе.

 : Комментарий
 : Так можно делать заметки самому себе или временно скрывать текст или код

Заголовки

Заголовки – это короткие фразы, словосочетания или отдельные слова, передающие суть всего текста. Заголовки бывают разного уровня – от 1 до 6, в зависимости от уровня выделяются разным оформлением – размером шрифта, отступами, цветом и прочим. Заголовок текста первого уровня – самый важный, на всей странице он должен быть только один. Он же используется в качестве заголовка страницы (если не указано иное). Команда заголовка первого уровня – :1 (аналог HTML-кода <H1>, второго – :2 и т.д.

 :1 Главный заголовок страницы
 :2 Подзаголовок для части текста

• Подробнее о заголовках

Дополнительная навигация

На сайтах с большим количеством страниц есть возможность дополнительной навигации между страницами, если сайт имеет определённую структуру и можно определить вложенность страниц. Часто такая навигация называется хлебными крошками, обычно выводится сразу после заголовка. Команда – :0.

 :1 Главный заголовок страницы
 :0

Мета-теги – заголовок, описание, ключевые слова

Каждая страница может иметь собственные мета-теги с заголовком, описанием и ключевыми словами. Эта информация не отображается на странице, но используется браузерами и поисковыми системами. Заголовок, указанный здесь, это аналог HTML-кода <TITLE>. Обычно этот заголовок совпадает с заголовком текста первого уровня, но его можно указать и в индивидуальном порядке.

 :1 Главный заголовок страницы
 :0
 :tit Главный заголовок страницы, отображаемый браузерами и поисковыми системами
 :des Краткое описание страницы для поискового продвижения (не более 160 символов).
 :key слова, ключевые слова, продвижение сайта

• Подробнее о мета-тегах и продвижении

Отображение блоков компонентов

Каждый сайт имеет ряд компонентов, указанных в его конфигурации. Компоненты выводят разную информацию в зависимости от запрашиваемого адреса. Также в управлении блоками можно подсмотреть служебные адреса блоков компонентов со структурированным выводом информации. Текстовый редактор даёт возможность подключать отображение блоков не через управление блоками, а через простую команду :com /adres/, где /adres/ – адрес страницы компонента или блока информации, взятый из управления блоками.

 :com /blog/last-posts/

Отображение страниц сайта

На странице можно отображать другие страницы сайта. Обычно это делается для отображения общих текстов (например, контактов или лицензии), дополнительное навигации и пр. Команда для отображения страницы – :pag /adres/, где /adres/ – адрес страницы с текстом. В качестве этого адреса может использоваться любое словосочетание, начинающееся с «freetext.». Таким образом можно будет использовать общий текст для нескольких страниц, без создания дополнительной страницы с адресом в виде использованного словосочетания.

 :pag /kontakty/
 :pag freetext.dop-menu

Отображение данных пользователей системы

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

 :usr login

Отображение списка страниц

Для использования на карте сайта или в иных целях есть возможность выводить список текстовых страниц сайта, отсортированных по времени их изменения. :new – вывод полного списка текстовых страниц. Количество выводимых страниц можно менять произвольно: :new20 – вывод 20 самых «свежих» страниц.

 :new

Разделение страниц

В Блоге и некоторых других компонентах подразумевается использование двусоставных страниц. Каждая такая страница разделяется на две части специальной командой. Первая часть страницы с вводным текстом отображается на сводных страницах, а обе части страницы отображаются уже на одной эксклюзивной странице. Например, в блоге вводная часть поста отображается на странице постов, анонсов и пр., а на странице самого поста отображается весь текст полностью. Обычно текст ссылки на продолжение страницы – «Читать далее», можно этот текст заменить на свой – :more Читайте продолжение с фото...

 :more

Важно: в блоге мета-теги, указываемые в тексте, можно располагать только после команды :more, в противном случае данные мета-теги будут срабатывать на некоторых общих страницах!

Дополнительные CSS-стили

Обычно CSS-стили указываются в специальных css-файлах оформления сайта, но иногда возникает необходимость указать несколько стилей на одной конкретной странице. В таком случае поможет специальна команда :css. После этой команды можно указать любое необходимое CSS-оформление и оно будет добавлено в HEAD-блок страницы.

 :css .white { color: #000; } .black { color: #fff; }

Прочие команды

• :comments – подключение механизма комментариев к странице. Да, да! На обычной текстовой странице сайта комментарии можно отобразить посредством этой простейшей команды.
• :not – отключение вывода даты и времени изменения страницы и автора изменений.
• :flv – внедрение в текст видео в формате FLV.
• :im – внедрение в текст изображений
• :mp3 – внедрение в текст аудиороликов в формате MP3.
• :o2c – внедрение в текст 3D-объектов.