Проект нового языка разметки
От: AndrewVK Россия http://blogs.rsdn.org/avk
Дата: 01.09.14 17:59
Оценка: 6 (1) +1 -1
#Имя: wiki.rsdn.newmarkup
Старое обсуждение
Автор: AndrewVK
Дата: 20.08.12

Спецификация языка разметки
API парсера
Репозиторий
AVK Blog
Отредактировано 20.12.2015 23:07 AndrewVK (New repo url) . Предыдущая версия . Еще …
Отредактировано 05.09.2014 13:56 AndrewVK . Предыдущая версия .
Отредактировано 05.09.2014 13:55 AndrewVK . Предыдущая версия .
Отредактировано 05.09.2014 13:53 AndrewVK . Предыдущая версия .
Отредактировано 01.09.2014 19:12 AndrewVK . Предыдущая версия .
Отредактировано 01.09.2014 18:17 AndrewVK . Предыдущая версия .
Отредактировано 01.09.2014 18:16 AndrewVK . Предыдущая версия .
Отредактировано 01.09.2014 18:00 AndrewVK . Предыдущая версия .
Re: Проект нового языка разметки
От: Abyx Россия  
Дата: 01.09.14 18:03
Оценка:
Здравствуйте, AndrewVK, Вы писали:

круто, но чем плохи существующие — markdown, textile, etc
In Zen We Trust
Re: Проект нового языка разметки
От: AndrewVK Россия http://blogs.rsdn.org/avk
Дата: 01.09.14 18:03
Оценка:
Перекинул сюда чтобы удобнее было обсуждать и не потерялось. Корневое сообщение темы помечено как wiki статья, т.е. доступно для редактирования.
... << RSDN@Home 1.2.0 alpha 5 rev. 100 on Windows 8 6.2.9200.0>>
AVK Blog
Re[2]: Проект нового языка разметки
От: AndrewVK Россия http://blogs.rsdn.org/avk
Дата: 01.09.14 18:07
Оценка:
Здравствуйте, Abyx, Вы писали:

A>круто, но чем плохи существующие — markdown, textile, etc


textile не очень удобен, а в markdown много чего не хватает. Вот тут тема есть — http://rsdn.ru/forum/rsdn/4862086.1
Автор: AndrewVK
Дата: 20.08.12
, в ней в том числе и этот вопрос обсуждался. Этот документ, собственно, на ее основе создан, я его просто перетащил сюда с битбакета, чтобы можно было обсуждать, а заодно и wiki потестировать.
... << RSDN@Home 1.2.0 alpha 5 rev. 100 on Windows 8 6.2.9200.0>>
AVK Blog
Re[3]: Проект нового языка разметки
От: A-Myth  
Дата: 02.09.14 12:31
Оценка: +1
AVK>textile не очень удобен, а в markdown много чего не хватает. Вот тут тема есть — http://rsdn.ru/forum/rsdn/4862086.1
Автор: AndrewVK
Дата: 20.08.12
, в ней в том числе и этот вопрос обсуждался. Этот документ, собственно, на ее основе создан, я его просто перетащил сюда с битбакета, чтобы можно было обсуждать, а заодно и wiki потестировать.


Для markdown есть несколько расширений. Плюс никто не мешает написать свой.
Они много где используются и поддерживаются.
Десятилетие обкатки.
А единый устраивающий всех язык разметки всё равно не создать.
Re[4]: Проект нового языка разметки
От: AndrewVK Россия http://blogs.rsdn.org/avk
Дата: 02.09.14 12:35
Оценка:
Здравствуйте, A-Myth, Вы писали:

AM>Для markdown есть несколько расширений. Плюс никто не мешает написать свой.


Ну а если писать свой, то тогда в чем вопрос?

AM>Они много где используются и поддерживаются.


Там в топике есть ссылки, и markdown далеко не на первом месте по популярности.

AM>Десятилетие обкатки.


Десятилетие это сильно сказано. Я точно помню что в 2009 это был еще довольно малоизвестный формат. Опять же, bbcode в разы старше, если уж на обкатку ориентироваться.

