Форматирование текста (Нисден)

Нисден и Каллиопе

По умолчанию разметку в текстовых полях Эгеи обрабатывает форматтер «Каллиопе», но начиная с версии 2.1 также возможно использование нового форматтера — «Нисден». Нисден круче и удобнее, но пока недоделан.

Для выделения внутри строк Нисден, как и Каллиопе, использует двойные знаки, которые нужно писать слитно с тем текстом, который в них заключён (например, //так//).

Ключевые отличия Нисдена от Каллиопе:

1. Корректное форматирование абзацев тегами <p> вместо разделения двойными переносами.
2. Поддержка ХТМЛ-кода безо всяких специальных тегов.
3. Корректная работа с древовидными списками.
4. Почтовый синтаксис для цитат (>).
5. Маркдауновый синтаксис для заголовков (#, ##, ###...).
6. Нисден объединяет в себе форматтер и типограф (после Каллиопе нужно было ещё отдельно типографить).
7. Более высокая производительность.
8. Расширяемость.

Выбор форматтера

Как выбрать форматтер, используемый в заметке:
адрес-заметки/@format/neasden/ — Нисден;
адрес-заметки/@format/calliope/ — Каллиопе.

Чтобы автоматически использовать Нисден в новых заметках, допишите в user/config.php:
$_config['default_formatter'] = 'neasden';

Расширения

Расширения Нисдена нужны для вставки особенных объектов в текст. Например конструкцию, означающую таблицу (см. примеры ниже), в настоящую таблицу преобразует расширение tables.

В Эгее расширения Нисдена лежат в /system/neasden/extensions/, но папку /system/ изменять нельзя, поэтому свои расширения нужно класть в /user/neasden/extensions/. Документации по тому, как писать расширения, пока нет.

Пример текста

Вот **так слова выделяются жирным**, а вот //так — курсивом//. Дефисы --зачёркивают-- текст. Разметку можно **//комбинировать//**.

Ссылки ставятся так: ((http://yandex.ru/ раз)) или [[http://mail.ru/ два]].

# Если строка начинается с диеза, она становится заголовком

## А если с двух — подзаголовком

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

picture.jpg

Альт картинки указывается просто через пробел (если нужен):

picture.jpg А этот текст после имени файла станет альтом изображения

Чтобы вставить цитату, используется почтовый синтаксис:

> Мой дядя самых честных правил
> //А. С. Пушкин//

Маркированный список делается так:
* раз,
* два,
* три.

Вместо звёздочек можно ставить тире и дефисы.

Нумерованный список:
1. Раз.
2. Два.
3. Три.

Списки можно комбинировать, вкладывать друг в друга и т. д. Древовидность делается отступом, например так:
1. Раз.
2. Два:
  - что-то там;
  - ещё кое-что.
3. Три.

Табличка пишется так:

-----
|one|two|three|
|1|2|3|
|raz|dva|tri|
|un|deux|trois|
-----

В таблице можно даже выравнивать элементы по нужному краю ячейки — достаточно оставить хотя бы один пробел с противоположного края:

-----
|параметр|значение|
|высота| 50|
|ширина| 400|
|глубина| 100|
-----

Если пробелы есть с обеих сторон ячейки, текст выравнивается по центру.

Просто ХТМЛ просто работает:

<iframe ...>