# Tuack-NG

> 新一代出题工具

重构后的 tuack 项目，旨在提供更加高效和轻量的出题体验。

## Table of Contents

### 工程结构

- [工程结构](/app/project/overview.md): Tuack-NG **比赛 - 比赛日 - 题目** 的三层工程结构。
- [工程配置文件](/app/project/config.md): 关于 Tuack-NG 三层工程的配置文件。
- [比赛注意事项](/app/project/precaution.md): Tuack-NG 比赛目录下的注意事项文件。

#### 数据

- [数据与测试用例](/app/project/data/overview.md): Tuack-NG 中测试用例、数据与标准程序的基本概念。
- [数据点配置](/app/project/data/configure.md): 关于 Tuack-NG 中数据点、样例、子任务及相关功能的配置。

### 生成

- [生成工程](/app/gen/overview.md): 生成 Tuack-NG 的三层工程结构，以及自动检测样例、数据与测试用例。

### 渲染题面

- [渲染题面](/app/ren/overview.md): 使用 `tuack-ng ren` 将题面渲染为指定格式的 PDF 或 Markdown。
- [渲染目标](/app/ren/targets.md): Tuack-NG 目前支持五种渲染目标。

#### 题面格式

- [题面语法](/app/ren/format/syntax.md): Tuack-NG 支持的 Markdown 语法参考。
- [MiniJinja 模板](/app/ren/format/template.md): Tuack-NG 支持的模板语法一览。
- [Lua 表格](/app/ren/format/lua.md): Tuack-NG 支持使用 Lua 脚本在题面中生成 Markdown 表格，适用于动态数据范围表等场景。

### 测试

- [测试题目](/app/test/overview.md): 使用 `tuack-ng test` 测试测试用例程序，验证标程和各种解法是否达到预期分数。
- [测试配置](/app/test/config.md): 通过题目的 `conf.json` 配置测试用例和测试行为。
- [SPJ 编写参考](/app/test/spj.md): Special Judge（SPJ）用于评测答案不唯一的题目，Tuack-NG 采用 Testlib 格式的 SPJ。

### 数据生成

- [生成数据](/app/dmk/overview.md): 调用生成器生成输入数据，并调用标程生成输出数据。
- [数据生成配置](/app/dmk/config.md): 数据生成相关的配置字段说明。
- [随机种子](/app/dmk/seed.md): Tuack-NG 使用 `.seed` 文件记录每个测试点的随机种子，确保数据可复现。
- [数据生成器规范](/app/dmk/generator.md): Tuack-NG 使用 C++ 程序作为数据生成器，驱动测试数据的自动生成。

### 校验

- [校验](/app/validate/overview.md): 使用 Validator 校验题目的输入数据是否合法。
- [校验配置](/app/validate/config.md): Validator 的编写与配置。
- [校验规范](/app/validate/spec.md): Validator 的编写规范。

### 导出

- [导出](/app/dump/overview.md): 将题目导出到评测系统格式。
- [导出目标](/app/dump/targets.md): Tuack-NG 支持的导出目标以及各自的局限性。

### 文档检查

- [文档检查](/app/doc/overview.md): 对题面进行质量检查和格式化。
- [检查规则](/app/doc/check-format.md): 检查文档中可能的不规范问题。
- [配置验证](/app/doc/validate.md): 显示配置文件加载时的消息树。

### 专题

- [交互题](/app/special/interactive/overview.md): Tuack-NG 交互题的配置、测试与数据生成。
- [从 Tuack 迁移](/app/special/migrate-tuack/overview.md): 将你的工程从 Tuack 迁移到 Tuack-NG。

### 常见问题

- [FAQ](/app/faq/faq.md): Tuack-NG 使用时的常见问题。
- [获取调试信息](/app/faq/debug-info.md): 获取 Tuack-NG 的调试信息。

### Other

- [Panic 报告](/app/faq/panic.md): 关于 Tuack-NG 发生 Panic 时的进一步指引。
- [安装](/app/install.md): 安装 Tuack-NG 到你的系统。
- [安装](/archive/guide/install.md)
- [批量修改配置](/archive/guide/conf.md)
- [数据与评测](/archive/guide/data-and-test/overview.md)
- [样例](/archive/intro/sample.md)
- [测试用例，数据与标准程序](/archive/guide/data-and-test/test-data-std.md)
- [测试题目](/archive/guide/test.md)
- [渲染工程](/archive/guide/ren.md)
- [生成工程](/archive/docs/gen.md)
- [生成工程](/archive/guide/gen.md)
- [第一个 PDF](/archive/intro/first-pdf.md)
- [运行测试](/archive/guide/data-and-test/test.md)
- [造数据](/archive/guide/dmk.md)
- [配置数据点](/archive/guide/data-and-test/configure-data.md)
- [题面格式](/app/ren/statement.md): 关于 Tuack-NG 的题面格式参考。
- [题面格式](/archive/guide/statement.md)