票友山

一篇较长的文章你可能分成很多的章节，也有可能你在写一篇文章的时候想要引用一些其他文章里面的东西，%!include 命令就可以帮你完成这一切，它可以将外部文件包含到源文件当中。

%!include 命令有几种不同的形式，而每种不同的形式的功能是不一样的。下面我们将通过例子来讲解。

注意：这个命令并非是一种设置，而是一个命令，但是它和设置域的使用要求很相似。独占一行，顶格，%! 开头。

假设我们在同目录下有一个名为li.t2t 的文件，并有一个由这个t2t 文件转换而成的html文件。其中，li.t2t 内容如下：
我是票友山做的一个小例子。

我是例子的第一段。

我是例子的第二段。这一段比第一段长一点。

我是最后一段。

默认形式

默认形式的命令如下：
%!include:li.t2t

当我使用这个指令的时候，得到如下的结果：
我是票友山做的一个小例子。

我是例子的第一段。

我是例子的第二段。这一段比第一段长一点。

我是最后一段。

大家看到了结果，那我来总结一下。

• 这个命令相当于将引入文件的主体域放入源文件的主体域进行转换。
• 和设置域一样，独占一行，顶格。
• 你可以再正文和设置域中使用这个默认形式
  • 在正文中，在命令使用处插入。
  • 在设置域中，在源文件主体域之前插入。

完全引用

形式为：

  %!include: ``li.t2t``

我们来看看作用：

  例子
  sunxun @ 票友山
  %%date(%Y 年%m 月 %d日)

  %!encoding:utf-8
  %!target:xhtml
  %!options:--no-headers

  我是[票友山 http://sunxun.info]做的一个小例子。

  我是例子的第一段。

  我是例子的第二段。这一段比第一段长一点。

  我是最后一段。

它的作用相当于将内容完全进行的引用，而不进行任何的解析。和完全引用域（我习惯叫块引用）的作用差不多。同样，你也可以再设置域和主体域使用它，只是引用的位置不一样而已。

原文

形式为：

  %!include: ""li.t2t""

效果为：
例子
sunxun @ 票友山
%%date(%Y 年%m 月 %d日)

%!encoding:utf-8
%!target:xhtml
%!options:--no-headers

我是[票友山 http://sunxun.info]做的一个小例子。

我是例子的第一段。

我是例子的第二段。这一段比第一段长一点。

我是最后一段。

它的作用类似于块原文，引入文件的内容以原文的形式输出，不解析相关标记。

你同样可以使用在设置域。

带标记

这个命令比较特殊，不是插入到源文件，而是插入到目标文件。

形式为：

  %!include:''li.html''

效果为：

我是票友山做的一个小例子。

我是例子的第一段。

我是例子的第二段。这一段比第一段长一点。

我是最后一段。

注意：

因为我插入的文件中有：

  --no-headers

所以插入的部分中没有标题。这是因为xhtml 文件要求比较严格，如果有了两个head 段，两个body 段，可能发生问题，同样，no-headers 的文件在本地li.xhtml也是有问题的。

版权说明

无特殊说明均为原创文章，转载请注明。
本文链接地址: http://sunxun.info/2009/08/txt2tags-cinclude/