# 3.17 (重新)生成文档和团队手册

Domjudge 的 doc 目录下有三组文档:

* **管理员手册(admin-manual)**
  * 对于系统管理员(本文档)
* **裁判手册(judge-manual)**
  * 对于裁判, 描述前端裁判界面并提供有关该系统的一些一般信息
* **队员手册(team-manual)**
  * 对于队员, 解释如何使用系统以及有哪些限制

队员手册仅以 PDF 格式提供, 必须在配置系统后从 `doc/team` 中的 LaTeX 源构建; 包含预先构建的队员手册, 但请注意, 它包含特定的站点配置/示例值, 例如队员 web 界面 URL 和评测设置(如内存限制); 我们强烈建议你重新构建队员手册以包含特定于站点的设置, 并修改它以反映你的竞赛特定环境和规则

除了标准的 LaTeX 安装, 队员手册还需要 `svn` 和 `expdlist` 包; 这些都可以在任何现代 Linux 发行版的 `texlive-latex-extra` 软件包中的 `TeX Live` 中获得; 或者, 你可已从 [http://mirror.ctan.org/macros/latex/contrib](http://mirror.ctan.org/macros/latex/contrib) 各自的 子目录中手动下载和安装它们

当安装 DOMjudge 的 `docs` 部分并设置特定于站点的配置时, 可以使用 `docs/team` 下的 `genteammanual` 命令生成队员手册; PDF 文档将放在当前目录或作为参数给出的目录中; 在类 Debian 系统中的命令如下:

```
sudo apt install make texlive-latex-extra texlive-latex-recommended texlive-lang-european
cd <INSTALL_PATH>/docs/team
./genteammanual [targetdir]
```

管理员手册和裁判手册以 PDF 和 HTML 格式提供, 并由 SGML 源代码预先构建; 通常不需要重新构建这些; 要在类 Debian 系统上重新构建它们, 应执行:

```
sudo apt install linuxdoc-tools make zip ghostscript groff texlive-latex-recommended
make -C doc/admin docs
make -C doc/judge docs
```