AM>А единый устраивающий всех язык разметки всё равно не создать.


Но можно создать такой, который устраивает максимальное количество. Да и не в устраиваемости дело, а в удобстве. Большая часть разметок создана хаотично, люди явно не везде тщательно задумывались об удобстве. А у нас еще и специфика двуязычной клавиатуры накладывается.
... << RSDN@Home 1.2.0 alpha 5 rev. 100 on Windows 8 6.2.9200.0>>
AVK Blog
Re[5]: Проект нового языка разметки
От: A-Myth  
Дата: 02.09.14 12:42
Оценка:
AM>>Для markdown есть несколько расширений. Плюс никто не мешает написать свой.
AVK>Ну а если писать свой, то тогда в чем вопрос?

Имел в виду — "своё". Расширение. А основную базу оставить от markdown.
По поводу популярности: "Sites such as GitHub, reddit, Diaspora, Stack Exchange, OpenStreetMap, and SourceForge use variants of Markdown to facilitate discussion between users"

Тут, конечно, дело вкуса и свободного времени, если есть возможность, то создавайте и обкатывайте — "больше языков хороших и разных".
Re[6]: Проект нового языка разметки
От: AndrewVK Россия http://blogs.rsdn.org/avk
Дата: 02.09.14 12:54
Оценка:
Здравствуйте, A-Myth, Вы писали:

AM>Имел в виду — "своё". Расширение. А основную базу оставить от markdown.


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

AM>По поводу популярности: "Sites such as GitHub, reddit, Diaspora, Stack Exchange, OpenStreetMap, and SourceForge use variants of Markdown to facilitate discussion between users"


Ну вот и у нас будет variant of Markdown.
... << RSDN@Home 1.2.0 alpha 5 rev. 100 on Windows 8 6.2.9200.0>>
AVK Blog
Re: Проект нового языка разметки
От: Ops Россия  
Дата: 03.09.14 20:48
Оценка:
Здравствуйте, AndrewVK, Вы писали:

Как я понял, оттенок цитат — это первый шаг. Но что-то неочень градиент, 1-2 уровня цитаты контрастные, а некоторые сливаются (у меня). Девочку бы посадить, настроить, с 5+ разными мониторами...
Переубедить Вас, к сожалению, мне не удастся, поэтому сразу перейду к оскорблениям.
Re[2]: Проект нового языка разметки
От: AndrewVK Россия http://blogs.rsdn.org/avk
Дата: 03.09.14 21:13
Оценка:
Здравствуйте, Ops, Вы писали:

Ops>Как я понял, оттенок цитат — это первый шаг.


Нет. Это просто 100 лет висевшая микрозадачка, которую несложно было сделать. В янусе практически с самого начала реализовано в редакторе.

Ops>Но что-то неочень градиент, 1-2 уровня цитаты контрастные, а некоторые сливаются (у меня).


А остальные не очень и важно. Их, по хорошему, вообще не должно быть, удалять надо.

Ops> Девочку бы посадить, настроить, с 5+ разными мониторами...


Девочку это мы завсегда за
... << RSDN@Home 1.2.0 alpha 5 rev. 100 on Windows 8 6.2.9200.0>>
AVK Blog
Re[3]: Проект нового языка разметки
От: Ops Россия  
Дата: 03.09.14 21:24
Оценка:
Здравствуйте, AndrewVK, Вы писали:

Ops>> Девочку бы посадить, настроить, с 5+ разными мониторами...

AVK>Девочку это мы завсегда за

Если столько разных мониторов есть — могу жену попросить, она с цветами неплохо разбирается (именно поэтому девочку). Но без этих ваших грязных намеков.
Переубедить Вас, к сожалению, мне не удастся, поэтому сразу перейду к оскорблениям.
Re[7]: Проект нового языка разметки
От: PM  
Дата: 04.09.14 04:43
Оценка:
Здравствуйте, AndrewVK, Вы писали:

AVK>Ну вот и у нас будет variant of Markdown.


Есть спецификация Markdown: http://standardmarkdown.com
Re[8]: Проект нового языка разметки
От: _Raz_  
Дата: 04.09.14 11:28
Оценка:
Здравствуйте, PM, Вы писали:

