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 各自的 子目录中手动下载和安装它们

当安装 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