Легкий язык разметки

A облегченный язык разметки (LML ), также называемый простым или гуманным языком разметки, представляет собой язык разметки с простым, ненавязчивым синтаксисом . Он разработан таким образом, чтобы его было легко писать с использованием любого общего и легко читать в необработанном виде. Облегченные языки разметки используются в приложениях, где может потребоваться прочитать необработанный документ, а также окончательный визуализированный вывод.

Например, человек, загружающий библиотеку программного обеспечения, может предпочесть читать документацию в текстовом редакторе, а не в веб-браузере. Еще одно приложение для таких языков - обеспечение ввода данных в веб-публикациях, таких как веб-журналы и вики, где интерфейс ввода представляет собой простой текстовое поле. Серверное программное обеспечение затем преобразует ввод в общий язык разметки документов, например HTML.

• 1 История
• 2 Типы
• 3 Сравнение языковых функций
• 4 Сравнение возможностей реализации
• 5 Сравнение синтаксиса облегченного языка разметки
  • 5.1 Синтаксис заголовка
    • 5.1.1 Подчеркнутые заголовки
    • 5.1.2 Заголовки с префиксом
  • 5.2 Синтаксис ссылки
  • 5.3 Синтаксис списка
• 6 См. Также
• 7 Ссылки
• 8 Внешние ссылки

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

В 1986 году международный стандарт SGML предоставил средства для определения и анализа облегченных языков разметки с использованием грамматик и импликации тегов. 1998 W3C XML - это профиль SGML, в котором эти возможности отсутствуют. Однако определение типа документа (DTD) SGML для любого из перечисленных ниже языков неизвестно.

Легкие языки разметки можно разделить на категории по типам их тегов. Подобно HTML (полужирный), в некоторых языках используются именованные элементы, которые имеют общий формат для начальных и конечных тегов (например, BBCode [b] жирный [ / b]), тогда как правильные упрощенные языки разметки ограничены ASCII -только знаками препинания и другими небуквенными символами для тегов, но некоторые также смешивают оба стиля (например, Textile bq.) или разрешить встроенный HTML (например, Markdown ), возможно, расширенный пользовательскими элементами (например, MediaWiki source).

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

Некоторые языки разметки предназначены для определенной цели, например, для документирования компьютерного кода (например, POD, RD ) или для преобразования в определенный выходной формат (обычно HTML) и ничего больше, другие более вообще в приложении. Сюда входит, ориентированы ли они на текстовое представление или на сериализацию данных.

Языки, ориентированные на представление, включают AsciiDoc, atx, BBCode, креольский, Crossmark, Epytext, Haml, JsonML, MakeDoc, Markdown, Org-mode, POD, reST, RD, Setext, SiSU, SPIP, Xupl, Texy!, Текстиль, txt2tags, UDO и Wikitext.

Языки, ориентированные на сериализацию данных, включают Curl (гомоиконный, но также читает JSON; каждый объект сериализуется), JSON и YAML.

Собственный синтаксис Markdown не поддерживает атрибуты класса или атрибуты id; однако, поскольку Markdown поддерживает включение собственного HTML-кода, эти функции могут быть реализованы с использованием прямого HTML. (Некоторые расширения могут поддерживать эти функции.)

Собственный синтаксис txt2tags не поддерживает атрибуты класса или атрибуты id; однако, поскольку txt2tags поддерживает включение собственного кода HTML в области с тегами, эти функции могут быть реализованы с использованием прямого HTML при сохранении в целевой HTML.

Хотя обычно документируется выделение текста курсивом и полужирным шрифтом, большинство облегченных процессоров разметки выводят семантические элементы HTML emи сильныйвместо этого. Моноширинный текст может привести либо к семантическому коду, либо к презентационным элементам tt. Некоторые языки проводят различие, например Текстиль, или позволить пользователю легко настроить вывод, например Texy.

LML иногда различаются разметкой из нескольких слов, где некоторые требуют, чтобы символы разметки заменяли межсловные пробелы (инфикс). Для некоторых языков требуется один символ в качестве префикса и суффикса, для других - удвоение или даже утроение или поддержка обоих символов с немного другим значением, например разные уровни акцента.

Microsoft Word и Outlook и, соответственно, другие текстовые процессоры и почтовые клиенты, которые стремятся к аналогичному взаимодействию с пользователем, также поддерживают базовое соглашение об использовании звездочек для жирного шрифта и подчеркивания для курсив. В то время как Word удаляет символы, Outlook сохраняет их.

Синтаксис заголовка

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

Большинство языков LML следуют одному из двух стилей заголовков: либо Setext -подобное подчеркивание, или -подобные atx -подобные маркеры строки, либо они поддерживают оба стиля.

Подчеркнутые заголовки

Заголовок уровня 1 =============== Заголовок уровня 2 --------------- Заголовок уровня 3 ~~~~~~~~~~~~~~~

В первом стиле используются подчеркивания, то есть повторяющиеся символы (например, равно =, дефис -или тильда ~, обычно не менее двух или четырех раз) в строке под текстом заголовка.

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

