Textile (markup language)
Encyclopedia
Textile is a lightweight markup language
originally developed by Dean Allen and billed as a "humane Web text generator". Textile converts its marked-up text input to valid, well-formed XHTML
and also inserts character entity reference
s for apostrophes, opening and closing single and double quotation mark
s, ellipses
and em dashes.
Textile was originally implemented in PHP
, but has been translated into other programming language
s including Perl
, Python
, Ruby
, ASP
, Java
and C#.
Textile is distributed under a BSD-style license
and is included with, or available as a plugin for, several content-management systems
.
* Another item in a bulleted list
** Second Level
** Second Level Items
*** Third level
# An item in an enumerated (ordered) list xxxxxxx
# Another item in an enumerated list yyyyyy
## Another level in an enumerated list vvvvvvvv
* This is a bullet
*# this is a numbered list
*# this is another numbered list
* This is another bullet
character must be at the beginning and end of every row.
|_. Header |_. Header |_. Header |
| Cell 1 | Cell 2 | Cell 3 |
| Cell 1 | Cell 2 | Cell 3 |
@your code here@
Multi-line example using JavaScript:
Note: Handling of line breaks can be a bit quirky and there cannot be any empty lines in the block of code.
@function myTest {
alert('Codeblock Example');
}
myTest;
@
h1(#id). An HTML first-level heading
h2. An HTML second-level heading
h3. An HTML third-level heading
h4. An HTML fourth-level heading
h5. An HTML fifth-level heading
h6. An HTML sixth-level heading
mailto:someone@example.com
Lightweight markup language
A lightweight markup language is a markup language with a simple syntax, designed to be easy for a human to enter with a simple text editor, and easy to read in its raw form....
originally developed by Dean Allen and billed as a "humane Web text generator". Textile converts its marked-up text input to valid, well-formed XHTML
XHTML
XHTML is a family of XML markup languages that mirror or extend versions of the widely-used Hypertext Markup Language , the language in which web pages are written....
and also inserts character entity reference
Character entity reference
In the markup languages SGML, HTML, XHTML and XML, a character entity reference is a reference to a particular kind of named entity that has been predefined or explicitly declared in a Document Type Definition . The "replacement text" of the entity consists of a single character from the Universal...
s for apostrophes, opening and closing single and double quotation mark
Quotation mark
Quotation marks or inverted commas are punctuation marks at the beginning and end of a quotation, direct speech, literal title or name. Quotation marks can also be used to indicate a different meaning of a word or phrase than the one typically associated with it and are often used to express irony...
s, ellipses
Ellipsis
Ellipsis is a series of marks that usually indicate an intentional omission of a word, sentence or whole section from the original text being quoted. An ellipsis can also be used to indicate an unfinished thought or, at the end of a sentence, a trailing off into silence...
and em dashes.
Textile was originally implemented in PHP
PHP
PHP is a general-purpose server-side scripting language originally designed for web development to produce dynamic web pages. For this purpose, PHP code is embedded into the HTML source document and interpreted by a web server with a PHP processor module, which generates the web page document...
, but has been translated into other programming language
Programming language
A programming language is an artificial language designed to communicate instructions to a machine, particularly a computer. Programming languages can be used to create programs that control the behavior of a machine and/or to express algorithms precisely....
s including Perl
Perl
Perl is a high-level, general-purpose, interpreted, dynamic programming language. Perl was originally developed by Larry Wall in 1987 as a general-purpose Unix scripting language to make report processing easier. Since then, it has undergone many changes and revisions and become widely popular...
, Python
Python (programming language)
Python is a general-purpose, high-level programming language whose design philosophy emphasizes code readability. Python claims to "[combine] remarkable power with very clear syntax", and its standard library is large and comprehensive...
, Ruby
Ruby (programming language)
Ruby is a dynamic, reflective, general-purpose object-oriented programming language that combines syntax inspired by Perl with Smalltalk-like features. Ruby originated in Japan during the mid-1990s and was first developed and designed by Yukihiro "Matz" Matsumoto...
, ASP
Active Server Pages
Active Server Pages , also known as Classic ASP or ASP Classic, was Microsoft's first server-side script engine for dynamically-generated Web pages. Initially released as an add-on to Internet Information Services via the Windows NT 4.0 Option Pack Active Server Pages (ASP), also known as Classic...
, Java
Java (programming language)
Java is a programming language originally developed by James Gosling at Sun Microsystems and released in 1995 as a core component of Sun Microsystems' Java platform. The language derives much of its syntax from C and C++ but has a simpler object model and fewer low-level facilities...
and C#.
Textile is distributed under a BSD-style license
BSD licenses
BSD licenses are a family of permissive free software licenses. The original license was used for the Berkeley Software Distribution , a Unix-like operating system after which it is named....
and is included with, or available as a plugin for, several content-management systems
Content management system
A content management system is a system providing a collection of procedures used to manage work flow in a collaborative environment. These procedures can be manual or computer-based...
.
- Version 2.0 beta was released in 2004 as part of the TextpatternTextpatternTextpattern is an open source content management system originally developed by Dean Allen. While it is often listed among weblogging tools, its aim is to be a general-purpose content management system suitable for deployment in many contexts. Textpattern is written in PHP using a MySQL database...
content management systemContent management systemA content management system is a system providing a collection of procedures used to manage work flow in a collaborative environment. These procedures can be manual or computer-based...
. - Version 2.0 was released in 2006.
- Version 2.2 was released on September 23, 2010.
Textile syntax examples
This is not an exhaustive listing of Textile's syntax. For a list of all available options in Textile 2, see the full syntax reference and a full reference and example list here.Lists
* An item in a bulleted (unordered) list* Another item in a bulleted list
** Second Level
** Second Level Items
*** Third level
# An item in an enumerated (ordered) list xxxxxxx
# Another item in an enumerated list yyyyyy
## Another level in an enumerated list vvvvvvvv
* This is a bullet
*# this is a numbered list
*# this is another numbered list
* This is another bullet
Tables
A|_. Header |_. Header |_. Header |
| Cell 1 | Cell 2 | Cell 3 |
| Cell 1 | Cell 2 | Cell 3 |
Code
Generic example:@your code here@
Multi-line example using JavaScript:
Note: Handling of line breaks can be a bit quirky and there cannot be any empty lines in the block of code.
@function myTest {
alert('Codeblock Example');
}
myTest;
@
Headings
You must leave a blank line after each heading.h1(#id). An HTML first-level heading
h2. An HTML second-level heading
h3. An HTML third-level heading
h4. An HTML fourth-level heading
h5. An HTML fifth-level heading
h6. An HTML sixth-level heading
Email Links
"(classname)link text(title tooltip)":Formatting help table
This table summarizes the available textile markers| Textile | Visual result | |
|---|---|---|
| *bold text* | bold text | |
| _italic text_ | italic text | |
| *_bold italic text_* | bold italic text | |
| -strikethrough text- | ||
| *-bold strikethrough text-* | ||
| *_-bold italic strikethrough text-_* | ||
| +underlined text+ | underlined text | |
| *+bold underlined text+* | bold underlined text | |
| _+italic underlined text+_ | italic underlined text | |
| *_+bold italic underlined text+_* | bold italic underlined text | |
| *_-+bold italic strikethrough underlined text+-_* | ||
| %{font-size:18pt}font size% | font size | |
| %{color:red}text in red% | text in red | |
| Link to click for the list of colours | ||
| # Chapter 1 | ||
| * bulleted list | bulleted list | |
* bulleted list ** 2-level |
|
|
|Table | with two columns | |and two | lines | |
Table | with two columns |
| and two | lines | |
"Link to Wikipedia":http://www.wikipedia.org |
Link to Wikipedia | |
!http://commons.wikimedia.org/wiki/Special:Filepath/Wikipedia-logo-en.png! |
||
| Brand ^TM^ | Brand TM | |
| Text ~subscript~ | Text subscript | |
See also
- TextpatternTextpatternTextpattern is an open source content management system originally developed by Dean Allen. While it is often listed among weblogging tools, its aim is to be a general-purpose content management system suitable for deployment in many contexts. Textpattern is written in PHP using a MySQL database...
, a content-management system, also originally by Dean Allen, which uses Textile.
External links
- Textile Homepage, updated 2011, as well as examples of an implementation in PHP
- Textile Download Link, updated 2011
- hobix.com Textile Reference, an example-based Textile reference.
- Text::Textile, an implementation of Textile in Perl.
- PyTextile, an implementation of Textile in Python.
- RedCloth, an implementation of Textile in Ruby.
- vbsTextile, an implementation of Textile for Microsoft Active Server Pages
- Textile UDF, an implementation of Textile in ColdFusion.
- JTextile, an implementation of Textile in Java
- Textile4j, an implementation of Textile in Java
- Textile-j, an implementation of Textile in Java that includes components for SWT and JFace and an EclipseEclipse (software)Eclipse is a multi-language software development environment comprising an integrated development environment and an extensible plug-in system...
editor plugin - Xilize, a superset of Textile for generating webpages, documents, and websites with any plain-text editor (plugin for jEditJEditjEdit is a text editor for programmers, available under the GNU General Public License version 2.0. It is written in Java and runs on any operating system with Java support, including Windows, Linux, Mac OS X, and BSD.-Development:...
available). Opensource. - Textile.NET, an implementation of Textile in C#/.NET
- octalforty Brushie Text, one more implementation of Textile in C#/.NET
- Textile Markup with MediaWiki, a way to use Textile on MediaWiki sites like Wikipedia
- Textile JS, an implementation of Textile in Javascript
- JQtextile, an implementation of Textile using the jQuery Javascript framework
- Mylyn WikiText, an implementation of Textile in Java that includes components for SWT and JFace, Ant tasks and an EclipseEclipse (software)Eclipse is a multi-language software development environment comprising an integrated development environment and an extensible plug-in system...
editor plugin