PM>Есть спецификация Markdown: http://standardmarkdown.com


Казалось бы, инициатива достойна всяческих похвал. Однако, сам Джон Грубер , что посторонние люди называют очередную реализацию синтаксиса «стандартной». Существует более двух десятков реализаций синтаксиса, и почему 25-тая вдруг должна называться «стандартной» с самого начала?


habr: Github, Reddit и StackExchange предложили стандартный синтаксис Markdown (сегодняшняя заметка (на статью не тянет))
Re[9]: Проект нового языка разметки
От: PM  
Дата: 04.09.14 12:17
Оценка:
Здравствуйте, _Raz_, Вы писали:

_R_>habr: Github, Reddit и StackExchange предложили стандартный синтаксис Markdown (сегодняшняя заметка (на статью не тянет))


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



Ну а если серьезно, то я за Markdown вместо сущестующих тегов, естественно с расширениями специфичными для RSDN.
Re: **
От: _Raz_  
Дата: 05.09.14 13:35
Оценка:
Здравствуйте, AndrewVK, Вы писали:

AVK>Выделяется символами ** с обеих сторон. При этом слева от открывающей ** должен быть пробел или начало строки, а справа не пробел и не конец строки. Для закрывающей, соответственно, не пробел и не начало строки слева, и пробел или конец строки справа.


Как насчет такого:

Глагол run — это неправильный глагол. Важно знать его формы наизусть.
формы глагола run

1 форма глагола run — r**u**n (первая форма это и есть сам глагол)
2 форма глагола run — r//a//n
3 форма глагола run — r**u**n

Standard Markdown Spec: 6.4 Emphasis and strong emphasis
Re[2]: **
От: AndrewVK Россия http://blogs.rsdn.org/avk
Дата: 05.09.14 13:40
Оценка:
Здравствуйте, _Raz_, Вы писали:

_R_>Standard Markdown Spec: 6.4 Emphasis and strong emphasis


В принципе, можно использовать правила из SMD. Поправь только страничку с описанием здесь.
... << RSDN@Home 1.2.0 alpha 5 rev. 100 on Windows 8 6.2.9200.0>>
AVK Blog
Спецификация языка разметки
От: AndrewVK Россия http://blogs.rsdn.org/avk
Дата: 05.09.14 13:52
Оценка:
#Имя: wiki.rsdn.newmarkup.spec

Спецификация разметки


Общие правила и определения


Пробельный символ это символ:
  1. Unicode символ CharacterTabulation
  2. Unicode символ LineTabulation
  3. Unicode символ FormFeed
  4. Unicode символ ZeroWidthNoBreakSpace
  5. Символ с unicode классом Zs

Разметка делится на две уровня. Разметка уровня документа и разметка содержимого.

К разметке уровня документа относятся:
  1. Заголовки.
  2. Списки.
  3. Цитаты сообщений.
  4. Блоковые цитаты (Blockquote).
  5. Таблицы.
  6. Горизонтальный разделитель (вертикальная черта, hr).
  7. Сообщение модератора или системы.
  8. Теглайны.
  9. Параграфы.

К разметке содержимого относится:
  1. Стили: жирный, курсив, подчеркнутый, зачеркнутый, верхний и нижний индексы.
  2. Ссылки.
  3. Картинки.
  4. Смайлики.
  5. Код.





Разметка уровня документа


Заголовки

= Уровень 1
== Уровень 2
=== Уровень 3
==== Уровень 4
===== Уровень 5
====== Уровень 6

Выходной HTML
<h1>Уровень 1</h1>
<h2>Уровень 2</h2>
<h3>Уровень 3</h3>
<h4>Уровень 4</h4>
<h5>Уровень 5</h5>
<h6>Уровень 6</h6>



Параграфы

Начало строки — начало параграфа. Конец строки — соответственно конец. Пустые строки между параграфами игнорируются. Если параграф начинается с пробелов или табуляций — они убираются, а вместо этого в параграфе фиксируется количество отступов. За один отступ считается одна табуляция или два пробела. Нечетное количество пробелов округляется до четного в меньшую сторону.
One Two

  Three
    Four