Заголовки с префиксом

# Заголовок уровня 1 ## Заголовок уровня 2 ## ### Заголовок уровня 3 ###

Второй стиль основан на повторяющихся маркерах (например, хэш #, равно =или звездочка *) в начале самого заголовка, где количество повторений указывает (иногда обратный) уровень заголовка. Большинство языков также поддерживают дублирование маркеров в конце строки, но в то время как некоторые делают их обязательными, другие даже не ожидают совпадения их номеров.

POD и Textile выберите соглашение HTML вместо этого пронумерованные уровни заголовков.

Орг-режим поддерживает отступ как средство указания уровня.

BBCode вообще не поддерживает заголовки разделов.

= head1 Уровень 1 Заголовок = head2 Заголовок уровня 2

h1. Уровень 1 Заголовок div class="ht". Уровень 2 Заголовок h3. Уровень 3 Заголовок h4. Уровень 4 Заголовок h5. Уровень 5 Заголовок h6. Заголовок уровня 6

Microsoft Word поддерживает автоматическое форматирование абзацев в качестве заголовков, если они не содержат более нескольких слов, без точки в конце и если пользователь дважды нажимает клавишу ввода. Для более низких уровней пользователь может нажать клавишу табулятора соответствующее количество раз перед вводом текста, т. Е. С одной по восемь вкладок для уровней заголовков со второго по девятый.

Синтаксис ссылки

Гиперссылки могут быть добавлены встроенными, что может загромождать код из-за длинных URL-адресов, либо с именованным псевдонимомили пронумерованным idссылки на строки, не содержащие ничего, кроме адреса и связанных атрибутов, и часто могут находиться в любом месте документа. Большинство языков позволяют автору указывать текст Textдля отображения вместо простого адреса http://example.com , а некоторые также предоставляют методы для установки другой заголовок ссылки Заголовок, который может содержать дополнительную информацию о месте назначения.

LML, предназначенные для особых настроек, например вики-страницы или документация по коду могут автоматически создавать именованные привязки (для заголовков, функций и т. д.) внутри документа, ссылаться на связанные страницы (возможно, в другом пространстве имен) или обеспечивать текстовый поиск связанных ключевых слов.

В большинстве языков для заключения ссылок используются (двойные) квадратные или угловые скобки, но вряд ли какие-либо два языка полностью совместимы. Многие могут автоматически распознавать и анализировать абсолютные URL-адреса внутри текста без дополнительной разметки.

... Имя_..... _Name: http: // example.com

... [Текст]... [Текст] http://example.com

... [[id]]... <>

... [[id]]... <>

... привязка: id... xref: id

... привязка: id... xref: id [Текст]

... [Текст] [id]... [id]: http://example.com

... [Текст] [id]... [id]: http://example.com "Заголовок"

... [Текст]... [Текст]: http://example.com

... [Текст]... [Текст]: http://example.com "Заголовок"

... [Текст]... [Текст]: http://example.com

... [Текст]... [Текст]: http://example.com "Заголовок"

... "Text": alias... [alias] http://example.com

... "Text": alias... [псевдоним (Заголовок)] http://example.com

... «Текст»: псевдоним... [псевдоним]: http://example.com

... «Текст»: псевдоним... [псевдоним]: http://example.com. (Заголовок)

.

Синтаксис списка

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

Microsoft Word автоматически преобразует абзацы, которые начинаются со звездочки *, дефис-минус -или скобка «больше» >, за которой следует пробел или горизонтальный табулятор в качестве пунктов маркированного списка. Он также начнет нумерованный список для цифры 1 и букв без учета регистра a (для алфавитных списков) или i (для римских цифр), если за ними следует точка ., закрывающая круглая скобка ), знак «больше» >или дефис с минусом -и пробел или табуляция; в случае круглых скобок также поддерживается необязательный открывающий элемент (перед маркером списка.

Языки различаются в зависимости от того, поддерживают ли они необязательные или обязательные цифры в элементах нумерованных списков, и какие типы перечислителей они понимают (например, десятичную цифру 1, римские цифры i или I, буквенные буквы a или A) и поддерживают ли они сохранение явных значений в выходном формате. Некоторые диалекты Markdown, например, будут учитывать начальное значение, отличное от 1, но игнорировать любые другие явные значения.

Slack помогает пользователю вводить нумерованные и маркированные списки, но на самом деле не форматирует их как таковые, т. Е. Просто включает первая цифра, за которой следует точка и пробел или символ маркера ter •перед строкой.

.

.

• Легкий язык программирования
• Сравнение языков разметки документов
• Сравнение генераторов документации
• WikiText
• Markdown

В Wikibooks есть книга по теме: Curl

• C2's list
• Curl Markup для замены HTML + CSS + JS
• Жители авторской экосферы
• Список на сайте otl
• Гуманные текстовые форматы - сравнение (устарело)
• Pandoc: универсальный межформатный преобразователь