CTeX 宏集手册

Transcription

1 CTEX 宏集手册 ctex.org 2015/07/01 v2.2 简介 CTEX 宏集是面向中文排版的通用 L A TEX 排版框架, 为中文 L A TEX 文档提供了汉字输出支持 标点压缩 字体字号命令 标题文字汉化 中文版式调整 数字日期转换等支持功能, 可适应论文 报告 书籍 幻灯片等不同类型的中文文档 CTEX 宏集支持 L A TEX pdfl A TEX XƎL A TEX 和 LuaL A TEX 等多种不同的编译方式, 并为它们提供了统一的界面 主要功能由宏包 ctex 和中文文档类 ctexart ctexrep ctexbook 实现 目录 第 1 节介绍 2 第 2 节简明教程 CTEX 宏集的组成 CTEX 宏集的安装和更新 使用 CTEX 文档类 使用 ctex 宏包 第 3 节宏包选项与 \ctexset 命令 5 第 4 节编译方式 编码与中文字库 编译方式 中文编码 中文字库 第 5 节排版格式设定 文档默认字号 章节标题风格 排版方案选项 第 6 节文档汉化 日期汉化 文档标题汉化 页面格式设置与汉化 第 7 节章节标题格式设置 13 ctex-kit rev 第 8 节实用命令 字号与间距 中文数字转换 杂项 第 9 节 LuaLATEX 下的中文支持方式 LuaLATEX 下替代字体的设置. 24 第 10 节 CTEX 宏集的配置文件 修改宏包默认选项 宏包载入后的配置 配置标题中文翻译 自定义字体集 第 11 节对旧版本的兼容性 CTEX 0.8a 及以前的版本 CTEX 0.9 CTEX 1.0d CTEX 1.02c 以后的 SVN 开发版 CTEX 2.2 之前的版本 第 12 节宏集依赖情况与手工安装方法 29 第 13 节开发人员 30 第 14 节参考文献 30 第 15 节代码实现 31 版本历史 124 代码索引 124 1

2 第 1 节介绍 2 第 1 节 介绍 历史 CTEX 宏集的源头有两个 : 一是王磊编写的 cjkbook 文档类, 二是吴凌云编写的 GB.cap 这些工作没有经过认真 系统的设计, 也没有用户文档, 不利于维护和改进 2003 年, 吴凌云使用 doc 和 DocStrip 重构了整个工程, 并增加了许多新的功能, 称为 ctex 宏包 2007 年,oseen 和王越在 ctex 宏包的基础上, 增加了对 UTF-8 编码的支持, 开发出了 ctexutf8 宏包 2009 年 5 月, 我们在 Google Code 建立了 ctex-kit 项目 1, 对 ctex 宏包及相关脚本进行了整合, 并加入了对 XƎTEX 引擎的支持 在开发新版本时, 考虑到合作开发和调试的方便, 我们放弃了 doc 和 DocStrip, 采取了直接编写宏包代码的方式 2014 年 3 月, 为了适应 LATEX 的最新发展, 特别是 LATEX3 的逐渐成熟, 李清用 LATEX3 重构了整个宏包的代码, 并重新使用 doc 和 DocStrip 工具进行代码的管理, 升级版本号为 2.0, 并改称 CTEX 宏集 2015 年 3 月, 由于 Google Code 即将停止服务,ctex-kit 项目迁移至 GitHub 2 最初,Knuth 在设计开发 TEX 的时候没有考虑到多国语言支持, 特别是对多字节的中日韩语言的支持 这使得 TEX 以至后来的 LATEX 对中文的支持一直不是很好 即使在 CJK 宏包解决了中文字符处理的问题以后, 中文用户使用 LATEX 仍然要面对许多困难 这些困难里, 以章节标题的中文化为最 由于中文和西文语言习惯的差异, 用户很难使用标准文档类中的代码结构来表达中文标题 于是, 用户不得不对标准文档类做较大的修改 除此之外, 日期格式 首行缩进 中文字号和字距等细节问题, 也需要精细的调校 我们设计 CTEX 宏集的目的之一就是解决这些 LATEX 文档的汉化难题 另一方面, 随着 TEX 引擎和 LATEX 宏包的不断发展,LATEX 的中文支持方式从早期的专用系统 ( 如 CCT) 发展为适用于不同引擎的多种方式 3 这些方式的适用情况和使用方式有不少细节上的差异, 同时操作系统的不同 语言环境的不同等客观情况又进一步带来了更多的细节差异 我们设计 CTEX 宏集的另一个主要目的就是尽可能消除这些差异带来的影响, 使用户能够以一个统一的接口来使用不同的中文支持方式, 使得同一份文档能够在不同环境下交换使用 CTEX 宏集的许多实现细节离不开热心朋友们在 bbs.ctex.org 论坛上的讨论, 在此对参与讨论的朋友们表示感谢 关于宏集名字的说明 CTEX 之名是英文单词 China( 中国 ) 或 Chinese( 中文 ) 的首字母 C 与 TEX 结合而成的 在纯文本环境下, 该名字应写作 CTeX CTEX 宏集是由 CTEX 社区发起并维护的 LATEX 宏包和文档类的集合 社区另有发布名为 CTEX 套装的 TEX 发行版, 与本文档所述的 CTEX 宏集并非是同一事物 ctex 则是本宏集中的 ctex.sty 的名字 这一完全小写的名称, 在过去也被用来指代整个 CTEX 宏集, 不过现在则特指 ctex.sty 这一宏包 在不引起歧义的情况下, 它也可以沿用过去的习惯, 代指整个宏集 比如 :pdftex 引擎下的 CJK zhmcjk 宏包,XƎTEX 引擎下的 xecjk 宏包和 LuaTEX 引擎下的 LuaTeX-ja 宏包

3 第 2 节简明教程 3 第 2 节 简明教程 2.1 CTEX 宏集的组成 为了适应用户不同的需求, 我们将 CTEX 宏集的主要功能分散在三个中文文档类和四个宏包当中, 具体的组成见表 1 表 1 CTEX 宏集的组成 类别文件说明 文档类 ctexart.cls 标准文档类 article 的汉化版本, 一般适用于短篇幅的文章 ctexrep.cls 标准文档类 report 的汉化版本, 一般适用于中篇幅的报告 ctexbook.cls 标准文档类 book 的汉化版本, 一般适用于长篇幅的书籍 宏包 ctex.sty 提供全部功能, 但默认不开启章节标题设置功能, 需要使用 heading 选项来开启 ctexcap.sty 过时宏包, 仅作兼容使用, 相当于开启章节标题设置功能的 ctex.sty ctexsize.sty 定义和调整中文字号, 在 ctex 宏包或 CTEX 中文文档类之外单独调用 ctexheading.sty 提供章节标题设置功能的 ( 见 7 节 ), 在 ctex 宏包或 CTEX 中文文档类之外单独调用 2.2 CTEX 宏集的安装和更新 CTEX 宏集依赖的宏包和宏集已被最常见的 TEX 发行版 TEX Live 和 MiKTEX 所收录 如果本地安装 TEX Live 或 MiKTEX 不是完全版本, 就可能需要通过这两个发行版提供的宏包管理器来安装宏包 TEX Live 的宏包管理器是 tlmgr 用户可以在系统命令行中 4 执行 tlmgr gui 启动管理器的图形界面 (Windows 用户也可以通过开始菜单的 TeX Live 2015 TeX Live Manager 打开 ) 连接上远程仓库之后, 搜索 ctex 安装即可 tlmgr 的图形界面使用 Perl 编写, 容易造成系统假死 遇到这种问题的用户, 也可以直接在系统命令行执行 tlmgr install ctex 来安装 CTEX 宏集 5 MiKTEX 的宏包管理器是 mpm (MiKTEX Package Manager) 用户可以在开始菜单找到 MiKTeX Maintenance (Admin) Package Manager (Admin), 打开管理器, 连接上远程仓库之后, 搜索 ctex 安装即可 若希望了解 CTEX 宏集具体的依赖情况和手工安装宏集的方法, 请参阅第 12 节 当宏包发布新版本, 并被发行版在远程仓库安装之后, 在本地就可以通过宏包管理器来取得新版本 4 Windows 系统的命令行是 CMD 命令提示符, 你可以使用 Win + R 组合键打开 运行 对话框, 然后输入 cmd 确认打开命令 提示符窗口 5 *nix 用户可能需要超级用户权限才能正确安装宏集

4 第 2 节简明教程 4 对于 TEX Live, 可以在 tlmgr 的图形界面点击 更新全部已安装的 按钮或者在命令行执行 tlmgr update --all 来完整更新已安装的宏包 对于 MiKTEX, 在开始菜单找到 MiKTeX Maintenance (Admin) Update (Admin), 按照界面说明更新即可 2.3 使用 CTEX 文档类 如果用户需要在标准文档类的基础上添加中文支持和中文版式支持, 我们建议用户使用 CTEX 宏集提供的三个中文文档类 CTEX 宏集提供了三个中文文档类 :ctexart ctexrep 和 ctexbook, 分别对应 LATEX 的标准文档类 article report 和 book 使用它们的时候, 需要将涉及到的所有源文件使用 UTF-8 编码保存 6 例 1 \documentclass[utf8]{ctexart} \begin{document} 中文文档类测试 你需要将所有源文件保存为 UTF-8 编码 你可以使用 XeLaTeX 或 LuaLaTeX 编译, 也可以使用 (pdf)latex 编译 推荐使用 XeLaTeX 或 LuaLaTeX 编译 \end{document} 2.4 使用 ctex 宏包 用户在使用非标准文档类时, 如果需要添加中文支持或中文版式支持, 则可以使用 ctex 宏包 以下是使用 beamer 文档类编写中文演示文稿的一个示例 例 2 \documentclass{beamer} \usepackage[utf8]{ctex} \begin{document} \begin{frame}{ 中文演示文档 } \begin{itemize} \item 你需要将所有源文件保存为 UTF-8 编码 \item 你可以使用 XeLaTeX 或 LuaLaTeX 编译 \item 也可以使用 (pdf)latex 编译 \item 推荐使用 XeLaTeX 或 LuaLaTeX 编译 \end{itemize} \end{frame} \end{document} 有些文档类是建立在 LATEX 标准文档类之上开发的 这时, 给 ctex 宏包加上 heading 选项, 可以将章节标题设置为中文风格 \documentclass{ltxdoc} \usepackage[utf8, heading = true]{ctex} \begin{document} 例 3 6 使用 (pdf)l A TEX 时也能够使用 GBK 编码, 但不推荐 ( 见 4.2 节 )

