update the docs

README.md

@@ -1,5 +1,21 @@
 # cn-xcpc-docs
 
-## 推荐食用指南
+## 食用指南
 
-system > domserver + judgehost > cds > presentation + resolver + coachview + icpc-live
+system：选手机环境的安装与配置
+
+domserver：Domjudge 服务端的安装与配置
+
+judgehost：Domjudge 评测端的安装与配置
+
+cds：ICPC Tools 中的 Contest Data Server 工具，是使用其他工具的核心 API
+
+resolver：滚榜工具
+
+presentation：大屏幕工具链
+
+coachview：远程显示选手机桌面与摄像头的工具
+
+icpc-live：直播 layout 工具
+
+board：外榜

cds.md

@@ -4,6 +4,12 @@
 
 wlp.CDS-2.1.2100
 
+## 环境
+
+Ubuntu 18.04.3 LTS
+Domjudge 7.1.1
+jre8
+
 ## 在 Domjudge 中创建 cds 用户
 
 在 Domjudge 中创建一个拥有 `API reader`、`API writer` 与 `Source code reader` 权限的用户并设置其密码。

coachview.md

@@ -3,3 +3,20 @@
 ## 版本
 
 coachview-2.1.2100
+
+## 环境
+
+Ubuntu 18.04.3 LTS
+wlp.CDS-2.1.2100
+
+## 配置选手机 VLC
+
+## 配置 CDS
+
+## 启动
+
+## 在 icpc-live 中使用
+
+详见 `icpc-live` 文档。
+
+## Troubleshooting

domserver.md

@@ -6,7 +6,7 @@ Domjudge 7.1.1
 
 ## 环境
 
-Ubuntu 18.04.3 LTS，全新安装的系统
+Ubuntu 18.04.3 LTS
 
 ## 准备工作
 
@@ -162,4 +162,4 @@ sudo systemctl restart apache2
 
 访问 home 页面，点 Contests，点左下角的 add 按钮进行添加。
 
-## Troubleshooting
+## Troubleshooting

icpc-live.md

@@ -1 +1,69 @@
 # icpc-live
+
+## 版本
+
+cn-xcpc-tools/icpc-live-v2
+OBS Studio 24.0.3 + win-overlaymaster 插件
+
+## 环境
+
+Windows 10 1903
+jdk8
+Apache Maven 3.6.2
+wlp.CDS-2.1.2100
+Noto Sans CJK JP Normal（为所有用户安装）
+
+## 安装与编译 icpc-live 及其依赖
+
+```shell
+git clone https://github.com/cn-xcpc-tools/icpc-live-v2
+cd icpc-live-v2
+mvn install
+```
+
+## 配置
+
+首先从 `icpc-live/config/sample` 中将 `events.properties` 与 `mainscreen.properties` 复制到 `icpc-live/config`。
+
+### icpc-live/config/events.properties
+
+* login 与 password
+
+设置为 CDS 的 admin 用户。
+
+* url
+
+`https://cds/api/contests/{id}`
+
+* problemsNumber
+
+设置为题目数量。
+
+### icpc-live/src/main/resources/users.data
+
+为 Web 导播台设置用户名与密码，格式为 `{username}:{password}`。
+
+## 启动
+
+运行 `webserver.bat`，在其开始读取 CDS API 后运行 `main-screen.bat`，在 `c:\work\image.bin` 生成后运行 OBS 并添加 `Overlay Master` 项。
+
+## 导播台
+
+由 `http://127.0.0.1:8080` 进入导播台。
+
+* 在 Advertisment 中设置 `#Clock#` 即可在左下角显示比赛时间。
+
+* 在 Creeping Line 中设置 `#Standings#` 即可在底部黑条中显示靠前名次的滚动排行榜。
+
+* 在 Standing 中可控制完整排行榜的显示和隐藏。
+
+## Troubleshooting
+
+* icpc-live 不会读取 team 的隐藏设置
+
+沈阳站时的临时方案为在源码中将系统自带 DOMjudge 用户的提交均设置为封榜后的“？”状态。
+应考虑修改 EventLoader 部分源码以将该用户在 team 的读入时跳过，或在启动 CDS 前保证该用户不在该比赛中。
+
+## 未解决的问题
+
+* OBS 的“图像幻灯片放映”功能不能正确地循环所有选择的图像文件，而是在某几张图像内反复播放。

judgehost.md

@@ -6,8 +6,7 @@ Domjudge 7.1.1
 
 ## 环境
 