Выходной HTML
<p class='plain-text'>One Two</p>
<p class='plain-text indent1'>Three</p>
<p class='plain-text indent2'>Four</p>


Цитаты сообщений

Строка цитаты имеет следующий формат:
* Префикс из символов, цифр и знака подчеркивания, без пробелов, длиной от 0 до 6 символов.
* Произвольное количество символов >. Количество символов определяет уровень вложенности.
* Произвольный текст до конца строки.
A>> O La La
Bb> One Two

Выходной HTML
<span class='quota level2'><span class='quota-prefix'>A&gt;&gt;</span>O La La</span>
<span class='quota level1'><span class='quota-prefix'>Bb&gt;&gt;</span>O La La</span>



Списки


Ненумерованный список

Элемент списка — строка, начинающаяся с одного или нескольких символов * (в зависимости от уровня вложенности) и следующего за ним пробела.
* Item 1
** Item 1.1
* Item 2
* Item 3

Выходной HTML
<ul>
  <li>Item 1</li>
  <ul>
    <li>Item 1.1</li>
  </ul>
  <li>Item 2</li>
  <li>Item 3</li>
</ul>


Нумерованный список

Элемент списка — строка, начинающаяся с символа # или № и следующего за ним пробела
№ Item 1
## Item 1.1
№ Item 2
№ Item 3

Выходной HTML
<ol>
  <li>Item 1</li>
  <ol>
    <li>Item 1.1</li>
  </ol>
  <li>Item 2</li>
  <li>Item 3</li>
</ol>


Нумерованные и ненумерованные списки могут быть смешаны между собой на разных уровнях. Нумерованные и ненумерованные списки на одном уровне трактуются как два разных списка.

Свернутый блок

Начинается с символов +++ в начале строки и следующего за этими символами названия блока. Завершается строкой из символов +++.
+++ Много текста
Текст текст текст текст.
+++

Выходной HTML
<div class='collapsible'>
  <div class='title'>Много текста</div>
  <div class='content'>
    Текст текст текст текст.
  </div>
</div>


Блочная цитата

Начинается с тройного символа " и им же заканчивается.
"""
Один классик сказал …
"""

Перед открывающими кавычками можно указать символ +. Это будет означать, что цитата будет по умолчанию свернута в строку "Цитата".


Таблицы

|* Header 1 | Header 2 | Header 3|
|  Cell 1.1 | Cell 1.2 | Cell 1.3|
|  Cell 2.1 | Cell 2.2 | Cell 2.3|
|Left aligned | Centered | Right aligned|
|>| Colspan |<|
|\|||
|Rowspan|||

Выходной HTML:
<table>
  <thead>
    <tr>
      <th class='center'>Header 1</th>
      <th class='center'>Header 2</th>
      <th class='center'>Header 3</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td class='center'>Cell 1.1</td>
      <td class='center'>Cell 1.2</td>
      <td class='right'>Cell 1.3</td>
    </tr>
    <tr>
      <td class='center'>Cell 2.1</td>
      <td class='center'>Cell 2.2</td>
      <td class='right'>Cell 2.3</td>
    </tr>
    <tr>
      <td>Left aligned</td>
      <td class='center'>Centered</td>
      <td class='right'>Right aligned</td>
    </tr>
    <tr>
      <td colspan='3' class='center'>Cell 1.2</td>
    </tr>
    <tr>
      <td rowspan='2'>Rowspan</td>
      <td></td>
      <td></td>
    </tr>
    <tr>
      <td></td>
      <td></td>
    </tr>
  </tbody>
</table>


Горизонтальный разделитель

Строка, состоящая только из трех символов ---
Выходной HTML:
<hr/>



Сообщение модератора или системы

Заключается в скобки из тройных символов !!!


Теглайн

Строка, начинающаяся с трех символов @@@, следующиего за ними одного или нескольких пробелов и произвольным текстом далее до конца строки.
@@@Janus v1.2.1

Выходной HTML:
<div class='tagline'>Janus v1.2.1</div>



Объекты

