订制 Sublime Text 下 LaTeXTools 插件的编译脚本

LaTeXTools 是 Sublime Text 上的一个插件，用以增强在 Sublime Text 上编辑和编译 LaTeX 文档的体验。但是其自带的编译脚本比较难用，缺点如下：

为了解决这个问题，我自己写了一个编译脚本，命名为 advancedBuilder.py。

安装方法

在这里下载编译脚本；
打开 Sublime Text 目录；
将脚本拷贝至 ./Packages/LaTeXTools/builders/；
编辑 ./Packages/User/LaTeXTools.sublime-settings，将 "builder" 值从原来的 traditional 改为 advanced，即："builder": "advanced"；
重启 Sublime Text。

基本的使用方法和原本的 traditionalBuilder.py 相同，即使用快捷键 Ctrl + B 编译（Mac OS X 是 CMD + B）。但在文档开头的注释中，增加了更多的用法。

可以在主文档开头的注释中，使用下列语法改变编译流程。

1	%!TEX builder = BUILDER

其中 BUILDER 的可选值有：

大小写不论，默认是 SIMPLE，即只编译一遍。

此功能继承自默认编译脚本，有增强。

可以在主文档开头的注释中，使用下列语法改变编译引擎。

1	%!TEX program = PROGRAM

其中 PROGRAM 的可选值有：

大小写敏感，默认值是 pdflatex。

可以在主文档开头的注释中，使用下列语法添加编译参数。

1	%!TEX option = OPTION

其中 OPTION 的可选值为对 PROGRAM 合法的任意参数。大小写敏感，默认为空。

另外，强制启动 -interaction=nonstopmode 和 -synctex=1 两个参数，不允许更改。

此功能完整继承自默认编译脚本。

可以在子文档的开头注释中，使用下列语法指定主文档。

1	%!TEX root = ROOT

其中 ROOT 为主文档相对当前子文档的路径。指定主文档之后，可以在子文档中直接使用快捷键编译主文档，而不用将 Sublime Text 标签页切换到主文档再进行编译。

foo

\documentclass{article}
\begin{document}
Hello world!
\end{document}

对应的命令行为：

1	pdflatex -interaction=nonstopmode -synctex=1 foo.tex

foo

%!TEX builder = latexmk
\documentclass{article}
\begin{document}
Hello world!
\end{document}

对应的命令行为：

1	latexmk -cd -e $pdflatex = 'pdflatex -interaction=nonstopmode -synctex=1 %S %O' -f -pdf foo.tex

foo

%!TEX builder = latexmk
%!TEX program = xelatex
%!TEX option = -shell-escape
\documentclass{article}
\begin{document}
Hello world!
\end{document}

对应的命令行为：

1	latexmk -cd -e $pdflatex = 'xelatex -interaction=nonstopmode -synctex=1 -shell-escape %S %O' -f -pdf

foo

%!TEX builder = latexmk
%!TEX program = xelatex
%!TEX option = -shell-escape
\documentclass{article}
\begin{document}
\input{bar.tex}
\end{document}

bar

1 2	%!TEX root = foo.tex Hello world!

在 bar.tex 的窗口编译，命令行为：

1	latexmk -cd -e $pdflatex = 'xelatex -interaction=nonstopmode -synctex=1 -shell-escape %S %O' -f -pdf