-Ubuntu 18.04.3 LTS，全新安装的系统（Judge 机）。
-关于 Ubuntu 的批量网络安装方式，可以参考[这篇博客](https://blog.cool2645.com/posts/2018-icpc-shenyang-env-config-log/)。
+Ubuntu 18.04.3 LTS
 
 ## 准备工作
 
@@ -22,12 +21,9 @@ sudo apt install make sudo debootstrap libcgroup-dev lsof \
         php-cli php-curl php-json php-xml php-zip procps \
         gcc g++ openjdk-8-jre-headless \
         openjdk-8-jdk ghc fp-compiler \
-        libcurl4-gnutls-dev libjsoncpp-dev libmagic-dev \
-        supervisor
+        libcurl4-gnutls-dev libjsoncpp-dev libmagic-dev
 ```
 
-注：这里的 supervisor 用来管理 judgehost 的评测进程，如果你愿意，也可以换成现代系统自带的 systemd 来管理。
-
 ### 编译 Domjudge
 
 ```shell

presentation.md

@@ -1 +1,39 @@
 # presentation 工具链（ICPC Tools）
+
+## 版本
+
+presentations-2.1.2100
+presentationAdmin-2.1.2100
+
+## 环境
+
+（presAdmin机）Ubuntu 18.04.3 LTS
+（client机）Windows 10 1903
+jre8
+wlp.CDS-2.1.2100
+
+## presentationAdmin（架设到方便操作的机器上）
+
+`presAdmin https://cds presAdmin {password}`
+
+## presentations（架设到连接大屏幕的机器上，并接入 CDS 所在网络）
+
+`client {presentation-id，自选，多开时不重复即可} https://cds presentation {password}`
+
+## 使用
+
+在 `presAdmin` 中选中需要控制的 presentation，并在右侧选择需要令其显示的内容，然后点击 `Apply` 按钮。
+
+## Troubleshooting
+
+* `presAdmin` 右侧不显示可选的内容
+
+排查 CDS 是否正常运行、CDS 配置是否正确、`presAdmin` 是否与 CDS 在网络上能够通信。
+
+* `client` 启动后，`presAdmin` 中未显示该 presentation
+
+排查 `client` 是否与 CDS 在网络上能够通信。
+
+* 沈阳站场馆大屏幕的比例为 32:9，仅显示所连接 16:9 机器画面的上半部分
+
+此时在 `presAdmin` 中菜单栏内设置 presentation 的显示区域为 `(0,0,1920,540)` 即能使其完全在大屏幕上显示出来。

resolver.md

@@ -4,6 +4,12 @@
 
 resolver-2.1.2100
 
+## 环境
+
+Windows 10 1903
+Domjudge 7.1.1
+jre8
+
 ## 导出 event-feed
 
 在 Domjudge 中设置打星队为隐藏，之后对比赛进行 Finalize 操作，再访问 `http://domjudge/api/contests/{id}/event-feed?stream=false` 下载 event-feed。
@@ -18,7 +24,7 @@ award /path/of/event-feed --medals {gold} {silver} {bronze} --rank 3 --fts true
 
 ## 手工修改生成后的 event-feed
 
-* 删除不在榜单上出现的 team（尤其是带有容易引发 `resolver` 报错的空字段的）
+* 删除不在榜单上出现的 team （尤其是带有容易引发 `resolver` 报错的空字段的）
 
 * 设置打星队伍（见 `https://github.com/yang-er/dj_helper/blob/master/Resolver/README.md`）
 
@@ -28,4 +34,10 @@ award /path/of/event-feed --medals {gold} {silver} {bronze} --rank 3 --fts true
 resolver /path/of/event-feed.award --fast 0.15
 ```
 
+其中 `--fast` 参数的值影响滚榜时进行两次动画的间隙时间。
+
 ## Troubleshooting
+
+* 沈阳站场馆大屏幕的比例为 32:9，仅显示所连接 16:9 机器画面的上半部分
+
+此时在运行 `resolver` 时为其设置 `--display 2` 能使其在屏幕左上 1/4 的区域显示滚榜。

system.md

@@ -2,10 +2,10 @@
 
 ## 版本
 
-Ubuntu 18.04.3 LTS，WF2020 镜像源。
+Ubuntu 18.04.3 LTS + WF 镜像源 20190130
 
 ## Troubleshooting
 
-* WF2020 镜像 VSCode 插件自带 keymap 并默认开启
+* VSCode 插件自带 keymap 并默认开启
 
-* WF2020 镜像 Pycharm 默认未配置 python 编译环境并默认开启 vim keymap。
+* Pycharm 默认未配置 python 编译环境并默认开启 vim keymap。