Предназначены для вставки внешних по отношению к форматтеру объектов. Должно присутствовать уникальное имя объекта, а в теле тега значение параметров в JSON формате.
((object_id(
  param1: 25,
  param2: {
    p2p1: 12,
    p2p2: '14'
}
)))

Выходной HTML определяется хостом.







Разметка содержимого


Общее правило для стилей текста:
  1. Открывающая конструкция должна заканчиваться не пробельным символом;
  2. Перед закрывающей конструкцией должен стоять не пробельный символ;

Жирный

Выделяется символами ** с обеих сторон.
**слово**
**несколько слов**
ст**о**ит

Выходной HTML
<strong>слово</strong>
<strong>несколько слов</strong>
ст<strong>о</strong>ит


Курсив

Выделяется символами // с обеих сторон. Правила по обрамлению пробелами соответствуют выделению жирным.
//слово//
//несколько слов//

Выходной HTML
<em>слово</em>
<em>несколько слов</em>


Подчеркнутый

__слово__
__несколько слов__

Выходной HTML
<u>слово</u>
<u>несколько слов</u>


Перечеркнутый

--слово--
--несколько слов--

Выходной HTML
<del>слово</del>
<del>несколько слов</del>


Верхний индекс

^^слово^^
^^несколько слов^^

Выходной HTML
<sup>слово</sup>
<sup>несколько слов</sup>


Нижний индекс

vvсловоvv
vvнесколько словvv

Выходной HTML
<sub>слово</sub>
<sub>несколько слов</sub>


Ссылки

[[текст ссылки|url]]
[[url]]

Текст ссылки может быть пустым. В этом случае в качестве текста используется сам url, но с заменой url escaping на исходный текст.
Выходной HTML
<a href='url'>текст ссылки</a>
<a href='url'>url</a>


Ссылки на сообщения по имени

[[текст ссылки|#name]]
[[#name]]

Текст ссылки может быть пустым. В этом случае текст должен предоставить хост. url ссылки формируется по имени хостом.
Выходной HTML
<a class='name-link' href='host-provided-url'>текст ссылки</a>
<a class='name-link' href='host-provided-url'>host-provided-text</a>



Изображения

![[имя изображения|url]]
![[url]]
+![[имя изображения|url]]

имя изображения может быть пустым. В этом случае в качестве текста используется последний сегмент пути url (имя файла). Если впереди стоит знак + — изображение по умолчанию свернуто.
Выходной HTML
<div class='img'>
  <div class='title'>имя изображения</div>
  <img src='url' alt='имя изображения'/>
</div>
<div class='img'>
  <div class='title'>filename.jpg</div>
  <img src='url' alt='filename.jpg'/>
</div>
<div class='img collapsible'>
  <div class='title'>имя изображения</div>
  <img src='url' alt='имя изображения'/>
</div>



Смайлы


Стандартные смайлы

:)
:))
:)))
:(
;)
:-\\
:???:

Выходной HTML
<i class='emoticon smile'></i>
<i class='emoticon biggrin'></i>
<i class='emoticon lol'></i>
<i class='emoticon frown'></i>
<i class='emoticon wink'></i>
<i class='emoticon smirk'></i>
<i class='emoticon confused'></i>


Смайлы из расширений

Имеют формат :smileid:, где smileid — строка от 1 до 5 символов английского или русского алфавита без пробелов и знаков препинания. Для каждого smileid должны быть два синонима — в русской и английской раскладке.

Код

Внутри кода игнорируется вся разметка, за исключением выделения. Внутри кода так же допускается использование {{{ и }}}. Признак конца кода определяется парсером по парности фигурных скобок.

Кусок текста, окруженный тройными скобками {{{ и }}} распознается как код. Опционально между второй и третьей открывающей скобкой можно указать название языка.
Текст {{ruby{if (x == 0) return;}}} текст

Выходной HTML:
Текст <span class='code'>if (x == 0) return;</span> текст


Если перед и или за блоком кода не идет ничего кроме пробельных символов или конца строки, такой блок форматируется как блочный.
{{cs{
  if (x == 0)
    return;
}}} текст

