The Textile Reference Manual
The official reference manual for Textile 2. Textile is the lightweight, humane web text generator included in Textpattern and many other web applications.
Contents
Paragraph text
Paragraphs are separated by blank lines. Each paragraph of text is transformed into a XHTML <p> paragraph block.
A paragraph. Another paragraph. | A paragraph. Another paragraph. |
<p>A paragraph.</p> <p>Another paragraph.</p> |
Line breaks within paragraphs are transformed into XHTML line breaks.
A paragraph with a line break. | A paragraph with |
<p>A paragraph with<br /> a line break.</p> |
Simple XHTML tags may be included in a paragraph.
Here's some <b>bold</b> text. | Here’s some bold text. |
<p>Here’s some <b>bold</b> text.</p> |
A line beginning with a space will be left untouched, and not wrapped in <p> tags.
No paragraph tags here. | No paragraph tags here.
|
No paragraph tags here. |
Smart quotes
Single and double typewriter quotation marks ' and " are transformed into typographically correct “curly” quote marks.
"Proceed!" said he to the host. | “Proceed!” said he to the host. |
<p>“Proceed!” said he to the host.</p> |
'Proceed!' said he to the host. | ‘Proceed!’ said he to the host. |
<p>‘Proceed!’ said he to the host.</p> |
Single and double quotation marks may be nested one inside the other.
"'I swear, captain,' replied I." | “‘I swear, captain,’ replied I.” |
<p>“‘I swear, captain,’ replied I.”</p> |
'"I swear, captain," replied I.' | ‘“I swear, captain,” replied I.’ |
<p>‘“I swear, captain,” replied I.’</p> |
Single quotation marks ' will be turned into apostrophe glyphs when used as such.
Greengrocers' apostrophe's. | Greengrocers’ apostrophe’s. |
<p>Greengrocers’ apostrophe’s.</p> |
Other punctuation
Other common punctuation marks are transformed from their typewriter characters to typographically correct XHTML entities.
Double -- dashes become an em-dash glyph.
You know the Italian proverb -- Chi ha compagno ha padrone. | You know the Italian proverb — Chi ha compagno ha padrone. |
<p>You know the Italian proverb — Chi ha compagno ha padrone.</p> |
You know the Italian proverb--Chi ha compagno ha padrone. | You know the Italian proverb—Chi ha compagno ha padrone. |
<p>You know the Italian proverb—Chi ha compagno ha padrone.</p> |
Single - dashes are replaced with en-dashes.
You know the Italian proverb - Chi ha compagno ha padrone. | You know the Italian proverb – Chi ha compagno ha padrone. |
<p>You know the Italian proverb – Chi ha compagno ha padrone.</p> |
Three period marks become an ellipsis character.
Meanwhile... | Meanwhile… |
<p>Meanwhile…</p> |
An “x” is replaced with the dimension character when used between numbers.
1 x 2 x 3 = 6 | 1 × 2 × 3 = 6 |
<p>1 × 2 × 3 = 6</p> |
1x2x3 = 6 | 1×2×3 = 6 |
<p>1×2×3 = 6</p> |
Trademark, Registered and Copyright symbols are represented by their common plain text equivalents.
Registered(r) Trademark(tm) Copyright (c). | Registered® Trademark™ Copyright ©. |
<p>Registered® Trademark™ Copyright ©.</p> |
Acronyms and Uppercase
Acronyms consist of three or more uppercase characters, followed immediately by words in parentheses.
ABC(Always Be Closing) | ABC |
<p><acronym title="Always Be Closing"><span class="caps">ABC</span></acronym></p> |
Uppercase words of three or more characters are enclosed with a special span element.
IBM or HAL | IBM or HAL |
<p><span class="caps">IBM</span> or <span class="caps">HAL</span></p> |
Use a CSS style such as span.caps{letter-spacing: 0.1em} to take advantage of this by altering the letter spacing on capitals.
Previous: Introduction Next: Phrase modifiers
29 April 2007, 11:49 by Alex ·
Commenting is closed for this article.
RSS
Awesome, thank you so much Alex for taking the time to do this. This is the Textile guide I’ve been waiting for.
— Robin Apr 29, 06:32 pm #
Great manual!
This is the “All you ever wanted to know about Textile but you were afraid to ask” guide!
I think I spot a typo error in the link alias explanation, in the [textile] code.
— Maniquà Apr 30, 02:26 pm #
Outstanding! This is a great guide to the new version. Just one small bug report — the canonical reference guide lacks some of the styles applied to examples in this blog post. It’s a little thing, but it really improves readability.
Thanks for the documentation. :-)
— Adam Messinger Apr 30, 03:14 pm #
Great manual!
A tiny note: when you click on Link to the latest Textile Reference, some of the formatting seems to be gone (esp. the light red & green boxes)
— Gerhard Apr 30, 11:48 pm #
Thanks for the manual! Could you also add a table of contents?
— Jon-Michael May 4, 03:14 am #
I’ve have to warn you i’ve seen quite a few links going here…
http://textile.thresholdstate.com/reference/
You may want to redirect those here until that one is ready.
— Robin May 11, 10:59 pm #
Thanks Robin – redirected.
— Alex May 12, 09:01 am #
Very timely. This is very useful, just as I am trying to learn Textpattern. Thank you.
P.S. Any chance of a PDF version? It is usable but a bit broken in Opera 9.20.
— David Hucklesby May 14, 03:16 pm #
Is it possible to make a link that opens up a new window? Any chance to add such a feature?
— Andreas Cahen May 27, 08:20 pm #