LaTeX是一种功能强大的排版语言,不可能在现场预见所有用例。如果开箱即用的Texpad无法满足您的排版需求,您可以写信给我们,以迎合他们的需求来改进Texpad,因为还会有其他人从中受益。但是,与此同时,您可以使用自定义构建脚本来编写 Texpad的“排版” 脚本,以适应您的需求。
使用构建脚本进行自定义排版教程
Texpad允许您使用自己的脚本来自定义和控制排版过程。使用这些时,将绕过标准排版,以支持这些构建脚本。这些脚本必须具有区分大小写的扩展名.tpbuild,并且当前被假定为Unix bash脚本(这意味着它们由Texpad使用/ bin / bash运行)。
谁应该尝试编写自定义.tpbuild脚本?
自定义排版仅适用于那些熟悉基于Unix的bash脚本编写的高级用户。我们建议避免使用这些自定义脚本,除非它们对于排版非标准LaTeX项目绝对必要。在某些情况下,可能难以将其使用与Texpad集成在一起。
.tpbuild脚本如何工作?
在运行.tpbuild脚本之前,Texpad设置以下两个环境变量供您在.tpbuild文件中使用:
TEXPAD_ROOTFILE
TEXPAD_ROOTFILE_NO_EXT
例如,root.tpbuild可能如下所示
xeLaTeX $TEXPAD_ROOTFILE
与TEXPAD_ROOTFILE被设置为root.tex由Texpad运行之前.tpbuild脚本。TEXPAD_ROOTFILE_NO_EXT例如,当您必须$TEXPAD_ROOTFILE_NO_EXT.dvi在后续步骤中将第一步的DVI输出(文件)转换为PDF 时,第二个环境变量就很方便。
为了使Texpad在其PDF窗格中显示自定义脚本的PDF输出,该文件必须与放置在同一目录中,TEXPAD_ROOTFILE.tex并且必须命名为TEXPAD_ROOTFILE.pdf。要在排版配置中选择.tpbuild脚本,请切换到“手动”选项,并选择一个构建脚本。
本地和全局脚本
这些脚本形成两个类,本地和全局 .tpbuild脚本。
1、全局.tpbuild脚本
Texpad附带了许多安装在目录中的全局构建脚本
~/Library/Application Support/Texpad/BuildScripts/
可以使用菜单选项Typeset在Texpad中打开此目录。 添加/编辑全局.tpbuild脚本…。开箱即用的Texpad带有一个脚本,用于将LaTeX文档排版为ePub,以便直接从LaTeX源创建ePub书籍。可以将其删除,并根据需要将新脚本添加到BuildScripts目录。这些脚本也可以用作创建自己的脚本的模板。
2、本地.tpbuild脚本
在某些情况下,文档或项目具有特定的排版需求,而这些需求既不能通过标准排版器来满足,也不能通过全局.tpbuild脚本来满足。可以使用本地.tpbuild脚本处理此类情况。当为文件root.tex选择此选项时,Texpad首先在与root.tex相同的目录中查找root.tpbuild文件。如果找到一个,它将运行它而不是它自己的排版链。该机制是防错的,因为如果Texpad无法找到本地.tpbuild脚本,它将简单地还原为普通的排版(相当于按Cmd-T)。