Выходной HTML:
<div class='code'>
  <span class='code-keyword'>if</span> (x == <span class='code-num-literal'>0</span>)
    <span class='code-keyword'>return</span>;
</div>

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

Выделение в коде

Выделить можно либо строку целиком, либо конкретный участок кода. Выделенная строка начинается с символов >>> и следующего на ними пробельного символа. Выделенный участок кода должен быть расположен на одной строке и обрамляется символами >>> и <<< слева и справа. Расположение этих символов относительно слов соответствует правилам для выделения жирным.
if (x == 0)
>>>  Foo();
else
  x = >>>GetX()<<<;



Экранирование

Для экранирования служебного символа можно применять символ экранирования \. Действует только для следующих символов — "\_*+-/!|><@{(:#№[". Все остальные комбинации трактуются как просто текст.


Автозамены

Некоторые комбинации символов заменяются:
* ... (три точки) на … (троеточие)
* --, окруженный пробелами на ­— (длинное тире)
AVK Blog
Отредактировано 15.09.2014 15:32 VladD2 . Предыдущая версия . Еще …
Отредактировано 15.09.2014 15:31 VladD2 . Предыдущая версия .
Отредактировано 12.09.2014 14:45 AndrewVK . Предыдущая версия .
Отредактировано 10.09.2014 18:10 AndrewVK (Ссылки) . Предыдущая версия .
Отредактировано 10.09.2014 18:04 AndrewVK (Параграфы) . Предыдущая версия .
Отредактировано 08.09.2014 17:40 AndrewVK (Выходной HTML) . Предыдущая версия .
Отредактировано 06.09.2014 18:30 AndrewVK (Примеры) . Предыдущая версия .
Отредактировано 06.09.2014 18:22 AndrewVK (Объекты) . Предыдущая версия .
Отредактировано 06.09.2014 18:19 AndrewVK . Предыдущая версия .
Отредактировано 06.09.2014 18:18 AndrewVK . Предыдущая версия .
Отредактировано 06.09.2014 18:16 AndrewVK . Предыдущая версия .
Отредактировано 06.09.2014 15:51 AndrewVK . Предыдущая версия .
Отредактировано 06.09.2014 15:30 AndrewVK (Ссылки по имени) . Предыдущая версия .
Отредактировано 06.09.2014 15:25 AndrewVK (Цитаты) . Предыдущая версия .
Отредактировано 06.09.2014 15:23 AndrewVK (Примеры HTML) . Предыдущая версия .
Отредактировано 06.09.2014 15:15 AndrewVK (Примеры HTML) . Предыдущая версия .
Отредактировано 06.09.2014 15:01 AndrewVK (Параграфы) . Предыдущая версия .
API парсера
От: AndrewVK Россия http://blogs.rsdn.org/avk
Дата: 05.09.14 13:54
Оценка:
#Имя: wiki.rsdn.newmarkup.api
AVK Blog
Re: API парсера
От: _Raz_  
Дата: 05.09.14 14:15
Оценка:
  const string rmdStringSource = "**hello**";
  const string rbbStringSource = "[-b]hello[/-b]";

  var rmdLexer = new RsdnMarkdownLexer();
  var rbbLexer = new RsdnBbCodeLexer();

  var rmdTree = Parser.Parse(rmdLexer, rmdStringSource);
  var rbbTree = Parser.Parse(rbbLexer, rbbStringSource);


rmdTree == rbbTree
Отредактировано 05.09.2014 14:16 _Raz_ . Предыдущая версия .
Re: API парсера
От: _Raz_  
Дата: 05.09.14 14:23
Оценка:
  const string rmdStringSource = "**hello**";
  const string rbbStringSource = "[-b]hello[/-b]";

  var rmdLexerCollection = RsdnMarkdownLexer.ProcessInput(rmdStringSource);
  var rbbLexerCollection = RsdnBbCodeLexer.ProcessInput(rbbStringSource);

  var rmdTree = Parser.Parse(rmdLexerCollection);
  var rbbTree = Parser.Parse(rbbLexerCollection);
Подождите ...
Wait...
Пока на собственное сообщение не было ответов, его можно удалить.