5 第 3 节宏包选项与 \ctexset 命令 5 \section{ 简介 } 章节标题中文化的 \LaTeX{} 手册 \end{document} 第 3 节 宏包选项与 \ctexset 命令 CTEX 宏集已经尽可能就中文的行文和版式习惯做了调整和配置, 通常而言, 这些配置已经够用 因此, 除非必要, 我们不建议普通用户修改这些默认配置 如果你认为 CTEX 宏集的默认配置还可以完善, 可以在项目主页上提交 issue, 向我们反映, 我们会酌情在后续版本中予以改进 不过,CTEX 宏集也提供了一系列选项 用户可以使用这些选项来控制 CTEX 宏集的行为 具体来说, 这些选项里, 有的以传统的方式提供, 也有的以 key = value 的形式提供 对于以键值对形式提供的选项, 在下面的说明中使用粗体来表示 CTEX 的默认设置 另一方面, 这些选项可以分为以下三类 : 名字后带有 号的选项, 只能作为宏包 / 文档类选项, 需要在引入宏包 / 文档类的时候指定 ; 名字后带有 号的选项, 只能通过 CTEX 宏集提供的用户接口 \ctexset 来设定 ; 名字后不带有特殊符号的选项, 既可以作为宏包 / 文档类选项, 也可以通过 \ctexset 来设定 后续文档将在使用说明中对某些特殊的选项加以说明 \ctexset New: \ctexset { 键值列表 } 是 CTEX 宏集的通用控制命令, 用来在宏包载入后控制宏包的各项功能 \ctexset 的参数是一个键值列表, 以通用的接口完成各项设置 \ctexset 的参数是一组由逗号分隔的选项列表, 列表中的选项通常是一个 key = value 格式的定义 例如设置摘要与参考文献标题名称 (6.2 节 ) 就可以使用 : \ctexset{ abstractname = { 本文概要 }, bibname = { 文 \quad 献 } } 例 4 \ctexset 采用 LATEX3 风格的键值设置, 支持不同类型的选项与层次化的选项设置, 相关示例见 7 节 第 4 节 编译方式 编码与中文字库 4.1 编译方式 CTEX 宏集会根据用户使用的编译方式 7, 在底层选择不同的中文支持方式 ( 见表 2) 不同的编译方式和中文支持方式会在一定程度上影响 CTEX 宏集的行为, 比如宏包对编码的处理 在用户使用 XƎLATEX 及 LuaLATEX 编译时,CTEX 宏集使用 ( 且仅能使用 )UTF-8 编码 ; 而因为历史原因, 在用户使用 LATEX 及 pdflatex 编译时, 宏包默认使用 GBK 编码 用户需要保证编译方式 源文件编码 宏包编码选项三者一致 关于宏包编码选项, 可以参考 4.2 节 7 L A TEX pdfl A TEX XƎL A TEX 以及 LuaL A TEX

6 第 4 节编译方式 编码与中文字库 6 表 2 CTEX 宏集的中文支持方式 (pdf)latex XƎLATEX LuaLATEX CJK xecjk LuaTeX-ja 除去文档编码之外, 选择不同的编译方式还可能影响 CTEX 宏集对字体选择 空格处理 标点处理的处理 具体的影响将在本文档后续内容中进行阐述 4.2 中文编码 GBK UTF8 指明编写文档时使用的编码格式 CTEX 宏集无法检测用户编写文档时使用的编码格式, 因此需要用户自行指定编码 我们建议用户总是使用 UTF-8 编码, 并显式指定 UTF8 选项, 并使用 XƎLATEX 或 LuaLATEX 编译 使用 XƎLATEX 或 LuaLATEX 编译时,CTEX 宏集强制使用 UTF-8 编码, 此时 GBK 选项无效 使用 (pdf)latex 编译时,CTEX 宏集默认启用 GBK 选项 ; 不过, 用户也可以显式声明 UTF8 选项, 使 CTEX 宏集工作在 UTF-8 编码下 4.3 中文字库 以往, 为 LATEX 文档配置中文支持是一件相当繁琐的事情 默认情况下,CTEX 宏集能自动检测用户使用的编译方式 ( 参见 4.1 节 ) 和操作系统 8, 选择合适的底层支持和字库, 从而简化配置过程 自动配置的情况参见表 3 表 3 CTEX 宏集自动配置字体策略 Mac OS X Windows New 1 Windows Old 2 其他 XƎLATEX xecjk 华文字库 xecjk 中易字库 + 微软雅黑 xecjk 中易字库 xecjk Fandol 字库 3 LuaLATEX 4 LuaTeX-ja 华文字库 LuaTeX-ja 中易字库 + 微软雅黑 LuaTeX-ja 中易字库 LuaTeX-ja Fandol 字库 pdflatex 不可用 CJK + zhmetrics 中易字库 + 微软雅黑 CJK + zhmetrics 中易字库 不可用 LATEX + DVIPDFMx 不可用 CJK + zhmetrics 中易字库 + 微软雅黑 CJK + zhmetrics 中易字库 CJK + zhmetrics Fandol 字库 1 Windows Vista 及以后的 Windows 操作系统 2 Windows XP 及以前的 Windows 操作系统 3 由马起园 苏杰 黄晨成等人开发的开源中文字体, 参见 : 4 LuaL A TEX 编译时使用 LuaTeX-ja 宏包 对此, 第 9 节有特别说明 通常, 由 CTEX 宏集进行的自动配置已经足够使用, 无需用户手工干预 ; 但是 CTEX 仍然提供了一系列选项, 供在 CTEX 的自动选择机制因为意外情况失效, 或者在用户有特殊需求的情况下使用 除非必要, 用户不应使用这些选项 zhmap zhmap = true false zhmcjk Updated: 指定字体映射机制 本选项只在使用 pdflatex/latex 编译时有意义 8 CTEX 宏集现在能够识别 Mac OS X 系统以及 Windows 系统

7 第 4 节编译方式 编码与中文字库 7 true 使用 zhmetrics 宏包, 将 CJK 字库通过 \special 命令映射到.ttf 文件 false 使用传统的 CJK 字库 (Type 1) 9 zhmcjk 载入 zhmcjk 宏包 10, 由 zhmcjk 宏包提供从 CJK 字库到.ttf 的映射 fontset New: fontset = none adobe fandol founder mac ubuntu windows windowsnew windowsold... 指定 CTEX 宏集加载的字库 如果没有指定 fontset 的值,CTEX 宏集将自动检测用户使用的操作系统, 配置相应的字体 ( 参见表 3) CTEX 预定义了以下六种中文字库 adobe 使用 Adobe 公司的四款中文字体, 不支持 pdflatex fandol 使用 Fandol 中文字体, 不支持 pdflatex founder 使用方正公司的中文字体 mac 使用 Mac OS X 系统下的华文字体, 不支持 (pdf)latex ubuntu 使用 Ubuntu 系统下的文泉驿和文鼎字体 windows 使用简体中文 Windows 系统下的中文字体, 自动判断 Windows 系统版本, 采用 windowsnew 或 windowsold 的设置 windowsnew 使用简体中文 Windows Vista 或之后系统下的中易字体和微软雅黑字体 windowsold 使用简体中文 Windows XP 或之前系统下的中易字体 注意 : 使用 (pdf)latex 编译的时候, 若设置 zhmap = false( 比如需要使用 LATEX + Dvips 编译 ), 则需要按照传统方式 11 在本地安装好 CJK 字体 如果不想使用 CTEX 预定义的中文字库, 可以设置 fontset 为下述值之一 none name 不配置中文字体, 需要用户自己配置 这里 name 为自定义的名字 CTEX 宏集将载入名为 ctex-fontset- name.def 的文件作为字体配置文件 因此, 请先保证文件的存在 可以在当前工作目录或者本地 TDS 目录树下合适位置建立一个名为 ctex-fontset- name.def 的文件, 在这个文件里面自定义中文字体 然后通过使用 fontset= name 选项来调用它 字体配置文件的具体写法可以参考 CTEX 宏集 fontset 目录下的字体配置文件 注意 : 如果希望使用 \ctexset 在导言区指定字库, 则需要先在宏包 / 文档类选项中指定 fontset = none 例如 : \documentclass[fontset = none]{ctexart} \ctexset{fontset = founder} \begin{document} 在文档类选项中声明 \verb fontset = none, 随后在导言区用 \verb \ctexset 指定字体 \end{document} 例 5 CTEX 宏集预定义的中文字库还定义了一些字体命令 \songti 宋体,CJK 等价命令 \CJKfamily{zhsong} \heiti 黑体,CJK 等价命令 \CJKfamily{zhhei} \fangsong 仿宋,CJK 等价命令 \CJKfamily{zhfs} \kaishu 楷书,CJK 等价命令 \CJKfamily{zhkai} 9 如果需要使用自定义的字体映射文件, 或者希望使用 Type1 字库, 请禁用本选项 10 zhmcjk 宏包基于 zhmetrics 和 CJK 宏包, 提供与 xecjk 宏包类似的用户接口 11 可以使用 zhmetrics 宏包提供的脚本 CTeXFonts.lua

8 第 5 节排版格式设定 8 其中 \fangsong 在 ubuntu 字库中没有定义 在 windows 和 founder 字库中, 还有 \lishu 和 \youyuan \lishu 隶书,CJK 等价命令 \CJKfamily{zhli} \youyuan 圆体,CJK 等价命令 \CJKfamily{zhyou} 在 windowsnew 字库中, 还有 \yahei \yahei 微软雅黑,CJK 等价命令 \CJKfamily{zhyahei} 第 5 节 排版格式设定 5.1 文档默认字号 zihao zihao = -4 5 false New: 将文章默认字号 (\normalsize) 设置为小四号字或五号字, 具体情况见表 4 false 禁用本功能 本选项可以用于三个 CTEX 文档类和 ctex 宏包, 也可以用于 ctexsize 宏包 scheme = chinese 时, 默认值为 5, 即设置 \normalsize 为五号字 表 4 标准字体命令与字号的对应 zihao = 5 zihao = -4 10pt 11pt 12pt 字体命令字号 bp 字号 bp pt pt pt \tiny 七号 5.5 小六 \scriptsize 小六 6.5 六号 \footnotesize 六号 7.5 小五 \small 小五 9 五号 \normalsize 五号 10.5 小四 \large 小四 12 小三 \Large 小三 15 小二 \LARGE 小二 18 二号 \huge 二号 22 小一 \Huge 一号 26 一号 pt 11pt 12pt CTEX 文档类是在 LATEX 标准文档类之上开发的 因此, 除了可以使用 CTEX 宏包定义的字号选项之外, 还可以使用标准文档类的同类选项 (10pt 11pt 和 12pt) 在使用这些来自标准文档类的选项的时候,CTEX 文档类的字号选项会被抑制 亦即, 在 zihao 选项之后设置 10pt 选项,zihao 选项将不再起作用 标准文档类的其他选项在 CTEX 文档类中依旧有效 例如, 设置纸张大小和方向的 a4paper 和 landscape, 设置单双面的 oneside 和 twoside 等 CTEX 会将这些选项传给标准文档类 事实上,L A TEX 在文档类中的选项是全局设定的, 除了对使用的文档类有影响外, 也可能会影响到随后使用的宏包 如果这些宏 包中有某些选项出现在文档类的选项列表中, 那么该选项将会被自动激活

