当前位置：首页 > news >正文

Tuack 生成 OI 比赛题目 PDF 笔记

news 2025/12/15 10:33:25

Part 1. Tuack 的基本介绍

Tuack，是一个由来自 THU 的大佬 Mulab11 开发的，用于造算法竞赛题目的工具。

你可以用它：

导出 PDF、Markdown、HTML 等多种不同格式，NOI、CPC 等不同风格的题面。
简单的出题人自评测功能，用于对比不同出题人、验题人程序的得分情况。
导出 LemonLime、Arbiter 等多种不同评测平台的评测包。
导入测试数据。
导入 docx、Markdown 等多种不同格式的题面，并进行简单的样例提取、表格提取等。
简单的题面格式检查，例如部分标点符号用法、公式用法等。
题面书写辅助工具，例如数据参数引用、整数公式化输出、外部文件引用等。
完成有关出题的其它东西

Part 2. 安装 Tuack

因为 Tuack 基于 Python 3，所以你需要事先安装 Python

方法1：pip

如果你安装了 Python 的包管理器 pip，你可以直接使用 pip 安装 Tuack 的最新稳定版。

pip install tuack

如果你没有安装 pip，可以使用下列方式安装：

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python get-pip.py

方法2：`setup.py+pip`

如果你需要安装正在开发的版本，或某些原因无法使用 pip，可以使用这样的方法：

先在本地 git clone Tuack 原工程，或下载并解压工程。然后在本工程的主目录下运行下列命令（其中 ??? 是版本号）

python setup.py sdist
pip install dist/tuack-???.tar.gz

方法3：`setup.py`

在本地 git clone Tuack 原工程，或下载并解压工程。然后运行

python setup.py install

这个方法不会自动安装依赖，因此不推荐。如果你长期使用 Tuack，并且要快速切换成最新的开发版本时可以使用这个方法。在具体的使用中你需要手动安装报错的库。

为了正常使用 Tuack，你可能需要手动安装如下应用：

pandoc，这个工具可以转换不同的文本格式，用于输出题面。
\(\LaTeX\) 相关工具（如：XeLaTeX，MikTeX 等）只用于导出 pdf 格式的题面，且巨大无比，因此不预装。

使用方法

Step 1

明显地，你需要先新建一个文件夹专门用于你的比赛。

Step 2

打开 cmd，将操作路径改为你的比赛的路径，方法为 cd <DIR>，<DIR> 在这里代之你的比赛文件夹的路径。

Step 3

使用 python –m tuack.gen contest 命令创建比赛

Step 4

使用 python –m tuack.gen day day0 [day1]...[dayn] 命令创建比赛日（[xxx] 指你可以额外输入 xxx 的参数，但也可以不用。这里指你可以选择创建这个比赛日，也可以不用）

Step 5

进入比赛日的文件夹，方法同 Step 2，<DIR> 在这里应该是 dayX，其中 X 是一个整数

Step 6

使用 python –m tuack.gen problem A [B] [C]... 命令创建若干个分别名为 A，B，C... 的题目，其中的名字不一定要是 A B C 这些字符，但似乎（？我没测过）要用英文名

Step 7

进入题目的文件夹

Step 8

编辑 statement 文件夹下的 zh-cn.md 以修改中文题面，如果你要多语言则在 statement 文件夹下创建 en.md 表示英语题面等。可以适当看一下它的 zh-cn.md 里的内容，Tuack 有些东西的渲染方式和一般的 \(\mathrm{Markdown}\) 不一样。

放样例放在 down 文件夹，放表格放在 tables 文件夹，其它的可以参考自动生成时的 zh-cn.md。

Step 9

回到你的比赛总文件夹，然后使用 python –m tuack.ren noi –o Linux 指令渲染题面，如果不是生成 CCF 风格的题面，可以把 noi 换成 tuoi，tupc，ccpc，ccc-tex，tuoj，ccc-md，loj，uoj，tsinsen-oj，thuoj 之类的风格，具体可以看官方 Wiki。对于 -o 后的操作系统，可以换成 Linux、Windows 和 Darwin（MacOS）的其中之一