（本文收录于[go4pro.org]）

一直很不喜欢使用Word做文档制作工具。除了平台相关性太严重之外，二进制文件也给版本管理带来了很多麻烦。于是这次在新的项目里，就尝试使用格式化文本制作工具。

选工具的时候，在asciidoc和txt2tags之间犹豫了一下。最终选择了txt2tags。有几个理由：

• asciidoc从功能上来说比txt2tags强大很多，但是强大的功能带来了写作时的不流畅感，你要在内容之外考虑太多的东西，非常不舒服。而且其实对于我写的大部分文档来说，txt2tags够用了。
• txt2tags工具链配置简单，编译速度非常快。
• txt2tags我之前用过，比较熟悉。

txt2tags的语法规则其实没几条，去网站上看一下，10分钟就可以学会了。所以这一点我就不罗嗦了。txt2tags可以直接产生网页，我之前的很多文档也是用它写的。这个也没什么好说。

但是公司文档用html一个是不方便，另外一个也显得太不正式。所以，我需要一个工具链，来把它转换成PDF。

txt2tags不支持直接到PDF的转换，但是它可以转换成很容易生成pdf文件的latex格式。所以我就非常自然的想走 txt2tags -> latex -> PDF 这条路了。

首先去下载了了一个CTEX安装包，避免在latex中文问题上做过多的纠缠。

然后将txt2tags文件转换成latex文件：

python "d:Program Files	xt2tags-2.6	xt2tags" -t tex README_deploy.t2t

没错，Windows下就是这么麻烦，在Linux下简单很多：

txt2tags -t tex README_deploy.t2t

就行了。不过还好我们可以写脚本，这个下面再提。

这样会生成 README_deploy.tex 文件，但是这个文件默认是无法编译的，因为里面没有引用中文的相关包。所以我们需要对这个tex文件做一些预处理。我写了一个简单的python脚本来自动完成这件事：

#encoding:utf-8
import sys

# 在usepackage{graphicx}的后面加上一行usepackage{CJKutf8}
# 将usepackage[urlcolor=blue,colorlinks=true]{hyperref}
#   替换成usepackage[unicode,urlcolor=blue,colorlinks=true]{hyperref}
# 用于支持中文书签和目录
# 在egin{document}的后面加上一行egin{CJK}{UTF8}{song}
#   并加上CJKcaption{zh-Hans}用于生成中文目录
# 在end{document}的前面加上两行:
ewpage(中文目录hack)和end{CJK}

input_file, output_file = sys.argv[1:3]

content = open(input_file, "rt").read()
content = content.replace("\usepackage{graphicx}", "\usepackage{graphicx}
\usepackage{CJKutf8}")
content = content.replace("\usepackage[urlcolor=blue,colorlinks=true]{hyperref}", "\usepackage[unicode,urlcolor=blue,colorlinks=true]{hyperref}")
content = content.replace("\begin{document}", "\begin{document}
\begin{CJK}{UTF8}{song}
\CJKcaption{zh-Hans}")
content = content.replace("\end{document}", "\newpage
\end{CJK}
\end{document}")

open(output_file, "wt").write(content)

经过这样处理之后的tex，我们就可以使用pdflatex命令直接生成pdf了。

下面给出我用于这个文件的批处理脚本，有进一步的应用可以在这个基础上改进。

set PYTHON=d:python27python.exe
set TXT2TAGS="d:Program Files	xt2tags-2.6	xt2tags"
set PDFLATEX="D:CTEXMiKTeXmiktexinpdflatex.exe"

rem generate latex source file
%PYTHON% %TXT2TAGS% -t tex README_deploy.t2t

rem Patch tex file for Chinese support
%PYTHON% pdf_cjk_patch.py README_deploy.tex temp.tex
copy temp.tex README_deploy.tex
rm temp.tex

rem Generate PDF file
%PDFLATEX% README_deploy.tex

另外要注意的一点是，latex不支持“没有编号的章节”生成目录。所以在标识章节的时候，一定要记得用"+"而不是"="