9 第 5 节排版格式设定 章节标题风格 heading heading = true false New: 本选项只能在调用 ctex.sty 时作为宏包选项使用 CTEX 宏集提供了一套用于修改文档章节标题格式的接口 该选项用于选择是否启用该功能 详细的设置方法请参见 7 节和 6.3 节 CTEX 宏集提供的三个文档类总是启用该功能 如果在 ctex.sty 下启用该选项, 将会检查当前是否使用 LATEX 标准文档类 若然, 则该选项将会使得 ctex.sty 宏包的行为和 CTEX 宏集提供的三个中文文档类完全一致 ; 若不然, 则会根据 \chapter 是否有定义来使用 ctexbook 或者 ctexart 的标题设置 sub3section sub4section 修改 \paragraph 和 \subparagraph 的格式 默认情况下, \paragraph 和 \subparagraph 会将标题与随后的正文排版在同一个段落 启用 sub3section 会将 \paragraph 的格式修改为类似 \section 的格式, 并将 \subparagraph 的格式修改为原本 \paragraph 的格式 启用 sub4section 会将 \paragraph 和 \subparagraph 的格式都修改为类似 \section 的格式 启用该选项通常需要将计数器 secnumdepth 的值为设置为 4 或 5 具体格式可参考 7 节中的 afterskip 等选项 注意, 上述两个选项只有在 heading 选项启用的时候才有意义 亦即, 只有在使用三个 CTEX 文档类或启用了 heading 的 ctex.sty 的时候才有意义 5.3 排版方案选项 scheme scheme = chinese plain New: 选择文章的排版方案, 预设有 chinese 和 plain 两种方案 chinese 调整默认字号为五号字, 并调整行距为 1.3; 汉化文档中的标题名字 ( 如 图 表 目录 和 参考文献, 见 6.2 节 ); 在 heading = true 的情况下 13 (5.2 节 ), 还会将章节标题的风格修改为中文样式 ( 见 7 节 ) 当关闭 heading 选项的 ctex 宏包与标准文档类或其衍生文档类联用时, 会载入 indentfirst 宏包, 以实现章节标题后的段首缩进 plain 不调整默认字号和行距, 不会汉化文档中的标题名字, 也不会将章节标题风格修改为中文样式, 同时不会调整 \pagestyle, 并禁用 autoindent 选项 事实上, 此时的 CTEX 宏集只提供了中文支持功能, 而不对文章版式进行任何修改 punct Updated: punct = quanjiao banjiao kaiming CCT plain 设置标点处理格式 预定义好的格式有 : quanjiao 全角式 : 所有标点占一个汉字宽度, 相邻两个标点占 1.5 汉字宽度 ; banjiao 半角式 : 所有标点占半个汉字宽度 ; kaiming 开明式 : 句末点号 14 用占一个汉字宽度, 标号和句内点号占半个汉字宽度 ; CCT CCT 式 : 所有标点符号的宽度略小于一个汉字宽度 ; plain 原样 ( 不调整标点间距 ) 13 使用 CTEX 文档类, 或者使用 ctex 宏包且开启该选项时 14 标点符号分为标号与点号 点号分为两类, 一共七种 : 句末点号有句号 问号和叹号 ; 句内点号有逗号 顿号 冒号和分号

10 第 5 节排版格式设定 10 space Updated: space = true false auto 是否在生成的 PDF 中保留汉字后面的空格 true 总是保留汉字后的空格 此时, 用户需要自行在行尾加上 % 处理换行产生的空格 15 false 总是忽略掉汉字后面的空格, 不论汉字后是什么 ( 使用 (pdf)latex 编译时 ); 等同于 auto 的效 果 ( 使用 XƎLATEX 编译时 ) 不建议使用该选项 auto 根据空格后面的情况决定是否保留 : 如果空格后面是汉字, 则忽略该空格, 否则保留 例如, 使用 \ctexset{space=true} 汉字分词技术 English 例 6 将得到 汉字分词技术 English ; 使用 \ctexset{space=auto} 汉字分词技术 English 例 7 则会得到 汉字分词技术 English 使用 LuaLATEX 编译的时候, 该选项无效 : 汉字间的空格以及汉字与西文字符之间的空格总是有效, 不会被忽略, 但可以自动忽略掉由换行产生的空格 linespread New: linespread = 数值 接受一个浮点数值, 设置行距倍数 本选项的初始值与 scheme 有关 scheme = chinese 初始值为 1.3, 即 1.3 倍行距 此时, 相邻两行的基线 (\baselineskip) 距离为 = 1.56 倍字体高度 scheme = plain CTEX 宏集默认不调整行距倍数, 文档中的行距由所选文档类和其他宏包或用户设置决定 autoindent New: autoindent = true false 数值 带单位的数值 在字体大小发生变化时, 是否自动调整段首缩进 (\parindent) 的大小 数值或带单位的数值 用于设置段首缩进的长度 如果不带单位, 则默认单位是单个汉字字宽 \ccwd; 如果带单位, 则使用该单位 true 等价于设置 autoindent = 2 false 禁用自动调整功能, 可以设置固定长度的段首缩进 如设置每段缩进 40 点 : \ctexset{autoindent=false} \setlength\parindent{40pt} 例 8 linestretch New: linestretch = 数值或长度 linestretch 是一个比较特殊的选项, 它用来设置汉字之间弹性间距的弹性程度 如果有单位, 则可以在选项中直接写 ; 如果是数字, 单位则是汉字宽度 \ccwd 的倍数 15 L A TEX 将单个换行视作一个空格

11 第 6 节文档汉化 11 如果行宽不是汉字宽度的整数倍, 为了让段落左右两端对齐, 自然就要求伸展汉字之间的间距, 而 linestretch 选项就是设置每行总的允许伸行量 初始值是允许每行伸行一个汉字的宽度 \ccwd, 并且此宽度能根据字号变化动态调整 过小的 linestretch 可能导致段落文字右侧可能参差不齐 ; 较大的 linestretch 选项则可以帮助拥有较长不可断行内容的复杂段落方便地断行, 而不会产生大量编译警告 ; 但很大的 linestretch 则会掩盖段落不良断行产生的坏盒子警告 如果将 linestretch 选项的值设置为 \maxdimen, 则可以禁止按字号自动修改每行的允许伸长量 此时汉字间的弹性间距则固定为 \baselineskip 的 0.08 倍 第 6 节 文档汉化 6.1 日期汉化 CTEX 宏包对显示当前日期的 \today 命令进行了汉化, 使之以中文的方式显示今天的日期 如编译本文档的日期就是 2015 年 7 月 1 日 today today = small big old 该选项用来控制 \today 命令的输出格式 : small big old 效果为 2015 年 7 月 1 日 使用阿拉伯数字和汉字的日期格式 效果为 二〇一五年七月一日 使用全汉字的日期格式 效果为 July 1, 2015 使用文档原来的( 英文 ) 日期格式 设置日期格式使用 \ctexset 命令完成, 例如设置全汉字的日期格式 : \ctexset{today=big} 例 9 CTEX 宏包的中文日期功能实际上是调用 zhnumber 宏包完成的 如果需要更多有关日期 时间的命令和更复杂的设置, 可以查阅 zhnumber 宏包的文档 6.2 文档标题汉化 这里主要介绍由宏包 scheme 选项 (5.3 节 ) 控制的文档标题汉化功能 设置文档标题名的示例可见例 4 下面的选项 ( 如 contentsname) 主要用来重新定义与选项同名的宏 ( 如 \contentsname) 的定义 contentsname contentsname = 名字 设置目录标题名 \contentsname 中文默认为 目录 listfigurename listfigurename = 名字 设置插图目录标题名 \listfigurename 中文默认为 插图 listtablename listtablename = 名字 设置表格目录标题名 \listtablename 中文默认为 表格 figurename figurename = 名字 设置图片环境标题名 \figurename 中文默认为 图

