票友山

现在说下最近几天的计划：

• 宏的内容一篇。
• 之前提到的大家在入门txt2tags 的时候不用去理会设置域，进阶，自然要写一些文字来讲解一下。
• 讲一下如何用gVim 编辑t2t 文件。

这样，使用方面就差不多结束了，如果以后使用中有什么问题，采取打补丁的方式加到以前的文章。如果发现什么特别的内容，可以专门发布专题来讲解。

宏的综述

什么是宏？

最初看见宏这个词，是在MS Office 里，后来我在越来越多的软件里面看大了这个东西。但是究竟什么是宏，我说不清楚。

在txt2tags 里面，可以理解为txt2tags 给用户留下的一些关键词，使用这些关键词，当文件在被转换的时候，这些关键字被替换为一些具体的输出。

在txt2tags 中使用宏注意一下几点：

• 宏以%%开头。
• 宏不区分大小写。
• 几乎所有的宏都可以出现在t2t 文件中的头部域和主体域的任意位置。只有一个例外，%%toc ，它只能出现在主体域，并且需要独占一行。注意：明显说明不能包括宏的区域宏是无法被解析的。

关于宏的学习，我觉得大家主要记忆一些位置上的内容，至于位置，大家使用的过程里面自然会发现什么地方是不能用的，慢慢积累。一次记忆太多会让你太快丧失兴趣。而且之后的课程里面我们会降到gvim 中使用宏，在gvim 代码高亮中，可以使用宏的区域和不能使用宏的区域你输入宏颜色是不一样的，很好区分。

%%date 宏 和%%mtime 宏

把这两个宏放在一起来讲因为它们有太多的相似的地方：

• 都是用来输出时间。
• 使用方法完全相同。

不同的地方：%%date 用来输出的是转换代码的时间，而%%mtime 输出的是源文件最后修改的时间。也就是说，只要不修改源文件，%%mtime 输出的时间是固定的，而%%date 输出的时间却随着转换的时间变化而变化，因为时间不会倒退，所示它输出的时间永远是不同的。

下面来说说它们的用法。因为用法是一致的，所以我这里只针对%%date 进行讲解。

在可以输入%%date 宏的任意地方输入%%date() ,然后，在括号中用一些参数对输出的时间格式进行定义。

要进行定义，首先我们要知道“年”，“月”，“日”这些概念是如何表示的。请看下表：

上面一些内容是我认为最常用的一些参数，更详细的可以参考官方的文档，但是我觉得这已经足够用户自定义常见的时间格式的了。

现在我们来看三个例子：

• %%date，得到格式为：20090821
• %%date(%c) ，得到的格式为：08/21/09 17:52:55
• %%date(%Y 年%m 月 %d %H:%M:%S)，得到格式为2009 年08 月 21 17:52:55

注意：如果你希望使用% 来隔开内容，那你需要输入两个百分号，%% 。

%%infile 和 %%outfile

和上面两个类似，这两个用法也完全一致，从字面大家也可以猜到它们是干什么的，前者用来输出源文件在系统中的路径信息，后者用来输出目标文件的路径。

因为没有需求，我还从来没使用过这两个宏。

既然和上面一样是用法一致的，我用%%infile来进行讲解。

在可以输入%%infile 宏的任意地方输入%%infile() ,然后，在括号中用一些参数对格式进行定义。

括号中可以输入的参数有：

同样，当是在进行组合的时候需要使用的% 的时候请输入%% 。

%%infile默认显示macro.t2t。

注意到上面的发生了什么吗？

当接上盘符的时候，输出的内容出现了问题，我的文件夹的名字是txt2tags，而在xp 下目录层次的分隔符是\ , \t 在输出的时候被解释成了一个制表符。我估计是这样。

%%toc

输出目录表的宏。需注意一下三点：

• 必须独占一行，但是前后可以有空格。
• 必须配合命令行参数--toc 或者在下一课里面讲到的设置域中进行设置。
• 只能出现在主体域。

因为本文太短，不适合使用目录，我就不做演示了。大家可以下载我Txt2tags 简单入门教程（我的学习笔记） 一文中提供的代码进行查看。而具体的参数可以查看Txt2tags 命令行转换使用详解 。

本文宏的综合演示

这篇文章是用gVim编写的，2009 年08 月 21 17:52:52，源文件macro.t2t 的编辑工作完成，2009 年08 月 21 17:52:55 ，通过txt2tags 将文章转换为macro.xhtml ，准备发布。

版权说明

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