Textile (original) (raw)

Textile — простой язык разметки, позволяющий пользователям получать код HTML из своего текста. Разработан Dean Allen. Используется в CMS Textpattern и некоторых других.

Textile автоматически преобразует текст в разметку, отслеживая абзацы в тексте. Абзацы, отделяемые пустой строкой, преобразуются в элементы HTML <p>.

Переводы строк автоматически преобразуются в элементы HTML <br />.

В тексте можно непосредственно использовать HTML-разметку, когда возможностей Textile не хватает для необходимого форматирования в документе. Теги HTML не обрабатываются только внутри элементов <pre> и <code>.

Textile HTML Отображение
_выделение_ выделение Это выделенный текст
*усиление* усиление Это усиленный текст
__курсив__ курсив Это курсивный текст
**полужирный** полужирный Это полужирный текст
??цитата?? цитата Это цитата
-удалённый текст- удалённый текст Это удалённый текст
+вставленный текст+ вставленный текст Это вставленный текст
^надстрочный^ надстрочный Это надстрочный текст
~подстрочный~ подстрочный Это подстрочный текст
%{стиль}фрагмент% фрагмент Это фрагмент текста
@код@ код Это код: function code(str)

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

Textile HTML Описание
h_n_. <h_n_> Заголовок уровня n
p.

Абзац
bq.
Блочная цитата
pre. 

Форматированный код




bc.


Программный код (комбинация из двух HTML-элементов)





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






Textile
HTML





"Textile":http://textile.thresholdstate.com/
Textile





Автоматически исправляются[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%
red




%[fr]rouge%
rouge




_(big)red_
red





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






Textile
HTML





p(bob). A paragraph

A paragraph





p{color:#ddd}. A paragraph

A paragraph





p[fr]. A paragraph

A paragraph






Отступы и выравнивание 






Textile
Описание





p<.
Выравнивание влево




p>.
Выравнивание вправо




p=.
Выравнивание по центру




p<>.
Выравнивание по ширине




p(., p((.
Отступ слева на 1em, 2em и т. д.




p)., p)).
Отступ справа на 1em, 2em и т. д.





Примеры 






Textile
Описание





h2()>.
Заголовок 2-го уровня, выравнивание вправо, отступ на 1em с обеих сторон




h3=.
Заголовок 3-го уровня, выравнивание по центру




!
Изображение с выравниванием по центру




p[no]{color:red}.
Абзац на норвежском языке, цвет: красный.





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






Модификатор
Выравнивание





>
вправо




<
влево




=
по центру




<>
по ширине





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






Модификатор
Выравнивание





^
по верху




~
по низу





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


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


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






Textile
HTML





table{width:100%}=.






{background:#ddd}. |первый
ряд




|{background:red}. второй
ряд





Объединение ячеек производится следующим образом:






Textile
HTML





|\2. Две колонки
таблицы




|/2. Две строки
таблицы





Вертикальное выравнивание 






Textile
HTML





^. |четвёртый
ряд




~. |пятый
ряд





Textile поддерживает как маркированные, так и нумерованные списки. Списки могут быть вложенными, один тип списка может быть вложен в другой. Уровень вложения списков не ограничен.






Textile
HTML





* Маркированный список

  • Маркированный список





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

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





* Пункт 1 ** Подпункт 1-1 ** Подпункт 1-2 * Пункт 2 ## Подпункт 2-1 ## Подпункт 2-2

  • Пункт 1
    • Подпункт 1-1
    • Подпункт 1-2
  • Пункт 2
    1. Подпункт 2-1
    2. Подпункт 2-2






Ссылка на изображение окружается восклицательными знаками и может быть дополнена гиперссылкой и альтернативным текстом:






Textile
HTML





!textist.gif!





!textist.gif(Textist)!
Textist




!textist.gif(Textist)!:http://textism.com
Textist





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






Textile
HTML





CSS(Cascading Style Sheets)
CSS





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






Textile
HTML





См. лопата[1].
См. лопата1.




fn1. Лопата — хозяйственный инструмент.

1 Лопата - хозяйственный инструмент.






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


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


    

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

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