Компьютеры - Textile (язык разметки)16 февраля 2011
простой язык разметки, позволяющий пользователям получать код HTML из своего текста. Разработан Dean Allen. Используется в CMS Textpattern и некоторых других.
Синтаксис
Textile автоматически преобразует текст в разметку, отслеживая абзацы в тексте. Абзацы, отделяемые пустой строкой, преобразуются в элементы HTML <p>.
Переводы строк автоматически преобразуются в элементы HTML <br />.
В тексте можно непосредственно использовать HTML-разметку, когда возможностей Textile не хватает для необходимого форматирования в документе. Теги HTML не обрабатываются только внутри элементов <pre> и <code>.
Строковые элементы
| Textile |
HTML |
Отображение |
| _выделение_ |
<em>выделение</em> |
Это выделенный текст |
| *усиление* |
<strong>усиление</strong> |
Это усиленный текст |
| __курсив__ |
<i>курсив</i> |
Это курсивный текст |
| **полужирный** |
<b>полужирный</b> |
Это полужирный текст |
| ??цитата?? |
<cite>цитата</cite> |
Это цитата |
| -удалённый текст- |
<del>удалённый текст</del> |
Это удалённый текст |
| +вставленный текст+ |
<ins>вставленный текст</ins> |
Это вставленный текст |
| ^надстрочный^ |
<sup>надстрочный</sup> |
Это текст |
| ~подстрочный~ |
<sub>подстрочный</sub> |
Это подстрочный текст |
| %{стиль}фрагмент% |
<span style="стиль">фрагмент</span> |
Это фрагмент текста |
| @код@ |
<code>код</code> |
Это код: function code |
Блочные элементы
Модификаторы блочных элементов обычно заканчиваются точкой и отделяются от содержимого пробелом.
| Textile |
HTML |
Описание |
| hn. |
<hn> |
Заголовок уровня n |
| p. |
<p> |
Абзац |
| bq. |
<blockquote> |
Блочная цитата |
| pre. |
<pre> |
Форматированный код |
| bc. |
<pre><code> |
Программный код |
Ссылки
Текст ссылки заключается в кавычки и отделяется от URL двоеточием:
| Textile |
HTML |
| "Textile":http://textile.thresholdstate.com/ |
<a href="http://textile.thresholdstate.com/">Textile</a> |
Пунктуация и подстановки
Автоматически исправляются при конвертации в XHTML следующие сочетания знаков:
| Textile |
HTML |
Отображение |
| "кавычки" |
“кавычки” |
«кавычки» |
| 'кавычки' |
‘кавычки’ |
‘кавычки’ |
| длинное — тире |
длинное — тире |
| короткое - тире |
короткое – тире |
короткое — тире |
| д’Орсе |
д‘Орсе |
д‘Орсе |
| многоточие... |
многоточие… |
многоточие… |
| 2 * 2 = 4 |
2 × 2 = 4 |
2 × 2 = 4 |
| Dean Allen |
© Dean Allen |
© Dean Allen |
| Textile |
Textile® |
Textile® |
| Textpattern™ |
Textpattern™ |
Textpattern™ |
Атрибуты элементов
Атрибуты могут указываться для блочных и строковых элементов. Например, таблице или выделению может быть назначен класс, идентификатор или описан стиль.
Синтаксис
| Атрибут |
Описание |
|
Класс элемента |
|
Идентификатор элемента |
| {стиль} |
Стиль элемента |
|
Язык элемента |
Атрибуты могут использоваться в комбинированной записи, например:
Атрибуты строковых элементов
| Textile |
HTML |
| %{color:red}red% |
<span style="color:red">red</span> |
| %rouge% |
<span lang="fr">rouge</span> |
| _red_ |
<em class="big">red</em> |
Атрибуты блочных элементов
| Textile |
HTML |
| p. A paragraph |
<p class="bob">A paragraph</p> |
| p{color:#ddd}. A paragraph |
<p style="color:#ddd">A paragraph</p> |
| p. A paragraph |
<p lang="fr">A paragraph</p> |
Отступы и выравнивание
| Textile |
Описание |
| p<. |
Выравнивание влево |
| p>. |
Выравнивание вправо |
| p=. |
Выравнивание по центру |
| p<>. |
Выравнивание по ширине |
| p(., p((. |
Отступ слева на 1em, 2em и т. д. |
| p)., p)). |
Отступ справа на 1em, 2em и т. д. |
Примеры
| Textile |
Описание |
| h2>. |
Заголовок 2-го уровня, выравнивание вправо, отступ на 1em с обоих сторон |
| h3=. |
Заголовок 3-го уровня, выравнивание по центру |
| !</image.gif! |
Изображение с выравниванием по центру |
| p{color:red}. |
Абзац на норвежском языке, цвет: красный. |
Выравнивание
Textile поддерживает четыре типа выравнивания содержимого: влево, вправо, по центру и по ширине.
| Модификатор |
Выравнивание |
| > |
вправо |
| < |
влево |
| = |
по центру |
| <> |
по ширине |
Вертикальное выравнивание устанавливается следующими модификаторами:
| Модификатор |
Выравнивание |
| ^ |
по верху |
| ~ |
по низу |
Таблицы
Таблицы создаются разделением ячеек вертикальной чертой:
|_. заголовок 1|_. заголовок 2|_. заголовок 3|
|первый|ряд|таблицы|
|второй|ряд|таблицы|
Атрибуты могут применяться как к таблице в целом, так и к её элементам индивидуально:
| Textile |
HTML |
| table{width:100 %}=. |
<table style="width:100%;text-align:center;"> |
| {background:#ddd}. |первый|ряд|таблицы| |
<tr style="background:#ddd;"><td>первый</td><td>ряд</td><td>таблицы</td></tr> |
| |{background:red}. второй|ряд|таблицы| |
<tr><td style="background:red;">второй</td><td>ряд</td><td>таблицы</td></tr> |
Объединение ячеек производится следующим образом:
| Textile |
HTML |
| |\2. Две колонки|таблицы| |
<tr><td colspan="2">Две колонки</td><td>таблицы</td></tr> |
| |/2. Две строки|таблицы| |
<tr><td rowspan="2">Две строки</td><td>таблицы</td></tr> |
Вертикальное выравнивание
| Textile |
HTML |
| ^. |четвёртый|ряд|таблицы| |
<tr style="vertical-align:top;"><td>четвёртый</td><td>ряд</td><td>таблицы</td></tr> |
| ~. |пятый|ряд|таблицы| |
<tr style="vertical-align:bottom;"><td>пятый</td><td>ряд</td><td>таблицы</td></tr> |
Списки
Textile поддерживает как маркированные, так и нумерованные списки. Списки могут быть вложенными, один тип списка может быть вложен в другой. Уровень вложения списков не ограничен.
| Textile |
HTML |
| * Маркированный список |
<ul>
<li>Маркированный список</li>
</ul> |
| # Нумерованный список |
<ol>
<li>Нумерованный список</li>
</ol> |
* Пункт 1
** Подпункт 1-1
** Подпункт 1-2
* Пункт 2
## Подпункт 2-1
## Подпункт 2-2
|
<ul>
<li>Пункт 1
<ul>
<li>Подпункт 1-1</li>
<li>Подпункт 1-2</li>
</ul></li>
<li>Пункт 2
<ol>
<li>Подпункт 2-1</li>
<li>Подпункт 2-2</li>
</ol></li>
</ul>
|
Изображения
Ссылка на изображение окружается восклицательными знаками и может быть дополнена гиперссылкой и альтернативным текстом:
| Textile |
HTML |
| !textist.gif! |
<img src="textist.gif" /> |
| !textist.gif! |
<img src="textist.gif" title="Textist" alt="Textist" /> |
| !textist.gif!:http://textism.com |
<a href="http://textism.com"><img src="textist.gif" title="Textist" alt="Textist" /></a> |
Сокращения
Акронимы автоматически распознаются при нахождении трёх или более знаков в верхнем регистре и описания в скобках непосредственно за ними. Дополнительно текст акронима может заключаться в строковый элемент <span> с определённым классом.
| Textile |
HTML |
| CSS |
<acronym title="Cascading Style Sheets"><span class="caps">CSS</span></acronym> |
Сноски
Ссылки в тексте на сноски заключаются в квадратные скобки. Для создания сноски, соответствующей ссылке в тексте, необходимо создать абзац, начинающийся с fn<номер_сноски>.:
| Textile |
HTML |
| См. лопата. |
См. лопата<sup><a href="#fn1">1</a></sup>. |
| fn1. Лопата — хозяйственный инструмент. |
<p id="fn1"><sup>1</sup> Лопата - хозяйственный инструмент.</p> |
HTML
==здесь <b>textile</b> не обрабатывается==
notextile. здесь <b>textile</b> не обрабатывается
Просмотров: 1231
|