Textile 语法

2011-03-27
标签: TEXTILE
本文发布至今已有13年零27天,可能不再适用,请谨慎对待。

Textile 是类似 MarkDown 一样的快速小型标记性语言,让用户能够快速的设计格式,将注意力集中在格式上面,而不是XHTML的语法和尖括号的配对上面。本文简单介绍 Textile 语法。

简介

Textile 是类似 MarkDown 一样的快速小型标记性语言。最初由Dean Allen开发,号称"人性化的网络语言生成器"(A Humane Web Text Generator)。Textile将特定的符号转化为 HTML 的语法,用简单的字符替代了复杂的标记符号,让用户能够快速的设计格式,将注意力集中在格式上面,而不是 HTML 的语法和尖括号的配对上面。

Textile最初用PHP开发,随后移植到其他的语言,比如Perl、Python、Ruby、ASP、Java和C语言。

有些内容管理系统(CMS,content-management system)把Textile作为可以安装的外部插件,或者直接内置作为一项特色功能。比如 本站 使用的Textpattern系统,就在2004年内置了Textile 2.0 beta版。Textile语言更多的用于论坛、评论等需要设置简单文字格式的场合。

Textile文档在这里 ,在这里简单介绍下语法和中文环境下的特殊用法。

修饰文字

修饰行内文字的语法如下表:

字体样式Textile语法对应XHTML语法实际显示效果
加强*strong*<strong>strong</strong>strong
强调_emphasis_<em>emphasis</em>emphasis
加粗**bold**<b>bold</b>bold
斜体__italics__<i>italics</i>italics
加大字号++bigger++<big>bigger</big>bigger
减小字号--smaller--<small>smaller</small>smaller
删除文字-deleted text-<del>deleted text</del>deleted text
插入文字+inserted text+<ins>inserted text</ins>inserted text
上标^superscript^<sup>superscript</sup>Text 上标
下标~subscript~<sub>subscript</sub>Text 下标
Span%span%<span>span</span>span
行内代码块@code@<code>code</code>code

修饰段落

修饰段落用于指定当前段落的属性,修饰段落的语法如下表:

用途Textile语法对应XHTML语法
普通段落p.<p></p>
标题hn.<hn></hn>
块状引用bq.<blockquote></blockquote>
块状代码bc.<code></code>

普通段落 p.

一般情况下 p. 这个修饰符可以忽略,因为所有的空行后面新起的一行会被 textile 解释器解释为普通段落。也就是说,下面的文本:

一行文字
(空行)
空行后的一行文字

等效于textile 的写法

p. 一行文字

p. 空行后的一行文字

以上二者都会被解释为如下的 HTML:

<p>一行文字</p>

<p>空行后的一行文字</p>

标题文字 hn.

这里 n 表示 1~7 等数字

h2. 二级标题

会被解释为:

<h2>二级标题</h2>

块状引用 bq.

表示整段引用的文字,比如

bq. 块状引用

会被解释为:

<blockquote>
<p>块状引用</p>
</blockquote>

代码块 bc.

表示代码框,比如

bc. 代码块

会被解释为:

<pre>
<code>代码块</code>
</pre>

正常情况下,这些段落以一个新的换行符为结束的标志。但有时候一个段落内需要包含换行符(比如多行的代码),这时候需要将段落的定义延伸。

延伸段落的范围

一般来说,换行符开始会被认作段落的结束标志,但是如果要在一个段落包含两个以上的新行,只需要在修饰符(比如p.)后面再多加一个点,告诉textile解析器,段落内有多个新行,直到出现另一个段落标记(p.)。比如

bc.. 本段落会一直延伸到一个 p. 结束。

这是第二段。

这是第三段。


p. 这一段不包括在上面的段落内。

转义符

有些字符不需要解释为Textile语言,这时就需要转义符。Textile语言的转义符是相连的两个等号"==",用两个等号围起来的部分,就输出为原始的HTML格式,不做解析。比如

An asterisk is used as in ==*.*== .

将输出 An asterisk is used as in *.* .

这样,中间的句点就不会被被强调加粗。

列表

HTML里的常用的列表有两种:有序(ordered list, ol)和无序(unordered list, ul),在textile里分别用#和*表示。这种代替办法也很形象,实际生活中的确用#代表序号,用*表示列表符号。比如,

* one
* two
* three

会输出

  • one
  • two
  • three

这里空格的位置很重要,首先星号*要顶格写,其次星号后面和正文之间要有空格。这两个条件缺一不可,不然不能正确解析。

也可以构造多级列表:

* one
** one A
** one B
*** one B1
* two
** two A
** two B
* three

将输出

  • one
    • one A
    • one B
      • one B1
  • two
    • two A
    • two B
  • three

有序列表与之类似。

空格、空行的影响

因为Textile简化了标记语言里的分隔符,所以解析Textile必须依靠空白符号作为分隔符,比如下面的语句

Textile is way c\*oo\*l

里面的成对星号*不会被解析,因为解析器不能确定星号是作为单词的一部分还是作为修饰符单独存在。而如果在星号外侧加上空白,像这样

Textile is way c **oo** l.

两边的空白明确告诉解析器,这里就是Textile语言表达式,就可以解析为strong

但是,如果想修饰完整单词的其中一部分,就不能引入空格,这是需要用中括号[]提高优先级。比如,想达到 Textile is way cool. 的效果,应该这么写

Textile is way c[*oo*]l.

同样的,中文文字间是没有空格的,如果为了解析而多出空格就很不协调。这时也需要中括号帮助,就好比把汉字当作英文单词里的字母对待。比如

这是个[*加强*]的文字

就能得到 这是个加强的文字 的效果。

另外,段落标记 p. 里的句点和后面文字中间必须有空白,否则不被认为是段落标记,是正文。类似的,标题 hn. 修饰的标题文字后面必须有一空行,否则不被认为是标题。

内联修饰符

内联修饰符是指添加在已有Textile表达式中的进一步的修饰符,有以下几种:

{style rule},花括号表示一个CSS的样式集,相当于"style= style rule",

[language],中括号表示语言种类,相当于"lang=language",

(css class),小括号表示CSS类,相当于"class=css class",

(#identifier),小括号加井字号表示CSS的id,相当于"id=identifier".

这些内联符号不能单独修饰文字,必须与被修饰的HTML实体结合使用,比如<span>、<p>等。

例如:

%{color:red}red%

会解析为  <span style="color:red">red</span>

%[fr]rouge%

会解析为 <span lang="fr">rouge</span>

_(big)red_

会解析为 <em class="big">red</em>

内联符号必须紧贴HTML实体,中间不能有空白,否则不能被解析。

超链接

Textile表示超链接的格式是

"显示文字":链接

如果要给链接添加title,使用小括号

"显示文字(title)":链接

如果您对本站内容有疑问或者寻求合作,欢迎 联系邮箱邮箱已到剪贴板

标签: TEXTILE

欢迎转载本文,惟请保留 原文出处 ,且不得用于商业用途。
本站 是个人网站,若无特别说明,所刊文章均为原创,并采用 署名协议 CC-BY-NC 授权。