Джот
Расширение имени файла |
.диджей [1] |
---|---|
Тип интернет-СМИ | неизвестное значение |
Разработано | Джон Макфарлейн |
Последний выпуск | |
Тип формата | Легкий язык разметки |
Расширено с | CommonMark |
Открытый формат ? | Да |
Свободный формат ? | Да |
Веб-сайт | джот |
Djot ( /dʒɑt/ ) — это легкий язык разметки , целью которого является улучшение синтаксиса CommonMark там, где он сложен и его трудно эффективно анализировать. [3] Он был создан в 2022 году Джоном Макфарлейном , автором Pandoc и членом группы стандартизации CommonMark. [4] [5]
Он заимствует большинство своих функций из CommonMark, но включает в себя более широкий набор функций, включая списки описаний, сноски, таблицы, несколько новых видов встроенного форматирования, математические вычисления и интеллектуальную пунктуацию. [3]
Исходная эталонная реализация написана на языке сценариев ( Lua ), но этот язык предназначен для эффективного анализа, поэтому он очень быстрый. [6]
Код и документация выпускаются под лицензией MIT . [7]
Отличие от CommonMark
[ редактировать ]Синтаксис Djot похож на синтаксис CommonMark, но есть некоторые различия. [8]
Пустые строки
[ редактировать ]CommonMark не нуждается в пустых строках вокруг элементов уровня блока, в отличие от Djot.
Пример:
Вход | Соответствующий HTML, созданный процессором CommonMark. | Соответствующий HTML, созданный процессором Djot. |
---|---|---|
# Heading
Paragraphs.
|
<h1>Heading</h1>
<p>Paragraphs.</p>
|
<h1>Heading Paragraphs.</h1>
|
# Heading
Paragraphs.
|
<h1>Heading</h1>
<p>Paragraphs.</p>
|
<h1>Heading</h1>
<p>Paragraphs.</p>
|
Вход | Соответствующий HTML, созданный процессором CommonMark. | Соответствующий HTML, созданный процессором Djot. |
---|---|---|
* fruits
* apple
* banana
|
<ul>
<li>fruits
<ul>
<li>apple</li>
<li>banana</li>
</ul>
</li>
</ul>
|
<ul>
<li>fruits
* apple
* banana
</li>
</ul>
|
* fruits
* apple
* banana
|
<ul>
<li><p>fruits</p>
<ul>
<li>apple</li>
<li>banana</li>
</ul>
</li>
</ul>
|
<ul>
<li>fruits
<ul>
<li>apple</li>
<li>banana</li>
</ul>
</li>
</ul>
|
Заголовки
[ редактировать ]У Джота нет сеттекста ( =
или -
) заголовки, только ATX ( #
) заголовки.
Пример:
Текст с использованием синтаксиса CommonMark | Текст с использованием синтаксиса Djot | Соответствующий HTML создан |
---|---|---|
Heading
=======
Sub-heading
-----------
|
# Heading
## Sub-heading
|
<h1>Heading</h1>
<h2>Sub-heading</h2>
|
Акцент
[ редактировать ]CommonMark использует одиночный *
или _
для акцента и двойной *
или _
для сильного акцента. Джот использует одиночный _
для акцента и одиночного *
для сильного акцента.
Пример:
Текст с использованием синтаксиса CommonMark | Текст с использованием синтаксиса Djot | Соответствующий HTML создан |
---|---|---|
Text attributes _italic_, **bold**.
|
Text attributes _italic_, *bold*.
|
<p>Text attributes <em>italic</em>, <strong>bold</strong>.</p>
|
Ссылки
[ редактировать ]В отличие от CommonMark, в Djot нет специального синтаксиса для добавления заголовка к ссылке. Вместо этого заголовок можно добавить, используя общий синтаксис атрибута.
Пример:
Текст с использованием синтаксиса CommonMark | Текст с использованием синтаксиса Djot | Соответствующий HTML создан |
---|---|---|
A [link](http://example.com "title").
|
A [link](http://example.com){title="title"}.
|
<p>A <a href="http://example.com" title="title">link</a>.</p>
|
Примеры
[ редактировать ]Текст с использованием синтаксиса Djot | Соответствующий HTML, созданный процессором Djot. | Текст, просматриваемый в браузере |
---|---|---|
# Heading
## Sub-heading
Paragraphs are separated
by a blank line.
The backslash at the end of a line\
produces a line break.
|
<h1>Heading</h1>
<h2>Sub-heading</h2>
<p>Paragraphs are separated
by a blank line.</p>
<p>The backslash at the end of a line<br>
produces a line break.</p>
|
Абзацы разделены пустой строкой. Обратная косая черта в конце строки |
Text attributes _italic_, *bold*, `monospace`.
Horizontal rule:
* * *
|
<p>Text attributes <em>italic</em>, <strong>bold</strong>, <code>monospace</code>.</p>
<p>Horizontal rule:</p>
<hr>
|
Текстовые атрибуты: курсив , жирный шрифт , monospace .
Горизонтальное правило: |
Bullet lists nested within a numbered list:
1. fruits
* apple
* banana
2. vegetables
- carrot
- broccoli
|
<p>Bullet lists nested within a numbered list:</p>
<ol>
<li>fruits
<ul>
<li>apple</li>
<li>banana</li>
</ul>
</li>
<li>vegetables
<ul>
<li>carrot</li>
<li>broccoli</li>
</ul>
</li>
</ol>
|
Маркированные списки, вложенные в нумерованный список:
|
A [link](http://example.com).
{title="icon"}
> Djot uses email-style
characters for blockquoting.
>
> Multiple paragraphs need to be prepended individually.
Raw content such as inline `<abbr title="Hypertext Markup Language">HTML</abbr>`{=html} tags must be explicitly marked.
|
<p>A <a href="http://example.com">link</a>.</p>
<p><img alt="Image" title="icon" src="Icon-pictures.png"></p>
<blockquote>
<p>Djot uses email-style characters for blockquoting.</p>
<p>Multiple paragraphs need to be prepended individually.</p>
</blockquote>
<p>Raw content such as inline <abbr title="Hypertext Markup Language">HTML</abbr> tags must be explicitly marked.</p>
|
Ссылка .
Необработанный контент, такой как встроенные HTML- теги, должен быть явно помечен. |
Реализации
[ редактировать ]Имя | Лицензия | Язык | Репозиторий | Описание |
---|---|---|---|---|
djot.js | МОЯ лицензия | Машинопись | https://github.com/jgm/djot.js | Это переписанная TypeScript исходная эталонная реализация. |
djot.lua | МОЯ лицензия | Два | https://github.com/jgm/djot.lua | Исходная эталонная реализация. |
Записать | МОЯ лицензия | Ржавчина | https://github.com/hellux/jotdown | Анализатор Pull реализован в виде библиотеки Rust. |
Джота | Лицензия BSD из 3 пунктов | Пролог | https://github.com/aarroyoc/djota | Реализация на Прологе |
Джотс | МОЯ лицензия | Хаскелл | https://github.com/jgm/djoths | Библиотека Haskell и инструмент командной строки |
Годжот | МОЯ лицензия | Идти | https://github.com/sivukhin/godjot | Реализация на Go |
Использование
[ редактировать ]Ссылки
[ редактировать ]- ^ «Расширение файла» . github.com . Проверено 24 января 2023 г.
- ^ «Релиз 0.2.0» . 3 января 2023 г. Проверено 8 января 2023 г.
- ^ Перейти обратно: а б «Джот (/dʒɑt/)» . djot.net . Проверено 13 августа 2022 г.
- ^ Макфарлейн, Джон (11 июля 2022 г.). «Первоначальная фиксация» . github.com . Проверено 13 августа 2022 г.
- ^ Макфарлейн, Джон. "Инструменты" . johnmacfarlane.net . Проверено 13 августа 2022 г.
- ^ "README.md" . github.com . Проверено 24 января 2023 г.
- ^ «Лицензия» . github.com . Проверено 13 августа 2022 г.
- ^ «Быстрый старт для пользователей Markdown» . github.com . Проверено 14 августа 2022 г.
- ^ "пандок 3.1.12 (14 февраля 2024 г.)" . pandoc.org . Проверено 5 марта 2024 г.