SJTUTeX 是 SJTUThesis 项目使用的文档类集,
包含上海交通大学学位论文文档类 sjtuthesis
,以及普通文档类 sjtuarticle
和 sjtureport
。
对于 LaTeX 模版的更改,都应该在这个 repo 中进行,而后把解包后的结果同步到 SJTUThesis。
本文档类集基于 LaTeX3 编写,使用说明详见 发布区 文档。
SJTUTeX 和 SJTUThesis 项目共享讨论区与社区写作模式。如遇问题,请在 SJTUThesis 中反馈。
如果你正在使用 TeX Live 或 MacTeX,可以在终端输入下面的命令安装至本地发行版中。
cd sjtutex
l3build install
也可以将 发布区 的 sjtutex.tds.zip
手动解压到发行版的 TDS 目录下。
开发主要在 sjtutex
文件夹中进行,生成发布包会进行解包、测试、文档等全部流程。
cd sjtutex
l3build unpack # 解包
l3build doc # 文档
l3build check # 测试
l3build ctan # 生成发布包
文档类主要代码在 source/sjtutex.dtx
中,需要解包之后才能够使用。
l3build unpack
解包结果将置于 build/unpacked
(含有 dtx 文件)和 build/local
(不含 dtx 文件) 文件夹下。
从 source/sjtutex.dtx
编译出文档类文档 sjtutex.pdf
可以使用
l3build doc
请注意文档类文档
sjtutex.pdf
的正确编译需要使用 Noto CJK 字体(即ctex
字体配置中的fontset=ubuntu
)。
文档类还含有多个测试用例(比如 sample-thesis-zh
),主要存放于 testfiles
文件夹中(支持文件存放于 testfiles/support
文件夹)。
测试全部示例使用
l3build check
上面的过程默认隐藏编译细节。为了查看单个测试用例 <sample>
的编译细节,可以使用
l3build check <sample>
测试的 PDF 结果生成于 build/result
文件夹。
请使用尽可能新版本的 l3build,更多细节请参见 l3build 文档(
texdoc l3build
)。
上海交通大学校徽图片(sjtu-vi-logo-red.pdf
等)的版权归上海交通大学所有。
其他部分使用 LPPL 授权。