Создание сайтов Самара. Создание сайтов Тольятти. Разработка сайта Самара. Разработка сайта Тольятти.

Антикризисная программа — полноценный работающий сайт за 10 000 рублей!

Статьи

Руководство по Textile

Разделы:

Textile это простая текстовая разметка. Простые символы указывают на акцент слова. Блоки текста могут быть легко превращены в заголовки, цитаты и списки. Textile-документ может быть конвертирован в HTML для использования в Интернете.

Как смотреть примеры

В каждом разделе примеры подробно поясняються. В каждом примере образец Textile-кода сопровождается HTML-кодом, в который он преобразуется, также показывается как HTML-код будет выглядеть в интернет-браузере.

Пример Textile-кода
>

Конветированный в HTML

Как выглядит в браузере
1.
Написание в Textile

Textile ищет параграфы в вашем тексте. Параграфы разделяются одной пустой строкой. Каждый параграф преобразуется в HTML параграф.

A single paragraph.

Followed by another.
>

<p>A single paragraph.</p>

<p>Followed by another.</p>

A single paragraph.

Followed by another.

Использование HTML в Textile

I am <b>very</b> serious.

<pre>
I am <b>very</b> serious.
</pre>
>

<p>I am <b>very</b> serious.</p>


<pre>
I am &lt; b&gt; very&lt;/b&gt; serious.
</pre>

I am very serious.

  I am <b>very</b> serious.

Разрывы строк

Разрывы строк преобразуются в HTML разрывы.

I spoke.
And none replied.
>

<p>I spoke.
And none replied.</p>

I spoke. And none replied.

Разрывы строк могут быть отключены в RedCloth включением fold_lines.

Преобразования

Одиночные и двойные кавычки вокруг слов или выражений преобразуются в изогнутые кавычки, которые более удобны для чтения.

"Observe!"
>

<p>&#8220; Observe!&#8221;</p>

“Observe!”

Двойные дефисы заменяются знаком тире.

Observe -- very nice!
>

<p>Observe&#8212; very nice!</p>

Observe—very nice!

Одиночные дефисы остаются одиночными дефисами.

Observe - tiny and brief.
>

<p>Observe &#8211; tiny and brief.</p>

Observe – tiny and brief.

Три точки становятся троеточием.

Observe...
>

<p>Observe&#8230;</p>

Observe…

Символ ‘x’ становится знаком умножения когда использется с пробелами с 2-х сторон.

Observe: 2 x 2.
>

<p>Observe: 2&#215; 2.</p>

Observe: 2?2.

Преобразование торговой марки и авторских символов.

one(TM), two(R), three(C).
>

<p>one&#8482;, two&#174;, three&#169;.</p>

one™, two®, three©.

2.
Изменение блоков текста

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

Заголовки

Чтобы преобразовать параграф в заголовок, поместите “hn.” в начало текста, где n - число от 1 до 6.

h1. Header 1
>

<h1>Header 1</h1>

Header 1

h2. Header 2
>

<h2>Header 2</h2>

Header 2

h3. Header 3
>

<h3>Header 3</h3>

Header 3

Цитаты

Чтобы преобразовать параграф в цитату, поместите “bq.” перед текстом.

An old text

bq. A block quotation.

Any old text
>

<p>An old text</p>

<blockquote>
<p>A block quotation.</p>
</blockquote>

<p>Any old text</p>

An old text

A block quotation.

Any old text

Сноски

Сноски в тексте - числовые ссылки между квадратными скобками.

This is covered elsewhere[1].
>

<p>This is covered elsewhere<sup><a href="#fn1">1</a></sup>.</p>

This is covered elsewhere1.

Чтобы создать сноску, которая связана со ссылкой в тексте, начните новый параграф с fn и номером сноски, сопровождающимия точкой и пробелом.

fn1. Down here, in fact.
>

<p id="fn1"><sup>1</sup> Down here, in fact.</p>

1 Down here, in fact.

3.
Форматирование текста

Структурный акцент

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

I _believe_ every word.
>

<p>I <em>believe</em> every word.</p>

I believe every word.

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

And then? She *fell*!
>

<p>And then? She <strong>fell</strong>!</p>

And then? She fell!

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

I __know__.
I **really** __know__.
>

<p>I <i>know</i>.
I <b>really</b> <i>know</i>.</p>

I know. I really know.

Используя двойной знак вопроса можно указать цитату. Название книги, например.

??Cat's Cradle?? by Vonnegut
>

<p><cite>Cat&#8217; s Cradle</cite> by Vonnegut</p>