12 第 6 节文档汉化 12 tablename tablename = 名字 设置表格环境标题名 \tablename 中文默认为 表 abstractname abstractname = 名字 设置摘要 abstract 环境标题名 \abstractname 中文默认为 摘要 注意 book 类没有摘要, 该选项无效 indexname indexname = 名字 设置索引标题名 \indexname 中文默认为 索引 appendixname appendixname = 名字 设置附录标题名 \appendixname 中文默认为 附录 bibname bibname = 名字 设置参考文献标题名 \refname( 对 article) 或 \bibname( 对 report 和 book) 中文默认为 参考文献 6.3 页面格式设置与汉化 当使用了 CTEX 的文档类或是用 ctex 宏包加载了 heading 选项时, 会设置整个文档的页面格式 (page style) 为 headings, 即相当于设置了 \pagestyle{headings} 在页眉中显示当前章节的编号与标题 同时,CTEX 宏包也会对默认的 headings 页面格式进行修改, 使之调用 \CTEXthechapter \CTEXthesection 等宏来正确显示中文的章节编号 CTEX 宏包的默认页面格式设置是经过汉化的 headings, 其基本效果如本文档所示, 只在页眉一侧显示章节编号和标题, 另一侧显示页码 更复杂的页面格式可以通过调用 fancyhdr titleps 等宏包来设置 CTEX 宏包同时也为这些自定义页面格式的包提供了以下宏供使用 : \CTEXthechapter \CTEXthesection 等章节编号 ( 见 7 节 ) 它们用来代替英文文档类中的 \thechapter \thesection 等宏 \leftmark \rightmark, 它们是在使用章节标题命令后, 自动设置的宏 它们实际是在与章节标题命令对应的标记命令 \chaptermark \sectionmark 中调用 \markright 或 \markboth 生成的 有关 LATEX 页面标记的涵义与使用细节, 已经超出了本文档讨论的范围 可以参考 [1, Chapter 23] [2, 4.3, 4.4] 等书籍 这里举一个例子, 说明通过重定义 \sectionmark, 在 ctexart 文档类中的标准 headings 页面格式下控制页眉的方式 : \documentclass{ctexart} \pagestyle{headings} \ctexset{section={ name={ 第, 节 }, number=\arabic{section}, 例 10

13 第 7 节章节标题格式设置 13 } } \renewcommand\sectionmark[1]{% \markright{\ctexthesection #1}} \begin{document} \section{ 天地玄黄 } \newpage \section{ 宇宙洪荒 } \end{document} 在上例中, 我们设置了页眉的形式是用破折号分开的节编号与节标题, 即 第 1 节 天地玄黄 第 2 节 宇宙洪荒 CTEX 宏包已经对 fancyhdr 宏包进行了补丁, 载入 fancyhdr 后, 其 fancy 页面格式将使用 \CTEXthechapter 等宏显示中文章节编号 关于 fancyhdr 的具体用法可以参见其宏包手册 通常也只要像在标准的英文文档类中使用 fancyhdr 一样定义页眉页脚格式即可, 并不需要额外的定义 下面我则给出一个与前例类似而稍复杂的例子, 展示如何在文档中设置页眉内容与页眉的格式 例 11 \documentclass{ctexart} \ctexset{section={ name={ 第, 节 }, number=\arabic{section}, } } \usepackage{fancyhdr} \fancyhf{} \lhead{\textnormal{\kaishu\rightmark}} \rhead{--\ \thepage\ --} \pagestyle{fancy} % \sectionmark 的重定义需要在 \pagestyle 之后生效 \renewcommand\sectionmark[1]{% \markright{\ctexthesection #1}} \begin{document} \section{ 天地玄黄 } \newpage \section{ 宇宙洪荒 } \end{document} 本例的页眉效果大致如下 ( 有页眉线 ): 第 1 节 天地玄黄 1 第 7 节 章节标题格式设置 CTEX 宏包对 LATEX 的标准文档类 (article report 和 book) 进行了扩充 当以 heading 选项调用 CTEX 宏包时 (5.2 节 ), 则会启用章节标题的格式设置功能 本节就来介绍有关章节标题的格式选项, 所有选项使用 \ctexset 命令设置

14 第 7 节章节标题格式设置 14 第 6.3 节和本节介绍的功能已经被提取到 ctexheading 宏包之中, 可以在 ctex 宏包和 ctexart 等文档类之外独立使用 各选项的默认值与 scheme = plain 时的情形相同 章节标题的格式选项是分层设置的 顶层的选项是章节标题名称, 次一级的选项是章节标题的格式 章节标题名包括 part, chapter, section, subsection, subsubsection, paragraph, subparagraph; 而可用的格式包括 numbering, name, number, format, nameformat, numberformat, aftername, titleformat, aftertitle, runin, afterindent, beforeskip, afterskip, indent, pagestyle 等 但注意, 对 article 及其衍生的 ctexart 等文档类, 没有 chapter 级别的标题 多级选项之间用斜线分开, 例如,part/name 选项设置 \part 标题的在数字前后的名称, 而 section/number 选项设置 \section 标题的数字类型 注意斜线前后都不要有空格 使用 \ctexset 设置多级选项时, 可以在同一个上级选项下设置多个下级选项 例如, 同时设置 part 一级标题的 pagestyle 选项,chapter 一级标题的 format 与 pagestyle 选项和 section 一级标题的 name 与 number 选项 : \ctexset { part/pagestyle = empty, chapter = { format = \raggedright, pagestyle = empty, }, section = { name = { 第, 节 }, number = \chinese{section}, } } 例 12 part/numbering chapter/numbering section/numbering subsection/numbering subsubsection/numbering paragraph/numbering subparagraph/numbering New: numbering = true false 控制是否对章节标题编号 对各级标题的默认值均为 true 我们知道,LATEX 带星号的章节标题命令 ( 如 \section*) 不会对标题编号, 但也不会将该没编号的标题编入目录中 本选项控制的是不带星号的标题命令是否编号 设置本选项为 false, 除了不对标题编号以外, 功能与正常标题一致, 比如可以编目录, 正确的 hyperref 目录超链接位置和页眉标记 注意, 章节标题的编号深度受 LATEX 计数器 secnumdepth 的控制 numbering 选项在 secnumdepth 的控制下起作用 如果没有特别说明, 以下将用... 代表各级章节标题名.../name Updated: name = { 前名字, 后名字 } name = { 前名字 } 设置章节的名字 名字可以分为前后两部分, 即章节编号前后的词语, 两个词之间用一个半角逗号分开 ; 也可以只有一部分, 表示只有章节编号之前的名字 例如 : \ctexset{ chapter/name = { 第, 章 }, section/name = {\S}, } 例 13 会使得 \chapter 标题使用形如 第一章 的名字, 而 \section 标题则使用形如 1 的名字

15 第 7 节章节标题格式设置 15 表 5 name 选项的默认设置 标题名 scheme = chinese scheme = plain 注 part { 第, 部分 } {\partname\space} 原 \partname 为 Part chapter { 第, 章 } {\chaptername\space} 原 \chaptername 为 Chapter section 同右 {} subsection 同右 {} subsubsection 同右 {} paragraph 同右 {} subparagraph 同右 {}.../number number = { 数字输出命令 } 设置章节编号的数字输出格式 数字输出命令 通常是对应章节编号计数器的输出命令, 如 \thesection 或 \chinese{chapter} 之类 \ctexset{ section/number = \Roman{section} } 例 14 number 选项的定义同时将控制对章节计数器的交叉引用 在引用计数器时, 记录在 LATEX 辅助文件中的是 number 选项的定义 但是,number 选项不会影响计数器本身的输出 即设置 section/number 不会影响 \thesection 的定义 ( 但该选项会影响 \CTEXthesection 的定义, 见后 ) 表 6 number 选项的默认设置 标题名 scheme = chinese scheme = plain 原 \the 标题 等价定义 part \chinese{part} \thepart \Roman{part} chapter \chinese{chapter} \thechapter \arabic{chapter} section 同右 \thesection \arabic{section} subsection 同右 \thesubsection \thesection.\arabic{subsection} subsubsection 同右 \thesubsubsection \thesubsection.\arabic{subsubsection} paragraph 同右 \theparagraph \thesubsubsection.\arabic{paragraph} subparagraph 同右 \thesubparagraph \theparagraph.\arabic{subparagraph} \CTEXthepart \CTEXthechapter \CTEXthesection \CTEXthesubsection \CTEXthesubsubsection \CTEXtheparagraph \CTEXthesubparagraph 以 \CTEXthe 开头的这组宏给出结合了 name 与 number 选项的章节编号输出格式 例如在 scheme = chinese 时, 默认章编号输出格式就是 \CTEXthechapter, 形如 第一章 这组宏在 CTEX 文档类中将代替 \thechapter 等宏的作用, 在章节中引用本章节的完整编号 例如用于帮助定义自定义的目录格式 页眉格式等.../format.../format+ Updated: format = { 格式命令 } format+= { 格式命令 } format 选项用于控制章节标题的全局格式, 作用域为章节名字和随后的标题内容 可以用于控制章节标题的对齐方式 整体字体字号等格式 带加号的 format+ 选项则用于在已有格式之后追加新的格式命令 例如, 设置章格式为无衬线字体左对齐, 为节格式增加无衬线字体设置 :

16 第 7 节章节标题格式设置 16 例 15 \ctexset{ chapter/format = \sffamily\raggedright, section/format+ = \sffamily } 表 7 format 选项的默认设置 标题名 scheme = chinese scheme = plain part (article) \Large\bfseries\centering \raggedright part \huge\bfseries\centering \centering chapter \huge\bfseries\centering \raggedright section \Large\bfseries\centering \Large\bfseries subsection 同右 \large\bfseries subsubsection 同右 \normalsize\bfseries paragraph 同右 \normalsize\bfseries subparagraph 同右 \normalsize\bfseries.../nameformat.../nameformat+ Updated: nameformat = { 格式命令 } nameformat+= { 格式命令 } nameformat 用于控制章节名字的格式, 作用域为章节名字, 包括编号 它一般用于章节名 ( 包括编号 ) 与章节标题的字体 字号等设置不一致的情形 参见 titleformat 选项 nameformat+ 用于在已有的章节名字格式后附加内容 nameformat 选项的最后一个格式命令可以是一个有一个参数的命令 这个命令的参数用于接受章节名字和编号, 实现特殊效果 ( 见例 19) nameformat 选项的默认值, 在 scheme 选项的不同取值下相同 表 8 nameformat 选项的默认设置 标题名 scheme = chinese scheme = plain part (article) {} \Large\bfseries part {} \huge\bfseries chapter {} \huge\bfseries section 同右 {} subsection 同右 {} subsubsection 同右 {} paragraph 同右 {} subparagraph 同右 {}.../numberformat.../numberformat+ Updated: numberformat = { 格式命令 } numberformat+= { 格式命令 } numberformat 选项用于控制章节编号的格式, 作用域仅为编号数字本身 对各级标题默认均为空, 当你需要编号的格式和前后的章节名字不一样时可以使用 numberformat+ 选项用于在原有编号格式后面附加格式命令 numberformat 选项的最后一个格式命令可以是一个有一个参数的命令 这个命令的参数用于接受编号数字 例如, 我们可以使用 numberformat 特别强调章标题中的数字 :

17 第 7 节章节标题格式设置 17 例 16 \ctexset{ chapter/number = \arabic{chapter}, chapter/numberformat = \color{blue}\zihao{0}\itshape, } 上面的代码在 scheme = chinese 时可以做出类似这样的章标题效果 : 第 4 章.../aftername.../aftername+ Updated: aftername = { 代码 } aftername+= { 代码 } aftername 选项的参数 代码 将被插入到章节编号与其后的标题内容之间, 用于控制格式变换 常用于控制章节编号与标题内容之间的距离, 或者控制标题是否另起一行 aftername+ 选项用于在原有代码后面附加代码 表 9 aftername 选项的默认设置 标题名 scheme = chinese scheme = plain part (article) \quad \par\nobreak part 同右 \par\vskip 20pt chapter \quad \par\nobreak\vskip 20pt section 同右 \quad subsection 同右 \quad subsubsection 同右 \quad paragraph 同右 \quad subparagraph 同右 \quad.../titleformat.../titleformat+ Updated: titleformat = { 格式命令 } titleformat+= { 格式命令 } titleformat 选项用于控制标题内容的格式, 作用域为章节标题内容 titleformat+ 选项用于在原有标题格式后面附加格式命令 需要注意的是,titleformat 选项的最后一个格式命令可以是一个有一个参数的命令 这个命令的参数接受标题内容, 用于实现特殊效果 例如, 实现多行标题的居中悬挂对齐 : 例 17 \usepackage{varwidth} %% 提供 varwidth 环境 \ctexset{ chapter/name = { 第, 回 }, chapter/titleformat = \chaptertitleformat } \newcommand\chaptertitleformat[1]{%% 以标题内容为参数 \begin{varwidth}[t]{.7\linewidth}#1\end{varwidth}}... \chapter{ 情中情因情感妹妹 \\ 错里错以错劝哥哥 } 上面的代码可以做出类似这样的章标题效果 : 第三十四回 情中情因情感妹妹 错里错以错劝哥哥

18 第 7 节章节标题格式设置 18 表 10 titleformat 选项的默认设置 标题名 scheme = chinese scheme = plain part (article) {} \huge\bfseries part {} \Huge\bfseries chapter {} \Huge\bfseries section 同右 {} subsection 同右 {} subsubsection 同右 {} paragraph 同右 {} subparagraph 同右 {}.../aftertitle.../aftertitle+ New: aftertitle = { 代码 } aftertitle+= { 代码 } aftertitle 选项的参数 代码 将被插入到章节标题内容之后 aftertitle+ 选项用于在原有代码后面附加代码 aftertitle 选项的默认值, 在 scheme 选项的不同取值下相同 sub3section 或 sub4section 宏包选项 ( 见 5.2 节 ) 会影响 aftertitle 选项的默认值 表 11 aftertitle 选项的默认设置 表 12 runin 选项的默认设置 标题名 默认值 标题名 默认值 part \par chapter \par section \@@par subsection \@@par subsubsection \@@par paragraph {} (sub3section) \@@par (sub4section) 同上 subparagraph {} (sub4section) \@@par part chapter section subsection subsubsection paragraph (sub3section) (sub4section) subparagraph (sub4section) 无效无效 false false false true false 同上 true false section/runin subsection/runin subsubsection/runin paragraph/runin subparagraph/runin New: runin = true false runin 选项只对 \section 级以下标题有意义 用于确定标题与随后的正文是否排在同一段之上 runin 选项的默认值, 在 scheme 选项的不同取值下相同 默认情况下,\paragraph \subparagraph 两级标题是与后面正文排在同一段的,runin 选项为 true; 但使用 sub3section 或 sub4section 宏包选项 ( 见 5.2 节 ) 后, 将对这两级标题设 runin 选项为 false, 这两级标题会改为排在不同段.../afterindent New: afterindent = true false afterindent 选项用于设置章节标题后首段的缩进 book 和 report 类的 \part 标题被单独排在一页之上,afterindent 选项没有意义 对于 \section 级以下标题, 若设置了 runin 选项为 true, 即标题与随后正文排在同一段,afterindent 选项也就没有了意义

19 第 7 节章节标题格式设置 19 表 13 afterindent 选项的默认设置 标题名 scheme = chinese scheme = plain part (article) true false part 无效 无效 chapter true false section true false subsection true false subsubsection true false paragraph true false subparagraph true false.../beforeskip Updated: beforeskip = { 弹性间距 } beforeskip 选项用于设置章节标题前的垂直间距 beforeskip 选项的默认值, 在 scheme 选项的不同取值下相同 表 14 beforeskip 选项的默认设置 标题名 默认值 part (article) part chapter section subsection subsubsection paragraph subparagraph 4ex 0pt plus 1fil 50pt 3.5ex plus 1ex minus.2ex 3.25ex plus 1ex minus.2ex 3.25ex plus 1ex minus.2ex 3.25ex plus 1ex minus.2ex 3.25ex plus 1ex minus.2ex.../afterskip Updated: afterskip = { 弹性间距 } afterskip 选项控制章节标题与后面下方之间的距离 对于 \section 级以下标题,runin 选项会影响 afterskip 选项的意义 : 若 runin 为 true, 标题与随后正文排在同一段, 弹性间距 给出水平间距 否则, 正文另起一段, 弹性间距 给出的是垂直间距 afterskip 选项的默认值, 在 scheme 选项的不同取值下相同 sub3section 或 sub4section 宏包选项 ( 见 5.2 节 ) 会影响 aftertitle 选项的默认值.../indent indent = { 缩进间距 } Updated: indent 选项用于设置章节标题本身的首行缩进 indent 选项的默认值, 在 scheme 选项的不同取值下相同 例如, 设置 \section 标题缩进 20 pt: \ctexset{section={ format=\large\bfseries, indent=20pt, } } \section{ 首行缩进的标题 } \noindent 无缩进的正文 例 18

20 第 7 节章节标题格式设置 20 表 15 afterskip 选项的默认设置 表 16 indent 选项的默认设置 标题名 默认值 标题名 默认值 part (article) part chapter section subsection subsubsection paragraph (sub3section) (sub4section) subparagraph (sub4section) 3ex 0pt plus 1fil 40pt 2.3ex plus.2ex 1.5ex plus.2ex 1.5ex plus.2ex 1em 1ex plus.2ex 同上 1em 1ex plus.2ex part (article) part chapter section subsection subsubsection paragraph subparagraph (sub3section) (sub4section) 0pt 无效 0pt 0pt 0pt 0pt 0pt \parindent 0pt 同上 part/pagestyle chapter/pagestyle New: pagestyle = { 页面格式 } 设置 book/ctexbook 或 report/ctexrep 文档类中,\part 与 \chapter 标题所在页的页面格式 (page style) 表 17 pagestyle 选项的默认设置 标题名 part (article) part chapter 默认值无效 plain plain appendix/numbering New: numbering = true false 控制是否对附录章 ( 对 book 与 report) 或附录节 ( 对 article) 进行编号 用法与普通章节 numbering 选项类似 appendix/name Updated: name = { 前名字, 后名字 } name = { 前名字 } 设置附录章 ( 对 book 与 report) 或附录节 ( 对 article) 的名字 用法与普通章节 name 选项类似 注意该选项与 appendixname 选项 (6.2 节 ) 在意义上有些重叠, 但意义不同 appendixname 选项只用来重定义 \appendixname, 而不管 \appendixname 如何使用 ; 该选项则决定在章节标题中输出的名字, 可以调用 \appendixname 设置 表 18 appendix/name 选项的默认设置 文档类影响命令 scheme = chinese 实际定义 scheme = plain 实际定义 article \section {} {} book, report \chapter \appendixname\space 附录 \appendixname\space Appendix

21 第 8 节实用命令 21 appendix/number number = { 数字输出命令 } 设置附录章 ( 对 book 与 report) 或附录节 ( 对 article) 编号的数字输出格式 用法与普通章节的 number 选项类似 该选项也同时控制附录章节计数器的交叉引用 与普通章节的 number 选项类似, 同样需要注意, 该选项不会影响计数器本身的输出, 即不影响 \thesection 或 \thechapter 的定义 表 19 appendix/number 选项的默认设置 文档类影响命令默认值 article \section \Alph{section} book, report \chapter \Alph{chapter} 我们最后举一个稍微复杂的例子, 来看看上述选项的综合应用 例 19 \ctexset { chapter = { format = \Huge\bfseries, nameformat = \hrule height 1bp \relax\bigskip\hfill\chapternamebox, number = \arabic{chapter}, aftername = \par\medskip, aftertitle = \bigskip\hrule height 2bp \relax } } \newcommand\chapternamebox[1]{% \parbox{\ccwd}{\linespread{1}\selectfont\centering #1}}... \chapter{ 熟悉 \LaTeX} 本例的设置效果大致如下 : 熟悉 LATEX 第 1 章 第 8 节 实用命令 8.1 字号与间距 \zihao Updated: \ziju Updated: \zihao { 字号 } 用于调整字号大小 其中 字号 的有效值共有 16 个, 如表 20 所示 使用 \zihao 命令调整字体大小时, 西文字号大小会始终和中文字号保持一致 \ziju { 中文字符宽度的倍数 } 用于调整相邻汉字之间的间距, 即 ( 在正常中文行文中 ) 前一个汉字的右边缘与后一个汉字的左边缘之间的距离 其中参数可以是任意浮点数值 ; 而中文字符宽度指的是实际汉字的宽度, 不包含当前字距 这个命令会影响 \ccwd 的值, 但不会影响英文字距

22 第 8 节实用命令 22 表 20 中文字号 字号 大小 (bp) 大小 (pt) 意义 初号 小初号 一号小一号 二号 小二号 三号 小三号 四号 小四号 五号 小五号 六号 小六号 七号 八号

23 第 9 节 LuaLATEX 下的中文支持方式 23 \ccwd Updated: 当前汉字的字宽保存在长度寄存器 \ccwd 之中 汉字字宽是相邻两个汉字中心之间的距离, 包含字距在内 因此修改字距会间接修改字宽 8.2 中文数字转换 CTEX 宏集的中文数字转换功能实际上是调用 zhnumber 宏包来完成 下面只介绍一些基本的用法, 更高级的用法可以查阅 zhnumber 宏包的文档 \chinese Updated: \chinese { counter } \chinese 命令与 \roman 等命令的用法类似, 作用在一个 LATEX 计数器上, 将计数器的值以中文数字的形式输出 \zhnumber New: \zhnumber { number } 以中文格式输出数字 这里的数字可以是整数 小数和分数 \zhdigits New: \zhdigits { number } 将阿拉伯数字转换为中文数字串 \CTEXnumber \CTEXnumber \ macro { number } \ macro 必须是一个 TEX 宏, 不需预先定义 \CTEXnumber 通过 \zhnumber 将 number 转为中文数字, 最后将结果存储在 \ macro 里 对 \ macro 的定义是局部的, 将它展开一次就可以得到转换结果 一般来说, 并不需要使用 \CTEXnumber, 直接使用 \zhnumber 即可 但是, 如果在文档中需要多次使用同一个数字 number 的中文形式, 就可以先用 \CTEXnumber 将结果保存起来备用, 而不是每次使用时都用 \zhnumber 现场转换一次 \CTEXdigits \CTEXdigits \ macro { number } \CTEXdigits 与 \CTEXnumber 类似, 但其转换的结果是中文数字串, 而不是中文数字 8.3 杂项 \CTeX 用于显示 CTEX 标志 第 9 节 LuaLATEX 下的中文支持方式 在 LuaLATEX 下,CTEX 宏集依赖 LuaTeX-ja 宏包来完成中文支持 该宏包是日本 TEX 社区的北川弘典 前田一贵 八登崇之等人开发的, 设计目的主要是在 LuaTEX 引擎下实现日本 ptex 引擎的 ( 大部分 ) 功能 它为了兼容 platex 的使用习惯, 对 LATEX 2ε 的 NFSS 作了不少修改和扩充 这对于简体中文用户来说不是必要的, 因而 CTEX 禁用了它在 LATEX 格式下的大部分设置, 只保留了必要的部分 同时修改了它的字体设置方式, 使得相关命令与 xecjk 宏包大致相同 版以后的 LuaTeX-ja 宏包开始支持竖排, 但 CTEX 暂不支持竖排

24 第 9 节 LuaLATEX 下的中文支持方式 LuaL A TEX 下替代字体的设置 AlternateFont New: \setcjkfamilyfont { family } [ AlternateFont = { { character range 1 } [ alternate font features 1 ] { alternate font name 1 } { character range 2 } [ alternate font features 2 ] { alternate font name 2 }... }, base font features ] { base font name } 在设置字体族 family 的时候, 同时设置该字体族在字符范围 character range n 内, 对应字形的替代字体 CharRange New: \setcjkfamilyfont { family } [ CharRange = { character range }, alternate font features ] { alternate font name } 只设置字体族 family 在字符范围 character range 内, 对应字形的替代字体 一个 \setcjkfamilyfont 里只能使用一次 CharRange 或者 AlternateFont, 但可以将它们分开重叠使用 例如下面的方式是有效的 例 20 \setcjkmainfont[alternatefont={...}{...},...]{...} \setcjkmainfont[charrange={"4e00->"67ff,-2},...]{...} \setcjkmainfont[charrange={"6800->"9fff},...]{...} declarecharrange New: \ctexset { declarecharrange = { { name 1 } { character range 1 }, { name 2 } { character range 2 },... } } 预先声明字符范围 声明字符范围 name 之后, 它的名字 name 可以用在 AlternateFont 和 CharRange 选项的 character range 之中, 表示对应的字符范围 在声明字符范围 name 的同时, 还为 \setcjkmainfont 等字体设置命令定义了选项 name, 用于设置对应字符的替代字体 : name = [ alternate font features ] { alternate font name } name 选项可以与 AlternateFont 共同使用, 但不能与 CharRange 一起使用 如果没有给 name 设置值, 则等价于设置 CharRange= name, 即只设置 name 对应的字符范围的替代字体

25 第 10 节 CTEX 宏集的配置文件 25 clearalternatefont resetalternatefont New: \ctexset { clearalternatefont = { family 1, family 2,... }, resetalternatefont = { family 1, family 2,... }, clearalternatefont, resetalternatefont } 清除与重置 CJK 字体族 family 的替换字体设置 如果没有给定值, 则作用于当前 CJK 字体族 清除与重置操作总是全局的 第 10 节 CTEX 宏集的配置文件 CTEX 宏集提供了不同的配置文件, 可以通过修改配置文件来改变 CTEX 宏集的默认行为 在多数情况下, 并不需要修改配置文件,CTEX 宏集的默认设置已经能满足大多数用户的需要 不恰当地修改 CTEX 宏集的默认行为也可能导致同一文件在别处无法正常编译或排版效果完全不同, 因此修改应该慎重 但在一些情况下, 直接修改配置文件仍是必要的, 例如 : 系统没有安装默认设置的字体文件, 无法编译 需要经常编译来自其他系统的中文 TEX 文件, 但对方的操作系统或默认设置与本机不同 与 CTEX 宏集的源代码一样, 配置文件采用 LATEX3 的语法编写 CTEX 宏集的配置文件随宏包其他文件一起安装在 TEX 系统 TDS 目录树中, 文件后缀是.cfg 为了避免本地配置文件内容因 CTEX 宏集的更新而丢失, 不要直接修改系统 TDS 目录树中的配置文件, 而应该将系统自带的配置文件复制到本地的或用户私有的 TDS 目录树中修改, 并运行 texhash 命令刷新文件名数据库 例如对于 TEX Live, 系统自带的配置文件就在 TEX Live 安装目录下的 texmf-dist/tex/ latex/ctex/config/ 子目录下, 可以修改它的副本, 保存在本地 TDS 树的 texmf-local/ tex/latex/ctex/ 目录下, 或者用户 TDS 树的 ~/.texlive2015/texmf-var/tex/latex/ ctex/ 目录下, 作为本地 / 用户专有的配置文件 复制配置文件后需要运行 texhash 命令使本地配置文件生效 MiKTEX 的配置文件也保存在类似的目录结构中,MiKTEX 管理的几个 TDS 根目录可以在 MiKTEX Options 设置项中查看到, 这里不再赘述 除了修改本地 TEX 系统中的配置文件, 对于特定文档, 也可以将修改过的配置文件保存在文档的工作目录下 此时配置文件就只对工作目录下的所有文档生效 10.1 修改宏包默认选项 配置文件 ctexopts.cfg 可以用来修改宏包的默认选项 随系统安装的配置文件除了文件信息声明外没有实际的内容, 但在注释中给出了一个简单的示例, 只要取消注释就可以生效 例 21 % 系统自带 ctexopts.cfg 注释中的示例语句, 固定默认字体集为 windowsnew % 该设置可以用在安装了 Windows 字体的非 Windows 系统中 \keys_set:nn { ctex / option } { fontset = windowsnew }

26 第 11 节对旧版本的兼容性 26 如上例所示, 宏包选项通常使用 LATEX3 的 \keys_set:nn 命令完成键值设置, 第一个参数是固定的子模块 ctex/option, 第二个参数中是用户定义的新的默认宏包选项 ctexopts.cfg 中的设置将在 CTEX 宏集的开始处, 定义过宏包选项之后,\ProcessKeysOptions 命令之前生效 最好只使用此配置文件修改宏包默认选项 10.2 宏包载入后的配置 配置文件 ctex.cfg 将在宏包的末尾被载入生效 可以用它完成任意的设置, 或是覆盖已有的定义 随系统安装的配置文件除版本信息外没有实际内容, 注意配置文件中也使用 LATEX3 语法 % 简单的 ctex.cfg 内容示例 % 修改默认的页面格式设置 \pagestyle{plain} 例 22 例 23 % 略复杂的 ctex.cfg 内容示例 : 禁止段末孤字成行 % 在使用 XeTeX 编译时, 打开 xecjk 的 CheckSingle 选项 \xetex_if_engine:t { \xecjksetup { CheckSingle } } % 在使用 LuaTeX 编译时, 设置 LuaTeX-ja 的 jcharwidowpenalty 参数 \luatex_if_engine:t { \ltjsetparameter { jcharwidowpenalty = } } 10.3 配置标题中文翻译 由于 CTEX 宏集需要同时支持 GBK 和 UTF-8 两种编码, 因此对标题的中文翻译写在两个配置文件当中 :ctex-name-gbk.cfg 和 ctex-name-utf8.cfg 两个文件的设置相同, 只是编码不同 为了同一文档在不同电脑上编译效果的一致性, 通常不建议修改默认的中文翻译 10.4 自定义字体集 4.3 节介绍的用于 fontset 选项的自定义字库文件, 类似于 CTEX 宏集的配置文件, 也应该与其他本地配置文件一起保存在本地 TDS 目录树下, 并可以配合 ctexopts.cfg 等配置文件使用 第 11 节 对旧版本的兼容性 11.1 CTEX 0.8a 及以前的版本 在 ctex-kit 项目成立之前,CTEX 宏包的最后一个版本是 CTEX 0.8a(2007/05/06) 第 2 版未考虑对这些很早版本的兼容性

27 第 11 节对旧版本的兼容性 CTEX 0.9 CTEX 1.0d 在 2009 年在 ctex-kit 项目成立后, 新增了 XƎTEX 引擎的支持, 并增加了不少控制字体的命令和选项 这里主要介绍新版本 CTEX 宏包相对 1.02d 版本 (2014/06/09) 的兼容性 第 2 版的 CTEX 宏包已尽力保证对 1.0x 版本的兼容性, 原有为 1.0x 编写的代码, 在第 2 版的 CTEX 宏包下保证仍能编译, 并且在大多数情况下保持编译效果不变 CTEX 宏包在 0.8a 以前的版本支持以 CCT 作为底层中文支持方式, 从 0.9 版之后即不再推荐使用, 只保留向后兼容 在 CTEX 宏包第 2 版中则完全不再支持 CCT 下面这些是在旧版本 CTEX 宏包中存在, 而在新版本中已不建议使用的选项和命令, 在未来版本中可能会删去它们的支持 在多数情况下它们的功能仍将保留, 但也有部分选项命令功能已失效 cs4size c5size 分别相当于 zihao=-4 和 zihao=5, 过时选项 CCT CCTfont 相关选项已删除 indent noindent zhmap nozhmap winfonts adobefonts nofonts punct nopunct cap nocap space nospace fancyhdr indent 和 noindent 什么也不做, 过时选项 在中文版式下,ctex 宏包的相关功能在与标准文档类及其衍生文档类联用时默认打开 CTEX 文档类的相关功能由章节标题的 afterindent 选项的值来确定 zhmap 宏包选项增加了参数, 扩充了功能, 除了支持真假值参数外, 还支持选择 zhmcjk 作为底层中文处理宏包 (4.3 节 ) nozhmap 选项相当于 zhmap=false 过时选项 宏包选项 winfonts 相当于 fontset=windows,adobefonts 相当于 fontset=adobe,nofonts 相当于 fontset=none 这几个选项是过时选项, 对于新文档, 应使用 fontset 选项设置不同字体集 另外, 第 2 版 CTEX 宏包的默认字体不再是 Windows 系统字体, 而是根据检测到的操作系统选择使用 Windows Mac 的系统字体还是 Fandol 字体 (4.3 节 ) 旧版本中宏包 punct 选项没有参数, 现在可以用参数设定标点风格 (5.3 节 ) 原有无参形式的 punct 选项相当于 punct=quanjiao 旧版宏包中 nopunct 选项的效果大致相当于 punct=plain 过时选项, 不推荐使用 原有的 cap 和 nocap 选项由新的 scheme 选项代替 (5.3 节 ) cap 选项相当于 scheme = chinese,nocap 选项相当于 scheme = plain 它们均已过时, 仅因兼容性而保留 新版本宏包 space 选项增加真假值参数 (5.3 节 ) nospace 选项相当于 space=false, 成为过时选项 新版本宏包中总是自动处理对 fancyhdr 宏包的兼容性, 而由用户自己使用 \usepackage 载入 fancyhdr 宏包 fancyhdr 选项过时, 因兼容性保留, 功能是载入 fancyhdr 宏包

28 第 11 节对旧版本的兼容性 28 hyperref fntef \CTEXunderdot \CTEXunderline \CTEXunderdblline \CTEXunderwave \CTEXsout \CTEXxout \CTEXfilltwosides \CTEXsetfont \CTEXindent 新版本宏包中总是自动处理对 hyperref 宏包的兼容性, 而由用户自己使用 \usepackage 载入 hyperref 宏包 hyperref 选项过时, 因兼容性保留, 功能是在导言区末尾载入 hyperref 宏包 旧版本的 fntef 选项用于统一 CCTfntef 与 CJKfntef 的界面, 新版本 CTEX 宏集不再支持 CCT, 而是直接载入 CJKfntef 或 xecjkfntef 宏包并禁用其彩色设置 该选项是过时选项 在调用 fntef 宏包选项的同时, 旧版本 CTEX 宏包由于需要支持 CCT 系统, 会将以 \CJK 开头的 \CJKunderline 等宏换名为以 \CTEX 开头的 \CTEXunderline 等宏 此功能在新版本的 CTEX 宏集中已失去意义 此外, 在 pdftex 引擎下, 用于设置格式的 \CJKunderdotbasesep 等宏也被换名为 \CTEXunderdotbasesep 等宏 在新版本中, 上述由 fntef 衍生的相关宏都成为过时命令 更新当前的中文字体信息, 包括当前字距 (\ccwd) 和段首缩进 (\parindent) 一般来说, 用户无需使用这个命令 更新 \ccwd 宽度后设置 \parindent=2\ccwd 过时命令 \CTEXnoindent 设置 \parindent=0pt 过时命令 \CTEXsetup \CTEXsetup[ 选项 ]{ 标题 } 相当于设置了 \ctexset{ 标题 = { 选项 } } 过时命令 \CTEXoptions \CTEXoptions[ 选项 ] 相当于设置了 \ctexset{ 选项 } 过时命令 \Chinese \Chinese{ counter } 新版宏集中 \chinese 统一了旧版本中 \chinese 和 \Chinese 的功能 因此, 该命令已过时 captiondelimiter 原为 \CTEXoptions 命令的选项, 用于控制 \caption 编号后面的标点 此选项已过时, 并在新版本的 CTEX 宏包中失效 可以使用 caption 宏包的 labelsep 选项来完成同样的功能 % 代替 \CTEXoptions[captiondelimiter={:}] \usepackage{caption} \captionsetup{labelsep=colon} 例 CTEX 1.02c 以后的 SVN 开发版 CTEX 宏包在 1.02c 版本 (2011/03/11) 之后在 Google code 上的 SVN 开发版本, 内部版本号一直升到 1.11 版, 但从未正式发布 SVN 开发版在 1.02c 版本的基础上新增的功能在第 2 版中大多继承了过来, 但新增的命令与选项都不再保持兼容 CTEX 宏包第 2 版不保证对未发布的 SVN 开发版兼容

29 第 12 节宏集依赖情况与手工安装方法 CTEX 2.2 之前的版本 part/beforeskip chapter/beforeskip section/beforeskip subsection/beforeskip subsubsection/beforeskip paragraph/beforeskip subparagraph/beforeskip section/afterskip subsection/afterskip subsubsection/afterskip paragraph/afterskip subparagraph/afterskip 在 CTEX 2.2 之前的版本中,beforeskip 选项的符号还用于确定章节标题后首段的缩进 当 beforeskip 是负值时, 章节标题后的第一段按英文文档的排版习惯, 没有首行缩进, 否则保留首行缩进 这一特性在 2.2 版和后续版本中不再保留, 相应的功能通过新的 afterindent 选项来设置 如果原先设置 beforeskip 为负值, 在新版本中需要改为正值, 并设置相应的 afterindent 选项为 false 在 CTEX 2.2 之前的版本中, 对于 \section 级以下标题,afterskip 选项的符号用于确定标题与随后正文是否排在同一段 如果是正值, 则正文另起一段, 否则标题与随后正文排在同一段,afterskip 的绝对值给出水平间距 这一特性在 2.2 版和后续版本中不再保留, 相应的功能通过新的 runin 选项来设置 如果原先设置 afterskip 为负值, 在新版本中需要改为正值, 并设置相应的 runin 选项为 true 第 12 节 宏集依赖情况与手工安装方法 本节介绍 CTEX 宏集的依赖情况, 并介绍手工编译安装的具体方法 通常用户只需参照第 2.2 节介绍的方法, 使用发行版自带的宏包管理器安装本宏集 CTEX 宏集有两个源文件 :ctex.dtx ctexpunct.spa 使用不同的编译方式时,CTEX 依赖的宏包略有不同 在手工安装 CTEX 宏集之前, 请确保你的 TEX 发行版中已经正确安装了这些宏包 CTEX 依赖宏包的详情叙述如下 : expl3 xparse 和 l3keys2e 宏包 它们属于 l3kernel 和 l3packages 宏集, 它们还依赖 etex 宏包 indentfirst 宏包, 属于 tools 宏集 everysel 宏包, 属于 ms 宏集 zhnumber 宏包 以上是各种编译方式都必需的依赖项 CJK 宏集, 它的下划线功能依赖 ulem 宏包 CJKpunct 宏包 xcjk2uni 宏包 zhmetrics 宏包 zhmcjk 宏包 以上是使用 pdflatex 或 LATEX + DVIPDFMx 的编译方式所需要的依赖项, 其中 zhm- CJK 是可选的 xecjk 宏包, 它还依赖 fontspec 宏包, 它还依赖 * euenc 宏包 * xunicode 宏包, 它还依赖 tipa 宏包 以上是使用 XƎLATEX 编译时的依赖项 LuaTeX-ja 宏集, 它还依赖 oberdiek 宏集 xkeyval 宏包 lualibs 宏包 luaotfload 宏包, 它还依赖 luatexbase 宏包

30 第 13 节开发人员 30 以上是使用 LuaLATEX 编译时的依赖项 出于一些原因,zhmCJK 尚未被收入 TEX Live 和 MiKTEX 因此, 若你希望使用 zhmcjk 作为 CTEX 宏集的底层中文支持方式, 那么你需要自行安装该宏包 zhmcjk 的安装较为复杂 我们建议你 1. 从 CTAN 下载 zhmcjk 宏包的 TDS 安装包, 2. 按目录结构将文件复制到 TEX 发行版的本地 TDS 根目录, 3. 最后执行 texhash 刷新 TEX 发行版的 ls-r 数据库以完成安装 其他细节, 可参照其宏包手册中第 3 节的指导 CTEX 宏集已被 TEX Live 和 MiKTEX 收录, 若无特别理由, 我们强烈建议用户使用宏包管理器安装本宏集 若要手工安装, 请遵循如下步骤 : 1. 从 CTAN 下载 CTEX 宏集的 TDS 安装包, 2. 按目录结构将文件复制到 TEX 发行版的本地 TDS 根目录, 3. 最后执行 texhash 刷新 TEX 发行版的 ls-r 数据库以完成安装 第 13 节 开发人员 吴凌云 (aloft@ctex.org) 江疆 (gzjjgod@gmail.com) 王越 (yuleopen@gmail.com) 刘海洋 (LeoLiu.PKU@gmail.com) 李延瑞 (LiYanrui.m2@gmail.com) 陈之初 (zhichu.chen@gmail.com) 李清 (sobenlee@gmail.com) 黄晨成 (liamhuang0205@gmail.com) 目前比较活跃的开发维护人员是刘海洋 李清和黄晨成 第 14 节 参考文献 [1] Donald Ervin Knuth. The TEXbook, Computers & Typesetting, volume A. Addison- Wesley, 1986 [2] Frank Mittelbach and Michel Goossens. The LATEX Companion. Tools and Techniques for Computer Typesetting. Boston: Addison-Wesley, second edition, 2004

31 第 15 节代码实现 31 第 15 节 代码实现 宏包载入检查 2 *class ctex 3 \tl_const:nx \c ctex_version_tl 4 { \cs_if_exist_use:cf { ver@ \@currname. \@currext } { 9999/99/99 } } 5 *class 6 \cs_new_eq:cn { ver@ctex. \@pkgextension } \c ctex_version_tl 7 \cs_new_eq:cn { ver@ctexcap. \@pkgextension } \c ctex_version_tl 8 \cs_new_eq:cn { ver@ctexsize. \@pkgextension } \c ctex_version_tl 9 \cs_new_eq:cn { ver@ctexheading. \@pkgextension } \c ctex_version_tl 10 /class 11 *ctex 12 \msg_new:nnnn { ctex } { subpackage-loaded } 13 { Package~`#1'~can~not~be~loaded~with~`ctex'. } 14 { 15 `#1'~is~actually~a~part~of~`ctex'.\\ 16 It~is~not~necessary~to~load~it~separately. 17 } 18 \@ifpackageloaded { ctexsize } 19 { \msg_error:nnn { ctex } { subpackage-loaded } { ctexsize } } 20 { \cs_new_eq:cn { ver@ctexsize. \@pkgextension } \c ctex_version_tl } 21 \@ifpackageloaded { ctexheading } 22 { \msg_error:nnn { ctex } { subpackage-loaded } { ctexheading } } 23 { \cs_new_eq:cn { ver@ctexheading. \@pkgextension } \c ctex_version_tl } 24 /ctex 25 /class ctex 26 *class style 27 \RequirePackage { xparse, l3keys2e } 28 /class style 检查 expl3 和 l3keys2e 的版本 29 *class 30 \msg_new:nnnn { ctex } { l3-too-old } 31 { Support~package~`#1'~too~old. } 32 { 33 Please~update~an~up~to~date~version~of~the~bundles\\\\ 34 `l3kernel'~and~`l3packages'\\\\ 35 using~your~tex~package~manager~or~from~ctan. 36 } 37 \@ifpackagelater { expl3 } { 2014/07/20 } { } 38 { \msg_error:nnn { ctex } { l3-too-old } { expl3 } } 39 \@ifpackagelater { l3keys2e } { 2014/05/05 } { } 40 { \msg_error:nnn { ctex } { l3-too-old } { l3keys2e } } 41 /class 42 *class ctex ctexheading 43 \RequirePackage { ctexhook, ctexpatch } 44!ctexheading \RequirePackage { fix-cm, everysel } 15.1 内部函数与变量 \l ctex_tmp_tl \l ctex_tmp_int \l ctex_tmp_dim \l ctex_tmp_box 45 \tl_new:n \l ctex_tmp_tl 46 \int_new:n \l ctex_tmp_int 47!ctexheading \dim_new:n \l ctex_tmp_dim 48 \box_new:n \l ctex_tmp_box (End definition for \l ctex_tmp_tl and others.) \ctex_file_wrapper:nnn 设置文件操作的 \catcode 环境, 参数 #1 是设置,#2 是文件操作,#3 是恢复 默认关闭 LATEX3 语法环境, 的 \catcode 为 11

32 第 15 节代码实现 \cs_new_protected:npn \ctex_file_wrapper:nnn #1#2#3 50 { 51 \use:x 52 { 53 \ExplSyntaxOff 54 \char_set_catcode_letter:n { 64 } 55 #1 56 \exp_not:n {#2} 57 \bool_if:ntf \l kernel_expl_bool 58 { \ExplSyntaxOn } 59 { \ExplSyntaxOff } 60 \char_set_catcode:nn { 64 } { \char_value_catcode:n { 64 } } 61 #3 62 } 63 } (End definition for \ctex_file_wrapper:nnn.) \ctex_file_input:n 输入文件 64 \cs_new_protected_nopar:npn \ctex_file_input:n #1 65 { \ctex_file_wrapper:nnn { } { \file_input:n {#1} } { } } (End definition for \ctex_file_input:n.) \ctex_scheme_input:n 输入 scheme 文件 先查找当前文档类下的 scheme, 找不到再查找一般的文件 66 \cs_new_protected_nopar:npn \ctex_scheme_input:n #1 67 { 68 \ctex_file_wrapper:nnn 69 { } 70 { 71 \tl_if_exist:ntf \c ctex_class_tl 72 { 73 \file_if_exist_input:nf { ctex-scheme- #1 - \c ctex_class_tl.def } 74 { \file_input:n { ctex-scheme- #1.def } } 75 } 76 { \file_input:n { ctex-scheme- #1.def } } 77 } 78 { } 79 } 80 \cs_generate_variant:nn \ctex_scheme_input:n { o } (End definition for \ctex_scheme_input:n.) g ctex_section_depth_flag 若大于 3, 则 \paragraph 和 \subparagraph 标题单独占一行 ; 若为 3, 则 \paragraph 单独占一行 81 \cs_new_eq:nn \g ctex_section_depth_flag \c_two (End definition for \g ctex_section_depth_flag.) 82 /class ctex ctexheading 83 *class ctex 对旧版本的宏包给出错误信息 84 \msg_new:nnnn { ctex } { package-too-old } 85 { Support~package~`#1'~too~old. } 86 { 87 Please~update~an~up~to~date~version~of~the~package~`#1'\\ 88 using~your~tex~package~manager~or~from~ctan. 89 } \ctex_lua_now_x:n 最新的 expl3 去掉了 l3luatex 模块, 因而 \lua_now_x:n 不再有定义 90 \cs_new_eq:nn \ctex_lua_now_x:n \luatex_directlua:d

33 第 15 节代码实现 33 (End definition for \ctex_lua_now_x:n.) \ctex_if_pdfmode:tf ifpdf 宏包的简单实现 91 \cs_if_exist:ntf \pdftex_pdfoutput:d 92 { 93 \int_compare:nnntf \pdftex_pdfoutput:d > \c_zero 94 { 95 \cs_new_eq:nn \ifctexpdf \tex_iftrue:d 96 \cs_new_eq:nn \ctex_if_pdfmode:tf \use_i:nn 97 } 98 } 99 { \use:n } 100 { 101 \cs_new_eq:nn \ifctexpdf \tex_iffalse:d 102 \cs_new_eq:nn \ctex_if_pdfmode:tf \use_ii:nn 103 } (End definition for \ctex_if_pdfmode:tf.) \ctex_if_preamble:tf 测试是否在 LATEX 2ε 的导言区 在宏包内部初始为真, 文档最开始位置再设置为假 注意, 钩子 \ctex_after_end_preamble:n 在 \AtBeginDocument 之后执行, 可以与 \@onlypreamble 的行为一致 104 \cs_new_eq:nn \ctex_if_preamble:tf \use_i:nn 105 \ctex_after_end_preamble:n { \cs_set_eq:nn \ctex_if_preamble:tf \use_ii:nn } (End definition for \ctex_if_preamble:tf.) \ctex_set_default_ccwd:nn 若参数 #2 带长度单位, 则设置它为 tl 变量 #1 的值, 否则以 \ccwd 为单位 106 \cs_new:npn \ctex_set_default_ccwd:nn #1#2 107 { 108 \dim_compare:nnntf 109 { \ctex_default_pt:n {#2} } = { \ctex_default_pt:n { #2 ~ mm } } 110 { \tl_set:nn #1 {#2} } 111 { \tl_set:nn #1 { #2 \ccwd } } 112 } (End definition for \ctex_set_default_ccwd:nn.) \ctex_default_pt:n 最新版本的 expl3 已经不允许 \dim_to_decimal:n 的参数带额外的单位 然而我们需要这个特性实现可展的 \@defaultunits 113 \cs_new:npn \ctex_default_pt:n #1 114 { 115 \exp_after:wn \ ctex_default_pt:w 116 \dim_use:n \etex_dimexpr:d #1 pt \scan_stop: \q_stop 117 } 118 \group_begin: 119 \char_set_catcode_other:n \P 120 \char_set_catcode_other:n \T 121 \tex_lowercase:d 122 { 123 \group_end: 124 \cs_new:npn \ ctex_default_pt:w #1 PT #2 \q_stop { #1 PT } 125 } (End definition for \ctex_default_pt:n.) \l ctex_encoding_tl (pdf)latex 初始化编码为 GBK, 其它则是 UTF8 126 \tl_new:n \l ctex_encoding_tl 127 \tl_set:nx \l ctex_encoding_tl 128 { \pdftex_if_engine:tf { GBK } { UTF8 } }

34 第 15 节代码实现 34 (End definition for \l ctex_encoding_tl.) \g ctex_zhmcjk_bool 是否使用 zhmcjk 宏包 129 \bool_new:n \g ctex_zhmcjk_bool (End definition for \g ctex_zhmcjk_bool.) \l ctex_autoindent_tl 保存 autoindent 选项的值, 空值表示不自动调整首行缩进 130 \tl_new:n \l ctex_autoindent_tl (End definition for \l ctex_autoindent_tl.) \ctex_if_autoindent_touched:f 检查 autoindent 选项是否被用户设置 131 \cs_new_eq:nn \ctex_if_autoindent_touched:f \use:n (End definition for \ctex_if_autoindent_touched:f.) \ctex_zhmap_case:nnn 参数 #1 是 zhmcjk 的内容,#2 是 zhmetrics 132 \cs_new_eq:nn \ctex_zhmap_case:nnn \use_ii:nnn (End definition for \ctex_zhmap_case:nnn.) \ctex_at_end:n 区分 \AtEndOfClass 和 \AtEndOfPackage, 虽然它们的意思都是一样的 133 class \cs_new_protected_nopar:npn \ctex_at_end:n { \AtEndOfClass } 134 ctex \cs_new_protected_nopar:npn \ctex_at_end:n { \AtEndOfPackage } (End definition for \ctex_at_end:n.) \g ctex_std_options_clist 保存传递给标准文档类的选项 135 *class 136 \clist_new:n \g ctex_std_options_clist 137 /class (End definition for \g ctex_std_options_clist.) 对无效选项给出警告 138 \msg_new:nnn { ctex } { invalid-option } 139 { Option~`\l_keys_key_tl'~is~invalid~in~current~mode. } 140 \msg_new:nnn { ctex } { invalid-value } 141 { Value~`#1'~is~invalid~for~the~key~`\l_keys_key_tl'. } 对过时选项或命令给出警告 142 \msg_new:nnn { ctex } { deprecated-option } 143 { Option~ `\l_keys_key_tl'~ is~ deprecated.\\ #1 } 144 \msg_new:nnn { ctex } { deprecated-command } 145 { Command~ #1 is~ deprecated.\\ #2 } 146 \msg_new:nnn { ctex } { deprecated-environment } 147 { Environment~ `#1'~ is~ deprecated.\\ #2 } 148 /class ctex \g ctex_font_size_flag 0 表示修改默认字体大小为五号,1 为小四号, 其它值则不作修改 149 *class ctex ctexsize 150 \cs_new_eq:nn \g ctex_font_size_flag \c_minus_one 151 /class ctex ctexsize (End definition for \g ctex_font_size_flag.)

35 第 15 节代码实现 宏包选项 152 *class style 153 \keys_define:nn { ctex / option } 154 { 155 /class style zihao 156 *class ctex ctexsize 157 zihao.choice:, 158 zihao.default:n = { 5 }, 159 zihao / 5.code:n = { \cs_gset_eq:nn \g ctex_font_size_flag \c_zero }, 160 zihao / -4.code:n = { \cs_gset_eq:nn \g ctex_font_size_flag \c_one }, 161 zihao / false.code:n = { \cs_gset_eq:nn \g ctex_font_size_flag \c_two }, 162 ctexsize } 163 /class ctex ctexsize 164 *class ctex 165 c5size.code:n = 166 { 167 \msg_warning:nnn { ctex } { deprecated-option } 168 { Option~ `zihao=5'~ is~ set. } 169 \keys_set:nn { ctex / option } { zihao = 5 } 170 }, 171 cs4size.code:n = 172 { 173 \msg_warning:nnn { ctex } { deprecated-option } 174 { Option~ `zihao=-4'~ is~ set. } 175 \keys_set:nn { ctex / option } { zihao = -4 } 176 }, 177 c5size.value_forbidden:, 178 cs4size.value_forbidden:, (End definition for zihao. This function is documented on page 21.) linespread 行距初始值为标志 nan, 用于检查用户是否设置了 linespread 选项 179 linespread.fp_set:n = \l ctex_line_spread_fp, 180 linespread.initial:n = { \c_nan_fp }, 181 linespread.value_required:, (End definition for linespread. This function is documented on page 10.) autoindent 自动调整段落的首行缩进功能 182 autoindent.choice:, 183 autoindent.default:n = { true }, 184 autoindent / true.code:n = 185 { 186 \tl_set:nn \l ctex_autoindent_tl { 2 \ccwd } 187 \cs_set_eq:nn \ctex_if_autoindent_touched:f \use_none:n 188 }, 189 autoindent / false.code:n = 190 { 191 \tl_clear:n \l ctex_autoindent_tl 192 \cs_set_eq:nn \ctex_if_autoindent_touched:f \use_none:n 193 }, 194 autoindent / unknown.code:n = 195 { 196 \ctex_set_default_ccwd:nn \l ctex_autoindent_tl {#1} 197 \cs_set_eq:nn \ctex_if_autoindent_touched:f \use_none:n 198 }, (End definition for autoindent. This function is documented on page 10.) indent 仅为兼容性保留, 已过时

36 第 15 节代码实现 indent.code:n = 200 { 201 \msg_warning:nnn { ctex } { deprecated-option } 202 { 203 The~ functionality~ has~ been~ removed.\\ 204 It's~ better~ to~ set~ the~ heading~ styles~ via~ `afterindent'~ 205 options.~ 206 } 207 }, 208 indent.value_forbidden:, 209 noindent.code:n = 210 { 211 \msg_warning:nnn { ctex } { deprecated-option } 212 { 213 The~ functionality~ has~ been~ removed.\\ 214 It's~ better~ to~ set~ the~ heading~ styles~ via~ `afterindent'~ 215 options. 216 } 217 }, 218 noindent.value_forbidden:, (End definition for indent. This function is documented on page 27.) GBK UTF8 219 GBK.code:n = { \tl_set:nn \l ctex_encoding_tl { GBK } }, 220 UTF8.code:n = { \tl_set:nn \l ctex_encoding_tl { UTF8 } }, 221 GBK.value_forbidden:, 222 UTF8.value_forbidden:, (End definition for GBK and UTF8. These functions are documented on page 6.) fontset 初始值为空 若用户未指定, 则根据操作系统载入对应字体配置, 可以区分 Windows Mac OS X 和其它 223 fontset.tl_gset:n = \g ctex_fontset_tl, 224 nofonts.code:n = 225 { 226 \msg_warning:nnn { ctex } { deprecated-option } 227 { 228 Option~ `fontset=none'~ is~ set.~ It~ is~ better~ to~ use~ 229 fontset~ option. 230 } 231 \keys_set:nn { ctex / option } { fontset = none } 232 }, 233 adobefonts.code:n = 234 { 235 \msg_warning:nnn { ctex } { deprecated-option } 236 { 237 Option~ `fontset=adobe'~ is~ set.~ It~ is~ better~ to~ use~ 238 fontset~ option. 239 } 240 \keys_set:nn { ctex / option } { fontset = adobe } 241 }, 242 winfonts.code:n = 243 { 244 \msg_warning:nnn { ctex } { deprecated-option } 245 { 246 Option~ `fontset=windows'~ is~ set.~ It~ is~ better~ to~ use~ 247 fontset~ option. 248 } 249 \keys_set:nn { ctex / option } { fontset = windows } 250 }, 251 nofonts.value_forbidden:, 252 winfonts.value_forbidden:, 253 adobefonts.value_forbidden:,

37 第 15 节代码实现 37 (End definition for fontset. This function is documented on page 7.) zhmap 254 zhmap.choice:, 255 zhmap.default:n = { true }, 256 zhmap / zhmcjk.code:n = 257 { 258 \bool_gset_true:n \g ctex_zhmcjk_bool 259 \cs_gset_eq:nn \ctex_zhmap_case:nnn \use_i:nnn 260 }, 261 zhmap / true.code:n = 262 { 263 \bool_gset_false:n \g ctex_zhmcjk_bool 264 \cs_gset_eq:nn \ctex_zhmap_case:nnn \use_ii:nnn 265 }, 266 zhmap / false.code:n = 267 { 268 \bool_gset_false:n \g ctex_zhmcjk_bool 269 \cs_gset_eq:nn \ctex_zhmap_case:nnn \use_iii:nnn 270 }, 271 nozhmap.code:n = 272 { 273 \msg_warning:nnn { ctex } { deprecated-option } 274 { Option~ `zhmap=false'~ is~ set. } 275 \keys_set:nn { ctex / option } { zhmap = false } 276 }, 277 nozhmap.value_forbidden:, (End definition for zhmap. This function is documented on page 27.) punct 设置标点符号输出格式 278 punct.tl_set:n = \l ctex_punct_tl, 279 punct.default:n = { quanjiao }, 280 punct.initial:n = { quanjiao }, 281 nopunct.code:n = 282 { 283 \msg_warning:nnn { ctex } { deprecated-option } 284 { Option~ `punct=plain'~ is~ set. } 285 \keys_set:nn { ctex / option } { punct = plain } 286 }, 287 nopunct.value_forbidden:, (End definition for punct. This function is documented on page 27.) space 288 space.choices:nn = 289 { true, auto, false } 290 { 291 \exp_args:nx \ctex_at_end:n 292 { \keys_set:nn { ctex } { space = \l_keys_choice_tl } } 293 }, 294 space.default:n = { true }, 295 nospace.code:n = 296 { 297 \msg_warning:nnn { ctex } { deprecated-option } 298 { Option~ `space=false'~ is~ set. } 299 \keys_set:nn { ctex / option } { space = false } 300 }, 301 nospace.value_forbidden:, (End definition for space. This function is documented on page 27.) heading 302 heading.bool_set:n = \l ctex_heading_bool,