Skip to content

sjtug/SJTUTeX

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SJTUTeX

CTAN

简介

SJTUTeX 是 SJTUThesis 项目使用的文档类集, 包含上海交通大学学位论文文档类 sjtuthesis,以及普通文档类 sjtuarticlesjtureport。 对于 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 授权。