Cat’s Cradle by Vonnegut

Выражения, содержащие код, могут быть окружены символом собачка.

Convert with @r.to_html@
>

<p>Convert with <code>r.to_html</code></p>

Convert with r.to_html

Чтобы указать текст, который был удален, окружите его дефисами.

I'm -sure- not sure.
>

<p>I&#8217; m <del>sure</del> not sure.</p>

I’m sure not sure.

Плюсы вокруг выражения означают его подчеркнутость.

You are a +pleasant+ child.
>

<p>You are a <ins>pleasant</ins> child.</p>

You are a pleasant child.

Чтобы показать надстрочный индекс, окружите фразу симовлами ^.

a ^2^ + b ^2^ = c ^2^
>

<p>a <sup>2</sup> + b <sup>2</sup> = c <sup>2</sup></p>

a 2 + b 2 = c 2

Чтобы показать подстрочный индекс, окружите фразу симовлами ~.

log ~2~ x
>

<p>log <sub>2</sub> x</p>

log 2 x

HTML-Спецификация

Если вы хотите изменить стиль выражения, используйте знаки процента чтобы преобразовать выражение в HTML span.

I'm %unaware% of most soft drinks.
>

<p>I&#8217; m <span>unaware</span> of most soft drinks.</p>

I’m unaware of most soft drinks.

Таким образом вы сможете применять настройки стиля, как описано в следующем разделе.

I'm %{color:red}unaware%
of most soft drinks.
>

<p>I&#8217; m <span style="color:red;">unaware</span>
of most soft drinks.</p>

I’m unaware of most soft drinks.

4.
Свойства

Приспособить Textile чтобы он подходил вашим требованиям очень легко.Для каждого элемента можно использовать CSS.

Свойства блоков

Блок может использовать CSS. Для этого нужно поместить класс в круглые скобки перед блоком.

p(example1). An example
>

<p class="example1">An example</p>

An example

Элемент ID может быть получен вписыванием ID с символом # и использованием вместо класса.

