Textile

Textile — простой язык разметки, позволяющий пользователям получать код 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>	Это _{подстрочный} текст
%{стиль}фрагмент%	<img style="стиль">фрагмент</img>	Это фрагмент текста
@код@	<code>код</code>	Это код: `function code(str)`

Блочные элементыПравить

Модификаторы блочных элементов обычно заканчиваются точкой и отделяются от содержимого пробелом.

Textile	HTML	Описание
hn.	<hn>	Заголовок уровня n
p.	<p>	Абзац
bq.	<blockquote>	Блочная цитата
pre.	<pre>	Форматированный код
bc.	<pre><code>	Программный код (комбинация из двух HTML-элементов)

СсылкиПравить

Текст ссылки заключается в кавычки и отделяется от URL двоеточием:

Textile	HTML
"Textile":http://textile.thresholdstate.com/	<a href="http://textile.thresholdstate.com/">Textile</a>

Пунктуация и подстановкиПравить

Автоматически исправляются^[1] при конвертировании в XHTML следующие сочетания знаков:

Textile	HTML	Отображение
"кавычки"	“кавычки”	“кавычки”
'кавычки'	‘кавычки’	‘кавычки’
длинное -- тире	длинное—тире	длинное—тире
короткое - тире	короткое – тире	короткое – тире
д'Орсе	д‘Орсе	д’Орсе
многоточие...	многоточие…	многоточие…
2 x 2 = 4	2×2 = 4	2×2 = 4
(c) Dean Allen	© Dean Allen	© Dean Allen
Textile(r)	Textile®	Textile®
Textpattern(tm)	Textpattern™	Textpattern™

Атрибуты элементовПравить

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

Синтаксис

Атрибут	Описание
(класс)	Класс элемента
(#id)	Идентификатор элемента
{стиль}	Стиль элемента
[язык]	Язык элемента (сокращение)

Атрибуты могут использоваться в комбинированной записи, например:

(class#id)

Атрибуты строковых элементов

Textile	HTML
%{color:red}red%	<img style="color:red">red</img>
%[fr]rouge%	<img lang="fr">rouge</img>
_(big)red_	<em class="big">red</em>

Атрибуты блочных элементов

Textile	HTML
p(bob). A paragraph	<p class="bob">A paragraph</p>
p{color:#ddd}. A paragraph	<p style="color:#ddd">A paragraph</p>
p[fr]. 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[no]{color:red}.	Абзац на норвежском языке, цвет: красный.

ВыравниваниеПравить

Textile поддерживает четыре типа выравнивания содержимого: влево, вправо, по центру и по ширине.

Модификатор	Выравнивание
>	вправо
<	влево
=	по центру
<>	по ширине

Вертикальное выравнивание устанавливается следующими модификаторами:

Модификатор	Выравнивание
^	по верху
~	по низу

ТаблицыПравить

Таблицы создаются разделением ячеек вертикальной чертой (ячейки заголовков выделяются подчёркиванием):

|_. заголовок 1|_. заголовок 2|_. заголовок 3|
|первый|ряд|таблицы|
|второй|ряд|таблицы|

Атрибуты могут применяться как к таблице в целом^[2], так и к её элементам (строкам и ячейкам) индивидуально:

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 colimg="2">Две колонки</td><td>таблицы</td></tr>
\|/2. Две строки\|таблицы\|	<tr><td rowimg="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(Textist)!	<img src="textist.gif" title="Textist" alt="Textist" />
!textist.gif(Textist)!:http://textism.com	<a href="http://textism.com"><img src="textist.gif" title="Textist" alt="Textist" /></a>

Сокращения (акронимы)Править

Акронимы автоматически распознаются при нахождении трёх или более знаков в верхнем регистре и описания в скобках непосредственно за ними (без пробела). Дополнительно текст акронима может заключаться в строковый элемент <img> с определённым классом.

Textile	HTML
CSS(Cascading Style Sheets)	<acronym title="Cascading Style Sheets"><img class="caps">CSS</img></acronym>

СноскиПравить

Ссылки в тексте на сноски заключаются в квадратные скобки. Для создания сноски, соответствующей ссылке в тексте, необходимо создать абзац, начинающийся с fn<номер_сноски>.:

Textile	HTML
См. лопата[1].	См. лопата<sup><a href="#fn1">1</a></sup>.
fn1. Лопата — хозяйственный инструмент.	<p id="fn1"><sup>1</sup> Лопата - хозяйственный инструмент.</p>

HTMLПравить

==здесь <b>textile</b> не обрабатывается==

notextile. здесь <b>textile</b> не обрабатывается

ПримечанияПравить

↑ К сожалению, используются нормы английской типографики. Локализация зависит от реализации Textile или настроек дополнения CMS.
↑ Для применения атрибутов к таблице перед её началом необходимо указать дополнительный тег table.

СсылкиПравить

Домашняя страница Textile

РеализацииПравить

Text::Textile, реализация Textile на Perl.
Live Textile Preview, конвертирование текста на Javascript.
MT-Textile, реализация Textile на Perl для Movable Type.
PyTextile, реализация Textile на Python.
RedCloth, реализация Textile на Ruby.
vbsTextile, реализация Textile для Microsoft Active Server Pages
Textile UDF, реализация Textile для ColdFusion.
Plextile, реализация Textile на Java
JTextile, реализация Textile на Java
Textile4j, реализация Textile на Java
Textile-j (недоступная ссылка), реализация Textile на Java, включающая компоненты для SWT и JFace, а также дополнение к Eclipse
TextilePHP, PHP-версия Perl-модуля Textile (добавлены некоторые возможности Perl-версии, не входящие в PHP-версию Textile).
Zend_Markup PHP реализация Textile во фреймворке Zend Framework
Textile.NET, реализация Textile на C#/.NET
octalforty Brushie Text, ещё одна реализация Textile на C#/.NET
Texticl, реализация Textile на Common Lisp

РуководстваПравить

Справка Textpattern, поиск информации о тегах по ключевым словам.

ПрочееПравить

Textism, домашняя страница Textile на сайте разработчика.
Textile Markup with MediaWiki, использование Textile на сайтах MediaWiki.
Xilize, утилита для генерации документов с разметкой Textile (доступно дополнение для редактора jEdit).
Форум русскоязычных пользователей CMS Textpattern.
Txt.io - простой, минималистичный блогосервис, для разметки используется Textile.

[1] К сожалению, используются нормы английской типографики. Локализация зависит от реализации Textile или настроек дополнения CMS.

[2] Для применения атрибутов к таблице перед её началом необходимо указать дополнительный тег table.

[1]

[2]