Difference between revisions of "Advanced textile editing"

From Spiffy Stores Knowledge Base

 
(197 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
Textile is a simple text markup. Simple symbols mark a word's emphasis. Blocks of text can be easily tagged as headers, quotes, or lists. A Textile document can then be converted to HTML (Hypertext Markup Language) for viewing on the web.
 +
 +
Texile makes it easy to mark up text for a web page without needing to have any knowledge about HTML.
 +
 +
You can try out Textile on the [http://www.textism.com/tools/textile/ Textile home page].
 +
 +
=== Reading the Examples ===
 +
 +
In each section below, examples are provided to help clearly illustrate how to use the markup.  In each example, the Textile example is followed by the raw HTML that is generated. This is followed by an example of how the output will appear in a browser.
 +
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|Textile example
 +
|→
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|Converted to HTML
 +
|-
 +
| 
 +
| 
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|Browser view
 +
|}
 +
 
== Writing in Textile ==
 
== Writing in Textile ==
  
Textile is a simple text markup. Simple symbols mark words' emphasis. Blocks of text can be easily tagged as headers, quotes, or lists. A Textile document can then be converted to HTML (Hypertext Markup Language) for viewing on the web.
+
=== Paragraphs in Textile ===
 +
 
 +
Textile looks for paragraphs in your text. Paragraphs are separated by one blank line. Every paragraph is translated as an HTML paragraph.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|A single paragraph.<br /><br />Followed by another.
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;A single paragraph.&lt;/p&gt;<br /><br /> &lt;p&gt;Followed by another.&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>A single paragraph.</p><p>Followed by another.</p>
 +
|}
 +
 
 +
=== Using HTML in Textile ===
 +
 
 +
You can certainly use HTML tags inside your Textile documents. HTML will only be escaped if it's found in a ''pre'' or ''code'' block.
 +
 
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|I am &lt;b&gt;very&lt;/b&gt; serious.<br /><br />&lt;pre&gt;<br />I am &lt;b&gt;very&lt;/b&gt; serious.<br />&lt;/pre&gt;
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;I am &lt;b&gt;very&lt;/b&gt; serious.&lt;/p&gt;<br /><br />&lt;pre&gt;<br />I am &amp;lt;b&amp;gt;very&amp;lt;/b&amp;gt; serious.<br />&lt;/pre&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>I am <b>very</b> serious.</p><p>I am &lt;b&gt;very&lt;/b&gt; serious.</p>
 +
|}
 +
 
 +
=== Line Breaks ===
 +
 
 +
Line breaks are converted to HTML breaks.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|I spoke.<br />And none replied.
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;I spoke.&lt;br /&gt;And none replied.&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>I spoke.<br />And none replied.</p>
 +
|}
 +
 
 +
=== Entities ===
 +
 
 +
Single-quotes and double-quotes around words or phrases are converted to curly quotations, which are much easier on the eye.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|"Observe!"
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;&amp;#8220;Observe!&amp;#8221;&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>&#8220;Observe!&#8221;</p>
 +
|}
 +
 
 +
Double hyphens are replaced with an em-dash.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|Observe -- very nice!
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;Observe &amp;#8212; very nice!&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>Observe &#8212; very nice!</p>
 +
|}
 +
 
 +
Single hyphens are replaced with en-dashes.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|Observe - tiny and brief.
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;Observe &amp;#8211; tiny and brief.&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>Observe &#8211; tiny and brief.</p>
 +
|}
 +
 
 +
Triplets of periods become an ellipsis.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|Observe...
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;Observe&amp;#8230;&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>Observe&#8230;</p>
 +
|}
 +
 
 +
The letter &#8216;x&#8217; becomes a dimension sign when used alone.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|Observe: 2x2.
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;Observe: 2&amp;#215;2.&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>Observe: 2&#215;2.</p>
 +
|}
 +
 
 +
Conversion of trademark and copyright symbols.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|a(TM), b(R), c(C).
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;a&amp;#8482;, b&amp;#174;, c&amp;#169;.&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>a&#8482;, b&#174;, c&#169;.</p>
 +
|}
 +
 
 +
== Quick Block Modifiers ==
 +
 
 +
Blocks of text are treated as paragraphs by default. However, modifers can be prefixed to the beginning of a block to change its treatment.
 +
 
 +
=== Headers ===
 +
 
 +
To make an entire paragraph into a Header, place "h''n''" at its beginning, where ''n'' is a number from 1-6.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|h1. Header 1
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;h1&gt;Header 1&lt;/h1&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px; font-size: 30px; font-weight: bold"|Header 1
 +
|}
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|h2. Header 2
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;h2&gt;Header 2&lt;/h2&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px; font-size: 20px; font-weight: bold"|Header 2
 +
|}
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|h3. Header 3
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;h3&gt;Header 3&lt;/h3&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px; font-size: 15px; font-weight: bold"|Header 3
 +
|}
 +
 
 +
=== Block Quotes ===
 +
 
 +
To make an entire paragraph into a block quotation, place "bq." before it.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|An old text<br /><br />bq. A block quotation.<br /><br />Any old text
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;An old text&lt;/p&gt;<br />&lt;blockquote&gt;<br />&lt;p&gt;A block quotation.&lt;/p&gt;<br />&lt;/blockquote&gt;<br />&lt;p&gt;Any old text&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>An old text</p><blockquote><p>A block quotation.</p></blockquote><p>Any old text</p>
 +
|}
 +
 
 +
=== Footnotes ===
 +
 
 +
Numeric references within text to footnotes appear between square brackets.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|This is covered elsewhere[1].
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;This is covered elsewhere&lt;sup&gt;&lt;a href="#fn1"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>This is covered elsewhere<sup>[[#fn1|1]]</sup>.</p>
 +
|}
 +
 
 +
To create the footnote that corresponds to its reference within the text, begin a new paragraph with fn and the footnote's number, followed by a dot and a space.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|fn1. Down here, in fact.
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p id="fn1"&gt;&lt;sup&gt;1&lt;/sup&gt; Down here, in fact.&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p id="fn1"><sup>1</sup> Down here, in fact.</p>
 +
|}
 +
 
 +
== Quick Phrase Modifiers ==
 +
 
 +
=== Structural Emphasis ===
 +
 
 +
Emphasis to text is added by surrounding a phrase with underscores. In HTML, this often appears as ''italics''.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|I _believe_ every word.
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;I &lt;em&gt;believe&lt;/em&gt; every word.&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>I ''believe'' every word.</p>
 +
|}
 +
 
 +
Strength can be give to text by surrounding with asterisks.  In HTML, this strength appears as '''bold'''.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|And then? She *fell*!
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;And then? She &lt;strong&gt;fell&lt;/strong&gt;!&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>And then? She '''fell'''!</p>
 +
|}
 +
 
 +
Both italics and bold can be forced by doubling the underscores or asterisks.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|I __know__.<br />I **really** __know__.
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;I &lt;i&gt;know&lt;/i&gt;.&lt;br /&gt;<br />I &lt;b&gt;really&lt;/b&gt; &lt;i&gt;know&lt;/i&gt;.&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>I <i>know</i>.<br />I <b>really</b> <i>know</i>.</p>
 +
|}
 +
 
 +
Use double question marks to indicate ''citation''. The title of a book, for instance,
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|??Cat's Cradle?? by Vonnegut
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;&lt;cite&gt;Cat's Cradle&lt;/cite&gt; by Vonnegut&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p><cite>Cat's Cradle</cite> by Vonnegut</p>
 +
|}
 +
 
 +
Code phrases can be surrounded by at-symbols.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|Convert with @r.to_html@
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;Convert with &lt;code&gt;r.to_html&lt;/code&gt;&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>Convert with <code>r.to_html</code></p>
 +
|}
 +
 
 +
To indicate a passage which has been deleted, surround the passage with hyphens.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|I'm -sure- not sure.
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;I'm &lt;del&gt;sure&lt;/del&gt; not sure.&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>I'm <del>sure</del> not sure.</p>
 +
|}
 +
 
 +
Pluses around a passage indicate its insertion.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|You are a +pleasant+ child.
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;You are a &lt;ins&gt;pleasant&lt;/ins&gt; child.&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>You are a <ins>pleasant</ins> child.</p>
 +
|}
 +
 
 +
To superscript a phrase, surround with carets.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|a^2^ + b^2^ = c^2^
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;a&lt;sup&gt;2&lt;/sup&gt; + b&lt;sup&gt;2&lt;/sup&gt; = c&lt;sup&gt;2&lt;/sup&gt;&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>a<sup>2</sup> + b<sup>2</sup> = c<sup>2</sup></p>
 +
|}
 +
 
 +
To subscript, surround with tildes.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|log~2~ x
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;log&lt;sub&gt;2&lt;/sub&gt; x&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>log<sub>2</sub> x</p>
 +
|}
 +
 
 +
=== HTML-Specific ===
 +
 
 +
Lastly, if you find yourself needing to customize the style of a passage, use percent symbols to translate the passage as an HTML span.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|I'm %unaware% of most soft drinks.
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;I'm &lt;span&gt;unaware&lt;/span&gt; of most soft drinks.&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>I'm <span>unaware</span> of most soft drinks.</p>
 +
|}
 +
 
 +
This way, you can apply style settings, as described in the next section to arbitrary phrases.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|I'm %{color:red}unaware% of most soft drinks.
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;I'm &lt;span style="color:red;"&gt;unaware&lt;/span&gt; of most soft drinks.&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>I'm <span style="color:red;">unaware</span> of most soft drinks.</p>
 +
|}
 +
 
 +
== Attributes ==
  