p(#big-red). Red here
>

<p id="big-red">Red here</p>

Red here

Класс and ID могут быть совмещены.

p(example1#big-red2). Red here
>

<p class="example1" id="big-red2">Red here</p>

Red here

Свойства стиля могут быть определены при помощи фигурных скобок {}.

p{color:blue;margin:30px}. Spacey blue
>

<p style="color:blue; margin:30px;">Spacey blue</p>

Spacey blue

Языковые свойства указываются между квадратными скобками.

p[fr]. rouge
>

<p lang="fr">rouge</p>

rouge

Свойства текста

Все свойства блоков могут быть применены к тексту.

I seriously *{color:red}blushed*
when I _(big)sprouted_ that
corn stalk from my
%[es]cabeza%.
>

<p>I seriously <strong style="color:red;">blushed</strong>
when I <em class="big">sprouted</em> that
corn stalk from my
<span lang="es">cabeza</span>.</p>

I seriously blushed when I sprouted that corn stalk from my cabeza.

Выравнивание блоков

Текст внутри блоков может быть выравнен четырьмя различными способами.

p<. align left
>

<p style="text-align:left;">align left</p>

align left

p>. align right
>

<p style="text-align:right;">align right</p>

align right

p=. centered
>

<p style="text-align:center;">centered</p>

centered

p<>. justified
>

<p style="text-align:justify;">justified</p>

justified

Отступы образуются, если поставить открывающую скобку (для 1em).

p(. left ident 1em
>

<p style="padding-left:1em;">left ident 1em</p>

left ident 1em

p((. left ident 2em
>

<p style="padding-left:2em;">left ident 2em</p>

left ident 2em

p))). right ident 3em
>

<p style="padding-right:3em;">right ident 3em</p>

right ident 3em

Объединение с выравниванием

Форматирование может совмещаться с выравниванием.

h2()>. Bingo.
>

<h2 style="padding-left:1em; padding-right:1em; text-align:right;">Bingo.</h2>

Bingo.

И, кроме того, совмещаться с языковыми свойствами и CSS стилями.

h3()>[no]{color:red}. Bingo
>

<h3 style="color:red; padding-left:1em; padding-right:1em; text-align:right;" lang="no">Bingo</h3>

Bingo

HTML в Textile

Textile предназначен для простого форматирования текста. Для более сложного форматирования лучше использовать HTML.

Например, длинный блоки с кодом между тэгами pre and code. Обособляйте ваш код чтобы быть уверенным что Textile проигнорирует его содержимое.

<pre>
<code>
a.gsub!( /</, '' )
</code>
</pre>
>

<pre>
<code>
a.gsub!( /&lt;/, '' )
</code>
</pre>


  a.gsub!( /</, '' )

Чтобы поделить текст на части можно использовать тэг div.

<div style="float:right;">

h3. Sidebar

"Headlab":http://www.headlab.ru/
"Txp":http://www.textpattern.com/

</div>

The main text of the
page goes here and will
stay to the left of the
sidebar.
>

<div style="float:right;">
<h3>Sidebar</h3>

<p><a href="http://www.headlab.ru/">Headlab</a>
<a href="http://www.textpattern.com/">Txp</a></p>


</div>
<p>The main text of the
page goes here and will
stay to the left of the
sidebar.</p>

Sidebar

Headlab Txp

The main text of the page goes here and will stay to the left of the sidebar.

5.
Списки

Числовые списки

Чтобы создать числовой список, поместите каждый его пункт в параграф, в начале параграфа поставьте ”#”.

# A first item
# A second item
# A third
>

<ol>
<li>A first item</li>
<li>A second item</li>
<li>A third</li>
</ol>

  1. A first item
  2. A second item
  3. A third

Списки могут быть вложенными, если использовать большее количество символов ”#”.

# Fuel could be:
## Coal
## Gasoline
## Electricity
# Humans need only:
## Water
## Protein
>

<ol>
<li>Fuel could be:
<ol>
<li>Coal</li>
<li>Gasoline</li>
<li>Electricity</li>
</ol>
</li>
<li>Humans need only:
<ol>
<li>Water</li>
<li>Protein</li>
</ol></li>
</ol>

  1. Fuel could be:
    1. Coal
    2. Gasoline
    3. Electricity
  2. Humans need only:
    1. Water
    2. Protein

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

Ненумерованные списки используют звездочки вместо решеток.

* A first item
* A second item
* A third
>

<ul>
<li>A first item</li>
<li>A second item</li>
<li>A third</li>
</ul>

  • A first item
  • A second item
  • A third

Эти списки также могут быть вложенными.

* Fuel could be:
** Coal
** Gasoline
** Electricity
* Humans need only:
** Water
** Protein
>

<ul>
<li>Fuel could be:
<ul>
<li>Coal</li>
<li>Gasoline</li>
<li>Electricity</li>
</ul>
</li>
<li>Humans need only:
<ul>
<li>Water</li>
<li>Protein</li>
</ul></li>
</ul>

  • Fuel could be:
    • Coal
    • Gasoline
    • Electricity
  • Humans need only:
    • Water
    • Protein
6.
Вшешние ссылки

Гипертекстовые ссылки

Ссылки состоят из текста, который ссылается на URL. Поместите текст ссылки в двойные кавычки. За текстом обязательно должны следовать двоеточие и URL.

I searched "Google":http://google.com.
>

<p>I searched <a href="http://google.com">Google</a>.</p>

I searched Google.

Помните, ссылка не включает никакую конечную пунктуацию.

Совместное использование одной ссылки

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

I am crazy about "Headlab":headlab
and "it's":headlab "all":headlab I ever
"link to":headlab!

[headlab]http://www.headlab.ru
>

<p>I am crazy about <a href="http://www.headlab.ru">Headlab</a>
and <a href="http://www.headlab.ru">it&#8217; s</a> <a href="http://www.headlab.ru">all</a> I ever
<a href="http://www.headlab.ru">link to</a>!</p>

I am crazy about Headlab and it’s all I ever link to!

Вложенные изображения

Чтобы использовать изображение в вашем Textile-документе , нужно окружить URL знаками восклицания.

!http://www.headlab.ru/sample.jpg!
>

<p><img src="http://www.headlab.ru/sample.jpg" alt="" /></p>

URLы могут быть относительными.

Также может быть указано имя изображения - в круглых скобках перед закрывающим знаком восклицания.

!example.gif(Bunny.)!
>

<p><img src="example.gif" title="Bunny." alt="Bunny." /></p>

Bunny.

Название также используется как alt текст если картинка не будет найдена.

Ссылки могут быть добавлены к изображению при помощи двоеточия.

!example.gif!:http://www.headlab.ru/
>

<p><a href="http://www.headlab.ru/"><img src="example.gif" alt="" /></a></p>

Выравнивание изображений

Выравнивание может быть применено и к изображениям.

!>example.gif!

And others sat all round the small
machine and paid it to sing to them.
>

<p style="float:right"><img src="example.gif" alt="" /></p>

<p>And others sat all round the small
machine and paid it to sing to them.</p>

And others sat all round the small machine and paid it to sing to them.

Акронимы

Чтобы определить акроним нужно после акронима в скобках указать определение.

We use CSS(Cascading Style Sheets).
>

<p>We use <acronym title="Cascading Style Sheets">CSS</acronym>.</p>

We use CSS.

7.
Таблицы

Чтобы нарисовать таблицу, нужно отделить каждую ячейку символом |.

| name | age | sex |
| joan | 24 | f |
| archie | 29 | m |
| bella | 45 | f |
>

<table>
<tr>
<td> name </td>
<td> age </td>
<td> sex </td>
</tr>
<tr>
<td> joan </td>
<td> 24 </td>
<td> f </td>
</tr>
<tr>
<td> archie </td>
<td> 29 </td>
<td> m </td>
</tr>
<tr>
<td> bella </td>
<td> 45 </td>
<td> f </td>
</tr>
</table>

name age sex
joan 24 f
archie 29 m
bella 45 f

Чтобы сделать из текста заголовок, нужно поставить перед текстом символы _..

|_. name |_. age |_. sex |
| joan | 24 | f |
| archie | 29 | m |
| bella | 45 | f |
>

<table>
<tr>
<th>name </th>
<th>age </th>
<th>sex </th>
</tr>
<tr>
<td> joan </td>
<td> 24 </td>
<td> f </td>
</tr>
<tr>
<td> archie </td>
<td> 29 </td>
<td> m </td>
</tr>
<tr>
<td> bella </td>
<td> 45 </td>
<td> f </td>
</tr>
</table>

name age sex
joan 24 f
archie 29 m
bella 45 f

Свойства ячейки

Выравнивание текста в ячейке также указывается перед текстом.

|_. attribute list |
|<. align left |
|>. align right|
|=. center |
|<>. justify |
|^. valign top |
|~. bottom |
>

<table>
<tr>
<th>attribute list </th>
</tr>
<tr>
<td style="text-align:left;">align left </td>
</tr>
<tr>
<td style="text-align:right;">align right</td>
</tr>
<tr>
<td style="text-align:center;">center </td>
</tr>
<tr>
<td style="text-align:justify;">justify </td>
</tr>
<tr>
<td style="vertical-align:top;">valign top </td>
</tr>
<tr>
<td style="vertical-align:bottom;">bottom </td>
</tr>
</table>

attribute list
align left
align right
center
justify
valign top
bottom

Также можно растянуть ячейку в ширину. Для этого используются colspans - обратный слэш и ширина (количество ячеек на которые данная растягивается).

|\2. spans two cols |
| col 1 | col 2 |
>

<table>
<tr>
<td colspan="2">spans two cols </td>
</tr>
<tr>
<td> col 1 </td>
<td> col 2 </td>
</tr>
</table>

spans two cols
col 1 col 2

Ячейку можно растянуть в высоту. Используется rowspan - слэш и высота ячейки (количество ячеек, на которые нужно растянуть данную).

|/3. spans 3 rows | a |
| b |
| c |
>

<table>
<tr>
<td rowspan="3">spans 3 rows </td>
<td> a </td>
</tr>
<tr>
<td> b </td>
</tr>
<tr>
<td> c </td>
</tr>
</table>

spans 3 rows a
b
c

Все свойства блоков могут быть применены и для таблиц.

|{background:#ddd}. Grey cell|
>

<table>
<tr>
<td style="background:#ddd;">Grey cell</td>
</tr>
</table>

Grey cell

Свойства таблицы и колонок

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

table{border:1px solid black}.
|This|is|a|row|
|This|is|a|row|
>

<table style="border:1px solid black;">
<tr>
<td>This</td>
<td>is</td>
<td>a</td>
<td>row</td>
</tr>
<tr>
<td>This</td>
<td>is</td>
<td>a</td>
<td>row</td>
</tr>
</table>

This is a row
This is a row

Свойства могут быть применены и для колонки. Для этого перед началом колонки вставляются те же свойства что и у таблицы

|This|is|a|row|
{background:#ddd}. |This|is|grey|row|
>

<table>
<tr>
<td>This</td>
<td>is</td>
<td>a</td>
<td>row</td>
</tr>
<tr style="background:#ddd;">
<td>This</td>
<td>is</td>
<td>grey</td>
<td>row</td>
</tr>
</table>

This is a row
This is grey row
 

2005-2009 Headlab +7 917 1233333 Контакты

+7 917 1233333