You can try Textile out on the [http://www.textism.com/tools/textile/ Textile home page].
+
Tailoring Textile to suit your needs is quite easy. Attributes allow you to provide Cascading Style Sheets (CSS) information about any phrase.
  
=== Reading the Examples ===
+
=== Block Attributes ===
  
In each section below, examples are provided to clearly illustrate.  In each example, the Textile example is followed by the raw <span class="caps">HTML</span> it is translated into, followed by how the <span class="caps">HTML</span> appears in the browser.
+
A block can be tagged with a CSS class by enclosing the class name in parentheses and placing it just before the period which marks the block.
  
</td></tr>
+
{| style="width: 100%" cellspacing="10"
<tr><td class='example1' valign='top'><pre>Textile example</pre></td><td>&rarr;</td><td class='example2'><p>Converted to HTML</p></td></tr><tr><td colspan='2'></td><td class='example3'>Browser-view</td></tr>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|p(example1). An example
<tr><th colspan='3'><a name='writing-in-textile'><small>1.</small></a><br />Writing in Textile</th></tr>
+
|&rarr;
<tr><td class='explain' colspan='3'>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p class="example1"&gt;An example&lt;/p&gt;
<p>Textile looks for paragraphs in your text.  Paragraphs are separated by one blank line. Every paragraph is translated as an <span class="caps">HTML</span> paragraph.</p>
+
|-
</td></tr>
+
|&nbsp;
<tr><td class='example1' valign='top'><pre>A single paragraph.<br /><br />Followed by another.</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;A single paragraph.&lt;/p&gt;<br /><br /> &lt;p&gt;Followed by another.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>A single paragraph.</p>
+
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p class="example1">An example</p>
 +
|}
  
<p>Followed by another.</p></td></tr>
+
An element ID can be given by prefixing the ID with a hash symbol (#) and using it in place of the class.
<tr><td class='explain' colspan='3'>
 
<h4>Using <span class="caps">HTML</span> in Textile</h4>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>You can certainly use <span class="caps">HTML</span> tags inside your Textile documents.  <span class="caps">HTML</span> will only be escaped if it&#8217;s found in a <code>pre</code> or <code>code</code> block.</p>
 
  
</td></tr>
+
{| style="width: 100%" cellspacing="10"
<tr><td class='example1' valign='top'><pre>I am &lt;b&gt;very&lt;/b&gt; serious.<br /><br />&lt;pre&gt;<br />  I am &lt;b&gt;very&lt;/b&gt; serious.<br />&lt;/pre&gt;</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;I am &lt;b&gt;very&lt;/b&gt; serious.&lt;/p&gt;<br /><br /><br />&lt;pre&gt;<br />  I am &amp;lt; b&amp;gt; very&amp;lt;/b&amp;gt; serious.<br />&lt;/pre&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>I am <b>very</b> serious.</p>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|p(#big-red). Red here
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p id="big-red"&gt;Red here&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p id="big-red">Red here</p>
 +
|}
  
 +
Class and ID can be combined by placing the class first.
  
<pre>
+
{| style="width: 100%" cellspacing="10"
  I am &lt;b&gt;very&lt;/b&gt; serious.
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|p(example1#big-red2). Red here
</pre></td></tr>
+
|&rarr;
<tr><td class='explain' colspan='3'>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p class="example1" id="big-red2"&gt;Red here&lt;/p&gt;
<h4>Line Breaks</h4>
+
|-
</td></tr>
+
|&nbsp;
<tr><td class='explain' colspan='3'>
+
|&nbsp;
<p>Line breaks are converted to <span class="caps">HTML</span> breaks.</p>
+
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p class="example1" id="big-red2">Red here</p>
 +
|}
  
</td></tr>
+
Style settings can be provided directly by surrounding them in curly braces.
<tr><td class='example1' valign='top'><pre>I spoke.<br />And none replied.</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;I spoke.<br />And none replied.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>I spoke.
 
And none replied.</p></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>Line breaks can be disabled in RedCloth by turning on <code>fold_lines</code>.</p>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<h4>Entities</h4>
 
  
</td></tr>
+
{| style="width: 100%" cellspacing="10"
<tr><td class='explain' colspan='3'>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|p{color:blue;margin:30px}. Spacey blue
<p>Single- and double-quotes around words or phrases are converted to curly quotations, much easier on the eye.</p>
+
|&rarr;
</td></tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p style="color:blue; margin:30px;"&gt;Spacey blue&lt;/p&gt;
<tr><td class='example1' valign='top'><pre>"Observe!"</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;&amp;#8220; Observe!&amp;#8221;&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>&#8220;Observe!&#8221;</p></td></tr>
+
|-
<tr><td class='explain' colspan='3'>
+
|&nbsp;
<p>Double hyphens are replaced with an em-dash.</p>
+
|&nbsp;
</td></tr>
+
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p style="color:blue;margin:30px;">Spacey blue</p>
<tr><td class='example1' valign='top'><pre>Observe -- very nice!</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;Observe&amp;#8212; very nice!&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>Observe&#8212;very nice!</p></td></tr>
+
|}
  
<tr><td class='explain' colspan='3'>
+
Language designations can be given between square brackets.
<p>Single hyphens are replaced with en-dashes.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>Observe - tiny and brief.</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;Observe &amp;#8211; tiny and brief.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>Observe &#8211; tiny and brief.</p></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>Triplets of periods become an ellipsis.</p>
 
</td></tr>
 
  
<tr><td class='example1' valign='top'><pre>Observe...</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;Observe&amp;#8230;&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>Observe&#8230;</p></td></tr>
+
{| style="width: 100%" cellspacing="10"
<tr><td class='explain' colspan='3'>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|p[fr]. rouge
<p>The letter &#8216;x&#8217; becomes a dimension sign when used alone.</p>
+
|&rarr;
</td></tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p lang="fr"&gt;rouge&lt;/p&gt;
<tr><td class='example1' valign='top'><pre>Observe: 2 x 2.</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;Observe: 2&amp;#215; 2.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>Observe: 2&#215;2.</p></td></tr>
+
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p lang="fr">rouge</p>
 +
|}
  
<tr><td class='explain' colspan='3'>
+
=== Phrase Attributes ===
<p>Conversion of trademark and copyright symbols.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>one(TM), two(R), three(C).</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;one&amp;#8482;, two&amp;#174;, three&amp;#169;.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>one&#8482;, two&#174;, three&#169;.</p></td></tr>
 
<tr><td colspan='5' style='border-bottom: solid 1px #eee;'></td></tr>
 
  
<tr><th colspan='3'><a name='quick-block-modifiers'><small>2.</small></a><br />Quick Block Modifiers</th></tr>
+
All block attributes can be applied to phrases as well by placing them just inside the opening modifier.
<tr><td class='explain' colspan='3'>
 
<p>Blocks of text default to being treated as paragraphs.  But modifers can be affixed to the beginning of a block to change its treatment.</p>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<h4>Headers</h4>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>To make an entire paragraph into a Header, place &#8220;h<em>n</em>.&#8221; at its beginning, where <em>n</em> is a number from 1-6.</p>
 
  
</td></tr>
+
{| style="width: 100%" cellspacing="10"
<tr><td class='example1' valign='top'><pre>h1. Header 1</pre></td><td>&rarr;</td><td class='example2'><p>&lt;h1&gt;Header 1&lt;/h1&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><h1>Header 1</h1></td></tr>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|I seriously *{color:red}blushed* when I _(big)sprouted_ that corn stalk from my %[es]cabeza%.
<tr><td class='example1' valign='top'><pre>h2. Header 2</pre></td><td>&rarr;</td><td class='example2'><p>&lt;h2&gt;Header 2&lt;/h2&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><h2>Header 2</h2></td></tr>
+
|&rarr;
<tr><td class='example1' valign='top'><pre>h3. Header 3</pre></td><td>&rarr;</td><td class='example2'><p>&lt;h3&gt;Header 3&lt;/h3&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><h3>Header 3</h3></td></tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;I seriously &lt;strong style="color:red;"&gt;blushed&lt;/strong&gt; when I &lt;em class="big"&gt;sprouted&lt;/em&gt; that corn stalk from my &lt;span lang="es"&gt;cabeza&lt;/span&gt;.&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>I seriously <strong style="color:red;">blushed</strong> when I <em style="font-size: 20px">sprouted</em> that corn stalk from my <span lang="es">cabeza</span>.</p>
 +
|}
  
<tr><td class='explain' colspan='3'>
+
=== Block Alignments ===
<h4>Block Quotes</h4>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>To make an entire paragraph into a block quotation, place &#8220;bq.&#8221; before it.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>An old text<br /><br />bq. A block quotation.<br /><br />Any old text</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;An old text&lt;/p&gt;<br /><br /> &lt;blockquote&gt;<br /> &lt;p&gt;A block quotation.&lt;/p&gt;<br /> &lt;/blockquote&gt;<br /><br /> &lt;p&gt;Any old text&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>An old text</p>
 
  
<blockquote>
+
Text inside blocks can be aligned in four basic ways.
<p>A block quotation.</p>
 
</blockquote>
 
  
<p>Any old text</p></td></tr>
+
{| style="width: 100%" cellspacing="10"
<tr><td class='explain' colspan='3'>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|p&lt;. align left
<h4>Footnotes</h4>
+
|&rarr;
</td></tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p style="text-align:left;"&gt;align left&lt;/p&gt;
<tr><td class='explain' colspan='3'>
+
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p style="text-align:left;">align left</p>
 +
|}
  
<p>Numeric references within text to footnotes appear between square brackets.</p>
+
{| style="width: 100%" cellspacing="10"
</td></tr>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|p&gt;. align right
<tr><td class='example1' valign='top'><pre>This is covered elsewhere[1].</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;This is covered elsewhere&lt;sup&gt;&lt;a href="#fn1"&gt;1&lt;/a&gt;&lt;/sup&gt;.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>This is covered elsewhere<sup><a href="#fn1">1</a></sup>.</p></td></tr>
+
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p style="text-align:right;"&gt;align right&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p style="text-align:right;">align right</p>
 +
|}
  
<tr><td class='explain' colspan='3'>
+
{| style="width: 100%" cellspacing="10"
<p>To create the footnote that corresponds to its reference within the text, begin a new paragraph with fn and the footnote&#8217;s number, followed by a dot and a space.</p>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|p=. centered
</td></tr>
+
|&rarr;
<tr><td class='example1' valign='top'><pre>fn1. Down here, in fact.</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p id="fn1"&gt;&lt;sup&gt;1&lt;/sup&gt; Down here, in fact.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p id="fn1"><sup>1</sup> Down here, in fact.</p></td></tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p style="text-align:center;"&gt;centered&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p style="text-align:center;">centered</p>
 +
|}
  
<tr><td colspan='5' style='border-bottom: solid 1px #eee;'></td></tr>
+
{| style="width: 100%" cellspacing="10"
<tr><th colspan='3'><a name='quick-phrase-modifiers'><small>3.</small></a><br />Quick Phrase Modifiers</th></tr>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|p&lt;&gt;. justified
<tr><td class='explain' colspan='3'>
+
|&rarr;
<h4>Structural Emphasis</h4>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p style="text-align:justify;"&gt;justified&lt;/p&gt;
</td></tr>
+
|-
<tr><td class='explain' colspan='3'>
+
|&nbsp;
<p>Emphasis to text is added by surrounding a phrase with underscores.  In <span class="caps">HTML</span>, this often appears as <em>italics</em>.</p>
+
|&nbsp;
</td></tr>
+
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p style="text-align:justify;">justified</p>
<tr><td class='example1' valign='top'><pre>I _believe_ every word.</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;I &lt;em&gt;believe&lt;/em&gt; every word.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>I <em>believe</em> every word.</p></td></tr>
+
|}
  
<tr><td class='explain' colspan='3'>
+
Indentation can also be specified by provide a single left paren for every 1em to the left. A single right paren for every 1em to the right.
<p>Strength can be give to text by surrounding with asterisks. In <span class="caps">HTML</span>, this strength appears as <strong>bold</strong>.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>And then? She *fell*!</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;And then? She &lt;strong&gt;fell&lt;/strong&gt;!&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>And then? She <strong>fell</strong>!</p></td></tr>
 
  
<tr><td class='explain' colspan='3'>
+
{| style="width: 100%" cellspacing="10"
<p>Both italics and bold can be forced by doubling the underscores or asterisks.</p>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|p(. left ident 1em
</td></tr>
+
|&rarr;
<tr><td class='example1' valign='top'><pre>I __know__.<br />I **really** __know__.</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;I &lt;i&gt;know&lt;/i&gt;.<br />I &lt;b&gt;really&lt;/b&gt; &lt;i&gt;know&lt;/i&gt;.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>I <i>know</i>.
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p style="padding-left:1em;"&gt;left ident 1em&lt;/p&gt;
I <b>really</b> <i>know</i>.</p></td></tr>
+
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p style="padding-left:1em;">left ident 1em</p>
 +
|}
  
<tr><td class='explain' colspan='3'>
+
{| style="width: 100%" cellspacing="10"
<p>Use double question marks to indicate <em>citation</em>.  The title of a book, for instance.</p>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|p((. left ident 2em
</td></tr>
+
|&rarr;
<tr><td class='example1' valign='top'><pre>??Cat's Cradle?? by Vonnegut</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;&lt;cite&gt;Cat&amp;#8217; s Cradle&lt;/cite&gt; by Vonnegut&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p><cite>Cat&#8217;s Cradle</cite> by Vonnegut</p></td></tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p style="padding-left:2em;"&gt;left ident 2em&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p style="padding-left:2em;">left ident 2em</p>
 +
|}
  
<tr><td class='explain' colspan='3'>
+
{| style="width: 100%" cellspacing="10"
<p>Code phrases can be surrounded by at-symbols.</p>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|p))). right ident 3em
</td></tr>
+
|&rarr;
<tr><td class='example1' valign='top'><pre>Convert with @r.to_html@</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;Convert with &lt;code&gt;r.to_html&lt;/code&gt;&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>Convert with <code>r.to_html</code></p></td></tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p style="padding-right:3em;"&gt;right ident 3em&lt;/p&gt;
<tr><td class='explain' colspan='3'>
+
|-
<p>To indicate a passage which has been deleted, surround the passage with hypens.</p>
+
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p style="padding-right:3em;">right ident 3em</p>
 +
|}
  
</td></tr>
+
=== Combining Alignments ===
<tr><td class='example1' valign='top'><pre>I'm -sure- not sure.</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;I&amp;#8217; m &lt;del&gt;sure&lt;/del&gt; not sure.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>I&#8217;m <del>sure</del> not sure.</p></td></tr>
 
  
<tr><td class='explain' colspan='3'>
+
Identation may be coupled with alignment.
<p>Pluses around a passage indicate its insertion.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>You are a +pleasant+ child.</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;You are a &lt;ins&gt;pleasant&lt;/ins&gt; child.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>You are a <ins>pleasant</ins> child.</p></td></tr>
 
  
<tr><td class='explain' colspan='3'>
+
{| style="width: 100%" cellspacing="10"
<p>To superscript a phrase, surround with carets.</p>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|h2()&gt;. Bingo.
</td></tr>
+
|&rarr;
<tr><td class='example1' valign='top'><pre>a ^2^ + b ^2^ = c ^2^</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;a &lt;sup&gt;2&lt;/sup&gt; + b &lt;sup&gt;2&lt;/sup&gt; = c &lt;sup&gt;2&lt;/sup&gt;&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>a <sup>2</sup> + b <sup>2</sup> = c <sup>2</sup></p></td></tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;h2 style="padding-left:1em; padding-right:1em; text-align:right;"&gt;Bingo.&lt;/h2&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px; font-size: 20px; font-weight: bold"|<div style="padding-left:1em;padding-right:1em;text-align:right;">Bingo.</div>
 +
|}
  
<tr><td class='explain' colspan='3'>
+
And, furthermore, coupled with language settings and CSS styles.
<p>To subscript, surround with tildes.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>log ~2~ x</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;log &lt;sub&gt;2&lt;/sub&gt; x&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>log <sub>2</sub> x</p></td></tr>
 
  
<tr><td class='explain' colspan='3'>
+
{| style="width: 100%" cellspacing="10"
<h4><span class="caps">HTML</span>-Specific</h4>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|h3()&gt;[no]{color:red}. Bingo
</td></tr>
+
|&rarr;
<tr><td class='explain' colspan='3'>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;h3 style="color:red; padding-left:1em; padding-right:1em; text-align:right;" lang="no"&gt;Bingo&lt;/h3&gt;
<p>Lastly, if you find yourself needing to customize the style of a passage, use percent symbols to translate the passage as an <span class="caps">HTML</span> span.</p>
+
|-
</td></tr>
+
|&nbsp;
<tr><td class='example1' valign='top'><pre>I'm %unaware% of most soft drinks.</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;I&amp;#8217; m &lt;span&gt;unaware&lt;/span&gt; of most soft drinks.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>I&#8217;m <span>unaware</span> of most soft drinks.</p></td></tr>
+
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px; font-size: 15px; font-weight: bold"|<div style="color:red;padding-left:1em;padding-right:1em;text-align:right;" lang="no">Bingo</div>
 +
|}
  
<tr><td class='explain' colspan='3'>
+
=== HTML in Textile ===
<p>This way, you can apply style settings, as described in the next section to arbitrary phrases.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>I'm %{color:red}unaware%<br />of most soft drinks.</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;I&amp;#8217; m &lt;span style="color:red;"&gt;unaware&lt;/span&gt;<br />of most soft drinks.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>I&#8217;m <span style="color:red;">unaware</span>
 
  
of most soft drinks.</p></td></tr>
+
Textile is designed for making simple markup quick and easy. For more complex formatting, you are encouraged to break out into HTML.
<tr><td colspan='5' style='border-bottom: solid 1px #eee;'></td></tr>
 
<tr><th colspan='3'><a name='attributes'><small>4.</small></a><br />Attributes</th></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>Tailoring Textile to suit your needs is quite easy. Attributes allow you to provide <acronym title="Cascading Style Sheets">CSS</acronym> information about any phrase.</p>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<h4>Block Attributes</h4>
 
</td></tr>
 
  
<tr><td class='explain' colspan='3'>
+
For example, long code blocks belong between <code>&lt;pre&gt;&hellip;&lt;/pre&gt;</code> and <code>&lt;code&gt;&hellip;&lt;/code&gt;</code> tags.  Please also indent your code inside the tags to be sure that all Textile processors out there will ignore the contents.
<p>A block can be tagged with a <span class="caps">CSS</span> class by circling the class in parentheses and placing it just before the period which marks the block.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>p(example1). An example</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p class="example1"&gt;An example&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p class="example1">An example</p></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>An element ID can be given by prefixing the ID with a pound symbol and using it in place of the class.</p>
 
</td></tr>
 
  
<tr><td class='example1' valign='top'><pre>p(#big-red). Red here</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p id="big-red"&gt;Red here&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p id="big-red">Red here</p></td></tr>
+
{| style="width: 100%" cellspacing="10"
<tr><td class='explain' colspan='3'>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|&lt;pre&gt;<br />&lt;code&gt;<br />&nbsp;&nbsp;a.gsub!( /&lt;/, &#x27;&#x27; )<br />&lt;/code&gt;<br />&lt;/pre&gt;
<p>Class and ID can be combined by placing the class first.</p>
+
|&rarr;
</td></tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;pre&gt;<br />&lt;code&gt;<br />&nbsp;&nbsp;a.gsub!( /&amp;lt;/, &#x27;&#x27; )<br />&lt;/code&gt;<br />&lt;/pre&gt;
<tr><td class='example1' valign='top'><pre>p(example1#big-red2). Red here</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p class="example1" id="big-red2"&gt;Red here&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p class="example1" id="big-red2">Red here</p></td></tr>
+
|-
<tr><td class='explain' colspan='3'>
+
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<code>a.gsub!( /&lt;/, &#x27;&#x27; )</code>
 +
|}
  
<p>Style settings can be provided directly by surrounding them in curly braces.</p>
+
You may also choose to surround sections with <code>&lt;div&gt;</code> tags to separate your document into sections. [http://www.instiki.org Instiki] uses this technique to float a sidebar to the right.
</td></tr>
 
<tr><td class='example1' valign='top'><pre>p{color:blue;margin:30px}. Spacey blue</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p style="color:blue; margin:30px;"&gt;Spacey blue&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p style="color:blue;margin:30px;">Spacey blue</p></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>Language designations can be given between angel brackets.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>p[fr]. rouge</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p lang="fr"&gt;rouge&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p lang="fr">rouge</p></td></tr>
 
  
<tr><td class='explain' colspan='3'>
+
{| style="width: 100%" cellspacing="10"
<h4>Phrase Attributes</h4>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|&lt;div style="float:right;padding:5px;"&gt;<br /><br />h3. Sidebar<br /><br />"Spiffy":<nowiki>http://www.spiffystores.com/</nowiki><br />"Ruby":<nowiki>http://ruby-lang.org/</nowiki><br /><br />&lt;/div&gt;<br /><br />The main text of the page goes here and will stay to the left of the sidebar.
</td></tr>
+
|&rarr;
<tr><td class='explain' colspan='3'>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding:5px"|&lt;div style="float:right;padding:5px;"&gt;<br />&lt;h3&gt;Sidebar&lt;/h3&gt;<br />&lt;p&gt;<br />&lt;a href="<nowiki>http://www.spiffystores.com/</nowiki>"&gt;Spiffy&lt;/a&gt;&lt;br /&gt;<br />&lt;a href="<nowiki>http://ruby-lang.org/</nowiki>"&gt;Ruby&lt;/a&gt;<br />&lt;/p&gt;<br />&lt;/div&gt;<br /><br />&lt;p&gt;The main text of the page goes here and will stay to the left of the sidebar.&lt;/p&gt;
<p>All block attributes can be applied to phrases as well by placing them just inside the opening modifier.</p>
+
|-
</td></tr>
+
|&nbsp;
<tr><td class='example1' valign='top'><pre>I seriously *{color:red}blushed*<br />when I _(big)sprouted_ that<br />corn stalk from my<br />%[es]cabeza%.</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;I seriously &lt;strong style="color:red;"&gt;blushed&lt;/strong&gt;<br />when I &lt;em class="big"&gt;sprouted&lt;/em&gt; that<br />corn stalk from my<br />&lt;span lang="es"&gt;cabeza&lt;/span&gt;.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>I seriously <strong style="color:red;">blushed</strong>
+
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<div style="float:right;padding:5px;"><div style="font-size: 15px; font-weight: bold">Sidebar</div><p>[http://www.spiffystores.com Spiffy]<br />[http://ruby-lang.org/ Ruby]</p></div>
 +
<p>The main text of the page goes here and will stay to the left of the sidebar.</p>
 +
|}
  
when I <em class="big">sprouted</em> that
+
== Lists ==
corn stalk from my
 
<span lang="es">cabeza</span>.</p></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<h4>Block Alignments</h4>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>Text inside blocks can be aligned in four basic ways.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>p&lt;. align left</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p style="text-align:left;"&gt;align left&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p style="text-align:left;">align left</p></td></tr>
 
  
<tr><td class='example1' valign='top'><pre>p&gt;. align right</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p style="text-align:right;"&gt;align right&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p style="text-align:right;">align right</p></td></tr>
+
=== Numeric Lists ===
<tr><td class='example1' valign='top'><pre>p=. centered</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p style="text-align:center;"&gt;centered&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p style="text-align:center;">centered</p></td></tr>
 
<tr><td class='example1' valign='top'><pre>p&lt;&gt;. justified</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p style="text-align:justify;"&gt;justified&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p style="text-align:justify;">justified</p></td></tr>
 
  
<tr><td class='explain' colspan='3'>
+
To make a numbered list, place each item in its own paragraph, preceded by a hash character ("#").
<p>Indentation can also be specified by provide a single left paren for every 1em to the left.  A single right paren for every 1em to the right.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>p(. left ident 1em</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p style="padding-left:1em;"&gt;left ident 1em&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p style="padding-left:1em;">left ident 1em</p></td></tr>
 
<tr><td class='example1' valign='top'><pre>p((. left ident 2em</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p style="padding-left:2em;"&gt;left ident 2em&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p style="padding-left:2em;">left ident 2em</p></td></tr>
 
<tr><td class='example1' valign='top'><pre>p))). right ident 3em</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p style="padding-right:3em;"&gt;right ident 3em&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p style="padding-right:3em;">right ident 3em</p></td></tr>
 
  
<tr><td class='explain' colspan='3'>
+
{| style="width: 100%" cellspacing="10"
<h4>Combining Alignments</h4>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|# A first item<br /># A second item<br /># A third
</td></tr>
+
|&rarr;
<tr><td class='explain' colspan='3'>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;ol&gt;<br />&lt;li&gt;A first item&lt;/li&gt;<br />&lt;li&gt;A second item&lt;/li&gt;<br />&lt;li&gt;A third&lt;/li&gt;<br />&lt;/ol&gt;
<p>Identation may be coupled with alignment.</p>
+
|-
</td></tr>
+
|&nbsp;
<tr><td class='example1' valign='top'><pre>h2()&gt;. Bingo.</pre></td><td>&rarr;</td><td class='example2'><p>&lt;h2 style="padding-left:1em; padding-right:1em; text-align:right;"&gt;Bingo.&lt;/h2&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><h2 style="padding-left:1em;padding-right:1em;text-align:right;">Bingo.</h2></td></tr>
+
|&nbsp;
<tr><td class='explain' colspan='3'>
+
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<ol>
<p>And, furthermore, coupled with language settings and <span class="caps">CSS</span> styles.</p>
+
<li>A first item</li>
 +
<li>A second item</li>
 +
<li>A third</li>
 +
</ol>
 +
|}
  
</td></tr>
+
These lists may be nested by increasing the number of hash characters ("#") that precede the child entries.
<tr><td class='example1' valign='top'><pre>h3()&gt;[no]{color:red}. Bingo</pre></td><td>&rarr;</td><td class='example2'><p>&lt;h3 style="color:red; padding-left:1em; padding-right:1em; text-align:right;" lang="no"&gt;Bingo&lt;/h3&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><h3 style="color:red;padding-left:1em;padding-right:1em;text-align:right;" lang="no">Bingo</h3></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<h4><span class="caps">HTML</span> in Textile</h4>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>Textile is designed for quickening the simple markups.  For more complex formatting, you are encouraged to break out into <span class="caps">HTML</span>.</p>
 
  
</td></tr>
+
{| style="width: 100%" cellspacing="10"
<tr><td class='explain' colspan='3'>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|# Fuel could be:<br />## Coal<br />## Petrol<br />## Electricity<br /># Humans need only:<br />## Water<br />## Protein
<p>For example, long code blocks belong between <code>pre</code> and <code>code</code> tags.  Please also indent your code inside the tags to be sure that all Textile processors out there will ignore the contents.</p>
+
|&rarr;
</td></tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;ol&gt;<br />&lt;li&gt;Fuel could be:<br />&lt;ol&gt;<br />&lt;li&gt;Coal&lt;/li&gt;<br />&lt;li&gt;Petrol&lt;/li&gt;<br /> &lt;li&gt;Electricity&lt;/li&gt;<br />&lt;/ol&gt;<br />&lt;/li&gt;<br />&lt;li&gt;Humans need only:<br />&lt;ol&gt;<br />&lt;li&gt;Water&lt;/li&gt;<br />&lt;li&gt;Protein&lt;/li&gt;<br />&lt;/ol&gt;<br />&lt;/li&gt;<br />&lt;/ol&gt;
<tr><td class='example1' valign='top'><pre>&lt;pre&gt;<br />&lt;code&gt;<br /> a.gsub!( /&lt;/, '' )<br />&lt;/code&gt;<br />&lt;/pre&gt;<br /></pre></td><td>&rarr;</td><td class='example2'><p>&lt;pre&gt;<br />&lt;code&gt;<br /> a.gsub!( /&amp;lt;/, '' )<br />&lt;/code&gt;<br />&lt;/pre&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><pre>
+
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<ol>
 +
<li>Fuel could be:
 +
<ol>
 +
<li>Coal</li>
 +
<li>Petrol</li>
 +
<li>Electricity</li>
 +
</ol>
 +
</li>
 +
<li>Humans need only:
 +
<ol>
 +
<li>Water</li>
 +
<li>Protein</li>
 +
</ol></li>
 +
</ol>
 +
|}
  
<code>
+
=== Bulleted Lists ===
  a.gsub!( /&lt;/, '' )
 
</code>
 
</pre></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>You may also choose to surround sections with <code>div</code> tags to separate your document into sections. <a href="http://www.instiki.org/">Instiki</a> uses this technique to float a sidebar to the right.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>&lt;div style="float:right;"&gt;<br /><br />h3. Sidebar<br /><br />"Hobix":http://hobix.com/<br />"Ruby":http://ruby-lang.org/<br /><br />&lt;/div&gt;<br /><br />The main text of the<br />page goes here and will <br />stay to the left of the <br />sidebar.<br /></pre></td><td>&rarr;</td><td class='example2'><p>&lt;div style="float:right;"&gt;<br /> &lt;h3&gt;Sidebar&lt;/h3&gt;<br /><br /> &lt;p&gt;&lt;a href="http://hobix.com/"&gt;Hobix&lt;/a&gt;<br />&lt;a href="http://ruby-lang.org/"&gt;Ruby&lt;/a&gt;&lt;/p&gt;<br /><br /><br />&lt;/div&gt;<br /> &lt;p&gt;The main text of the<br />page goes here and will <br />stay to the left of the <br />sidebar.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><div style="float:right;">
 
  
<h3>Sidebar</h3>
+
Bulleted lists use an asterisk character ("*") instead of the hash character ("#").
  
<p><a href="http://hobix.com/">Hobix</a>
+
{| style="width: 100%" cellspacing="10"
<a href="http://ruby-lang.org/">Ruby</a></p>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|* A first item<br />* A second item<br />* A third
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;ul&gt;<br />&lt;li&gt;A first item&lt;/li&gt;<br />&lt;li&gt;A second item&lt;/li&gt;<br />&lt;li&gt;A third&lt;/li&gt;<br />&lt;/ul&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<ul>
 +
<li>A first item</li>
 +
<li>A second item</li>
 +
<li>A third</li>
 +
</ul>
 +
|}
  
 +
These lists may also be nested in a similar manner.
  
</div>
+
{| style="width: 100%" cellspacing="10"
<p>The main text of the
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|* Fuel could be:<br />** Coal<br />** Petrol<br />** Electricity<br />* Humans need only:<br />** Water<br />** Protein
page goes here and will
+
|&rarr;
stay to the left of the
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;ul&gt;<br />&lt;li&gt;Fuel could be:<br />&lt;ul&gt;<br />&lt;li&gt;Coal&lt;/li&gt;<br />&lt;li&gt;Petrol&lt;/li&gt;<br /> &lt;li&gt;Electricity&lt;/li&gt;<br />&lt;/ul&gt;<br />&lt;/li&gt;<br />&lt;li&gt;Humans need only:<br />&lt;ul&gt;<br />&lt;li&gt;Water&lt;/li&gt;<br />&lt;li&gt;Protein&lt;/li&gt;<br />&lt;/ul&gt;<br />&lt;/li&gt;<br />&lt;/ul&gt;
sidebar.</p></td></tr>
+
|-
<tr><td colspan='5' style='border-bottom: solid 1px #eee;'></td></tr>
+
|&nbsp;
<tr><th colspan='3'><a name='lists'><small>5.</small></a><br />Lists</th></tr>
+
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<ul>
 +
<li>Fuel could be:
 +
<ul>
 +
<li>Coal</li>
 +
<li>Petrol</li>
 +
<li>Electricity</li>
 +
</ul>
 +
</li>
 +
<li>Humans need only:
 +
<ul>
 +
<li>Water</li>
 +
<li>Protein</li>
 +
</ul></li>
 +
</ul>
 +
|}
  
<tr><td class='explain' colspan='3'>
+
== External References ==
<h4>Numeric Lists</h4>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>To make a numbered list, place each item in its own paragraph, preceded by &#8221;#&#8221;.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre># A first item<br /># A second item<br /># A third</pre></td><td>&rarr;</td><td class='example2'><p>&lt;ol&gt;<br /> &lt;li&gt;A first item&lt;/li&gt;<br /> &lt;li&gt;A second item&lt;/li&gt;<br /> &lt;li&gt;A third&lt;/li&gt;<br /> &lt;/ol&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><ol>
 
  
<li>A first item</li>
+
=== Hypertext Links ===
<li>A second item</li>
 
<li>A third</li>
 
</ol></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>These lists may be nested by increasing the number of pound symbols preceding child entries.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre># Fuel could be:<br />## Coal<br />## Gasoline<br />## Electricity<br /># Humans need only:<br />## Water<br />## Protein</pre></td><td>&rarr;</td><td class='example2'><p>&lt;ol&gt;<br /> &lt;li&gt;Fuel could be:<br /> &lt;ol&gt;<br /> &lt;li&gt;Coal&lt;/li&gt;<br /> &lt;li&gt;Gasoline&lt;/li&gt;<br /> &lt;li&gt;Electricity&lt;/li&gt;<br /> &lt;/ol&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Humans need only:<br /> &lt;ol&gt;<br /> &lt;li&gt;Water&lt;/li&gt;<br /> &lt;li&gt;Protein&lt;/li&gt;<br /> &lt;/ol&gt;&lt;/li&gt;<br /> &lt;/ol&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><ol>
 
  
<li>Fuel could be:
+
Basic links are comprised of a phrase which is linked to a URL.  Place the descriptive phrase in quotation marks, and follow it immediately by a colon and the URL.
<ol>
 
<li>Coal</li>
 
<li>Gasoline</li>
 
<li>Electricity</li>
 
</ol>
 
</li>
 
<li>Humans need only:
 
<ol>
 
  
<li>Water</li>
+
{| style="width: 100%" cellspacing="10"
<li>Protein</li>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|I searched "Google":<nowiki>http://google.com</nowiki>.
</ol></li>
+
|&rarr;
</ol></td></tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;I searched &lt;a href="<nowiki>http://google.com</nowiki>"&gt;Google&lt;/a&gt;.&lt;/p&gt;
<tr><td class='explain' colspan='3'>
+
|-
<h4>Bulleted Lists</h4>
+
|&nbsp;
</td></tr>
+
|&nbsp;
<tr><td class='explain' colspan='3'>
+
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>I searched [http://google.com Google].</p>
<p>Bulleted lists use an asterisk in place of the pound.</p>
+
|}
  
</td></tr>
+
Note, the link won't include any trailing punctuation.
<tr><td class='example1' valign='top'><pre>* A first item<br />* A second item<br />* A third</pre></td><td>&rarr;</td><td class='example2'><p>&lt;ul&gt;<br /> &lt;li&gt;A first item&lt;/li&gt;<br /> &lt;li&gt;A second item&lt;/li&gt;<br /> &lt;li&gt;A third&lt;/li&gt;<br /> &lt;/ul&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><ul>
 
  
<li>A first item</li>
+
=== Link Aliases ===
<li>A second item</li>
 
<li>A third</li>
 
</ul></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>These lists may be nested in like manner.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>* Fuel could be:<br />** Coal<br />** Gasoline<br />** Electricity<br />* Humans need only:<br />** Water<br />** Protein</pre></td><td>&rarr;</td><td class='example2'><p>&lt;ul&gt;<br /> &lt;li&gt;Fuel could be:<br /> &lt;ul&gt;<br /> &lt;li&gt;Coal&lt;/li&gt;<br /> &lt;li&gt;Gasoline&lt;/li&gt;<br /> &lt;li&gt;Electricity&lt;/li&gt;<br /> &lt;/ul&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;Humans need only:<br /> &lt;ul&gt;<br /> &lt;li&gt;Water&lt;/li&gt;<br /> &lt;li&gt;Protein&lt;/li&gt;<br /> &lt;/ul&gt;&lt;/li&gt;<br /> &lt;/ul&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><ul>
 
  
<li>Fuel could be:
+
If you are using the same link several times in your document, or you'd just like to be a tad more organized, you can use a link alias.  Place the URL anywhere in your document, beginning with its alias in square brackets.  Then, use the alias in place of the URL, using the link format above.
<ul>
 
<li>Coal</li>
 
<li>Gasoline</li>
 
<li>Electricity</li>
 
</ul>
 
</li>
 
<li>Humans need only:
 
<ul>
 
  
<li>Water</li>
+
{| style="width: 100%" cellspacing="10"
<li>Protein</li>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|I am crazy about "Spiffy Stores":spiffy<br />and "it's":spiffy "all":spiffy I ever<br />"link to":spiffy!<br /><br />[spiffy]<nowiki>http://www.spiffystores.com</nowiki>
</ul></li>
+
|&rarr;
</ul></td></tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;I am crazy about &lt;a href="<nowiki>http://www.spiffystores.com</nowiki>"&gt;Spiffy Stores&lt;/a&gt;<br />and &lt;a href="<nowiki>http://www.spiffystores.com</nowiki>"&gt;it's&lt;/a&gt; &lt;a href="<nowiki>http://www.spiffystores.com</nowiki>"&gt;all&lt;/a&gt; I ever<br />&lt;a href="<nowiki>http://www.spiffystores.com</nowiki>"&gt;link to&lt;/a&gt;!&lt;/p&gt;
<tr><td colspan='5' style='border-bottom: solid 1px #eee;'></td></tr>
+
|-
<tr><th colspan='3'><a name='external-references'><small>6.</small></a><br />External References</th></tr>
+
|&nbsp;
<tr><td class='explain' colspan='3'>
+
|&nbsp;
<h4>Hypertext Links</h4>
+
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>I am crazy about [http://www.spiffystores.com Spiffy Stores] and [http://www.spiffystores.com it's] [http://www.spiffystores.com all] I ever
 +
[http://www.spiffystores.com link to]!</p>
 +
|}
  
</td></tr>
+
=== Embedded Images ===
<tr><td class='explain' colspan='3'>
 
<p>Basic links are comprised of a phrase which is linked to a <acronym title="Universal Resource Locator">URL</acronym>.  Place the descriptive phrase in quotation marks.  Follow it immediately by a colon and the <span class="caps">URL</span>.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>I searched "Google":http://google.com.</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;I searched &lt;a href="http://google.com"&gt;Google&lt;/a&gt;.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>I searched <a href="http://google.com">Google</a>.</p></td></tr>
 
  
<tr><td class='explain' colspan='3'>
+
You can embed an image in your Textile document by surrounding its URL with exclamation marks.
<p>Notice, the link won&#8217;t include any trailing punctuation.</p>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<h4>Link Aliases</h4>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>If you are using the same link several times in your document, or you&#8217;d just like to be a tad more organized, you can use a link alias.  Place the <span class="caps">URL</span> anywhere in your document, beginning with its alias in square brackets.  Then, use the alias in place of the <span class="caps">URL</span>, using the link format above.</p>
 
  
</td></tr>
+
{| style="width: 100%" cellspacing="10"
<tr><td class='example1' valign='top'><pre>I am crazy about "Hobix":hobix<br />and "it's":hobix "all":hobix I ever<br />"link to":hobix!<br /><br />[hobix]http://hobix.com<br /></pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;I am crazy about &lt;a href="http://hobix.com"&gt;Hobix&lt;/a&gt;<br />and &lt;a href="http://hobix.com"&gt;it&amp;#8217; s&lt;/a&gt; &lt;a href="http://hobix.com"&gt;all&lt;/a&gt; I ever<br />&lt;a href="http://hobix.com"&gt;link to&lt;/a&gt;!&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>I am crazy about <a href="http://hobix.com">Hobix</a>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|<nowiki>!http://spiffyserver.com/images/spiffy-stores-logo.gif!</nowiki>
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;&lt;img src="<nowiki>http://spiffyserver.com/images/spiffy-stores-logo.gif</nowiki>" alt="" /&gt;&lt;/p&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>http://spiffyserver.com/images/spiffy-stores-logo.gif</p>
 +
|}
  
and <a href="http://hobix.com">it&#8217;s</a> <a href="http://hobix.com">all</a> I ever
+
URLs may be relative.
<a href="http://hobix.com">link to</a>!</p></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<h4>Embedded Images</h4>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>You can embed an image in your Textile document by surrounding its <span class="caps">URL</span> with exclamation marks.</p>
 
  
</td></tr>
+
A title for the image can also be provided in parentheses, just before the closing exclamation mark.
<tr><td class='example1' valign='top'><pre>!http://hobix.com/sample.jpg!</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;&lt;img src="http://hobix.com/sample.jpg" alt="" /&gt;&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p><img src="http://hobix.com/sample.jpg" alt="" /></p></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>URLs may be relative.</p>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>A title for the image can also be provided in parens, just before the closing exclamation.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>!openwindow1.gif(Bunny.)!</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;&lt;img src="openwindow1.gif" title="Bunny." alt="Bunny." /&gt;&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p><img src="openwindow1.gif" title="Bunny." alt="Bunny." /></p></td></tr>
 
  
<tr><td class='explain' colspan='3'>
+
{| style="width: 100%" cellspacing="10"
<p>The title also acts as <strong>alt</strong> text should the image not be found.</p>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|<nowiki>!http://spiffyserver.com/images/spiffy-stores-logo.gif(Spiffy Logo)!</nowiki>
</td></tr>
+
|&rarr;
<tr><td class='explain' colspan='3'>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;&lt;img src="<nowiki>http://spiffyserver.com/images/spiffy-stores-logo.gif</nowiki>" title="Spiffy Logo" alt="Spiffy Logo" /&gt;&lt;/p&gt;
<p>Links can be attached to images with a colon.</p>
+
|-
</td></tr>
+
|&nbsp;
<tr><td class='example1' valign='top'><pre>!openwindow1.gif!:http://hobix.com/</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;&lt;a href="http://hobix.com/"&gt;&lt;img src="openwindow1.gif" alt="" /&gt;&lt;/a&gt;&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p><a href="http://hobix.com/"><img src="openwindow1.gif" alt="" /></a></p></td></tr>
+
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p><html><img src="http://spiffyserver.com/images/spiffy-stores-logo.gif" title="Spiffy Logo" alt="Spiffy Logo"></html></p>
 +
|}
  
<tr><td class='explain' colspan='3'>
+
The title also acts as '''alt''' text should the image not be found.
<h4>Image Alignments</h4>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>Alignments can be applied as well to images.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>!&gt;obake.gif!<br /><br />And others sat all round the small<br />machine and paid it to sing to them.</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p style="float:right"&gt;&lt;img src="obake.gif" alt="" /&gt;&lt;/p&gt;<br /><br /> &lt;p&gt;And others sat all round the small<br />machine and paid it to sing to them.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p style="float:right"><img src="obake.gif" alt="" /></p>
 
  
<p>And others sat all round the small
+
Links can be attached to images with a colon.
machine and paid it to sing to them.</p></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<h4>Acronyms</h4>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>Definitions for acronyms can be provided by following an acronym with its definition in parens.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>We use CSS(Cascading Style Sheets).</pre></td><td>&rarr;</td><td class='example2'><p>&lt;p&gt;We use &lt;acronym title="Cascading Style Sheets"&gt;CSS&lt;/acronym&gt;.&lt;/p&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><p>We use <acronym title="Cascading Style Sheets">CSS</acronym>.</p></td></tr>
 
  
<tr><td colspan='5' style='border-bottom: solid 1px #eee;'></td></tr>
+
{| style="width: 100%" cellspacing="10"
<tr><th colspan='3'><a name='tables'><small>7.</small></a><br />Tables</th></tr>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|<nowiki>!http://spiffyserver.com/images/spiffy-stores-logo.gif!:http://www.spiffystores.com/</nowiki>
<tr><td class='explain' colspan='3'>
+
|&rarr;
<p>Simple tables can be built by separating fields with pipe characters</p>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;&lt;a href="<nowiki>http://www.spiffystores.com/</nowiki>"&gt;&lt;img src="<nowiki>http://spiffyserver.com/images/spiffy-stores-logo.gif</nowiki>" alt="" /&gt;&lt;/a&gt;&lt;/p&gt;
</td></tr>
+
|-
<tr><td class='example1' valign='top'><pre>| name | age | sex |<br />| joan | 24 | f |<br />| archie | 29 | m |<br />| bella | 45 | f |</pre></td><td>&rarr;</td><td class='example2'><p>&lt;table&gt;<br /> &lt;tr&gt;<br /> &lt;td&gt; name &lt;/td&gt;<br /> &lt;td&gt; age &lt;/td&gt;<br /> &lt;td&gt; sex &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td&gt; joan &lt;/td&gt;<br /> &lt;td&gt; 24 &lt;/td&gt;<br /> &lt;td&gt; f &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td&gt; archie &lt;/td&gt;<br /> &lt;td&gt; 29 &lt;/td&gt;<br /> &lt;td&gt; m &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td&gt; bella &lt;/td&gt;<br /> &lt;td&gt; 45 &lt;/td&gt;<br /> &lt;td&gt; f &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;/table&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><table>
+
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>[http://www.spiffystores.com/ http://spiffyserver.com/images/spiffy-stores-logo.gif]</p>
 +
|}
  
<tr>
+
=== Image Alignments ===
<td> name </td>
 
<td> age </td>
 
<td> sex </td>
 
</tr>
 
<tr>
 
  
<td> joan </td>
+
Alignments can be applied as well to images.
<td> 24 </td>
 
<td> f </td>
 
</tr>
 
<tr>
 
<td> archie </td>
 
  
<td> 29 </td>
+
{| style="width: 100%" cellspacing="10"
<td> m </td>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|!&gt;<nowiki>http://spiffyserver.com/images/spiffy-stores-logo.gif</nowiki>!<br /><br />And others sat all round the small<br />machine and paid it to sing to them.
</tr>
+
|&rarr;
<tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p style="float:right"&gt;&lt;img src="<nowiki>http://spiffyserver.com/images/spiffy-stores-logo.gif</nowiki>" alt="" /&gt;&lt;/p&gt;<br /><br />&lt;p&gt;And others sat all round the small<br />machine and paid it to sing to them.&lt;/p&gt;
<td> bella </td>
+
|-
<td> 45 </td>
+
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p style="float:right">http://spiffyserver.com/images/spiffy-stores-logo.gif</p>
 +
<p>And others sat all round the small machine and paid it to sing to them.</p>
 +
|}
  
<td> f </td>
+
=== Acronyms ===
</tr>
 
</table></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>Specify header cells by marking them with an underscore and period.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>|_. name |_. age |_. sex |<br />| joan | 24 | f |<br />| archie | 29 | m |<br />| bella | 45 | f |</pre></td><td>&rarr;</td><td class='example2'><p>&lt;table&gt;<br /> &lt;tr&gt;<br /> &lt;th&gt;name &lt;/th&gt;<br /> &lt;th&gt;age &lt;/th&gt;<br /> &lt;th&gt;sex &lt;/th&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td&gt; joan &lt;/td&gt;<br /> &lt;td&gt; 24 &lt;/td&gt;<br /> &lt;td&gt; f &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td&gt; archie &lt;/td&gt;<br /> &lt;td&gt; 29 &lt;/td&gt;<br /> &lt;td&gt; m &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td&gt; bella &lt;/td&gt;<br /> &lt;td&gt; 45 &lt;/td&gt;<br /> &lt;td&gt; f &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;/table&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><table>
 
  
<tr>
+
Definitions for acronyms can be provided by following an acronym with its definition in parentheses.
<th>name </th>
 
<th>age </th>
 
<th>sex </th>
 
</tr>
 
<tr>
 
<td> joan </td>
 
  
<td> 24 </td>
+
{| style="width: 100%" cellspacing="10"
<td> f </td>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|We use CSS(Cascading Style Sheets).
</tr>
+
|&rarr;
<tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;p&gt;We use &lt;acronym title="Cascading Style Sheets"&gt;CSS&lt;/acronym&gt;.&lt;/p&gt;
<td> archie </td>
+
|-
<td> 29 </td>
+
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<p>We use <html><acronym title="Cascading Style Sheets">CSS</acronym></html>.</p>
 +
|}
  
<td> m </td>
+
== Tables ==
</tr>
 
<tr>
 
<td> bella </td>
 
<td> 45 </td>
 
<td> f </td>
 
  
</tr>
+
Simple tables can be built by separating fields with pipe characters.
</table></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<h4>Cell Attributes</h4>
 
</td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>The period used above marks the end of a cell&#8217;s attributes.  Other attributes can be applied as well.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>|_. attribute list |<br />|&lt;. align left |<br />|&gt;. align right|<br />|=. center |<br />|&lt;&gt;. justify |<br />|^. valign top |<br />|~. bottom |</pre></td><td>&rarr;</td><td class='example2'><p>&lt;table&gt;<br /> &lt;tr&gt;<br /> &lt;th&gt;attribute list &lt;/th&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td style="text-align:left;"&gt;align left &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td style="text-align:right;"&gt;align right&lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td style="text-align:center;"&gt;center &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td style="text-align:justify;"&gt;justify &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td style="vertical-align:top;"&gt;valign top &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td style="vertical-align:bottom;"&gt;bottom &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;/table&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><table>
 
  
<tr>
+
{| style="width: 100%" cellspacing="10"
<th>attribute list </th>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|<nowiki>| name | age | sex |</nowiki><br /><nowiki>| joan | 24 | f |</nowiki><br /><nowiki>| archie | 29 | m |</nowiki><br /><nowiki>| bella | 45 | f |</nowiki>
</tr>
+
|&rarr;
<tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;table&gt;<br />&lt;tr&gt;<br />&lt;td&gt; name &lt;/td&gt;<br />&lt;td&gt; age &lt;/td&gt;<br />&lt;td&gt; sex &lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td&gt; joan &lt;/td&gt;<br />&lt;td&gt; 24 &lt;/td&gt;<br />&lt;td&gt; f &lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td&gt; archie &lt;/td&gt;<br />&lt;td&gt; 29 &lt;/td&gt;<br />&lt;td&gt; m &lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td&gt; bella &lt;/td&gt;<br />&lt;td&gt; 45 &lt;/td&gt;<br />&lt;td&gt; f &lt;/td&gt;<br />&lt;/tr&gt;<br /> &lt;/table&gt;
<td style="text-align:left;">align left </td>
+
|-
</tr>
+
|&nbsp;
<tr>
+
|&nbsp;
<td style="text-align:right;">align right</td>
+
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<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>
 +
|}
 +
 
 +
Specify header cells by marking them with an underscore and period.
 +
 
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|<nowiki>| _.name | _.age | _.sex |</nowiki><br /><nowiki>| joan | 24 | f |</nowiki><br /><nowiki>| archie | 29 | m |</nowiki><br /><nowiki>| bella | 45 | f |</nowiki>
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;table&gt;<br />&lt;tr&gt;<br />&lt;th&gt; name &lt;/th&gt;<br />&lt;th&gt; age &lt;/th&gt;<br />&lt;th&gt; sex &lt;/th&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td&gt; joan &lt;/td&gt;<br />&lt;td&gt; 24 &lt;/td&gt;<br />&lt;td&gt; f &lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td&gt; archie &lt;/td&gt;<br />&lt;td&gt; 29 &lt;/td&gt;<br />&lt;td&gt; m &lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td&gt; bella &lt;/td&gt;<br />&lt;td&gt; 45 &lt;/td&gt;<br />&lt;td&gt; f &lt;/td&gt;<br />&lt;/tr&gt;<br /> &lt;/table&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<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>
 +
|}
  
</tr>
+
=== Cell Attributes ===
<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>
+
The period character, as used above, marks the end of a cell's attributes.  Other attributes can be applied as well.
</tr>
 
<tr>
 
<td style="vertical-align:bottom;">bottom </td>
 
</tr>
 
</table></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>You can also specify colspans with a backslash, followed by the cell width.</p>
 
  
</td></tr>
 
<tr><td class='example1' valign='top'><pre>|\2. spans two cols |<br />| col 1 | col 2 |</pre></td><td>&rarr;</td><td class='example2'><p>&lt;table&gt;<br /> &lt;tr&gt;<br /> &lt;td colspan="2"&gt;spans two cols &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td&gt; col 1 &lt;/td&gt;<br /> &lt;td&gt; col 2 &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;/table&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><table>
 
  
<tr>
+
{| style="width: 100%" cellspacing="10"
<td colspan="2">spans two cols </td>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|<nowiki>|_. attribute list |</nowiki><br /><nowiki>|&lt;. align left |</nowiki><br /><nowiki>|&gt;. align right|</nowiki><br /><nowiki>|=. center |</nowiki><br /><nowiki>|&lt;&gt;. justify |</nowiki><br /><nowiki>|^. valign top |</nowiki><br /><nowiki>|~. bottom |</nowiki>
</tr>
+
|&rarr;
<tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;table&gt;<br />&lt;tr&gt;<br />&lt;th&gt;attribute list &lt;/th&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td style="text-align:left;"&gt;align left &lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td style="text-align:right;"&gt;align right&lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td style="text-align:center;"&gt;center &lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td style="text-align:justify;"&gt;justify &lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td style="vertical-align:top;"&gt;valign top &lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td style="vertical-align:bottom;"&gt;bottom &lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;/table&gt;
<td> col 1 </td>
+
|-
<td> col 2 </td>
+
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<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>
 +
|}
  
</tr>
+
You can also specify ''colspans'' with a backslash, followed by the cell width.
</table></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>Rowspan is specified by a forward slash, followed by the row height.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>|/3. spans 3 rows | a |<br />| b |<br />| c |</pre></td><td>&rarr;</td><td class='example2'><p>&lt;table&gt;<br /> &lt;tr&gt;<br /> &lt;td rowspan="3"&gt;spans 3 rows &lt;/td&gt;<br /> &lt;td&gt; a &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td&gt; b &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td&gt; c &lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;/table&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><table>
 
  
<tr>
+
{| style="width: 100%" cellspacing="10"
<td rowspan="3">spans 3 rows </td>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|<nowiki>|\2. spans two cols |</nowiki><br /><nowiki>| col 1 | col 2 |
<td> a </td>
+
</nowiki>
</tr>
+
|&rarr;
<tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;table&gt;<br />&lt;tr&gt;<br />&lt;td colspan="2"&gt;spans two cols &lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td&gt; col 1 &lt;/td&gt;<br />&lt;td&gt; col 2 &lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;/table&gt;
<td> b </td>
+
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<table>
 +
<tr>
 +
  <td colspan="2">spans two cols </td>
 +
</tr>
 +
<tr>
 +
  <td> col 1 </td>
 +
  <td> col 2 </td>
 +
</tr>
 +
</table>
 +
|}
  
</tr>
+
A ''rowspan'' is specified by a forward slash, followed by the row height.
<tr>
 
<td> c </td>
 
</tr>
 
</table></td></tr>
 
<tr><td class='explain' colspan='3'>
 
<p>All block attributes can be applied to table cells as well.</p>
 
</td></tr>
 
<tr><td class='example1' valign='top'><pre>|{background:#ddd}. Grey cell|</pre></td><td>&rarr;</td><td class='example2'><p>&lt;table&gt;<br /> &lt;tr&gt;<br /> &lt;td style="background:#ddd;"&gt;Grey cell&lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;/table&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><table>
 
  
<tr>
+
{| style="width: 100%" cellspacing="10"
<td style="background:#ddd;">Grey cell</td>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|<nowiki>|/3. spans 3 rows | a |</nowiki><br /><nowiki>| b |</nowiki><br /><nowiki>| c |</nowiki>
</tr>
+
|&rarr;
</table></td></tr>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;table&gt;<br />&lt;tr&gt;<br />&lt;td rowspan="3"&gt;spans 3 rows &lt;/td&gt;<br />&lt;td&gt; a &lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td&gt; b &lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td&gt; c &lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;/table&gt;
<tr><td class='explain' colspan='3'>
+
|-
<h4>Table and Row Attributes</h4>
+
|&nbsp;
</td></tr>
+
|&nbsp;
<tr><td class='explain' colspan='3'>
+
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<table>
<p>Table-wide attributes can be applied before the first row of the table.  On its own line, followed by a period.</p>
+
<tr>
</td></tr>
+
<td rowspan="3">spans 3 rows </td>
 +
<td> a </td>
 +
</tr>
 +
<tr>
 +
<td> b </td>
 +
</tr>
 +
<tr>
 +
<td> c </td>
 +
</tr>
 +
</table>
 +
|}
  
<tr><td class='example1' valign='top'><pre>table{border:1px solid black}.<br />|This|is|a|row|<br />|This|is|a|row|</pre></td><td>&rarr;</td><td class='example2'><p>&lt;table style="border:1px solid black;"&gt;<br /> &lt;tr&gt;<br /> &lt;td&gt;This&lt;/td&gt;<br /> &lt;td&gt;is&lt;/td&gt;<br /> &lt;td&gt;a&lt;/td&gt;<br /> &lt;td&gt;row&lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;tr&gt;<br /> &lt;td&gt;This&lt;/td&gt;<br /> &lt;td&gt;is&lt;/td&gt;<br /> &lt;td&gt;a&lt;/td&gt;<br /> &lt;td&gt;row&lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;/table&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><table style="border:1px solid black;">
+
All block attributes can be applied to table cells as well.
  
<tr>
+
{| style="width: 100%" cellspacing="10"
<td>This</td>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|<nowiki>|{background:#ddd}. Grey cell|</nowiki>
<td>is</td>
+
|&rarr;
<td>a</td>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;table&gt;<br />&lt;tr&gt;<br />&lt;td style="background:#ddd;"&gt;Grey cell&lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;/table&gt;
<td>row</td>
+
|-
</tr>
+
|&nbsp;
<tr>
+
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<table>
 +
<tr>
 +
<td style="background:#ddd;">Grey cell</td>
 +
</tr>
 +
</table>
 +
|}
  
<td>This</td>
+
=== Table and Row Attributes ===
<td>is</td>
 
<td>a</td>
 
<td>row</td>
 
</tr>
 
</table></td></tr>
 
<tr><td class='explain' colspan='3'>
 
  
<p>Attributes can be applied to a single row by supplying the attribute before the row starts, using a <code>table</code> modifier and following it by a period.</p>
+
Table-wide attributes can be applied before the first row of the table.  On its own line, followed by a period.
</td></tr>
 
<tr><td class='example1' valign='top'><pre>|This|is|a|row|<br />{background:#ddd}. |This|is|grey|row|</pre></td><td>&rarr;</td><td class='example2'><p>&lt;table&gt;<br /> &lt;tr&gt;<br /> &lt;td&gt;This&lt;/td&gt;<br /> &lt;td&gt;is&lt;/td&gt;<br /> &lt;td&gt;a&lt;/td&gt;<br /> &lt;td&gt;row&lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;tr style="background:#ddd;"&gt;<br /> &lt;td&gt;This&lt;/td&gt;<br /> &lt;td&gt;is&lt;/td&gt;<br /> &lt;td&gt;grey&lt;/td&gt;<br /> &lt;td&gt;row&lt;/td&gt;<br /> &lt;/tr&gt;<br /> &lt;/table&gt;</p></td></tr><tr><td colspan='2'></td><td class='example3'><table>
 
  
<tr>
+
{| style="width: 100%" cellspacing="10"
<td>This</td>
+
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|table{border:1px solid black}.<br /><nowiki>|This|is|a|row|</nowiki><br /><nowiki>|This|is|a|row|</nowiki>
<td>is</td>
+
|&rarr;
<td>a</td>
+
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;table style="border:1px solid black;"&gt;<br />&lt;tr&gt;<br />&lt;td&gt;This&lt;/td&gt;<br />&lt;td&gt;is&lt;/td&gt;<br />&lt;td&gt;a&lt;/td&gt;<br />&lt;td&gt;row&lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;tr&gt;<br />&lt;td&gt;This&lt;/td&gt;<br />&lt;td&gt;is&lt;/td&gt;<br />&lt;td&gt;a&lt;/td&gt;<br />&lt;td&gt;row&lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;/table&gt;
<td>row</td>
+
|-
</tr>
+
|&nbsp;
<tr style="background:#ddd;">
+
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<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>
 +
|}
  
<td>This</td>
+
Attributes can be applied to a single row by supplying the attribute before the row starts, using a <code>table</code> modifier and following it by a period.
<td>is</td>
 
<td>grey</td>
 
<td>row</td>
 
</tr>
 
</table></td></tr>
 
<tr><td colspan='5' style='border-bottom: solid 1px #eee;'></td></tr>
 
  
 +
{| style="width: 100%" cellspacing="10"
 +
|style="width: 49%; background-color: #B30; color: white; padding: 5px"|<nowiki>|This|is|a|row|</nowiki><br />{background:#ddd}. <nowiki>|This|is|grey|row|</nowiki>
 +
|&rarr;
 +
|style="width: 49%; background-color: #EEE; border: 1px solid #DDD; padding: 5px"|&lt;table&gt;<br />&lt;tr&gt;<br />&lt;td&gt;This&lt;/td&gt;<br />&lt;td&gt;is&lt;/td&gt;<br />&lt;td&gt;a&lt;/td&gt;<br />&lt;td&gt;row&lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;tr style="background:#ddd;"&gt;<br />&lt;td&gt;This&lt;/td&gt;<br />&lt;td&gt;is&lt;/td&gt;<br />&lt;td&gt;grey&lt;/td&gt;<br />&lt;td&gt;row&lt;/td&gt;<br />&lt;/tr&gt;<br />&lt;/table&gt;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|style="background-color: #FFE; border: 1px solid #EED; padding: 5px"|<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>
 
</table>
 +
|}

Latest revision as of 12:57, 7 June 2011

Textile is a simple text markup. Simple symbols mark a word's emphasis. Blocks of text can be easily tagged as headers, quotes, or lists. A Textile document can then be converted to HTML (Hypertext Markup Language) for viewing on the web.

Texile makes it easy to mark up text for a web page without needing to have any knowledge about HTML.

You can try out Textile on the Textile home page.

Reading the Examples

In each section below, examples are provided to help clearly illustrate how to use the markup. In each example, the Textile example is followed by the raw HTML that is generated. This is followed by an example of how the output will appear in a browser.

Textile example Converted to HTML
    Browser view

Writing in Textile

Paragraphs in Textile

Textile looks for paragraphs in your text. Paragraphs are separated by one blank line. Every paragraph is translated as an HTML paragraph.

A single paragraph.

Followed by another.
<p>A single paragraph.</p>

<p>Followed by another.</p>
   

A single paragraph.

Followed by another.

Using HTML in Textile

You can certainly use HTML tags inside your Textile documents. HTML will only be escaped if it's found in a pre or code block.


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.

Line Breaks

Line breaks are converted to HTML breaks.

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

I spoke.
And none replied.

Entities

Single-quotes and double-quotes around words or phrases are converted to curly quotations, which are much easier on the eye.

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

“Observe!”

Double hyphens are replaced with an em-dash.

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

Observe — very nice!

Single hyphens are replaced with en-dashes.

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

Observe – tiny and brief.

Triplets of periods become an ellipsis.

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

Observe…

The letter ‘x’ becomes a dimension sign when used alone.

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

Observe: 2×2.

Conversion of trademark and copyright symbols.

a(TM), b(R), c(C). <p>a&#8482;, b&#174;, c&#169;.</p>
   

a™, b®, c©.

Quick Block Modifiers

Blocks of text are treated as paragraphs by default. However, modifers can be prefixed to the beginning of a block to change its treatment.

Headers

To make an entire paragraph into a Header, place "hn" at its beginning, where n is a number from 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

Block Quotes

To make an entire paragraph into a block quotation, place "bq." before it.

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

Footnotes

Numeric references within text to footnotes appear between square brackets.

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

This is covered elsewhere1.

To create the footnote that corresponds to its reference within the text, begin a new paragraph with fn and the footnote's number, followed by a dot and a space.

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

1 Down here, in fact.

Quick Phrase Modifiers

Structural Emphasis

Emphasis to text is added by surrounding a phrase with underscores. In HTML, this often appears as italics.

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

I believe every word.

Strength can be give to text by surrounding with asterisks. In HTML, this strength appears as bold.

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

And then? She fell!

Both italics and bold can be forced by doubling the underscores or asterisks.

I __know__.
I **really** __know__.
<p>I <i>know</i>.<br />
I <b>really</b> <i>know</i>.</p>
   

I know.
I really know.

Use double question marks to indicate citation. The title of a book, for instance,

??Cat's Cradle?? by Vonnegut <p><cite>Cat's Cradle</cite> by Vonnegut</p>
   

Cat's Cradle by Vonnegut

Code phrases can be surrounded by at-symbols.

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

Convert with r.to_html

To indicate a passage which has been deleted, surround the passage with hyphens.

I'm -sure- not sure. <p>I'm <del>sure</del> not sure.</p>
   

I'm sure not sure.

Pluses around a passage indicate its insertion.

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

You are a pleasant child.

To superscript a phrase, surround with carets.

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

a2 + b2 = c2

To subscript, surround with tildes.

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

log2 x

HTML-Specific

Lastly, if you find yourself needing to customize the style of a passage, use percent symbols to translate the passage as an HTML span.

I'm %unaware% of most soft drinks. <p>I'm <span>unaware</span> of most soft drinks.</p>
   

I'm unaware of most soft drinks.

This way, you can apply style settings, as described in the next section to arbitrary phrases.

I'm %{color:red}unaware% of most soft drinks. <p>I'm <span style="color:red;">unaware</span> of most soft drinks.</p>
   

I'm unaware of most soft drinks.

Attributes

Tailoring Textile to suit your needs is quite easy. Attributes allow you to provide Cascading Style Sheets (CSS) information about any phrase.

Block Attributes

A block can be tagged with a CSS class by enclosing the class name in parentheses and placing it just before the period which marks the block.

p(example1). An example <p class="example1">An example</p>
   

An example

An element ID can be given by prefixing the ID with a hash symbol (#) and using it in place of the class.

p(#big-red). Red here <p id="big-red">Red here</p>
   

Red here

Class and ID can be combined by placing the class first.

p(example1#big-red2). Red here <p class="example1" id="big-red2">Red here</p>
   

Red here

Style settings can be provided directly by surrounding them in curly braces.

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

Spacey blue

Language designations can be given between square brackets.

p[fr]. rouge <p lang="fr">rouge</p>
   

rouge

Phrase Attributes

All block attributes can be applied to phrases as well by placing them just inside the opening modifier.

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.

Block Alignments

Text inside blocks can be aligned in four basic ways.

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

Indentation can also be specified by provide a single left paren for every 1em to the left. A single right paren for every 1em to the right.

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

Combining Alignments

Identation may be coupled with alignment.

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

And, furthermore, coupled with language settings and CSS styles.

h3()>[no]{color:red}. Bingo <h3 style="color:red; padding-left:1em; padding-right:1em; text-align:right;" lang="no">Bingo</h3>
   
Bingo

HTML in Textile

Textile is designed for making simple markup quick and easy. For more complex formatting, you are encouraged to break out into HTML.

For example, long code blocks belong between <pre>…</pre> and <code>…</code> tags. Please also indent your code inside the tags to be sure that all Textile processors out there will ignore the contents.

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

You may also choose to surround sections with <div> tags to separate your document into sections. Instiki uses this technique to float a sidebar to the right.

<div style="float:right;padding:5px;">

h3. Sidebar

"Spiffy":http://www.spiffystores.com/
"Ruby":http://ruby-lang.org/

</div>

The main text of the page goes here and will stay to the left of the sidebar.
<div style="float:right;padding:5px;">
<h3>Sidebar</h3>
<p>
<a href="http://www.spiffystores.com/">Spiffy</a><br />
<a href="http://ruby-lang.org/">Ruby</a>
</p>
</div>

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

Spiffy
Ruby

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

Lists

Numeric Lists

To make a numbered list, place each item in its own paragraph, preceded by a hash character ("#").

# 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

These lists may be nested by increasing the number of hash characters ("#") that precede the child entries.

# Fuel could be:
## Coal
## Petrol
## Electricity
# Humans need only:
## Water
## Protein
<ol>
<li>Fuel could be:
<ol>
<li>Coal</li>
<li>Petrol</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. Petrol
    3. Electricity
  2. Humans need only:
    1. Water
    2. Protein

Bulleted Lists

Bulleted lists use an asterisk character ("*") instead of the hash character ("#").

* 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

These lists may also be nested in a similar manner.

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

External References

Hypertext Links

Basic links are comprised of a phrase which is linked to a URL. Place the descriptive phrase in quotation marks, and follow it immediately by a colon and the URL.

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

I searched Google.

Note, the link won't include any trailing punctuation.

Link Aliases

If you are using the same link several times in your document, or you'd just like to be a tad more organized, you can use a link alias. Place the URL anywhere in your document, beginning with its alias in square brackets. Then, use the alias in place of the URL, using the link format above.

I am crazy about "Spiffy Stores":spiffy
and "it's":spiffy "all":spiffy I ever
"link to":spiffy!

[spiffy]http://www.spiffystores.com
<p>I am crazy about <a href="http://www.spiffystores.com">Spiffy Stores</a>
and <a href="http://www.spiffystores.com">it's</a> <a href="http://www.spiffystores.com">all</a> I ever
<a href="http://www.spiffystores.com">link to</a>!</p>
   

I am crazy about Spiffy Stores and it's all I ever link to!

Embedded Images

You can embed an image in your Textile document by surrounding its URL with exclamation marks.

!http://spiffyserver.com/images/spiffy-stores-logo.gif! <p><img src="http://spiffyserver.com/images/spiffy-stores-logo.gif" alt="" /></p>
   

spiffy-stores-logo.gif

URLs may be relative.

A title for the image can also be provided in parentheses, just before the closing exclamation mark.

!http://spiffyserver.com/images/spiffy-stores-logo.gif(Spiffy Logo)! <p><img src="http://spiffyserver.com/images/spiffy-stores-logo.gif" title="Spiffy Logo" alt="Spiffy Logo" /></p>
   

Spiffy Logo

The title also acts as alt text should the image not be found.

Links can be attached to images with a colon.

!http://spiffyserver.com/images/spiffy-stores-logo.gif!:http://www.spiffystores.com/ <p><a href="http://www.spiffystores.com/"><img src="http://spiffyserver.com/images/spiffy-stores-logo.gif" alt="" /></a></p>
   

spiffy-stores-logo.gif

Image Alignments

Alignments can be applied as well to images.

!>http://spiffyserver.com/images/spiffy-stores-logo.gif!

And others sat all round the small
machine and paid it to sing to them.
<p style="float:right"><img src="http://spiffyserver.com/images/spiffy-stores-logo.gif" alt="" /></p>

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

spiffy-stores-logo.gif

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

Acronyms

Definitions for acronyms can be provided by following an acronym with its definition in parentheses.

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

We use CSS.

Tables

Simple tables can be built by separating fields with pipe characters.

| 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

Specify header cells by marking them with an underscore and period.

| _.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

Cell Attributes

The period character, as used above, marks the end of a cell's attributes. Other attributes can be applied as well.


|_. 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

You can also specify colspans with a backslash, followed by the cell width.

|\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

A rowspan is specified by a forward slash, followed by the row height.

|/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

All block attributes can be applied to table cells as well.

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

Table and Row Attributes

Table-wide attributes can be applied before the first row of the table. On its own line, followed by a period.

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

Attributes can be applied to a single row by supplying the attribute before the row starts, using a table modifier and following it by a period.

|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