https://wiki.tfcis.org/api.php?action=feedcontributions&feedformat=atom&user=Tobiichi3227
TFcisWiki - 使用者貢獻 [zh-tw]
2026-04-15T01:51:23Z
使用者貢獻
MediaWiki 1.39.2
https://wiki.tfcis.org/index.php?title=TOJ&diff=471
TOJ
2025-08-09T05:45:25Z
<p>Tobiichi3227：</p>
<hr />
<div>[[Category:TOJ]]<br />
<br />
https://toj.tfcis.org/oj/<br />
<br />
* 社團練習用的Online Judge<br />
* 由[[T13]]的[[吳哲宇]]([[pzread]])開發<br />
* [[T19]]的[[lys0829]]於2017年將judge更新<br />
* [[T24]]的[[tobiichi3227]]與[[ccccchhhheeenng]]於2022年將後端Server的軟硬體更新<br />
<br />
== 出題 ==<br />
以下內容均為 Problem Package 的形式，TOJ 已經支援用 UI 新增題目了<br />
=== 一般題目 ===<br />
limit欄位的 default 一定要存在，其餘可以填寫 TOJ 支援的編譯器 (gcc, g++, clang, clang++, python3, rust, java)<br />
<br />
記憶體與輸出限制的單位是 KiB, 時間限制的單位是 ms<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"time": 1000,<br />
"memory": 65536,<br />
"output": 65536,<br />
},<br />
"python3": {<br />
"time": 2500,<br />
"memory": 524288,<br />
"output": 65536,<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
check欄位可以填 "diff", "diff-strict"<br />
{| class="wikitable"<br />
|-<br />
! Type !! 解釋<br />
|-<br />
| diff || 寬鬆比對<br />
|-<br />
| diff-strict || 嚴格比對<br />
|}<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": false,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5, "hard-1"<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
data的部份是測資檔案名稱<br />
需將檔案放到 /res/testdata 下面<br />
<br />
輸入輸出檔都需要 (.in, .out)<br />
<br />
=== Makefile題目 (編譯互動題) ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": true,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
在 res/make 新增 Makefile 與 要編譯的檔案<br />
;/res/make/Makefile<br />
<syntaxhighlight lang="make"><br />
default:<br />
g++ main.cpp stub.cpp -o $(OUT)<br />
</syntaxhighlight><br />
stub.cpp 可以自己換成其他要一起編譯的檔案，編譯選項可以自行修改<br />
<br />
=== CMS/Testlib Checker ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"check": "cms",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
會傳入三個參數，分別為測資輸入，測資輸出，答案輸入<br />
<syntaxhighlight lang="C++"><br />
#include <fstream><br />
int main(int argc, char** argv) {<br />
std::ifstream test_in(argv[1]);<br />
std::ifstream test_out(argv[2]);<br />
std::ifstream ans_in(argv[3]);<br />
<br />
// C<br />
FILE* test_in_ptr = fopen(argv[1], "r");<br />
FILE* test_out_ptr = fopen(argv[2], "r");<br />
FILE* ans_in_ptr = fopen(argv[3], "r");<br />
<br />
fclose(test_in_ptr);<br />
fclose(test_out_ptr);<br />
fclose(ans_in_ptr);<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.py<br />
<syntaxhighlight lang="python"><br />
#!/bin/python3<br />
import sys<br />
<br />
test_in = open(sys.argv[1])<br />
test_out = open(sys.argv[2])<br />
ans_in = open(sys.argv[3])<br />
<br />
test_in.close()<br />
test_out.close()<br />
ans_in.close()<br />
</syntaxhighlight><br />
<br />
==== Verdict Message (Checker Message) ====<br />
對標準錯誤 (STDERR) 輸出 verdict message<br />
<br />
C/C++<br />
<syntaxhighlight lang="C++"><br />
#include <iostream><br />
std::cerr << "checker message" << std::endl;<br />
<br />
#include <cstdio><br />
fprintf(stderr, "checker message");<br />
</syntaxhighlight><br />
<br />
Python<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
print("checker message", sys.stderr)<br />
</syntaxhighlight><br />
<br />
==== Special Score & Status ====<br />
對標準輸出 (STDOUT) 輸出 Special Score & Status，輸出標準如下<br />
ScoreType;Score;Status<br />
<br />
===== Score =====<br />
ScoreType 可以是 NONE, CMS, CF<br />
<br />
NONE 代表 Judge 不會理會 Score 的值<br />
<br />
CMS 代表 Judge 會將 該題子任務分數乘上 Score (與 CMS 的 GroupMin 相同)，且 Score 範圍應該從 0.0 到 1.0，大於 1.0 將設定為 1.0，小於 0.0 將設定為 0.0<br />
<br />
CF 代表 Judge 會直接用 Score 覆蓋該子任務分數<br />
<br />
===== Status =====<br />
Status 可以是 TOJ 所支援的所有 Status (AC, PC, WA, RE, RESIG, TLE, MLE, OLE, CE, CLE, SJE, IE)<br />
<br />
如果 Status 為空 或 不在支援的 Status 中將按照 Checker 回傳值決定狀態 (return 0 為 AC，其餘為 WA)<br />
<br />
下面列出幾個作為參考<br />
{| class="wikitable"<br />
|-<br />
! STDOUT String !! Score !! Status<br />
|-<br />
| CMS;0.5;PC || 子任務分數 * 0.5 || PC (Partial Correct)<br />
|-<br />
| CF;32.27;AC || 32.27 || AC (Answer Correct)<br />
|-<br />
| NONE;3131;WA || 子任務分數 || WA (Wrong Answer)<br />
|-<br />
| CF;32.27; || 32.27 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| ;; || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| (沒有任何輸出) || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|}<br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
# python<br />
# cp check.py check<br />
# chmod +x check<br />
</syntaxhighlight><br />
<br />
=== IORedir ===<br />
將[https://github.com/TFcis/Problem-setting-tools/blob/master/TOJ-problem-example/conf.json conf.json]中的 check 從 diff 改成 ioredir，及設定 metadata 如下。<br />
如果 Checker 的 STDOUT 或 STDERR 沒有被佔用且有輸出內容，那 Verdict Message (Checker Message) 將會為該內容 (如果兩個同時都有，STDERR 優先於 STDOUT<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON">{<br />
"check": "ioredir",<br />
"metadata": {<br />
"redir_test": {<br />
"pipeout": 1,<br />
"testin": 0,<br />
"testout": -1,<br />
"pipein": -1<br />
},<br />
"redir_check": {<br />
"ansin": 2,<br />
"testin": -1,<br />
"pipeout": 0,<br />
"pipein": -1<br />
}<br />
}<br />
}</syntaxhighlight><br />
<br />
如果要用 ioredir 實現互動題， metadata 可以這樣寫<br />
<br />
從 STDERR 讀入測資，對 STDOUT 輸出測資<br />
從 STDIN 讀入答案<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"redir_test": {<br />
"pipein": 0,<br />
"testin": -1,<br />
"pipeout": 1,<br />
"testout": -1<br />
},<br />
"redir_check": {<br />
"ansin": -1,<br />
"pipein": 1,<br />
"testin": 2,<br />
"pipeout": 0<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
分別從答案及輸出分別讀入long double。<br />
<syntaxhighlight lang="C++"><br />
long double Answer, Output;<br />
FILE *ansf = fdopen(2, "r");<br />
<br />
scanf("%Lf", &Output);<br />
fscanf(ansf, "%Lf", &Answer);<br />
</syntaxhighlight><br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
</syntaxhighlight><br />
<br />
參考 https://hackmd.io/s/BkHdt57I<br />
<br />
=== Polygon to TOJ ===<br />
請參考 [https://github.com/TFcis/cf2toj cf2toj]<br />
<br />
=== TPS to TOJ ===<br />
請參考 [https://github.com/TFcis/tps2toj tps2toj]<br />
<br />
=== CMS to TOJ ===<br />
請參考 [https://github.com/TFcis/cms2toj cms2toj]<br />
<br />
=== 小技巧 ===<br />
==== OI制 (APCS) ====<br />
可以只上傳範例測資，並把該子任務分數設定為 0<br />
<br />
==== 負分 ====<br />
TOJ其實可以設定子任務分數為負數，但可能會有很多問題<br />
Scoreboard 應該選擇 IOI2013<br />
<br />
== 參見 ==<br />
* [[TOJ API]]：API文檔<br />
* [https://github.com/pzread/judge judge原始碼]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=TPS&diff=470
TPS
2025-08-01T06:36:09Z
<p>Tobiichi3227：</p>
<hr />
<div>TPS（Task Preparation System）是一套可以方便產生題目測試資料以及題本的工具，關於 TPS 可以參考以下的 GitHub Repo：<br />
* TPS Example：https://github.com/TNFSH-Programming-Contest/TPS-example<br />
* IOI 2017 TPS：https://github.com/ioi-2017/tps<br />
<br />
{{Memo|本頁面主要使用 TNFSH-Programming-Contest/cms-environment-testing-problem<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem</ref> 的 pB<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB</ref> 作為範本。|}}<br />
<br />
[[File:Icon tools.svg|20px]] 以下有此標誌的說明需要 CMS 系統管理員操作，出題者可忽略此說明。<br />
<br />
{{reflist-talk}}<br />
<br />
== 資料夾結構 ==<br />
=== 根目錄 ===<br />
==== .github/workflows ====<br />
GitHub 自動化流程設定檔。<br />
<br />
==== pX ====<br />
pA、pB 等{{slink||題目資料夾}}。<br />
<br />
==== .problems.json ====<br />
記錄{{slink||題目資料夾}}列表，供 GitHub Actions {{slink||自動建置}}使用，通常不應手動修改。<br />
<br />
==== Makefile ====<br />
[[File:Icon tools.svg|20px]] 匯入 CMS 的指令<br />
<br />
==== README.md ====<br />
主要在 GitHub 頁面上提供常用連結。<br />
<br />
==== cover.tex ====<br />
題本封面。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/cover.tex<br />
<br />
==== appendix.tex ====<br />
題本附錄。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/tps-starter/blob/main/appendix.tex<br />
<br />
==== template.tex ====<br />
題本內文模板，通常無需修改。<br />
<br />
=== 題目資料夾 ===<br />
==== attachments ====<br />
放在此處的所有檔案將會上傳到 CMS 上，供參賽者在題目敘述頁的「附件」，通常僅會在 pA 的附件放置{{slink||合併題本}}。<br />
<br />
[[File:Crystal Clear action run.png|20px]] 本目錄內容通常由程式自動產生。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pA/attachments<br />
<br />
==== gen ====<br />
放置{{slink||產測資}}相關的所有檔案。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/gen<br />
<br />
==== gen/manual ====<br />
{{See also|#手產測資檔}}<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/gen/manual<br />
<br />
==== gen/data ====<br />
{{See also|#產測資指令}}<br />
<br />
==== scripts ====<br />
[[File:Crystal Clear action run.png|20px]] 本目錄保存 TPS scripts，不需修改。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/scripts<br />
<br />
==== solution ====<br />
{{See also|#標程}}<br />
<br />
==== statement ====<br />
題本相關檔案，包含原始碼、圖片、{{slink||建置題本}}產生的 PDF。<br />
<br />
==== statement/index.md ====<br />
{{See also|#題目敘述}}<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/statement/index.md<br />
<br />
==== tests ====<br />
{{slink||產測資}}後的檔案會存放於此，參見{{slink||建置測資}}。<br />
<br />
[[File:Crystal Clear action run.png|20px]] 本目錄內容由程式自動產生，不應手動編輯。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/tests<br />
<br />
==== validator ====<br />
{{See also|#驗測資程式}}<br />
<br />
==== problem.json ====<br />
題目的相關設定，參見{{slink||競賽名稱|題目名稱|題目英文名稱|題目編號|記憶體限制|時間限制}}。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/problem.json<br />
<br />
==== solutions-check.txt ====<br />
所有標程的執行結果報告。<br />
<br />
[[File:Crystal Clear action run.png|20px]] 本檔案由程式自動產生，不應手動編輯。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/solutions-check.txt<br />
<br />
==== solutions.json ====<br />
列出所有{{slink||標程}}及其 verdict，標記為 model_solution 的標程會用於{{slink||產測資}}。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/solutions.json<br />
<br />
==== subtasks.json ====<br />
列出所有的{{slink||子任務}}，及每個子任務所使用的{{slink||驗測資程式}}。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/subtasks.json<br />
<br />
== 準備GitHub Repo ==<br />
=== 建立GitHub Repo ===<br />
# 進入 tps-starter。<ref>https://github.com/TNFSH-Programming-Contest/tps-starter</ref><br />
# 點擊 Use this template。<ref>直接連結：https://github.com/TNFSH-Programming-Contest/tps-starter/generate</ref><br />
# 填寫Repo資訊<br />
#* Repository name 填入競賽英文名，例如「cms-environment-testing-problem」。<br />
#* Description 填入競賽中文名，例如「CMS環境測試題目通用版」。<br />
#* [[File:OOjs UI icon alert-destructive.svg|20px]] '''注意：'''可見度必須選擇 '''Private'''。<br />
#* 點擊 Create repository from template。<br />
# 開啟 Github Action 權限<br />
## 前往 Settings -> Actions -> General<br />
## 找到 Workflow permissions <br />
## 選取 Read and write Permissions 並保存設定<br />
# （可選）若要將 GitHub Repo 更新傳送到 Discord，請參考 [https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks Intro to Webhooks – Discord] 操作。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 建立題目資料夾 ===<br />
此操作在每個競賽通常僅需執行 1 次。<br />
# 進入由 tps-starter 建立的 GitHub repo。<br />
# 點擊 Actions。<br />
# 在 Workflows 段落，點擊 New problem。<ref>參考連結：https://github.com/TNFSH-Programming-Contest/TPS-example/actions/workflows/new-problem.yml</ref><br />
# 點擊 Run workflow，在 How many problems in this contest? 輸入要建立的題目數量。<br />
#* 如果已有 3 題，要再新增 1 題，直接輸入 4 即可，已建立的目錄會直接被略過。<br />
# 點擊藍色 Run workflow 按鈕。<br />
# 等待題目資料夾建立完成，約 1 分鐘。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 刪除題目資料夾 ===<br />
雖然這通常不會發生，但如果誤建過多題目等情況，需要刪除題目資料夾時，請務必完成以下所有操作：<br />
# 刪除{{slink||題目資料夾}}。<br />
# 從{{slink||.problems.json}}刪除題目編號。<br />
# 從{{slink||Makefile}}刪除對應題目的匯入指令。<br />
# 從{{slink||README.md}}刪除對應題目的連結。<br />
<br />
== 準備TPS資料 ==<br />
=== 競賽名稱 ===<br />
競賽名稱使用於：<br />
# CMS 參賽介面左上角。<br />
# 題本封面第一行。<br />
# 題本內文各頁的左上角。<br />
<br />
需寫入於：（範例為「CMS環境測試題目通用版 v1.1」）<br />
# {{slink||cover.tex}}。<br />
# 各題目{{slink||problem.json}}的 contest_name 欄位。<br />
# [[File:Icon tools.svg|20px]] CMS 管理系統的 Description 欄位。<br />
<br />
=== 題目名稱 ===<br />
題目名稱（problem title）使用於：<br />
# CMS 競賽概況的題目列表。<br />
# CMS 題目敘述頁面。<br />
# 題目標題（第一頁第一行）。<br />
# 該題目各頁右上角。<br />
<br />
需寫入於{{slink||problem.json}}的 title 欄位，範例為「Piñata」。<br />
<br />
=== 題目英文名稱 ===<br />
題目英文名稱（problem name）應足以讓所有命題人員識別個別題目即可，通常取自於中文題目名稱，並盡量僅使用一個英文詞，首字大寫，若需要兩個英文詞以上，則使用[[zhwiki:駝峰式大小寫|PascalCase]]。使用於：<br />
# CMS 競賽概況的題目列表。<br />
# CMS 題目敘述。<br />
# CMS 系統內部用來識別題目的 [[zhwiki:主鍵|Primary key]]。<br />
#* [[File:Icon tools.svg|20px]] 由於同一 CMS 系統上的名稱無法重複，若與其他競賽題目衝突<ref>https://github.com/cms-dev/cms/issues/765</ref>，建議加上競賽名稱的英文縮寫作為前綴（例如「2022P-」）。<br />
# 可能作為 GitHub repo 內的題目資料夾名稱。<br />
<br />
需寫入於{{slink||problem.json}}的 name 欄位，範例為「Pinata」。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 題目編號 ===<br />
題目編號（problem label）為 A, B, C... 的流水號，在決定題目順序後才會確定，使用於：（範例為「B」）<br />
# CMS 競賽概況的題目列表。<br />
# 題目標題（第一頁第一行）。<br />
# 該題目各頁右上角。<br />
# 該題目各頁頁碼處。<br />
<br />
=== 記憶體限制 ===<br />
需寫入於{{slink||problem.json}}的 memory_limit 欄位，單位為MB，範例為「512」MB。<br />
<br />
=== 時間限制 ===<br />
需寫入於{{slink||problem.json}}的 time_limit 欄位，單位為秒，範例為「1.0」秒。<br />
<br />
=== 標程 ===<br />
AC code（又稱官方解法、標程等）需放置在{{slink||solution}}資料夾內，檔名無限制。同時將該檔名寫入{{slink||solutions.json}}，格式請參照範本，verdict 必須標記為 model_solution，範例檔名為「ac.cpp」<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/solution/ac.cpp</ref>。<br />
<br />
其他 AC code 亦按照前述方式操作，verdict 必須標記為 correct。<br />
<br />
其他類型的錯誤解法亦按照前述方式操作，verdict 標記方式請參考官方說明<ref>https://github.com/ioi-2017/tps/tree/master/docs#solutionsjson</ref>及 tps script<ref>https://github.com/TNFSH-Programming-Contest/tps-task-templates/blob/93cff7e64a43f57450b26568194432e7b662be38/default/scripts/internal/invoke.py#L18</ref>。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 產測資 ===<br />
TPS 產測資方式與 Codeforces polygon 相同。測資可以使用手產測資檔案，亦可由程式亂數產生，亦可混合兩者。<br />
<br />
==== 手產測資檔 ====<br />
{{Memo|'''最佳實踐：'''<br />
# 僅在 [[:zhwiki:en:Edge case|edge case]] 使用手產測資檔，其他使用產測程式。<br />
# 範例測資亦可隨機產生，若想要手動指定，亦可使用手產測資檔。<br />
|}}<br />
<br />
手產測資檔應放置在{{slink||gen/manual}}資料夾內，檔名無限制，但建議副檔名為 .in。<br />
<br />
本範例有 2 個範例測資，其中一個使用手產測資檔 sample-01.in<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/gen/manual/sample-01.in</ref>，另一個為隨機測資。<br />
<br />
{{reflist-talk}}<br />
<br />
==== 產測資程式 ====<br />
{{Memo|'''重要：'''產測資程式必須<br />
# 使用命令列參數讀入測資組及測資點<ref>[https://en.cppreference.com/w/cpp/language/main_function Main function - cppreference.com]</ref><ref>[https://stackoverflow.com/questions/3024197/what-does-int-argc-char-argv-mean c++ - What does int argc, char *argv&#x5B;&#x5D; mean? - Stack Overflow]</ref>。<br />
# 使用[[zhwiki:stdout|標準輸出（stdout）]]，不可直接寫入檔案。<br />
# 執行一次僅輸出一筆測資。<br />
# 使用 testlib.h<ref>[https://codeforces.com/blog/entry/18291 Generators with testlib.h]</ref> 等設定亂數種子的方式，使得每次產生的測資都是相同的。<br />
|inline:notice}}<br />
<br />
產測資程式（generator）應放置在{{slink||gen}}資料夾內，檔名無限制。<br />
<br />
以下說明請配合範例檔案 gen/gen.cpp<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/gen/gen.cpp</ref>。<br />
<br />
使用 <syntaxhighlight lang="c++" inline>#include "testlib.h"</syntaxhighlight> 引入 testlib 函式庫。<br />
<br />
main 函數務必寫成 <syntaxhighlight lang="c++" inline>int main(int argc, char* argv[])</syntaxhighlight> 來接收命令列參數。<br />
<br />
在 main 函數的第一行使用 <syntaxhighlight lang="c++" inline>registerGen(argc, argv, 1);</syntaxhighlight> 將命令列參數作為亂數種子。<br />
<br />
命令列參數會保存在 <syntaxhighlight lang="c++" inline>argv</syntaxhighlight> 內，可將其保存在 string 內： <syntaxhighlight lang="c++" inline>string task = argv[1];</syntaxhighlight>，或是使用 atoi<ref>https://en.cppreference.com/w/cpp/string/byte/atoi</ref> 等函數轉換為整數。例如範例中第一個參數用來判斷是第幾組測資，將其轉換為 <syntaxhighlight lang="c++" inline>int taskN</syntaxhighlight> 用於判斷。若為第一筆測資，測資範圍則為 87，若為其他測資，測資範圍則為 10^9。<br />
<br />
使用 <syntaxhighlight lang="c++" inline>rnd.next(-maxN, maxN)</syntaxhighlight> 來隨機產生範圍在 -maxN 到 maxN 之間的整數，保存在變數上用於之後輸出。<br />
<br />
最後將產生的測資輸出。<br />
<br />
{{Memo}} 由於 cout 中執行順序屬未定義行為，請勿將多個 rnd.next 合併在一個 cout 中使用，請分開 cout 或事先保存在變數上。<br />
{| class="wikitable"<br />
|-<br />
| <syntaxhighlight lang="c++"><br />
cout << rnd.next (1, n) << endl;<br />
</syntaxhighlight><br />
| {{Y}} <br />
|-<br />
| <syntaxhighlight lang="c++"><br />
cout << rnd.next (1, n) << " " << rnd.next (1, n) << endl;<br />
</syntaxhighlight><br />
| {{N}} 未定義行為<br />
|-<br />
| <syntaxhighlight lang="c++"><br />
cout << rnd.next (1, n) << " ";<br />
cout << rnd.next (1, n) << endl;<br />
</syntaxhighlight><br />
| {{Y}}<br />
|-<br />
| <syntaxhighlight lang="c++"><br />
int a = rnd.next (1, n), b = rnd.next (1, n);<br />
cout << a << " " << b << endl;<br />
</syntaxhighlight><br />
| {{Y}}<br />
|}<br />
<br />
完成產測資程式後，編譯成檔名為 gen 的執行檔（在 Windows 上的 gen.exe），在命令列使用：<br />
* <code>gen 1</code> 會隨機產生 4 個 -87 ~ 87 之間的數字（格式參見題目敘述）<br />
* <code>gen 2</code> 會隨機產生 4 個 -10^9 ~ 10^9 之間的數字<br />
<br />
{{reflist-talk}}<br />
<br />
==== 產測資指令 ====<br />
產測資指令應放置在{{slink||gen/data}}，以下說明請配合範例。<br />
<br />
每一個測資點以 @subtask 接測資點代號為開頭，這個測資點代號亦會使用在{{slink||子任務}}。<br />
<br />
接下來每個測資點可以有多筆測資，每筆測資可以使用手產測資檔，也可使用產測資程式。<br />
* 使用手產測資檔則為 manual 接續放在{{slink||gen/manual}}資料夾內的測資檔名。<br />
* 使用產測資程式則為呼叫在命令列中的指令。<br />
<br />
範例中第一行為 @subtask samples 為範例測資（samples 為固定名稱不可更改），包含一個手動測資檔 sample-01.in<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/gen/manual/sample-01.in</ref>。<br />
{{Memo|'''重要：'''將範例測資作為配分為 0 的第一筆測資點，名稱為 samples。|}}<br />
<br />
範例中除了範例測資外，共有 2 個測資點，名稱分別為 small 跟 all。兩個測資點都包含 5 筆自動測資。<br />
<br />
{{Memo}} 如果呼叫產測程式，但在指令中輸入了兩行一模一樣的內容，那麼這兩個測資就會相同（在設定亂數種子的情況下）。<br />
<br />
{| class="wikitable"<br />
|-<br />
| <syntaxhighlight lang="text"><br />
@subtask small<br />
gen 1<br />
gen 1<br />
gen 1<br />
</syntaxhighlight><br />
| {{N}} 會產生 3 筆相同測資<br />
|-<br />
| <syntaxhighlight lang="text"><br />
@subtask small<br />
gen 1 1<br />
gen 1 2<br />
gen 1 3<br />
</syntaxhighlight><br />
| {{Y}}<br />
|-<br />
| <syntaxhighlight lang="text"><br />
@subtask small<br />
gen 1 pewfw<br />
gen 1 qrewx<br />
gen 1 xckxk<br />
</syntaxhighlight><br />
| {{Y}}<br />
|}<br />
<br />
因此通常會在後面放上隨機文字作為亂數種子的一部分，亦可透過更換亂數種子來重新產生測資，隨機文字可使用線上工具<ref>例如 [https://www.random.org/strings/ Random String Generator]</ref>產生。<br />
<br />
{{Memo|'''小技巧：'''<br />
# 透過命令列參數直接控制測資範圍，就不需要在產測資程式碼內判斷測資點。<br />
# 發現不良的測資時，透過修改命令列參數的隨機文字來得到一筆新的隨機測資。<br />
# 若需要 edge case，使用手產測資檔。<br />
|}}<br />
<br />
{{reflist-talk}}<br />
<br />
=== 驗測資程式 ===<br />
{{Quote<br />
| 如果你寫了一個程式解題的問題，並準備好了測試資料，那麼你將可能會遇到一個恐怖的經驗：測試資料是無效的！（即測試資料並未符合題目所規定的限制），例如超過了範圍上限、你的圖實際上沒有連通、或是你的圖不是一棵樹……你很可能會有這種經驗，就算是有經驗的出題者也可能有時會出錯（知名案例像是 ACM ICPC World final 2007）。<br />
| 翻譯自 [https://codeforces.com/blog/entry/18426 Codeforces 上對於 Validator 的引言]。<br />
}}<br />
{{Memo|'''最佳實踐：'''撰寫驗測資程式來自動檢查測資範圍及其他條件是否有符合題目的規定，避免測資範圍錯誤。|}}<br />
<br />
驗測資程式（validator）應該放置在{{slink||validator}}資料夾內，檔名無限制，並將檔名寫入{{slink||subtasks.json}}的 global_validators 或 subtasks 的 validators。<br />
<br />
本範例包含 2 個 validator。<br />
<br />
validator.cpp <ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/validator/validator.cpp</ref> 用來驗證所有測資的範圍是否在 -10^9 ~ 10^9 內，故在{{slink||subtasks.json}}中設為 global_validators。<br />
<br />
validator-small.cpp<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/validator/validator-small.cpp</ref> 僅用來測試第 2 筆測資（index = 1）範圍是否在 -87 ~ 87，在{{slink||subtasks.json}}中設定為測資 small 的 validators。<br />
<br />
除了檢查範圍以外，readInt 等函數會回傳其數值，可以保存到變數上作進一步檢查，例如檢查陣列數值皆相異，檢查是否是圖、樹或其他資料結構。<br />
<br />
更多資訊請參見 Codeforces 上的說明<ref>[https://codeforces.com/blog/entry/18426 Validators with testlib.h - Codeforces]</ref>。<br />
<br />
{{Memo|'''小提示：'''驗測資程式僅檢查與解法無關的輸入資料限制，檢查是否 TLE、得部分分數屬於{{slink||標程}}的範圍。|}}<br />
<br />
{{reflist-talk}}<br />
<br />
=== 子任務 ===<br />
子任務（subtask）設定於{{slink||subtasks.json}}，包含各子任務的配分、文字描述、{{slink||驗測資程式}}。以下說明請參考範例。<br />
<br />
subtasks.json 最外層包含兩個 key：<br />
* global_validators：在所有測資使用的{{slink||驗測資程式}}。<br />
* subtasks：包含所有測資點。<br />
<br />
subtasks 是一個 key-value pairs，key 與{{slink||產測資指令}}中設定的相同。value 包含以下 key-value pairs：<br />
* index：流水號，出現在題本內的順序，從 0 開始；samples 必為 0。<br />
* score：子任務分數；samples 必為 0。<br />
* text：子任務描述，使用在題目描述內。<br />
* validators：僅在該子任務使用的{{slink||驗測資程式}}。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 題目敘述 ===<br />
題目敘述（statement）的檔案放置於{{slink||statement/index.md}}。使用 [[zhwiki:Markdown|Markdown]] 及 [[zhwiki:XeTeX|XeTeX]] 語法。<br />
<br />
結構由上到下依序為：<br />
# {{slink||題目圖片}}<br />
# {{slink||題目本文}}<br />
# 輸入（說明），參見{{slink||輸入及輸出說明}}<br />
# 輸出（說明），參見{{slink||輸入及輸出說明}}<br />
# {{slink||輸入限制}}<br />
# {{slink||子任務}}說明<br />
# 範例輸入，參見{{slink||範例輸入及輸出}}<br />
# 範例輸出，參見{{slink||範例輸入及輸出}}<br />
# {{slink||提示}}<br />
<br />
==== 題目圖片 ====<br />
參見{{slink|題目敘述故事|插圖}}。<br />
<br />
==== 題目本文 ====<br />
參見[[題目敘述故事]]。<br />
<br />
==== 輸入及輸出說明 ====<br />
輸入輸出說明必須明確說明參賽者要遵守的格式。<br />
<br />
應該以一行敘述測資中的一行所代表的資料，例如：<br />
* 第一行有 1 個整數，代表接下來的測資數量。<br />
* 第一行有 2 個整數，代表初始座標。<br />
<br />
如果需要在其他地方（輸入說明的其他行、輸入限制、題目本文等）提到該變數，應賦予變數代號，例如：<br />
* 第一行有 2 個整數 <math>V, E</math>，<math>V</math> 代表點的數量，<math>E</math> 代表邊的數量。<br />
* 第一行有 1 個整數 <math>N</math>，代表有 <math>N</math> 個人。...（換行）...接下來有 <math>N</math> 行，每一行有 1 個整數代表該人的分數。<br />
{{Memo|'''注意：'''同一個變數代號必須在該題目的任何地方皆相同，大小寫也必須相同。|}}<br />
<br />
==== 輸入限制 ====<br />
輸入限制用來告知參賽者測資的數值範圍限制，<br />
{| class="wikitable"<br />
|-<br />
! 原始碼 !! 顯示結果<br />
|-<br />
| <syntaxhighlight lang="markdown"><br />
- $1 \leq N \leq 100$<br />
- $1 \leq M \leq N$<br />
- $Y - X$ 必定為 2 個倍數<br />
- 若 $A = 1$，則 $B > 0$<br />
</syntaxhighlight><br />
|<br />
* <math>1 \leq N \leq 100</math><br />
* <math>1 \leq M \leq N</math><br />
* <math>Y - X</math> 必定為 2 個倍數<br />
* 若 <math>A = 1</math>，則 <math>B > 0</math><br />
|}<br />
<br />
==== 子任務說明 ====<br />
參見{{slink||子任務}}的操作，即會自動顯示於題本中。<br />
<br />
==== 範例輸入及輸出 ====<br />
範例輸入輸出必須與{{slink||產測資}}中設定的範例測資相同。<br />
<br />
{{TOJ side box<br />
|628|B. 國中會考分<br />
}}<br />
如果有多筆範例測資，標題應改命名為「範例輸入1、範例輸出1、範例輸入2、範例輸出2」等。<br />
{{clear}}<br />
<br />
{{TOJ side box<br />
|631|E. 蓋歐格（單個範例附說明）<br />
|632|F. 最小生成數（多個範例，僅有 1 個範例有說明）<br />
|637|D. 本田小狼（有圖片的範例說明）<br />
}}<br />
如果有需要說明測資，可加上「範例說明」章節，詳細說明範例測資中的意義，亦可附圖說明。<br />
<br />
{| class="wikitable"<br />
|-<br />
| style="vertical-align: top" |<br />
* 範例輸入<br />
* 範例輸出<br />
| style="vertical-align: top" |<br />
* 範例輸入1<br />
* 範例輸出1<br />
* 範例輸入2<br />
* 範例輸出2<br />
| style="vertical-align: top" |<br />
* 範例輸入1<br />
* 範例輸出1<br />
* 範例說明1<br />
* 範例輸入2<br />
* 範例輸出2<br />
|}<br />
<br />
==== 提示 ====<br />
{{TOJ side box<br />
|335|F. 參訪者們<br />
|509|C. Puyo<br />
}}<br />
如有需要，可以提供一些額外提示。如果內容為解題必須的，不應撰寫於提示，應寫於本文中。<br />
{{clear}}<br />
<br />
{{TOJ side box<br />
|330|A. Piñata<br />
|331|B. 尼莫西妮<br />
|473|A. 好哈快捷鍵<br />
}}<br />
亦可撰寫與解題毫無幫助，但與題目故事相關的小知識。<br />
{{clear}}<br />
<br />
== [[zhwiki:組建自動化|自動建置]] ==<br />
tps-starter<ref>https://github.com/TNFSH-Programming-Contest/tps-starter</ref> 使用了 GitHub Actions<ref>https://github.com/features/actions</ref>，對於建置題本和測資提供了簡易介面來執行構建，並包含自動建置、自動化測試等功能。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 建置題本 ===<br />
若要將題本編譯成 PDF，按照以下步驟操作：<br />
# 進入 GitHub repo。<br />
# 點擊 Actions。<br />
# 在 Workflows 段落，點擊 Build pdf。<ref>參考連結：https://github.com/TNFSH-Programming-Contest/TPS-example/actions/workflows/build-pdf.yml</ref><br />
# 點擊 Run workflow，在 Problem labels to build 輸入{{slink||題目編號}}，例如「B」。<br />
# 點擊藍色 Run workflow 按鈕。<br />
# 等待 PDF 題本建置完成，約 2 分鐘。<br />
# 可在對應題目的 statement/index.pdf 找到建置的 PDF。<ref>參考連結：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/statement/index.pdf</ref><br />
<br />
{{reflist-talk}}<br />
<br />
=== 自動建置題本 ===<br />
若題本已定稿，可開啟自動建置功能，之後對於相關檔案的修改都會觸發自動建置。刪除 statement/DISABLE_AUTO_BUILD<ref>https://github.com/TNFSH-Programming-Contest/tps-task-templates/blob/main/default/statement/DISABLE_AUTO_BUILD</ref> 即可開啟自動建置題本。<br />
<br />
修改以下檔案將會觸發自動建置：<br />
* scripts/statement.sh<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/scripts/statement.sh</ref><br />
* statement/*.jpg<ref>例如：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/statement/cover.jpg</ref><br />
* statement/index.md<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/statement/index.md</ref><br />
* template.tex<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/template.tex</ref><br />
* {{slink||cover.tex}}僅會構建 pA 的題本<br />
* {{slink||problem.json}}的<br />
** contest_name：{{slink||競賽名稱}}<br />
** problem_label：{{slink||題目編號}}<br />
** name：{{slink||題目英文名稱}}<br />
** title：{{slink||題目名稱}}<br />
** memory_limit：{{slink||記憶體限制}}<br />
** time_limit：{{slink||時間限制}}<br />
* {{slink||subtasks.json}}的 index、score、text ，參見{{slink||子任務}}。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 合併題本 ===<br />
在所有題目的題本皆完成，才進行合併題本，參考{{slink||建置題本}}的操作，在第 4 步驟的 Problem labels to build 輸入「+」，即會合併題本輸出於 pA/attachments/problems.pdf。<ref>參考連結：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pA/attachments/problems.pdf</ref><br />
<br />
{{reflist-talk}}<br />
<br />
=== 建置測資 ===<br />
若要自動產生測資 input、output、進行標程比較：<br />
# 進入 GitHub repo。<br />
# 點擊 Actions。<br />
# 在 Workflows 段落，點擊 Build tests。<ref>參考連結：https://github.com/TNFSH-Programming-Contest/TPS-example/actions/workflows/build-tests.yml</ref><br />
# 點擊 Run workflow。<br />
#* 若修改了{{slink||產測資}}程式，在 Problem labels to build inputs 輸入{{slink||題目編號}}，例如「B」，其他欄位不需重複輸入題號。將會自動建置輸入及輸出，若測資有變動，亦會自動測試標程。<br />
#* 若僅修改了{{slink||標程}}，導致僅有輸出會變動，在 Problem labels to build outputs 輸入{{slink||題目編號}}，其他欄位不需重複輸入題號。將會自動建置輸出，若測資有變動，亦會自動測試標程。<br />
#* 若僅要重新執行標程測試，在 Problem labels to run solutions 輸入{{slink||題目編號}}。<br />
# 點擊藍色 Run workflow 按鈕。<br />
# 等待測資建置完成。<br />
# 可在對應題目的{{slink||tests}}資料夾找到建置的測資。標程測試則在{{slink||solutions-check.txt}}。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 自動建置測資 ===<br />
若產測資程式和標程皆已定稿，可開啟自動建置功能，之後對於相關檔案的修改都會觸發自動建置。刪除 gen/DISABLE_AUTO_BUILD<ref>https://github.com/TNFSH-Programming-Contest/tps-task-templates/blob/main/default/gen/DISABLE_AUTO_BUILD</ref> 即可開啟自動建置測資。<br />
<br />
修改以下檔案將會觸發自動建置 input：<br />
* {{slink||gen}}內的所有檔案<br />
<br />
修改以下檔案將會觸發自動建置 output：<br />
* 在{{slink||solutions.json}}內設定的 model_solution 對應檔案。請注意：若變更 model_solution 的目標檔案可能不會觸發自動建置。<br />
<br />
修改以下檔案將會觸發自動建置 solutions：<br />
* {{slink||solution}}內的所有檔案<br />
* {{slink||solutions.json}}<br />
<br />
{{reflist-talk}}<br />
<br />
=== 跳過自動建置 ===<br />
若已經啟用自動建置，但想在特定一筆 Commit 跳過自動建置，請在 Commit message 加上 <code>[no ci]</code>，例如：<br />
<syntaxhighlight lang="text">pA Add wa.cpp<br />
<br />
Add WA solution without swap<br />
[no ci]<br />
</syntaxhighlight><br />
<br />
完整說明參見 [https://docs.github.com/en/actions/managing-workflow-runs/skipping-workflow-runs Skipping workflow runs - GitHub Docs]。</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=TPS&diff=469
TPS
2025-07-15T14:21:44Z
<p>Tobiichi3227：根目錄新增 appendix.tex</p>
<hr />
<div>TPS（Task Preparation System）是一套可以方便產生題目測試資料以及題本的工具，關於 TPS 可以參考以下的 GitHub Repo：<br />
* TPS Example：https://github.com/TNFSH-Programming-Contest/TPS-example<br />
* IOI 2017 TPS：https://github.com/ioi-2017/tps<br />
<br />
{{Memo|本頁面主要使用 TNFSH-Programming-Contest/cms-environment-testing-problem<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem</ref> 的 pB<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB</ref> 作為範本。|}}<br />
<br />
[[File:Icon tools.svg|20px]] 以下有此標誌的說明需要 CMS 系統管理員操作，出題者可忽略此說明。<br />
<br />
{{reflist-talk}}<br />
<br />
== 資料夾結構 ==<br />
=== 根目錄 ===<br />
==== .github/workflows ====<br />
GitHub 自動化流程設定檔。<br />
<br />
==== pX ====<br />
pA、pB 等{{slink||題目資料夾}}。<br />
<br />
==== .problems.json ====<br />
記錄{{slink||題目資料夾}}列表，供 GitHub Actions {{slink||自動建置}}使用，通常不應手動修改。<br />
<br />
==== Makefile ====<br />
[[File:Icon tools.svg|20px]] 匯入 CMS 的指令<br />
<br />
==== README.md ====<br />
主要在 GitHub 頁面上提供常用連結。<br />
<br />
==== cover.tex ====<br />
題本封面。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/cover.tex<br />
<br />
==== appendix.tex ====<br />
題本附錄。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/tps-starter/blob/main/appendix.tex<br />
<br />
==== template.tex ====<br />
題本內文模板，通常無需修改。<br />
<br />
=== 題目資料夾 ===<br />
==== attachments ====<br />
放在此處的所有檔案將會上傳到 CMS 上，供參賽者在題目敘述頁的「附件」，通常僅會在 pA 的附件放置{{slink||合併題本}}。<br />
<br />
[[File:Crystal Clear action run.png|20px]] 本目錄內容通常由程式自動產生。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pA/attachments<br />
<br />
==== gen ====<br />
放置{{slink||產測資}}相關的所有檔案。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/gen<br />
<br />
==== gen/manual ====<br />
{{See also|#手產測資檔}}<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/gen/manual<br />
<br />
==== gen/data ====<br />
{{See also|#產測資指令}}<br />
<br />
==== scripts ====<br />
[[File:Crystal Clear action run.png|20px]] 本目錄保存 TPS scripts，不需修改。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/scripts<br />
<br />
==== solution ====<br />
{{See also|#標程}}<br />
<br />
==== statement ====<br />
題本相關檔案，包含原始碼、圖片、{{slink||建置題本}}產生的 PDF。<br />
<br />
==== statement/index.md ====<br />
{{See also|#題目敘述}}<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/statement/index.md<br />
<br />
==== tests ====<br />
{{slink||產測資}}後的檔案會存放於此，參見{{slink||建置測資}}。<br />
<br />
[[File:Crystal Clear action run.png|20px]] 本目錄內容由程式自動產生，不應手動編輯。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/tests<br />
<br />
==== validator ====<br />
{{See also|#驗測資程式}}<br />
<br />
==== problem.json ====<br />
題目的相關設定，參見{{slink||競賽名稱|題目名稱|題目英文名稱|題目編號|記憶體限制|時間限制}}。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/problem.json<br />
<br />
==== solutions-check.txt ====<br />
所有標程的執行結果報告。<br />
<br />
[[File:Crystal Clear action run.png|20px]] 本檔案由程式自動產生，不應手動編輯。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/solutions-check.txt<br />
<br />
==== solutions.json ====<br />
列出所有{{slink||標程}}及其 verdict，標記為 model_solution 的標程會用於{{slink||產測資}}。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/solutions.json<br />
<br />
==== subtasks.json ====<br />
列出所有的{{slink||子任務}}，及每個子任務所使用的{{slink||驗測資程式}}。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/subtasks.json<br />
<br />
== 準備GitHub Repo ==<br />
=== 建立GitHub Repo ===<br />
# 進入 tps-starter。<ref>https://github.com/TNFSH-Programming-Contest/tps-starter</ref><br />
# 點擊 Use this template。<ref>直接連結：https://github.com/TNFSH-Programming-Contest/tps-starter/generate</ref><br />
# 填寫Repo資訊<br />
#* Repository name 填入競賽英文名，例如「cms-environment-testing-problem」。<br />
#* Description 填入競賽中文名，例如「CMS環境測試題目通用版」。<br />
#* [[File:OOjs UI icon alert-destructive.svg|20px]] '''注意：'''可見度必須選擇 '''Private'''。<br />
#* 點擊 Create repository from template。<br />
# 開啟 Github Action 權限<br />
## 前往 Settings -> Actions -> General<br />
## 找到 Workflow permissions <br />
## 選取 Read repository contents and packages permissions 並保存設定<br />
# （可選）若要將 GitHub Repo 更新傳送到 Discord，請參考 [https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks Intro to Webhooks – Discord] 操作。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 建立題目資料夾 ===<br />
此操作在每個競賽通常僅需執行 1 次。<br />
# 進入由 tps-starter 建立的 GitHub repo。<br />
# 點擊 Actions。<br />
# 在 Workflows 段落，點擊 New problem。<ref>參考連結：https://github.com/TNFSH-Programming-Contest/TPS-example/actions/workflows/new-problem.yml</ref><br />
# 點擊 Run workflow，在 How many problems in this contest? 輸入要建立的題目數量。<br />
#* 如果已有 3 題，要再新增 1 題，直接輸入 4 即可，已建立的目錄會直接被略過。<br />
# 點擊藍色 Run workflow 按鈕。<br />
# 等待題目資料夾建立完成，約 1 分鐘。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 刪除題目資料夾 ===<br />
雖然這通常不會發生，但如果誤建過多題目等情況，需要刪除題目資料夾時，請務必完成以下所有操作：<br />
# 刪除{{slink||題目資料夾}}。<br />
# 從{{slink||.problems.json}}刪除題目編號。<br />
# 從{{slink||Makefile}}刪除對應題目的匯入指令。<br />
# 從{{slink||README.md}}刪除對應題目的連結。<br />
<br />
== 準備TPS資料 ==<br />
=== 競賽名稱 ===<br />
競賽名稱使用於：<br />
# CMS 參賽介面左上角。<br />
# 題本封面第一行。<br />
# 題本內文各頁的左上角。<br />
<br />
需寫入於：（範例為「CMS環境測試題目通用版 v1.1」）<br />
# {{slink||cover.tex}}。<br />
# 各題目{{slink||problem.json}}的 contest_name 欄位。<br />
# [[File:Icon tools.svg|20px]] CMS 管理系統的 Description 欄位。<br />
<br />
=== 題目名稱 ===<br />
題目名稱（problem title）使用於：<br />
# CMS 競賽概況的題目列表。<br />
# CMS 題目敘述頁面。<br />
# 題目標題（第一頁第一行）。<br />
# 該題目各頁右上角。<br />
<br />
需寫入於{{slink||problem.json}}的 title 欄位，範例為「Piñata」。<br />
<br />
=== 題目英文名稱 ===<br />
題目英文名稱（problem name）應足以讓所有命題人員識別個別題目即可，通常取自於中文題目名稱，並盡量僅使用一個英文詞，首字大寫，若需要兩個英文詞以上，則使用[[zhwiki:駝峰式大小寫|PascalCase]]。使用於：<br />
# CMS 競賽概況的題目列表。<br />
# CMS 題目敘述。<br />
# CMS 系統內部用來識別題目的 [[zhwiki:主鍵|Primary key]]。<br />
#* [[File:Icon tools.svg|20px]] 由於同一 CMS 系統上的名稱無法重複，若與其他競賽題目衝突<ref>https://github.com/cms-dev/cms/issues/765</ref>，建議加上競賽名稱的英文縮寫作為前綴（例如「2022P-」）。<br />
# 可能作為 GitHub repo 內的題目資料夾名稱。<br />
<br />
需寫入於{{slink||problem.json}}的 name 欄位，範例為「Pinata」。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 題目編號 ===<br />
題目編號（problem label）為 A, B, C... 的流水號，在決定題目順序後才會確定，使用於：（範例為「B」）<br />
# CMS 競賽概況的題目列表。<br />
# 題目標題（第一頁第一行）。<br />
# 該題目各頁右上角。<br />
# 該題目各頁頁碼處。<br />
<br />
=== 記憶體限制 ===<br />
需寫入於{{slink||problem.json}}的 memory_limit 欄位，單位為MB，範例為「512」MB。<br />
<br />
=== 時間限制 ===<br />
需寫入於{{slink||problem.json}}的 time_limit 欄位，單位為秒，範例為「1.0」秒。<br />
<br />
=== 標程 ===<br />
AC code（又稱官方解法、標程等）需放置在{{slink||solution}}資料夾內，檔名無限制。同時將該檔名寫入{{slink||solutions.json}}，格式請參照範本，verdict 必須標記為 model_solution，範例檔名為「ac.cpp」<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/solution/ac.cpp</ref>。<br />
<br />
其他 AC code 亦按照前述方式操作，verdict 必須標記為 correct。<br />
<br />
其他類型的錯誤解法亦按照前述方式操作，verdict 標記方式請參考官方說明<ref>https://github.com/ioi-2017/tps/tree/master/docs#solutionsjson</ref>及 tps script<ref>https://github.com/TNFSH-Programming-Contest/tps-task-templates/blob/93cff7e64a43f57450b26568194432e7b662be38/default/scripts/internal/invoke.py#L18</ref>。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 產測資 ===<br />
TPS 產測資方式與 Codeforces polygon 相同。測資可以使用手產測資檔案，亦可由程式亂數產生，亦可混合兩者。<br />
<br />
==== 手產測資檔 ====<br />
{{Memo|'''最佳實踐：'''<br />
# 僅在 [[:zhwiki:en:Edge case|edge case]] 使用手產測資檔，其他使用產測程式。<br />
# 範例測資亦可隨機產生，若想要手動指定，亦可使用手產測資檔。<br />
|}}<br />
<br />
手產測資檔應放置在{{slink||gen/manual}}資料夾內，檔名無限制，但建議副檔名為 .in。<br />
<br />
本範例有 2 個範例測資，其中一個使用手產測資檔 sample-01.in<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/gen/manual/sample-01.in</ref>，另一個為隨機測資。<br />
<br />
{{reflist-talk}}<br />
<br />
==== 產測資程式 ====<br />
{{Memo|'''重要：'''產測資程式必須<br />
# 使用命令列參數讀入測資組及測資點<ref>[https://en.cppreference.com/w/cpp/language/main_function Main function - cppreference.com]</ref><ref>[https://stackoverflow.com/questions/3024197/what-does-int-argc-char-argv-mean c++ - What does int argc, char *argv&#x5B;&#x5D; mean? - Stack Overflow]</ref>。<br />
# 使用[[zhwiki:stdout|標準輸出（stdout）]]，不可直接寫入檔案。<br />
# 執行一次僅輸出一筆測資。<br />
# 使用 testlib.h<ref>[https://codeforces.com/blog/entry/18291 Generators with testlib.h]</ref> 等設定亂數種子的方式，使得每次產生的測資都是相同的。<br />
|inline:notice}}<br />
<br />
產測資程式（generator）應放置在{{slink||gen}}資料夾內，檔名無限制。<br />
<br />
以下說明請配合範例檔案 gen/gen.cpp<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/gen/gen.cpp</ref>。<br />
<br />
使用 <syntaxhighlight lang="c++" inline>#include "testlib.h"</syntaxhighlight> 引入 testlib 函式庫。<br />
<br />
main 函數務必寫成 <syntaxhighlight lang="c++" inline>int main(int argc, char* argv[])</syntaxhighlight> 來接收命令列參數。<br />
<br />
在 main 函數的第一行使用 <syntaxhighlight lang="c++" inline>registerGen(argc, argv, 1);</syntaxhighlight> 將命令列參數作為亂數種子。<br />
<br />
命令列參數會保存在 <syntaxhighlight lang="c++" inline>argv</syntaxhighlight> 內，可將其保存在 string 內： <syntaxhighlight lang="c++" inline>string task = argv[1];</syntaxhighlight>，或是使用 atoi<ref>https://en.cppreference.com/w/cpp/string/byte/atoi</ref> 等函數轉換為整數。例如範例中第一個參數用來判斷是第幾組測資，將其轉換為 <syntaxhighlight lang="c++" inline>int taskN</syntaxhighlight> 用於判斷。若為第一筆測資，測資範圍則為 87，若為其他測資，測資範圍則為 10^9。<br />
<br />
使用 <syntaxhighlight lang="c++" inline>rnd.next(-maxN, maxN)</syntaxhighlight> 來隨機產生範圍在 -maxN 到 maxN 之間的整數，保存在變數上用於之後輸出。<br />
<br />
最後將產生的測資輸出。<br />
<br />
{{Memo}} 由於 cout 中執行順序屬未定義行為，請勿將多個 rnd.next 合併在一個 cout 中使用，請分開 cout 或事先保存在變數上。<br />
{| class="wikitable"<br />
|-<br />
| <syntaxhighlight lang="c++"><br />
cout << rnd.next (1, n) << endl;<br />
</syntaxhighlight><br />
| {{Y}} <br />
|-<br />
| <syntaxhighlight lang="c++"><br />
cout << rnd.next (1, n) << " " << rnd.next (1, n) << endl;<br />
</syntaxhighlight><br />
| {{N}} 未定義行為<br />
|-<br />
| <syntaxhighlight lang="c++"><br />
cout << rnd.next (1, n) << " ";<br />
cout << rnd.next (1, n) << endl;<br />
</syntaxhighlight><br />
| {{Y}}<br />
|-<br />
| <syntaxhighlight lang="c++"><br />
int a = rnd.next (1, n), b = rnd.next (1, n);<br />
cout << a << " " << b << endl;<br />
</syntaxhighlight><br />
| {{Y}}<br />
|}<br />
<br />
完成產測資程式後，編譯成檔名為 gen 的執行檔（在 Windows 上的 gen.exe），在命令列使用：<br />
* <code>gen 1</code> 會隨機產生 4 個 -87 ~ 87 之間的數字（格式參見題目敘述）<br />
* <code>gen 2</code> 會隨機產生 4 個 -10^9 ~ 10^9 之間的數字<br />
<br />
{{reflist-talk}}<br />
<br />
==== 產測資指令 ====<br />
產測資指令應放置在{{slink||gen/data}}，以下說明請配合範例。<br />
<br />
每一個測資點以 @subtask 接測資點代號為開頭，這個測資點代號亦會使用在{{slink||子任務}}。<br />
<br />
接下來每個測資點可以有多筆測資，每筆測資可以使用手產測資檔，也可使用產測資程式。<br />
* 使用手產測資檔則為 manual 接續放在{{slink||gen/manual}}資料夾內的測資檔名。<br />
* 使用產測資程式則為呼叫在命令列中的指令。<br />
<br />
範例中第一行為 @subtask samples 為範例測資（samples 為固定名稱不可更改），包含一個手動測資檔 sample-01.in<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/gen/manual/sample-01.in</ref>。<br />
{{Memo|'''重要：'''將範例測資作為配分為 0 的第一筆測資點，名稱為 samples。|}}<br />
<br />
範例中除了範例測資外，共有 2 個測資點，名稱分別為 small 跟 all。兩個測資點都包含 5 筆自動測資。<br />
<br />
{{Memo}} 如果呼叫產測程式，但在指令中輸入了兩行一模一樣的內容，那麼這兩個測資就會相同（在設定亂數種子的情況下）。<br />
<br />
{| class="wikitable"<br />
|-<br />
| <syntaxhighlight lang="text"><br />
@subtask small<br />
gen 1<br />
gen 1<br />
gen 1<br />
</syntaxhighlight><br />
| {{N}} 會產生 3 筆相同測資<br />
|-<br />
| <syntaxhighlight lang="text"><br />
@subtask small<br />
gen 1 1<br />
gen 1 2<br />
gen 1 3<br />
</syntaxhighlight><br />
| {{Y}}<br />
|-<br />
| <syntaxhighlight lang="text"><br />
@subtask small<br />
gen 1 pewfw<br />
gen 1 qrewx<br />
gen 1 xckxk<br />
</syntaxhighlight><br />
| {{Y}}<br />
|}<br />
<br />
因此通常會在後面放上隨機文字作為亂數種子的一部分，亦可透過更換亂數種子來重新產生測資，隨機文字可使用線上工具<ref>例如 [https://www.random.org/strings/ Random String Generator]</ref>產生。<br />
<br />
{{Memo|'''小技巧：'''<br />
# 透過命令列參數直接控制測資範圍，就不需要在產測資程式碼內判斷測資點。<br />
# 發現不良的測資時，透過修改命令列參數的隨機文字來得到一筆新的隨機測資。<br />
# 若需要 edge case，使用手產測資檔。<br />
|}}<br />
<br />
{{reflist-talk}}<br />
<br />
=== 驗測資程式 ===<br />
{{Quote<br />
| 如果你寫了一個程式解題的問題，並準備好了測試資料，那麼你將可能會遇到一個恐怖的經驗：測試資料是無效的！（即測試資料並未符合題目所規定的限制），例如超過了範圍上限、你的圖實際上沒有連通、或是你的圖不是一棵樹……你很可能會有這種經驗，就算是有經驗的出題者也可能有時會出錯（知名案例像是 ACM ICPC World final 2007）。<br />
| 翻譯自 [https://codeforces.com/blog/entry/18426 Codeforces 上對於 Validator 的引言]。<br />
}}<br />
{{Memo|'''最佳實踐：'''撰寫驗測資程式來自動檢查測資範圍及其他條件是否有符合題目的規定，避免測資範圍錯誤。|}}<br />
<br />
驗測資程式（validator）應該放置在{{slink||validator}}資料夾內，檔名無限制，並將檔名寫入{{slink||subtasks.json}}的 global_validators 或 subtasks 的 validators。<br />
<br />
本範例包含 2 個 validator。<br />
<br />
validator.cpp <ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/validator/validator.cpp</ref> 用來驗證所有測資的範圍是否在 -10^9 ~ 10^9 內，故在{{slink||subtasks.json}}中設為 global_validators。<br />
<br />
validator-small.cpp<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/validator/validator-small.cpp</ref> 僅用來測試第 2 筆測資（index = 1）範圍是否在 -87 ~ 87，在{{slink||subtasks.json}}中設定為測資 small 的 validators。<br />
<br />
除了檢查範圍以外，readInt 等函數會回傳其數值，可以保存到變數上作進一步檢查，例如檢查陣列數值皆相異，檢查是否是圖、樹或其他資料結構。<br />
<br />
更多資訊請參見 Codeforces 上的說明<ref>[https://codeforces.com/blog/entry/18426 Validators with testlib.h - Codeforces]</ref>。<br />
<br />
{{Memo|'''小提示：'''驗測資程式僅檢查與解法無關的輸入資料限制，檢查是否 TLE、得部分分數屬於{{slink||標程}}的範圍。|}}<br />
<br />
{{reflist-talk}}<br />
<br />
=== 子任務 ===<br />
子任務（subtask）設定於{{slink||subtasks.json}}，包含各子任務的配分、文字描述、{{slink||驗測資程式}}。以下說明請參考範例。<br />
<br />
subtasks.json 最外層包含兩個 key：<br />
* global_validators：在所有測資使用的{{slink||驗測資程式}}。<br />
* subtasks：包含所有測資點。<br />
<br />
subtasks 是一個 key-value pairs，key 與{{slink||產測資指令}}中設定的相同。value 包含以下 key-value pairs：<br />
* index：流水號，出現在題本內的順序，從 0 開始；samples 必為 0。<br />
* score：子任務分數；samples 必為 0。<br />
* text：子任務描述，使用在題目描述內。<br />
* validators：僅在該子任務使用的{{slink||驗測資程式}}。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 題目敘述 ===<br />
題目敘述（statement）的檔案放置於{{slink||statement/index.md}}。使用 [[zhwiki:Markdown|Markdown]] 及 [[zhwiki:XeTeX|XeTeX]] 語法。<br />
<br />
結構由上到下依序為：<br />
# {{slink||題目圖片}}<br />
# {{slink||題目本文}}<br />
# 輸入（說明），參見{{slink||輸入及輸出說明}}<br />
# 輸出（說明），參見{{slink||輸入及輸出說明}}<br />
# {{slink||輸入限制}}<br />
# {{slink||子任務}}說明<br />
# 範例輸入，參見{{slink||範例輸入及輸出}}<br />
# 範例輸出，參見{{slink||範例輸入及輸出}}<br />
# {{slink||提示}}<br />
<br />
==== 題目圖片 ====<br />
參見{{slink|題目敘述故事|插圖}}。<br />
<br />
==== 題目本文 ====<br />
參見[[題目敘述故事]]。<br />
<br />
==== 輸入及輸出說明 ====<br />
輸入輸出說明必須明確說明參賽者要遵守的格式。<br />
<br />
應該以一行敘述測資中的一行所代表的資料，例如：<br />
* 第一行有 1 個整數，代表接下來的測資數量。<br />
* 第一行有 2 個整數，代表初始座標。<br />
<br />
如果需要在其他地方（輸入說明的其他行、輸入限制、題目本文等）提到該變數，應賦予變數代號，例如：<br />
* 第一行有 2 個整數 <math>V, E</math>，<math>V</math> 代表點的數量，<math>E</math> 代表邊的數量。<br />
* 第一行有 1 個整數 <math>N</math>，代表有 <math>N</math> 個人。...（換行）...接下來有 <math>N</math> 行，每一行有 1 個整數代表該人的分數。<br />
{{Memo|'''注意：'''同一個變數代號必須在該題目的任何地方皆相同，大小寫也必須相同。|}}<br />
<br />
==== 輸入限制 ====<br />
輸入限制用來告知參賽者測資的數值範圍限制，<br />
{| class="wikitable"<br />
|-<br />
! 原始碼 !! 顯示結果<br />
|-<br />
| <syntaxhighlight lang="markdown"><br />
- $1 \leq N \leq 100$<br />
- $1 \leq M \leq N$<br />
- $Y - X$ 必定為 2 個倍數<br />
- 若 $A = 1$，則 $B > 0$<br />
</syntaxhighlight><br />
|<br />
* <math>1 \leq N \leq 100</math><br />
* <math>1 \leq M \leq N</math><br />
* <math>Y - X</math> 必定為 2 個倍數<br />
* 若 <math>A = 1</math>，則 <math>B > 0</math><br />
|}<br />
<br />
==== 子任務說明 ====<br />
參見{{slink||子任務}}的操作，即會自動顯示於題本中。<br />
<br />
==== 範例輸入及輸出 ====<br />
範例輸入輸出必須與{{slink||產測資}}中設定的範例測資相同。<br />
<br />
{{TOJ side box<br />
|628|B. 國中會考分<br />
}}<br />
如果有多筆範例測資，標題應改命名為「範例輸入1、範例輸出1、範例輸入2、範例輸出2」等。<br />
{{clear}}<br />
<br />
{{TOJ side box<br />
|631|E. 蓋歐格（單個範例附說明）<br />
|632|F. 最小生成數（多個範例，僅有 1 個範例有說明）<br />
|637|D. 本田小狼（有圖片的範例說明）<br />
}}<br />
如果有需要說明測資，可加上「範例說明」章節，詳細說明範例測資中的意義，亦可附圖說明。<br />
<br />
{| class="wikitable"<br />
|-<br />
| style="vertical-align: top" |<br />
* 範例輸入<br />
* 範例輸出<br />
| style="vertical-align: top" |<br />
* 範例輸入1<br />
* 範例輸出1<br />
* 範例輸入2<br />
* 範例輸出2<br />
| style="vertical-align: top" |<br />
* 範例輸入1<br />
* 範例輸出1<br />
* 範例說明1<br />
* 範例輸入2<br />
* 範例輸出2<br />
|}<br />
<br />
==== 提示 ====<br />
{{TOJ side box<br />
|335|F. 參訪者們<br />
|509|C. Puyo<br />
}}<br />
如有需要，可以提供一些額外提示。如果內容為解題必須的，不應撰寫於提示，應寫於本文中。<br />
{{clear}}<br />
<br />
{{TOJ side box<br />
|330|A. Piñata<br />
|331|B. 尼莫西妮<br />
|473|A. 好哈快捷鍵<br />
}}<br />
亦可撰寫與解題毫無幫助，但與題目故事相關的小知識。<br />
{{clear}}<br />
<br />
== [[zhwiki:組建自動化|自動建置]] ==<br />
tps-starter<ref>https://github.com/TNFSH-Programming-Contest/tps-starter</ref> 使用了 GitHub Actions<ref>https://github.com/features/actions</ref>，對於建置題本和測資提供了簡易介面來執行構建，並包含自動建置、自動化測試等功能。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 建置題本 ===<br />
若要將題本編譯成 PDF，按照以下步驟操作：<br />
# 進入 GitHub repo。<br />
# 點擊 Actions。<br />
# 在 Workflows 段落，點擊 Build pdf。<ref>參考連結：https://github.com/TNFSH-Programming-Contest/TPS-example/actions/workflows/build-pdf.yml</ref><br />
# 點擊 Run workflow，在 Problem labels to build 輸入{{slink||題目編號}}，例如「B」。<br />
# 點擊藍色 Run workflow 按鈕。<br />
# 等待 PDF 題本建置完成，約 2 分鐘。<br />
# 可在對應題目的 statement/index.pdf 找到建置的 PDF。<ref>參考連結：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/statement/index.pdf</ref><br />
<br />
{{reflist-talk}}<br />
<br />
=== 自動建置題本 ===<br />
若題本已定稿，可開啟自動建置功能，之後對於相關檔案的修改都會觸發自動建置。刪除 statement/DISABLE_AUTO_BUILD<ref>https://github.com/TNFSH-Programming-Contest/tps-task-templates/blob/main/default/statement/DISABLE_AUTO_BUILD</ref> 即可開啟自動建置題本。<br />
<br />
修改以下檔案將會觸發自動建置：<br />
* scripts/statement.sh<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/scripts/statement.sh</ref><br />
* statement/*.jpg<ref>例如：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/statement/cover.jpg</ref><br />
* statement/index.md<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/statement/index.md</ref><br />
* template.tex<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/template.tex</ref><br />
* {{slink||cover.tex}}僅會構建 pA 的題本<br />
* {{slink||problem.json}}的<br />
** contest_name：{{slink||競賽名稱}}<br />
** problem_label：{{slink||題目編號}}<br />
** name：{{slink||題目英文名稱}}<br />
** title：{{slink||題目名稱}}<br />
** memory_limit：{{slink||記憶體限制}}<br />
** time_limit：{{slink||時間限制}}<br />
* {{slink||subtasks.json}}的 index、score、text ，參見{{slink||子任務}}。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 合併題本 ===<br />
在所有題目的題本皆完成，才進行合併題本，參考{{slink||建置題本}}的操作，在第 4 步驟的 Problem labels to build 輸入「+」，即會合併題本輸出於 pA/attachments/problems.pdf。<ref>參考連結：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pA/attachments/problems.pdf</ref><br />
<br />
{{reflist-talk}}<br />
<br />
=== 建置測資 ===<br />
若要自動產生測資 input、output、進行標程比較：<br />
# 進入 GitHub repo。<br />
# 點擊 Actions。<br />
# 在 Workflows 段落，點擊 Build tests。<ref>參考連結：https://github.com/TNFSH-Programming-Contest/TPS-example/actions/workflows/build-tests.yml</ref><br />
# 點擊 Run workflow。<br />
#* 若修改了{{slink||產測資}}程式，在 Problem labels to build inputs 輸入{{slink||題目編號}}，例如「B」，其他欄位不需重複輸入題號。將會自動建置輸入及輸出，若測資有變動，亦會自動測試標程。<br />
#* 若僅修改了{{slink||標程}}，導致僅有輸出會變動，在 Problem labels to build outputs 輸入{{slink||題目編號}}，其他欄位不需重複輸入題號。將會自動建置輸出，若測資有變動，亦會自動測試標程。<br />
#* 若僅要重新執行標程測試，在 Problem labels to run solutions 輸入{{slink||題目編號}}。<br />
# 點擊藍色 Run workflow 按鈕。<br />
# 等待測資建置完成。<br />
# 可在對應題目的{{slink||tests}}資料夾找到建置的測資。標程測試則在{{slink||solutions-check.txt}}。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 自動建置測資 ===<br />
若產測資程式和標程皆已定稿，可開啟自動建置功能，之後對於相關檔案的修改都會觸發自動建置。刪除 gen/DISABLE_AUTO_BUILD<ref>https://github.com/TNFSH-Programming-Contest/tps-task-templates/blob/main/default/gen/DISABLE_AUTO_BUILD</ref> 即可開啟自動建置測資。<br />
<br />
修改以下檔案將會觸發自動建置 input：<br />
* {{slink||gen}}內的所有檔案<br />
<br />
修改以下檔案將會觸發自動建置 output：<br />
* 在{{slink||solutions.json}}內設定的 model_solution 對應檔案。請注意：若變更 model_solution 的目標檔案可能不會觸發自動建置。<br />
<br />
修改以下檔案將會觸發自動建置 solutions：<br />
* {{slink||solution}}內的所有檔案<br />
* {{slink||solutions.json}}<br />
<br />
{{reflist-talk}}<br />
<br />
=== 跳過自動建置 ===<br />
若已經啟用自動建置，但想在特定一筆 Commit 跳過自動建置，請在 Commit message 加上 <code>[no ci]</code>，例如：<br />
<syntaxhighlight lang="text">pA Add wa.cpp<br />
<br />
Add WA solution without swap<br />
[no ci]<br />
</syntaxhighlight><br />
<br />
完整說明參見 [https://docs.github.com/en/actions/managing-workflow-runs/skipping-workflow-runs Skipping workflow runs - GitHub Docs]。</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=TPS&diff=468
TPS
2025-03-28T02:56:15Z
<p>Tobiichi3227：建立 Github Repo 加入修改 Github Action 權限教學</p>
<hr />
<div>TPS（Task Preparation System）是一套可以方便產生題目測試資料以及題本的工具，關於 TPS 可以參考以下的 GitHub Repo：<br />
* TPS Example：https://github.com/TNFSH-Programming-Contest/TPS-example<br />
* IOI 2017 TPS：https://github.com/ioi-2017/tps<br />
<br />
{{Memo|本頁面主要使用 TNFSH-Programming-Contest/cms-environment-testing-problem<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem</ref> 的 pB<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB</ref> 作為範本。|}}<br />
<br />
[[File:Icon tools.svg|20px]] 以下有此標誌的說明需要 CMS 系統管理員操作，出題者可忽略此說明。<br />
<br />
{{reflist-talk}}<br />
<br />
== 資料夾結構 ==<br />
=== 根目錄 ===<br />
==== .github/workflows ====<br />
GitHub 自動化流程設定檔。<br />
<br />
==== pX ====<br />
pA、pB 等{{slink||題目資料夾}}。<br />
<br />
==== .problems.json ====<br />
記錄{{slink||題目資料夾}}列表，供 GitHub Actions {{slink||自動建置}}使用，通常不應手動修改。<br />
<br />
==== Makefile ====<br />
[[File:Icon tools.svg|20px]] 匯入 CMS 的指令<br />
<br />
==== README.md ====<br />
主要在 GitHub 頁面上提供常用連結。<br />
<br />
==== cover.tex ====<br />
題本封面。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/cover.tex<br />
<br />
==== template.tex ====<br />
題本內文模板，通常無需修改。<br />
<br />
=== 題目資料夾 ===<br />
==== attachments ====<br />
放在此處的所有檔案將會上傳到 CMS 上，供參賽者在題目敘述頁的「附件」，通常僅會在 pA 的附件放置{{slink||合併題本}}。<br />
<br />
[[File:Crystal Clear action run.png|20px]] 本目錄內容通常由程式自動產生。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pA/attachments<br />
<br />
==== gen ====<br />
放置{{slink||產測資}}相關的所有檔案。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/gen<br />
<br />
==== gen/manual ====<br />
{{See also|#手產測資檔}}<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/gen/manual<br />
<br />
==== gen/data ====<br />
{{See also|#產測資指令}}<br />
<br />
==== scripts ====<br />
[[File:Crystal Clear action run.png|20px]] 本目錄保存 TPS scripts，不需修改。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/scripts<br />
<br />
==== solution ====<br />
{{See also|#標程}}<br />
<br />
==== statement ====<br />
題本相關檔案，包含原始碼、圖片、{{slink||建置題本}}產生的 PDF。<br />
<br />
==== statement/index.md ====<br />
{{See also|#題目敘述}}<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/statement/index.md<br />
<br />
==== tests ====<br />
{{slink||產測資}}後的檔案會存放於此，參見{{slink||建置測資}}。<br />
<br />
[[File:Crystal Clear action run.png|20px]] 本目錄內容由程式自動產生，不應手動編輯。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/tests<br />
<br />
==== validator ====<br />
{{See also|#驗測資程式}}<br />
<br />
==== problem.json ====<br />
題目的相關設定，參見{{slink||競賽名稱|題目名稱|題目英文名稱|題目編號|記憶體限制|時間限制}}。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/problem.json<br />
<br />
==== solutions-check.txt ====<br />
所有標程的執行結果報告。<br />
<br />
[[File:Crystal Clear action run.png|20px]] 本檔案由程式自動產生，不應手動編輯。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/solutions-check.txt<br />
<br />
==== solutions.json ====<br />
列出所有{{slink||標程}}及其 verdict，標記為 model_solution 的標程會用於{{slink||產測資}}。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/solutions.json<br />
<br />
==== subtasks.json ====<br />
列出所有的{{slink||子任務}}，及每個子任務所使用的{{slink||驗測資程式}}。<br />
<br />
範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/subtasks.json<br />
<br />
== 準備GitHub Repo ==<br />
=== 建立GitHub Repo ===<br />
# 進入 tps-starter。<ref>https://github.com/TNFSH-Programming-Contest/tps-starter</ref><br />
# 點擊 Use this template。<ref>直接連結：https://github.com/TNFSH-Programming-Contest/tps-starter/generate</ref><br />
# 填寫Repo資訊<br />
#* Repository name 填入競賽英文名，例如「cms-environment-testing-problem」。<br />
#* Description 填入競賽中文名，例如「CMS環境測試題目通用版」。<br />
#* [[File:OOjs UI icon alert-destructive.svg|20px]] '''注意：'''可見度必須選擇 '''Private'''。<br />
#* 點擊 Create repository from template。<br />
# 開啟 Github Action 權限<br />
## 前往 Settings -> Actions -> General<br />
## 找到 Workflow permissions <br />
## 選取 Read repository contents and packages permissions 並保存設定<br />
# （可選）若要將 GitHub Repo 更新傳送到 Discord，請參考 [https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks Intro to Webhooks – Discord] 操作。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 建立題目資料夾 ===<br />
此操作在每個競賽通常僅需執行 1 次。<br />
# 進入由 tps-starter 建立的 GitHub repo。<br />
# 點擊 Actions。<br />
# 在 Workflows 段落，點擊 New problem。<ref>參考連結：https://github.com/TNFSH-Programming-Contest/TPS-example/actions/workflows/new-problem.yml</ref><br />
# 點擊 Run workflow，在 How many problems in this contest? 輸入要建立的題目數量。<br />
#* 如果已有 3 題，要再新增 1 題，直接輸入 4 即可，已建立的目錄會直接被略過。<br />
# 點擊藍色 Run workflow 按鈕。<br />
# 等待題目資料夾建立完成，約 1 分鐘。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 刪除題目資料夾 ===<br />
雖然這通常不會發生，但如果誤建過多題目等情況，需要刪除題目資料夾時，請務必完成以下所有操作：<br />
# 刪除{{slink||題目資料夾}}。<br />
# 從{{slink||.problems.json}}刪除題目編號。<br />
# 從{{slink||Makefile}}刪除對應題目的匯入指令。<br />
# 從{{slink||README.md}}刪除對應題目的連結。<br />
<br />
== 準備TPS資料 ==<br />
=== 競賽名稱 ===<br />
競賽名稱使用於：<br />
# CMS 參賽介面左上角。<br />
# 題本封面第一行。<br />
# 題本內文各頁的左上角。<br />
<br />
需寫入於：（範例為「CMS環境測試題目通用版 v1.1」）<br />
# {{slink||cover.tex}}。<br />
# 各題目{{slink||problem.json}}的 contest_name 欄位。<br />
# [[File:Icon tools.svg|20px]] CMS 管理系統的 Description 欄位。<br />
<br />
=== 題目名稱 ===<br />
題目名稱（problem title）使用於：<br />
# CMS 競賽概況的題目列表。<br />
# CMS 題目敘述頁面。<br />
# 題目標題（第一頁第一行）。<br />
# 該題目各頁右上角。<br />
<br />
需寫入於{{slink||problem.json}}的 title 欄位，範例為「Piñata」。<br />
<br />
=== 題目英文名稱 ===<br />
題目英文名稱（problem name）應足以讓所有命題人員識別個別題目即可，通常取自於中文題目名稱，並盡量僅使用一個英文詞，首字大寫，若需要兩個英文詞以上，則使用[[zhwiki:駝峰式大小寫|PascalCase]]。使用於：<br />
# CMS 競賽概況的題目列表。<br />
# CMS 題目敘述。<br />
# CMS 系統內部用來識別題目的 [[zhwiki:主鍵|Primary key]]。<br />
#* [[File:Icon tools.svg|20px]] 由於同一 CMS 系統上的名稱無法重複，若與其他競賽題目衝突<ref>https://github.com/cms-dev/cms/issues/765</ref>，建議加上競賽名稱的英文縮寫作為前綴（例如「2022P-」）。<br />
# 可能作為 GitHub repo 內的題目資料夾名稱。<br />
<br />
需寫入於{{slink||problem.json}}的 name 欄位，範例為「Pinata」。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 題目編號 ===<br />
題目編號（problem label）為 A, B, C... 的流水號，在決定題目順序後才會確定，使用於：（範例為「B」）<br />
# CMS 競賽概況的題目列表。<br />
# 題目標題（第一頁第一行）。<br />
# 該題目各頁右上角。<br />
# 該題目各頁頁碼處。<br />
<br />
=== 記憶體限制 ===<br />
需寫入於{{slink||problem.json}}的 memory_limit 欄位，單位為MB，範例為「512」MB。<br />
<br />
=== 時間限制 ===<br />
需寫入於{{slink||problem.json}}的 time_limit 欄位，單位為秒，範例為「1.0」秒。<br />
<br />
=== 標程 ===<br />
AC code（又稱官方解法、標程等）需放置在{{slink||solution}}資料夾內，檔名無限制。同時將該檔名寫入{{slink||solutions.json}}，格式請參照範本，verdict 必須標記為 model_solution，範例檔名為「ac.cpp」<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/solution/ac.cpp</ref>。<br />
<br />
其他 AC code 亦按照前述方式操作，verdict 必須標記為 correct。<br />
<br />
其他類型的錯誤解法亦按照前述方式操作，verdict 標記方式請參考官方說明<ref>https://github.com/ioi-2017/tps/tree/master/docs#solutionsjson</ref>及 tps script<ref>https://github.com/TNFSH-Programming-Contest/tps-task-templates/blob/93cff7e64a43f57450b26568194432e7b662be38/default/scripts/internal/invoke.py#L18</ref>。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 產測資 ===<br />
TPS 產測資方式與 Codeforces polygon 相同。測資可以使用手產測資檔案，亦可由程式亂數產生，亦可混合兩者。<br />
<br />
==== 手產測資檔 ====<br />
{{Memo|'''最佳實踐：'''<br />
# 僅在 [[:zhwiki:en:Edge case|edge case]] 使用手產測資檔，其他使用產測程式。<br />
# 範例測資亦可隨機產生，若想要手動指定，亦可使用手產測資檔。<br />
|}}<br />
<br />
手產測資檔應放置在{{slink||gen/manual}}資料夾內，檔名無限制，但建議副檔名為 .in。<br />
<br />
本範例有 2 個範例測資，其中一個使用手產測資檔 sample-01.in<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/gen/manual/sample-01.in</ref>，另一個為隨機測資。<br />
<br />
{{reflist-talk}}<br />
<br />
==== 產測資程式 ====<br />
{{Memo|'''重要：'''產測資程式必須<br />
# 使用命令列參數讀入測資組及測資點<ref>[https://en.cppreference.com/w/cpp/language/main_function Main function - cppreference.com]</ref><ref>[https://stackoverflow.com/questions/3024197/what-does-int-argc-char-argv-mean c++ - What does int argc, char *argv&#x5B;&#x5D; mean? - Stack Overflow]</ref>。<br />
# 使用[[zhwiki:stdout|標準輸出（stdout）]]，不可直接寫入檔案。<br />
# 執行一次僅輸出一筆測資。<br />
# 使用 testlib.h<ref>[https://codeforces.com/blog/entry/18291 Generators with testlib.h]</ref> 等設定亂數種子的方式，使得每次產生的測資都是相同的。<br />
|inline:notice}}<br />
<br />
產測資程式（generator）應放置在{{slink||gen}}資料夾內，檔名無限制。<br />
<br />
以下說明請配合範例檔案 gen/gen.cpp<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/gen/gen.cpp</ref>。<br />
<br />
使用 <syntaxhighlight lang="c++" inline>#include "testlib.h"</syntaxhighlight> 引入 testlib 函式庫。<br />
<br />
main 函數務必寫成 <syntaxhighlight lang="c++" inline>int main(int argc, char* argv[])</syntaxhighlight> 來接收命令列參數。<br />
<br />
在 main 函數的第一行使用 <syntaxhighlight lang="c++" inline>registerGen(argc, argv, 1);</syntaxhighlight> 將命令列參數作為亂數種子。<br />
<br />
命令列參數會保存在 <syntaxhighlight lang="c++" inline>argv</syntaxhighlight> 內，可將其保存在 string 內： <syntaxhighlight lang="c++" inline>string task = argv[1];</syntaxhighlight>，或是使用 atoi<ref>https://en.cppreference.com/w/cpp/string/byte/atoi</ref> 等函數轉換為整數。例如範例中第一個參數用來判斷是第幾組測資，將其轉換為 <syntaxhighlight lang="c++" inline>int taskN</syntaxhighlight> 用於判斷。若為第一筆測資，測資範圍則為 87，若為其他測資，測資範圍則為 10^9。<br />
<br />
使用 <syntaxhighlight lang="c++" inline>rnd.next(-maxN, maxN)</syntaxhighlight> 來隨機產生範圍在 -maxN 到 maxN 之間的整數，保存在變數上用於之後輸出。<br />
<br />
最後將產生的測資輸出。<br />
<br />
{{Memo}} 由於 cout 中執行順序屬未定義行為，請勿將多個 rnd.next 合併在一個 cout 中使用，請分開 cout 或事先保存在變數上。<br />
{| class="wikitable"<br />
|-<br />
| <syntaxhighlight lang="c++"><br />
cout << rnd.next (1, n) << endl;<br />
</syntaxhighlight><br />
| {{Y}} <br />
|-<br />
| <syntaxhighlight lang="c++"><br />
cout << rnd.next (1, n) << " " << rnd.next (1, n) << endl;<br />
</syntaxhighlight><br />
| {{N}} 未定義行為<br />
|-<br />
| <syntaxhighlight lang="c++"><br />
cout << rnd.next (1, n) << " ";<br />
cout << rnd.next (1, n) << endl;<br />
</syntaxhighlight><br />
| {{Y}}<br />
|-<br />
| <syntaxhighlight lang="c++"><br />
int a = rnd.next (1, n), b = rnd.next (1, n);<br />
cout << a << " " << b << endl;<br />
</syntaxhighlight><br />
| {{Y}}<br />
|}<br />
<br />
完成產測資程式後，編譯成檔名為 gen 的執行檔（在 Windows 上的 gen.exe），在命令列使用：<br />
* <code>gen 1</code> 會隨機產生 4 個 -87 ~ 87 之間的數字（格式參見題目敘述）<br />
* <code>gen 2</code> 會隨機產生 4 個 -10^9 ~ 10^9 之間的數字<br />
<br />
{{reflist-talk}}<br />
<br />
==== 產測資指令 ====<br />
產測資指令應放置在{{slink||gen/data}}，以下說明請配合範例。<br />
<br />
每一個測資點以 @subtask 接測資點代號為開頭，這個測資點代號亦會使用在{{slink||子任務}}。<br />
<br />
接下來每個測資點可以有多筆測資，每筆測資可以使用手產測資檔，也可使用產測資程式。<br />
* 使用手產測資檔則為 manual 接續放在{{slink||gen/manual}}資料夾內的測資檔名。<br />
* 使用產測資程式則為呼叫在命令列中的指令。<br />
<br />
範例中第一行為 @subtask samples 為範例測資（samples 為固定名稱不可更改），包含一個手動測資檔 sample-01.in<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/gen/manual/sample-01.in</ref>。<br />
{{Memo|'''重要：'''將範例測資作為配分為 0 的第一筆測資點，名稱為 samples。|}}<br />
<br />
範例中除了範例測資外，共有 2 個測資點，名稱分別為 small 跟 all。兩個測資點都包含 5 筆自動測資。<br />
<br />
{{Memo}} 如果呼叫產測程式，但在指令中輸入了兩行一模一樣的內容，那麼這兩個測資就會相同（在設定亂數種子的情況下）。<br />
<br />
{| class="wikitable"<br />
|-<br />
| <syntaxhighlight lang="text"><br />
@subtask small<br />
gen 1<br />
gen 1<br />
gen 1<br />
</syntaxhighlight><br />
| {{N}} 會產生 3 筆相同測資<br />
|-<br />
| <syntaxhighlight lang="text"><br />
@subtask small<br />
gen 1 1<br />
gen 1 2<br />
gen 1 3<br />
</syntaxhighlight><br />
| {{Y}}<br />
|-<br />
| <syntaxhighlight lang="text"><br />
@subtask small<br />
gen 1 pewfw<br />
gen 1 qrewx<br />
gen 1 xckxk<br />
</syntaxhighlight><br />
| {{Y}}<br />
|}<br />
<br />
因此通常會在後面放上隨機文字作為亂數種子的一部分，亦可透過更換亂數種子來重新產生測資，隨機文字可使用線上工具<ref>例如 [https://www.random.org/strings/ Random String Generator]</ref>產生。<br />
<br />
{{Memo|'''小技巧：'''<br />
# 透過命令列參數直接控制測資範圍，就不需要在產測資程式碼內判斷測資點。<br />
# 發現不良的測資時，透過修改命令列參數的隨機文字來得到一筆新的隨機測資。<br />
# 若需要 edge case，使用手產測資檔。<br />
|}}<br />
<br />
{{reflist-talk}}<br />
<br />
=== 驗測資程式 ===<br />
{{Quote<br />
| 如果你寫了一個程式解題的問題，並準備好了測試資料，那麼你將可能會遇到一個恐怖的經驗：測試資料是無效的！（即測試資料並未符合題目所規定的限制），例如超過了範圍上限、你的圖實際上沒有連通、或是你的圖不是一棵樹……你很可能會有這種經驗，就算是有經驗的出題者也可能有時會出錯（知名案例像是 ACM ICPC World final 2007）。<br />
| 翻譯自 [https://codeforces.com/blog/entry/18426 Codeforces 上對於 Validator 的引言]。<br />
}}<br />
{{Memo|'''最佳實踐：'''撰寫驗測資程式來自動檢查測資範圍及其他條件是否有符合題目的規定，避免測資範圍錯誤。|}}<br />
<br />
驗測資程式（validator）應該放置在{{slink||validator}}資料夾內，檔名無限制，並將檔名寫入{{slink||subtasks.json}}的 global_validators 或 subtasks 的 validators。<br />
<br />
本範例包含 2 個 validator。<br />
<br />
validator.cpp <ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/validator/validator.cpp</ref> 用來驗證所有測資的範圍是否在 -10^9 ~ 10^9 內，故在{{slink||subtasks.json}}中設為 global_validators。<br />
<br />
validator-small.cpp<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/validator/validator-small.cpp</ref> 僅用來測試第 2 筆測資（index = 1）範圍是否在 -87 ~ 87，在{{slink||subtasks.json}}中設定為測資 small 的 validators。<br />
<br />
除了檢查範圍以外，readInt 等函數會回傳其數值，可以保存到變數上作進一步檢查，例如檢查陣列數值皆相異，檢查是否是圖、樹或其他資料結構。<br />
<br />
更多資訊請參見 Codeforces 上的說明<ref>[https://codeforces.com/blog/entry/18426 Validators with testlib.h - Codeforces]</ref>。<br />
<br />
{{Memo|'''小提示：'''驗測資程式僅檢查與解法無關的輸入資料限制，檢查是否 TLE、得部分分數屬於{{slink||標程}}的範圍。|}}<br />
<br />
{{reflist-talk}}<br />
<br />
=== 子任務 ===<br />
子任務（subtask）設定於{{slink||subtasks.json}}，包含各子任務的配分、文字描述、{{slink||驗測資程式}}。以下說明請參考範例。<br />
<br />
subtasks.json 最外層包含兩個 key：<br />
* global_validators：在所有測資使用的{{slink||驗測資程式}}。<br />
* subtasks：包含所有測資點。<br />
<br />
subtasks 是一個 key-value pairs，key 與{{slink||產測資指令}}中設定的相同。value 包含以下 key-value pairs：<br />
* index：流水號，出現在題本內的順序，從 0 開始；samples 必為 0。<br />
* score：子任務分數；samples 必為 0。<br />
* text：子任務描述，使用在題目描述內。<br />
* validators：僅在該子任務使用的{{slink||驗測資程式}}。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 題目敘述 ===<br />
題目敘述（statement）的檔案放置於{{slink||statement/index.md}}。使用 [[zhwiki:Markdown|Markdown]] 及 [[zhwiki:XeTeX|XeTeX]] 語法。<br />
<br />
結構由上到下依序為：<br />
# {{slink||題目圖片}}<br />
# {{slink||題目本文}}<br />
# 輸入（說明），參見{{slink||輸入及輸出說明}}<br />
# 輸出（說明），參見{{slink||輸入及輸出說明}}<br />
# {{slink||輸入限制}}<br />
# {{slink||子任務}}說明<br />
# 範例輸入，參見{{slink||範例輸入及輸出}}<br />
# 範例輸出，參見{{slink||範例輸入及輸出}}<br />
# {{slink||提示}}<br />
<br />
==== 題目圖片 ====<br />
參見{{slink|題目敘述故事|插圖}}。<br />
<br />
==== 題目本文 ====<br />
參見[[題目敘述故事]]。<br />
<br />
==== 輸入及輸出說明 ====<br />
輸入輸出說明必須明確說明參賽者要遵守的格式。<br />
<br />
應該以一行敘述測資中的一行所代表的資料，例如：<br />
* 第一行有 1 個整數，代表接下來的測資數量。<br />
* 第一行有 2 個整數，代表初始座標。<br />
<br />
如果需要在其他地方（輸入說明的其他行、輸入限制、題目本文等）提到該變數，應賦予變數代號，例如：<br />
* 第一行有 2 個整數 <math>V, E</math>，<math>V</math> 代表點的數量，<math>E</math> 代表邊的數量。<br />
* 第一行有 1 個整數 <math>N</math>，代表有 <math>N</math> 個人。...（換行）...接下來有 <math>N</math> 行，每一行有 1 個整數代表該人的分數。<br />
{{Memo|'''注意：'''同一個變數代號必須在該題目的任何地方皆相同，大小寫也必須相同。|}}<br />
<br />
==== 輸入限制 ====<br />
輸入限制用來告知參賽者測資的數值範圍限制，<br />
{| class="wikitable"<br />
|-<br />
! 原始碼 !! 顯示結果<br />
|-<br />
| <syntaxhighlight lang="markdown"><br />
- $1 \leq N \leq 100$<br />
- $1 \leq M \leq N$<br />
- $Y - X$ 必定為 2 個倍數<br />
- 若 $A = 1$，則 $B > 0$<br />
</syntaxhighlight><br />
|<br />
* <math>1 \leq N \leq 100</math><br />
* <math>1 \leq M \leq N</math><br />
* <math>Y - X</math> 必定為 2 個倍數<br />
* 若 <math>A = 1</math>，則 <math>B > 0</math><br />
|}<br />
<br />
==== 子任務說明 ====<br />
參見{{slink||子任務}}的操作，即會自動顯示於題本中。<br />
<br />
==== 範例輸入及輸出 ====<br />
範例輸入輸出必須與{{slink||產測資}}中設定的範例測資相同。<br />
<br />
{{TOJ side box<br />
|628|B. 國中會考分<br />
}}<br />
如果有多筆範例測資，標題應改命名為「範例輸入1、範例輸出1、範例輸入2、範例輸出2」等。<br />
{{clear}}<br />
<br />
{{TOJ side box<br />
|631|E. 蓋歐格（單個範例附說明）<br />
|632|F. 最小生成數（多個範例，僅有 1 個範例有說明）<br />
|637|D. 本田小狼（有圖片的範例說明）<br />
}}<br />
如果有需要說明測資，可加上「範例說明」章節，詳細說明範例測資中的意義，亦可附圖說明。<br />
<br />
{| class="wikitable"<br />
|-<br />
| style="vertical-align: top" |<br />
* 範例輸入<br />
* 範例輸出<br />
| style="vertical-align: top" |<br />
* 範例輸入1<br />
* 範例輸出1<br />
* 範例輸入2<br />
* 範例輸出2<br />
| style="vertical-align: top" |<br />
* 範例輸入1<br />
* 範例輸出1<br />
* 範例說明1<br />
* 範例輸入2<br />
* 範例輸出2<br />
|}<br />
<br />
==== 提示 ====<br />
{{TOJ side box<br />
|335|F. 參訪者們<br />
|509|C. Puyo<br />
}}<br />
如有需要，可以提供一些額外提示。如果內容為解題必須的，不應撰寫於提示，應寫於本文中。<br />
{{clear}}<br />
<br />
{{TOJ side box<br />
|330|A. Piñata<br />
|331|B. 尼莫西妮<br />
|473|A. 好哈快捷鍵<br />
}}<br />
亦可撰寫與解題毫無幫助，但與題目故事相關的小知識。<br />
{{clear}}<br />
<br />
== [[zhwiki:組建自動化|自動建置]] ==<br />
tps-starter<ref>https://github.com/TNFSH-Programming-Contest/tps-starter</ref> 使用了 GitHub Actions<ref>https://github.com/features/actions</ref>，對於建置題本和測資提供了簡易介面來執行構建，並包含自動建置、自動化測試等功能。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 建置題本 ===<br />
若要將題本編譯成 PDF，按照以下步驟操作：<br />
# 進入 GitHub repo。<br />
# 點擊 Actions。<br />
# 在 Workflows 段落，點擊 Build pdf。<ref>參考連結：https://github.com/TNFSH-Programming-Contest/TPS-example/actions/workflows/build-pdf.yml</ref><br />
# 點擊 Run workflow，在 Problem labels to build 輸入{{slink||題目編號}}，例如「B」。<br />
# 點擊藍色 Run workflow 按鈕。<br />
# 等待 PDF 題本建置完成，約 2 分鐘。<br />
# 可在對應題目的 statement/index.pdf 找到建置的 PDF。<ref>參考連結：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/statement/index.pdf</ref><br />
<br />
{{reflist-talk}}<br />
<br />
=== 自動建置題本 ===<br />
若題本已定稿，可開啟自動建置功能，之後對於相關檔案的修改都會觸發自動建置。刪除 statement/DISABLE_AUTO_BUILD<ref>https://github.com/TNFSH-Programming-Contest/tps-task-templates/blob/main/default/statement/DISABLE_AUTO_BUILD</ref> 即可開啟自動建置題本。<br />
<br />
修改以下檔案將會觸發自動建置：<br />
* scripts/statement.sh<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/scripts/statement.sh</ref><br />
* statement/*.jpg<ref>例如：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/statement/cover.jpg</ref><br />
* statement/index.md<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/statement/index.md</ref><br />
* template.tex<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/template.tex</ref><br />
* {{slink||cover.tex}}僅會構建 pA 的題本<br />
* {{slink||problem.json}}的<br />
** contest_name：{{slink||競賽名稱}}<br />
** problem_label：{{slink||題目編號}}<br />
** name：{{slink||題目英文名稱}}<br />
** title：{{slink||題目名稱}}<br />
** memory_limit：{{slink||記憶體限制}}<br />
** time_limit：{{slink||時間限制}}<br />
* {{slink||subtasks.json}}的 index、score、text ，參見{{slink||子任務}}。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 合併題本 ===<br />
在所有題目的題本皆完成，才進行合併題本，參考{{slink||建置題本}}的操作，在第 4 步驟的 Problem labels to build 輸入「+」，即會合併題本輸出於 pA/attachments/problems.pdf。<ref>參考連結：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pA/attachments/problems.pdf</ref><br />
<br />
{{reflist-talk}}<br />
<br />
=== 建置測資 ===<br />
若要自動產生測資 input、output、進行標程比較：<br />
# 進入 GitHub repo。<br />
# 點擊 Actions。<br />
# 在 Workflows 段落，點擊 Build tests。<ref>參考連結：https://github.com/TNFSH-Programming-Contest/TPS-example/actions/workflows/build-tests.yml</ref><br />
# 點擊 Run workflow。<br />
#* 若修改了{{slink||產測資}}程式，在 Problem labels to build inputs 輸入{{slink||題目編號}}，例如「B」，其他欄位不需重複輸入題號。將會自動建置輸入及輸出，若測資有變動，亦會自動測試標程。<br />
#* 若僅修改了{{slink||標程}}，導致僅有輸出會變動，在 Problem labels to build outputs 輸入{{slink||題目編號}}，其他欄位不需重複輸入題號。將會自動建置輸出，若測資有變動，亦會自動測試標程。<br />
#* 若僅要重新執行標程測試，在 Problem labels to run solutions 輸入{{slink||題目編號}}。<br />
# 點擊藍色 Run workflow 按鈕。<br />
# 等待測資建置完成。<br />
# 可在對應題目的{{slink||tests}}資料夾找到建置的測資。標程測試則在{{slink||solutions-check.txt}}。<br />
<br />
{{reflist-talk}}<br />
<br />
=== 自動建置測資 ===<br />
若產測資程式和標程皆已定稿，可開啟自動建置功能，之後對於相關檔案的修改都會觸發自動建置。刪除 gen/DISABLE_AUTO_BUILD<ref>https://github.com/TNFSH-Programming-Contest/tps-task-templates/blob/main/default/gen/DISABLE_AUTO_BUILD</ref> 即可開啟自動建置測資。<br />
<br />
修改以下檔案將會觸發自動建置 input：<br />
* {{slink||gen}}內的所有檔案<br />
<br />
修改以下檔案將會觸發自動建置 output：<br />
* 在{{slink||solutions.json}}內設定的 model_solution 對應檔案。請注意：若變更 model_solution 的目標檔案可能不會觸發自動建置。<br />
<br />
修改以下檔案將會觸發自動建置 solutions：<br />
* {{slink||solution}}內的所有檔案<br />
* {{slink||solutions.json}}<br />
<br />
{{reflist-talk}}<br />
<br />
=== 跳過自動建置 ===<br />
若已經啟用自動建置，但想在特定一筆 Commit 跳過自動建置，請在 Commit message 加上 <code>[no ci]</code>，例如：<br />
<syntaxhighlight lang="text">pA Add wa.cpp<br />
<br />
Add WA solution without swap<br />
[no ci]<br />
</syntaxhighlight><br />
<br />
完整說明參見 [https://docs.github.com/en/actions/managing-workflow-runs/skipping-workflow-runs Skipping workflow runs - GitHub Docs]。</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=TOJ&diff=467
TOJ
2025-02-02T08:33:12Z
<p>Tobiichi3227：python checker 應指定 shebang</p>
<hr />
<div>[[Category:TOJ]]<br />
<br />
https://toj.tfcis.org/oj/<br />
<br />
* 社團練習用的Online Judge<br />
* 由[[T13]]的[[吳哲宇]]([[pzread]])開發<br />
* [[T19]]的[[lys0829]]於2017年將judge更新<br />
* [[T24]]的[[tobiichi3227]]與[[ccccchhhheeenng]]於2022年將後端Server的軟硬體更新<br />
<br />
== 出題 ==<br />
以下內容均為 Problem Package 的形式，TOJ 已經支援用 UI 新增題目了<br />
=== 一般題目 ===<br />
limit欄位的 default 一定要存在，其餘可以填寫 TOJ 支援的編譯器 (gcc, g++, clang, clang++, python3, rust, java)<br />
<br />
記憶體限制的單位是 KB<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
},<br />
"python3": {<br />
"timelimit": 2500,<br />
"memlimit": 524288,<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
check欄位可以填 "diff", "diff-strict"<br />
{| class="wikitable"<br />
|-<br />
! Type !! 解釋<br />
|-<br />
| diff || 寬鬆比對<br />
|-<br />
| diff-strict || 嚴格比對<br />
|}<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": false,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5, "hard-1"<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
data的部份是測資檔案名稱<br />
需將檔案放到 /res/testdata 下面<br />
<br />
輸入輸出檔都需要 (.in, .out)<br />
<br />
=== Makefile題目 (編譯互動題) ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": true,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
在 res/make 新增 Makefile 與 要編譯的檔案<br />
;/res/make/Makefile<br />
<syntaxhighlight lang="make"><br />
default:<br />
g++ main.cpp stub.cpp -o $(OUT)<br />
</syntaxhighlight><br />
stub.cpp 可以自己換成其他要一起編譯的檔案，編譯選項可以自行修改<br />
<br />
=== CMS/Testlib Checker ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"check": "cms",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
會傳入三個參數，分別為測資輸入，測資輸出，答案輸入<br />
<syntaxhighlight lang="C++"><br />
#include <fstream><br />
int main(int argc, char** argv) {<br />
std::ifstream test_in(argv[1]);<br />
std::ifstream test_out(argv[2]);<br />
std::ifstream ans_in(argv[3]);<br />
<br />
// C<br />
FILE* test_in_ptr = fopen(argv[1], "r");<br />
FILE* test_out_ptr = fopen(argv[2], "r");<br />
FILE* ans_in_ptr = fopen(argv[3], "r");<br />
<br />
fclose(test_in_ptr);<br />
fclose(test_out_ptr);<br />
fclose(ans_in_ptr);<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.py<br />
<syntaxhighlight lang="python"><br />
#!/bin/python3<br />
import sys<br />
<br />
test_in = open(sys.argv[1])<br />
test_out = open(sys.argv[2])<br />
ans_in = open(sys.argv[3])<br />
<br />
test_in.close()<br />
test_out.close()<br />
ans_in.close()<br />
</syntaxhighlight><br />
<br />
==== Verdict Message (Checker Message) ====<br />
對標準錯誤 (STDERR) 輸出 verdict message<br />
<br />
C/C++<br />
<syntaxhighlight lang="C++"><br />
#include <iostream><br />
std::cerr << "checker message" << std::endl;<br />
<br />
#include <cstdio><br />
fprintf(stderr, "checker message");<br />
</syntaxhighlight><br />
<br />
Python<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
print("checker message", sys.stderr)<br />
</syntaxhighlight><br />
<br />
==== Special Score & Status ====<br />
對標準輸出 (STDOUT) 輸出 Special Score & Status，輸出標準如下<br />
ScoreType;Score;Status<br />
<br />
===== Score =====<br />
ScoreType 可以是 NONE, CMS, CF<br />
<br />
NONE 代表 Judge 不會理會 Score 的值<br />
<br />
CMS 代表 Judge 會將 該題子任務分數乘上 Score (與 CMS 的 GroupMin 相同)，且 Score 範圍應該從 0.0 到 1.0，大於 1.0 將設定為 1.0，小於 0.0 將設定為 0.0<br />
<br />
CF 代表 Judge 會直接用 Score 覆蓋該子任務分數<br />
<br />
===== Status =====<br />
Status 可以是 TOJ 所支援的所有 Status (AC, PC, WA, RE, RESIG, TLE, MLE, OLE, CE, CLE, SJE, IE)<br />
<br />
如果 Status 為空 或 不在支援的 Status 中將按照 Checker 回傳值決定狀態 (return 0 為 AC，其餘為 WA)<br />
<br />
下面列出幾個作為參考<br />
{| class="wikitable"<br />
|-<br />
! STDOUT String !! Score !! Status<br />
|-<br />
| CMS;0.5;PC || 子任務分數 * 0.5 || PC (Partial Correct)<br />
|-<br />
| CF;32.27;AC || 32.27 || AC (Answer Correct)<br />
|-<br />
| NONE;3131;WA || 子任務分數 || WA (Wrong Answer)<br />
|-<br />
| CF;32.27; || 32.27 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| ;; || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| (沒有任何輸出) || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|}<br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
# python<br />
# cp check.py check<br />
# chmod +x check<br />
</syntaxhighlight><br />
<br />
=== IORedir ===<br />
將[https://github.com/TFcis/Problem-setting-tools/blob/master/TOJ-problem-example/conf.json conf.json]中的 check 從 diff 改成 ioredir，及設定 metadata 如下。<br />
如果 Checker 的 STDOUT 或 STDERR 沒有被佔用且有輸出內容，那 Verdict Message (Checker Message) 將會為該內容 (如果兩個同時都有，STDERR 優先於 STDOUT<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON">{<br />
"check": "ioredir",<br />
"metadata": {<br />
"redir_test": {<br />
"pipeout": 1,<br />
"testin": 0,<br />
"testout": -1,<br />
"pipein": -1<br />
},<br />
"redir_check": {<br />
"ansin": 2,<br />
"testin": -1,<br />
"pipeout": 0,<br />
"pipein": -1<br />
}<br />
}<br />
}</syntaxhighlight><br />
<br />
如果要用 ioredir 實現互動題， metadata 可以這樣寫<br />
<br />
從 STDERR 讀入測資，對 STDOUT 輸出測資<br />
從 STDIN 讀入答案<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"redir_test": {<br />
"pipein": 0,<br />
"testin": -1,<br />
"pipeout": 1,<br />
"testout": -1<br />
},<br />
"redir_check": {<br />
"ansin": -1,<br />
"pipein": 1,<br />
"testin": 2,<br />
"pipeout": 0<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
分別從答案及輸出分別讀入long double。<br />
<syntaxhighlight lang="C++"><br />
long double Answer, Output;<br />
FILE *ansf = fdopen(2, "r");<br />
<br />
scanf("%Lf", &Output);<br />
fscanf(ansf, "%Lf", &Answer);<br />
</syntaxhighlight><br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
</syntaxhighlight><br />
<br />
參考 https://hackmd.io/s/BkHdt57I<br />
<br />
=== Polygon to TOJ ===<br />
請參考 [https://github.com/TFcis/cf2toj cf2toj]<br />
<br />
=== TPS to TOJ ===<br />
請參考 [https://github.com/TFcis/tps2toj tps2toj]<br />
<br />
=== CMS to TOJ ===<br />
請參考 [https://github.com/TFcis/cms2toj cms2toj]<br />
<br />
=== 小技巧 ===<br />
==== OI制 (APCS) ====<br />
可以只上傳範例測資，並把該子任務分數設定為 0<br />
<br />
==== Dependency Tree ====<br />
假設 subtask2 依賴 subtask1<br />
可以把 subtask1 的所有測資檔名複製到 subtask2 的測資中<br />
<br />
==== 偷偷支援目前 TOJ 無法使用的語言 ====<br />
前提：Judge 本身需要支援<br />
可以使用 Makefile 類型的題目<br />
並在編譯時使用其他語言<br />
<br />
==== 負分 ====<br />
TOJ其實可以設定子任務分數為負數，但可能會有很多問題<br />
Scoreboard 應該選擇 IOI2013<br />
<br />
== 參見 ==<br />
* [[TOJ API]]：API文檔<br />
* [https://github.com/pzread/judge judge原始碼]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=TOJ&diff=466
TOJ
2024-10-22T08:08:57Z
<p>Tobiichi3227：小技巧-負分</p>
<hr />
<div>[[Category:TOJ]]<br />
<br />
https://toj.tfcis.org/oj/<br />
<br />
* 社團練習用的Online Judge<br />
* 由[[T13]]的[[吳哲宇]]([[pzread]])開發<br />
* [[T19]]的[[lys0829]]於2017年將judge更新<br />
* [[T24]]的[[tobiichi3227]]與[[ccccchhhheeenng]]於2022年將後端Server的軟硬體更新<br />
<br />
== 出題 ==<br />
以下內容均為 Problem Package 的形式，TOJ 已經支援用 UI 新增題目了<br />
=== 一般題目 ===<br />
limit欄位的 default 一定要存在，其餘可以填寫 TOJ 支援的編譯器 (gcc, g++, clang, clang++, python3, rust, java)<br />
<br />
記憶體限制的單位是 KB<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
},<br />
"python3": {<br />
"timelimit": 2500,<br />
"memlimit": 524288,<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
check欄位可以填 "diff", "diff-strict"<br />
{| class="wikitable"<br />
|-<br />
! Type !! 解釋<br />
|-<br />
| diff || 寬鬆比對<br />
|-<br />
| diff-strict || 嚴格比對<br />
|}<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": false,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5, "hard-1"<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
data的部份是測資檔案名稱<br />
需將檔案放到 /res/testdata 下面<br />
<br />
輸入輸出檔都需要 (.in, .out)<br />
<br />
=== Makefile題目 (編譯互動題) ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": true,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
在 res/make 新增 Makefile 與 要編譯的檔案<br />
;/res/make/Makefile<br />
<syntaxhighlight lang="make"><br />
default:<br />
g++ main.cpp stub.cpp -o $(OUT)<br />
</syntaxhighlight><br />
stub.cpp 可以自己換成其他要一起編譯的檔案，編譯選項可以自行修改<br />
<br />
=== CMS/Testlib Checker ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"check": "cms",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
會傳入三個參數，分別為測資輸入，測資輸出，答案輸入<br />
<syntaxhighlight lang="C++"><br />
#include <fstream><br />
int main(int argc, char** argv) {<br />
std::ifstream test_in(argv[1]);<br />
std::ifstream test_out(argv[2]);<br />
std::ifstream ans_in(argv[3]);<br />
<br />
// C<br />
FILE* test_in_ptr = fopen(argv[1], "r");<br />
FILE* test_out_ptr = fopen(argv[2], "r");<br />
FILE* ans_in_ptr = fopen(argv[3], "r");<br />
<br />
fclose(test_in_ptr);<br />
fclose(test_out_ptr);<br />
fclose(ans_in_ptr);<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.py<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
<br />
test_in = open(sys.argv[1])<br />
test_out = open(sys.argv[2])<br />
ans_in = open(sys.argv[3])<br />
<br />
test_in.close()<br />
test_out.close()<br />
ans_in.close()<br />
</syntaxhighlight><br />
<br />
==== Verdict Message (Checker Message) ====<br />
對標準錯誤 (STDERR) 輸出 verdict message<br />
<br />
C/C++<br />
<syntaxhighlight lang="C++"><br />
#include <iostream><br />
std::cerr << "checker message" << std::endl;<br />
<br />
#include <cstdio><br />
fprintf(stderr, "checker message");<br />
</syntaxhighlight><br />
<br />
Python<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
print("checker message", sys.stderr)<br />
</syntaxhighlight><br />
<br />
==== Special Score & Status ====<br />
對標準輸出 (STDOUT) 輸出 Special Score & Status，輸出標準如下<br />
ScoreType;Score;Status<br />
<br />
===== Score =====<br />
ScoreType 可以是 NONE, CMS, CF<br />
<br />
NONE 代表 Judge 不會理會 Score 的值<br />
<br />
CMS 代表 Judge 會將 該題子任務分數乘上 Score (與 CMS 的 GroupMin 相同)，且 Score 範圍應該從 0.0 到 1.0，大於 1.0 將設定為 1.0，小於 0.0 將設定為 0.0<br />
<br />
CF 代表 Judge 會直接用 Score 覆蓋該子任務分數<br />
<br />
===== Status =====<br />
Status 可以是 TOJ 所支援的所有 Status (AC, PC, WA, RE, RESIG, TLE, MLE, OLE, CE, CLE, SJE, IE)<br />
<br />
如果 Status 為空 或 不在支援的 Status 中將按照 Checker 回傳值決定狀態 (return 0 為 AC，其餘為 WA)<br />
<br />
下面列出幾個作為參考<br />
{| class="wikitable"<br />
|-<br />
! STDOUT String !! Score !! Status<br />
|-<br />
| CMS;0.5;PC || 子任務分數 * 0.5 || PC (Partial Correct)<br />
|-<br />
| CF;32.27;AC || 32.27 || AC (Answer Correct)<br />
|-<br />
| NONE;3131;WA || 子任務分數 || WA (Wrong Answer)<br />
|-<br />
| CF;32.27; || 32.27 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| ;; || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| (沒有任何輸出) || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|}<br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
# python<br />
# cp check.py check<br />
# chmod +x check<br />
</syntaxhighlight><br />
<br />
=== IORedir ===<br />
將[https://github.com/TFcis/Problem-setting-tools/blob/master/TOJ-problem-example/conf.json conf.json]中的 check 從 diff 改成 ioredir，及設定 metadata 如下。<br />
如果 Checker 的 STDOUT 或 STDERR 沒有被佔用且有輸出內容，那 Verdict Message (Checker Message) 將會為該內容 (如果兩個同時都有，STDERR 優先於 STDOUT<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON">{<br />
"check": "ioredir",<br />
"metadata": {<br />
"redir_test": {<br />
"pipeout": 1,<br />
"testin": 0,<br />
"testout": -1,<br />
"pipein": -1<br />
},<br />
"redir_check": {<br />
"ansin": 2,<br />
"testin": -1,<br />
"pipeout": 0,<br />
"pipein": -1<br />
}<br />
}<br />
}</syntaxhighlight><br />
<br />
如果要用 ioredir 實現互動題， metadata 可以這樣寫<br />
<br />
從 STDERR 讀入測資，對 STDOUT 輸出測資<br />
從 STDIN 讀入答案<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"redir_test": {<br />
"pipein": 0,<br />
"testin": -1,<br />
"pipeout": 1,<br />
"testout": -1<br />
},<br />
"redir_check": {<br />
"ansin": -1,<br />
"pipein": 1,<br />
"testin": 2,<br />
"pipeout": 0<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
分別從答案及輸出分別讀入long double。<br />
<syntaxhighlight lang="C++"><br />
long double Answer, Output;<br />
FILE *ansf = fdopen(2, "r");<br />
<br />
scanf("%Lf", &Output);<br />
fscanf(ansf, "%Lf", &Answer);<br />
</syntaxhighlight><br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
</syntaxhighlight><br />
<br />
參考 https://hackmd.io/s/BkHdt57I<br />
<br />
=== Polygon to TOJ ===<br />
請參考 [https://github.com/TFcis/cf2toj cf2toj]<br />
<br />
=== TPS to TOJ ===<br />
請參考 [https://github.com/TFcis/tps2toj tps2toj]<br />
<br />
=== CMS to TOJ ===<br />
請參考 [https://github.com/TFcis/cms2toj cms2toj]<br />
<br />
=== 小技巧 ===<br />
==== OI制 (APCS) ====<br />
可以只上傳範例測資，並把該子任務分數設定為 0<br />
<br />
==== Dependency Tree ====<br />
假設 subtask2 依賴 subtask1<br />
可以把 subtask1 的所有測資檔名複製到 subtask2 的測資中<br />
<br />
==== 偷偷支援目前 TOJ 無法使用的語言 ====<br />
前提：Judge 本身需要支援<br />
可以使用 Makefile 類型的題目<br />
並在編譯時使用其他語言<br />
<br />
==== 負分 ====<br />
TOJ其實可以設定子任務分數為負數，但可能會有很多問題<br />
Scoreboard 應該選擇 IOI2013<br />
<br />
== 參見 ==<br />
* [[TOJ API]]：API文檔<br />
* [https://github.com/pzread/judge judge原始碼]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=TOJ&diff=465
TOJ
2024-10-22T07:35:53Z
<p>Tobiichi3227：新增一些小技巧</p>
<hr />
<div>[[Category:TOJ]]<br />
<br />
https://toj.tfcis.org/oj/<br />
<br />
* 社團練習用的Online Judge<br />
* 由[[T13]]的[[吳哲宇]]([[pzread]])開發<br />
* [[T19]]的[[lys0829]]於2017年將judge更新<br />
* [[T24]]的[[tobiichi3227]]與[[ccccchhhheeenng]]於2022年將後端Server的軟硬體更新<br />
<br />
== 出題 ==<br />
以下內容均為 Problem Package 的形式，TOJ 已經支援用 UI 新增題目了<br />
=== 一般題目 ===<br />
limit欄位的 default 一定要存在，其餘可以填寫 TOJ 支援的編譯器 (gcc, g++, clang, clang++, python3, rust, java)<br />
<br />
記憶體限制的單位是 KB<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
},<br />
"python3": {<br />
"timelimit": 2500,<br />
"memlimit": 524288,<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
check欄位可以填 "diff", "diff-strict"<br />
{| class="wikitable"<br />
|-<br />
! Type !! 解釋<br />
|-<br />
| diff || 寬鬆比對<br />
|-<br />
| diff-strict || 嚴格比對<br />
|}<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": false,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5, "hard-1"<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
data的部份是測資檔案名稱<br />
需將檔案放到 /res/testdata 下面<br />
<br />
輸入輸出檔都需要 (.in, .out)<br />
<br />
=== Makefile題目 (編譯互動題) ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": true,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
在 res/make 新增 Makefile 與 要編譯的檔案<br />
;/res/make/Makefile<br />
<syntaxhighlight lang="make"><br />
default:<br />
g++ main.cpp stub.cpp -o $(OUT)<br />
</syntaxhighlight><br />
stub.cpp 可以自己換成其他要一起編譯的檔案，編譯選項可以自行修改<br />
<br />
=== CMS/Testlib Checker ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"check": "cms",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
會傳入三個參數，分別為測資輸入，測資輸出，答案輸入<br />
<syntaxhighlight lang="C++"><br />
#include <fstream><br />
int main(int argc, char** argv) {<br />
std::ifstream test_in(argv[1]);<br />
std::ifstream test_out(argv[2]);<br />
std::ifstream ans_in(argv[3]);<br />
<br />
// C<br />
FILE* test_in_ptr = fopen(argv[1], "r");<br />
FILE* test_out_ptr = fopen(argv[2], "r");<br />
FILE* ans_in_ptr = fopen(argv[3], "r");<br />
<br />
fclose(test_in_ptr);<br />
fclose(test_out_ptr);<br />
fclose(ans_in_ptr);<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.py<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
<br />
test_in = open(sys.argv[1])<br />
test_out = open(sys.argv[2])<br />
ans_in = open(sys.argv[3])<br />
<br />
test_in.close()<br />
test_out.close()<br />
ans_in.close()<br />
</syntaxhighlight><br />
<br />
==== Verdict Message (Checker Message) ====<br />
對標準錯誤 (STDERR) 輸出 verdict message<br />
<br />
C/C++<br />
<syntaxhighlight lang="C++"><br />
#include <iostream><br />
std::cerr << "checker message" << std::endl;<br />
<br />
#include <cstdio><br />
fprintf(stderr, "checker message");<br />
</syntaxhighlight><br />
<br />
Python<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
print("checker message", sys.stderr)<br />
</syntaxhighlight><br />
<br />
==== Special Score & Status ====<br />
對標準輸出 (STDOUT) 輸出 Special Score & Status，輸出標準如下<br />
ScoreType;Score;Status<br />
<br />
===== Score =====<br />
ScoreType 可以是 NONE, CMS, CF<br />
<br />
NONE 代表 Judge 不會理會 Score 的值<br />
<br />
CMS 代表 Judge 會將 該題子任務分數乘上 Score (與 CMS 的 GroupMin 相同)，且 Score 範圍應該從 0.0 到 1.0，大於 1.0 將設定為 1.0，小於 0.0 將設定為 0.0<br />
<br />
CF 代表 Judge 會直接用 Score 覆蓋該子任務分數<br />
<br />
===== Status =====<br />
Status 可以是 TOJ 所支援的所有 Status (AC, PC, WA, RE, RESIG, TLE, MLE, OLE, CE, CLE, SJE, IE)<br />
<br />
如果 Status 為空 或 不在支援的 Status 中將按照 Checker 回傳值決定狀態 (return 0 為 AC，其餘為 WA)<br />
<br />
下面列出幾個作為參考<br />
{| class="wikitable"<br />
|-<br />
! STDOUT String !! Score !! Status<br />
|-<br />
| CMS;0.5;PC || 子任務分數 * 0.5 || PC (Partial Correct)<br />
|-<br />
| CF;32.27;AC || 32.27 || AC (Answer Correct)<br />
|-<br />
| NONE;3131;WA || 子任務分數 || WA (Wrong Answer)<br />
|-<br />
| CF;32.27; || 32.27 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| ;; || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| (沒有任何輸出) || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|}<br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
# python<br />
# cp check.py check<br />
# chmod +x check<br />
</syntaxhighlight><br />
<br />
=== IORedir ===<br />
將[https://github.com/TFcis/Problem-setting-tools/blob/master/TOJ-problem-example/conf.json conf.json]中的 check 從 diff 改成 ioredir，及設定 metadata 如下。<br />
如果 Checker 的 STDOUT 或 STDERR 沒有被佔用且有輸出內容，那 Verdict Message (Checker Message) 將會為該內容 (如果兩個同時都有，STDERR 優先於 STDOUT<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON">{<br />
"check": "ioredir",<br />
"metadata": {<br />
"redir_test": {<br />
"pipeout": 1,<br />
"testin": 0,<br />
"testout": -1,<br />
"pipein": -1<br />
},<br />
"redir_check": {<br />
"ansin": 2,<br />
"testin": -1,<br />
"pipeout": 0,<br />
"pipein": -1<br />
}<br />
}<br />
}</syntaxhighlight><br />
<br />
如果要用 ioredir 實現互動題， metadata 可以這樣寫<br />
<br />
從 STDERR 讀入測資，對 STDOUT 輸出測資<br />
從 STDIN 讀入答案<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"redir_test": {<br />
"pipein": 0,<br />
"testin": -1,<br />
"pipeout": 1,<br />
"testout": -1<br />
},<br />
"redir_check": {<br />
"ansin": -1,<br />
"pipein": 1,<br />
"testin": 2,<br />
"pipeout": 0<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
分別從答案及輸出分別讀入long double。<br />
<syntaxhighlight lang="C++"><br />
long double Answer, Output;<br />
FILE *ansf = fdopen(2, "r");<br />
<br />
scanf("%Lf", &Output);<br />
fscanf(ansf, "%Lf", &Answer);<br />
</syntaxhighlight><br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
</syntaxhighlight><br />
<br />
參考 https://hackmd.io/s/BkHdt57I<br />
<br />
=== Polygon to TOJ ===<br />
請參考 [https://github.com/TFcis/cf2toj cf2toj]<br />
<br />
=== TPS to TOJ ===<br />
請參考 [https://github.com/TFcis/tps2toj tps2toj]<br />
<br />
=== CMS to TOJ ===<br />
請參考 [https://github.com/TFcis/cms2toj cms2toj]<br />
<br />
=== 小技巧 ===<br />
==== OI制 (APCS) ====<br />
可以只上傳範例測資，並把該子任務分數設定為 0<br />
<br />
==== Dependency Tree ====<br />
假設 subtask2 依賴 subtask1<br />
可以把 subtask1 的所有測資檔名複製到 subtask2 的測資中<br />
<br />
==== 偷偷支援目前 TOJ 無法使用的語言 ====<br />
前提：Judge 本身需要支援<br />
可以使用 Makefile 類型的題目<br />
並在編譯時使用其他語言<br />
<br />
== 參見 ==<br />
* [[TOJ API]]：API文檔<br />
* [https://github.com/pzread/judge judge原始碼]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=TOJ&diff=464
TOJ
2024-10-15T07:38:46Z
<p>Tobiichi3227：新增測資</p>
<hr />
<div>[[Category:TOJ]]<br />
<br />
https://toj.tfcis.org/oj/<br />
<br />
* 社團練習用的Online Judge<br />
* 由[[T13]]的[[吳哲宇]]([[pzread]])開發<br />
* [[T19]]的[[lys0829]]於2017年將judge更新<br />
* [[T24]]的[[tobiichi3227]]與[[ccccchhhheeenng]]於2022年將後端Server的軟硬體更新<br />
<br />
== 出題 ==<br />
以下內容均為 Problem Package 的形式，TOJ 已經支援用 UI 新增題目了<br />
=== 一般題目 ===<br />
limit欄位的 default 一定要存在，其餘可以填寫 TOJ 支援的編譯器 (gcc, g++, clang, clang++, python3, rust, java)<br />
<br />
記憶體限制的單位是 KB<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
},<br />
"python3": {<br />
"timelimit": 2500,<br />
"memlimit": 524288,<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
check欄位可以填 "diff", "diff-strict"<br />
{| class="wikitable"<br />
|-<br />
! Type !! 解釋<br />
|-<br />
| diff || 寬鬆比對<br />
|-<br />
| diff-strict || 嚴格比對<br />
|}<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": false,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5, "hard-1"<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
data的部份是測資檔案名稱<br />
需將檔案放到 /res/testdata 下面<br />
<br />
輸入輸出檔都需要 (.in, .out)<br />
<br />
=== Makefile題目 (編譯互動題) ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": true,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
在 res/make 新增 Makefile 與 要編譯的檔案<br />
;/res/make/Makefile<br />
<syntaxhighlight lang="make"><br />
default:<br />
g++ main.cpp stub.cpp -o $(OUT)<br />
</syntaxhighlight><br />
stub.cpp 可以自己換成其他要一起編譯的檔案，編譯選項可以自行修改<br />
<br />
=== CMS/Testlib Checker ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"check": "cms",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
會傳入三個參數，分別為測資輸入，測資輸出，答案輸入<br />
<syntaxhighlight lang="C++"><br />
#include <fstream><br />
int main(int argc, char** argv) {<br />
std::ifstream test_in(argv[1]);<br />
std::ifstream test_out(argv[2]);<br />
std::ifstream ans_in(argv[3]);<br />
<br />
// C<br />
FILE* test_in_ptr = fopen(argv[1], "r");<br />
FILE* test_out_ptr = fopen(argv[2], "r");<br />
FILE* ans_in_ptr = fopen(argv[3], "r");<br />
<br />
fclose(test_in_ptr);<br />
fclose(test_out_ptr);<br />
fclose(ans_in_ptr);<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.py<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
<br />
test_in = open(sys.argv[1])<br />
test_out = open(sys.argv[2])<br />
ans_in = open(sys.argv[3])<br />
<br />
test_in.close()<br />
test_out.close()<br />
ans_in.close()<br />
</syntaxhighlight><br />
<br />
==== Verdict Message (Checker Message) ====<br />
對標準錯誤 (STDERR) 輸出 verdict message<br />
<br />
C/C++<br />
<syntaxhighlight lang="C++"><br />
#include <iostream><br />
std::cerr << "checker message" << std::endl;<br />
<br />
#include <cstdio><br />
fprintf(stderr, "checker message");<br />
</syntaxhighlight><br />
<br />
Python<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
print("checker message", sys.stderr)<br />
</syntaxhighlight><br />
<br />
==== Special Score & Status ====<br />
對標準輸出 (STDOUT) 輸出 Special Score & Status，輸出標準如下<br />
ScoreType;Score;Status<br />
<br />
===== Score =====<br />
ScoreType 可以是 NONE, CMS, CF<br />
<br />
NONE 代表 Judge 不會理會 Score 的值<br />
<br />
CMS 代表 Judge 會將 該題子任務分數乘上 Score (與 CMS 的 GroupMin 相同)，且 Score 範圍應該從 0.0 到 1.0，大於 1.0 將設定為 1.0，小於 0.0 將設定為 0.0<br />
<br />
CF 代表 Judge 會直接用 Score 覆蓋該子任務分數<br />
<br />
===== Status =====<br />
Status 可以是 TOJ 所支援的所有 Status (AC, PC, WA, RE, RESIG, TLE, MLE, OLE, CE, CLE, SJE, IE)<br />
<br />
如果 Status 為空 或 不在支援的 Status 中將按照 Checker 回傳值決定狀態 (return 0 為 AC，其餘為 WA)<br />
<br />
下面列出幾個作為參考<br />
{| class="wikitable"<br />
|-<br />
! STDOUT String !! Score !! Status<br />
|-<br />
| CMS;0.5;PC || 子任務分數 * 0.5 || PC (Partial Correct)<br />
|-<br />
| CF;32.27;AC || 32.27 || AC (Answer Correct)<br />
|-<br />
| NONE;3131;WA || 子任務分數 || WA (Wrong Answer)<br />
|-<br />
| CF;32.27; || 32.27 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| ;; || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| (沒有任何輸出) || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|}<br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
# python<br />
# cp check.py check<br />
# chmod +x check<br />
</syntaxhighlight><br />
<br />
=== IORedir ===<br />
將[https://github.com/TFcis/Problem-setting-tools/blob/master/TOJ-problem-example/conf.json conf.json]中的 check 從 diff 改成 ioredir，及設定 metadata 如下。<br />
如果 Checker 的 STDOUT 或 STDERR 沒有被佔用且有輸出內容，那 Verdict Message (Checker Message) 將會為該內容 (如果兩個同時都有，STDERR 優先於 STDOUT<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON">{<br />
"check": "ioredir",<br />
"metadata": {<br />
"redir_test": {<br />
"pipeout": 1,<br />
"testin": 0,<br />
"testout": -1,<br />
"pipein": -1<br />
},<br />
"redir_check": {<br />
"ansin": 2,<br />
"testin": -1,<br />
"pipeout": 0,<br />
"pipein": -1<br />
}<br />
}<br />
}</syntaxhighlight><br />
<br />
如果要用 ioredir 實現互動題， metadata 可以這樣寫<br />
<br />
從 STDERR 讀入測資，對 STDOUT 輸出測資<br />
從 STDIN 讀入答案<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"redir_test": {<br />
"pipein": 0,<br />
"testin": -1,<br />
"pipeout": 1,<br />
"testout": -1<br />
},<br />
"redir_check": {<br />
"ansin": -1,<br />
"pipein": 1,<br />
"testin": 2,<br />
"pipeout": 0<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
分別從答案及輸出分別讀入long double。<br />
<syntaxhighlight lang="C++"><br />
long double Answer, Output;<br />
FILE *ansf = fdopen(2, "r");<br />
<br />
scanf("%Lf", &Output);<br />
fscanf(ansf, "%Lf", &Answer);<br />
</syntaxhighlight><br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
</syntaxhighlight><br />
<br />
參考 https://hackmd.io/s/BkHdt57I<br />
<br />
=== Polygon to TOJ ===<br />
請參考 [https://github.com/TFcis/cf2toj cf2toj]<br />
<br />
=== TPS to TOJ ===<br />
請參考 [https://github.com/TFcis/tps2toj tps2toj]<br />
<br />
=== CMS to TOJ ===<br />
請參考 [https://github.com/TFcis/cms2toj cms2toj]<br />
<br />
== 參見 ==<br />
* [[TOJ API]]：API文檔<br />
* [https://github.com/pzread/judge judge原始碼]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=TOJ&diff=463
TOJ
2024-10-15T07:18:16Z
<p>Tobiichi3227：加上 makefile部份</p>
<hr />
<div>[[Category:TOJ]]<br />
<br />
https://toj.tfcis.org/oj/<br />
<br />
* 社團練習用的Online Judge<br />
* 由[[T13]]的[[吳哲宇]]([[pzread]])開發<br />
* [[T19]]的[[lys0829]]於2017年將judge更新<br />
* [[T24]]的[[tobiichi3227]]與[[ccccchhhheeenng]]於2022年將後端Server的軟硬體更新<br />
<br />
== 出題 ==<br />
以下內容均為 Problem Package 的形式，TOJ 已經支援用 UI 新增題目了<br />
=== 一般題目 ===<br />
limit欄位的 default 一定要存在，其餘可以填寫 TOJ 支援的編譯器 (gcc, g++, clang, clang++, python3, rust, java)<br />
<br />
記憶體限制的單位是 KB<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
},<br />
"python3": {<br />
"timelimit": 2500,<br />
"memlimit": 524288,<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
check欄位可以填 "diff", "diff-strict"<br />
{| class="wikitable"<br />
|-<br />
! Type !! 解釋<br />
|-<br />
| diff || 寬鬆比對<br />
|-<br />
| diff-strict || 嚴格比對<br />
|}<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": false,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
=== Makefile題目 (編譯互動題) ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": true,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
在 res/make 新增 Makefile 與 要編譯的檔案<br />
;/res/make/Makefile<br />
<syntaxhighlight lang="make"><br />
default:<br />
g++ main.cpp stub.cpp -o $(OUT)<br />
</syntaxhighlight><br />
stub.cpp 可以自己換成其他要一起編譯的檔案，編譯選項可以自行修改<br />
<br />
=== CMS/Testlib Checker ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"check": "cms",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
會傳入三個參數，分別為測資輸入，測資輸出，答案輸入<br />
<syntaxhighlight lang="C++"><br />
#include <fstream><br />
int main(int argc, char** argv) {<br />
std::ifstream test_in(argv[1]);<br />
std::ifstream test_out(argv[2]);<br />
std::ifstream ans_in(argv[3]);<br />
<br />
// C<br />
FILE* test_in_ptr = fopen(argv[1], "r");<br />
FILE* test_out_ptr = fopen(argv[2], "r");<br />
FILE* ans_in_ptr = fopen(argv[3], "r");<br />
<br />
fclose(test_in_ptr);<br />
fclose(test_out_ptr);<br />
fclose(ans_in_ptr);<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.py<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
<br />
test_in = open(sys.argv[1])<br />
test_out = open(sys.argv[2])<br />
ans_in = open(sys.argv[3])<br />
<br />
test_in.close()<br />
test_out.close()<br />
ans_in.close()<br />
</syntaxhighlight><br />
<br />
==== Verdict Message (Checker Message) ====<br />
對標準錯誤 (STDERR) 輸出 verdict message<br />
<br />
C/C++<br />
<syntaxhighlight lang="C++"><br />
#include <iostream><br />
std::cerr << "checker message" << std::endl;<br />
<br />
#include <cstdio><br />
fprintf(stderr, "checker message");<br />
</syntaxhighlight><br />
<br />
Python<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
print("checker message", sys.stderr)<br />
</syntaxhighlight><br />
<br />
==== Special Score & Status ====<br />
對標準輸出 (STDOUT) 輸出 Special Score & Status，輸出標準如下<br />
ScoreType;Score;Status<br />
<br />
===== Score =====<br />
ScoreType 可以是 NONE, CMS, CF<br />
<br />
NONE 代表 Judge 不會理會 Score 的值<br />
<br />
CMS 代表 Judge 會將 該題子任務分數乘上 Score (與 CMS 的 GroupMin 相同)，且 Score 範圍應該從 0.0 到 1.0，大於 1.0 將設定為 1.0，小於 0.0 將設定為 0.0<br />
<br />
CF 代表 Judge 會直接用 Score 覆蓋該子任務分數<br />
<br />
===== Status =====<br />
Status 可以是 TOJ 所支援的所有 Status (AC, PC, WA, RE, RESIG, TLE, MLE, OLE, CE, CLE, SJE, IE)<br />
<br />
如果 Status 為空 或 不在支援的 Status 中將按照 Checker 回傳值決定狀態 (return 0 為 AC，其餘為 WA)<br />
<br />
下面列出幾個作為參考<br />
{| class="wikitable"<br />
|-<br />
! STDOUT String !! Score !! Status<br />
|-<br />
| CMS;0.5;PC || 子任務分數 * 0.5 || PC (Partial Correct)<br />
|-<br />
| CF;32.27;AC || 32.27 || AC (Answer Correct)<br />
|-<br />
| NONE;3131;WA || 子任務分數 || WA (Wrong Answer)<br />
|-<br />
| CF;32.27; || 32.27 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| ;; || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| (沒有任何輸出) || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|}<br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
# python<br />
# cp check.py check<br />
# chmod +x check<br />
</syntaxhighlight><br />
<br />
=== IORedir ===<br />
將[https://github.com/TFcis/Problem-setting-tools/blob/master/TOJ-problem-example/conf.json conf.json]中的 check 從 diff 改成 ioredir，及設定 metadata 如下。<br />
如果 Checker 的 STDOUT 或 STDERR 沒有被佔用且有輸出內容，那 Verdict Message (Checker Message) 將會為該內容 (如果兩個同時都有，STDERR 優先於 STDOUT<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON">{<br />
"check": "ioredir",<br />
"metadata": {<br />
"redir_test": {<br />
"pipeout": 1,<br />
"testin": 0,<br />
"testout": -1,<br />
"pipein": -1<br />
},<br />
"redir_check": {<br />
"ansin": 2,<br />
"testin": -1,<br />
"pipeout": 0,<br />
"pipein": -1<br />
}<br />
}<br />
}</syntaxhighlight><br />
<br />
如果要用 ioredir 實現互動題， metadata 可以這樣寫<br />
<br />
從 STDERR 讀入測資，對 STDOUT 輸出測資<br />
從 STDIN 讀入答案<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"redir_test": {<br />
"pipein": 0,<br />
"testin": -1,<br />
"pipeout": 1,<br />
"testout": -1<br />
},<br />
"redir_check": {<br />
"ansin": -1,<br />
"pipein": 1,<br />
"testin": 2,<br />
"pipeout": 0<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
分別從答案及輸出分別讀入long double。<br />
<syntaxhighlight lang="C++"><br />
long double Answer, Output;<br />
FILE *ansf = fdopen(2, "r");<br />
<br />
scanf("%Lf", &Output);<br />
fscanf(ansf, "%Lf", &Answer);<br />
</syntaxhighlight><br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
</syntaxhighlight><br />
<br />
參考 https://hackmd.io/s/BkHdt57I<br />
<br />
=== Polygon to TOJ ===<br />
請參考 [https://github.com/TFcis/cf2toj cf2toj]<br />
<br />
=== TPS to TOJ ===<br />
請參考 [https://github.com/TFcis/tps2toj tps2toj]<br />
<br />
=== CMS to TOJ ===<br />
請參考 [https://github.com/TFcis/cms2toj cms2toj]<br />
<br />
== 參見 ==<br />
* [[TOJ API]]：API文檔<br />
* [https://github.com/pzread/judge judge原始碼]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=TOJ&diff=462
TOJ
2024-10-15T02:20:56Z
<p>Tobiichi3227：</p>
<hr />
<div>[[Category:TOJ]]<br />
<br />
https://toj.tfcis.org/oj/<br />
<br />
* 社團練習用的Online Judge<br />
* 由[[T13]]的[[吳哲宇]]([[pzread]])開發<br />
* [[T19]]的[[lys0829]]於2017年將judge更新<br />
* [[T24]]的[[tobiichi3227]]與[[ccccchhhheeenng]]於2022年將後端Server的軟硬體更新<br />
<br />
== 出題 ==<br />
以下內容均為 Problem Package 的形式，TOJ 已經支援用 UI 新增題目了<br />
=== 一般題目 ===<br />
limit欄位的 default 一定要存在，其餘可以填寫 TOJ 支援的編譯器 (gcc, g++, clang, clang++, python3, rust, java)<br />
<br />
記憶體限制的單位是 KB<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
},<br />
"python3": {<br />
"timelimit": 2500,<br />
"memlimit": 524288,<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
check欄位可以填 "diff", "diff-strict"<br />
{| class="wikitable"<br />
|-<br />
! Type !! 解釋<br />
|-<br />
| diff || 寬鬆比對<br />
|-<br />
| diff-strict || 嚴格比對<br />
|}<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": false,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
=== Makefile題目 (編譯互動題) ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": true,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
=== CMS/Testlib Checker ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"check": "cms",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
會傳入三個參數，分別為測資輸入，測資輸出，答案輸入<br />
<syntaxhighlight lang="C++"><br />
#include <fstream><br />
int main(int argc, char** argv) {<br />
std::ifstream test_in(argv[1]);<br />
std::ifstream test_out(argv[2]);<br />
std::ifstream ans_in(argv[3]);<br />
<br />
// C<br />
FILE* test_in_ptr = fopen(argv[1], "r");<br />
FILE* test_out_ptr = fopen(argv[2], "r");<br />
FILE* ans_in_ptr = fopen(argv[3], "r");<br />
<br />
fclose(test_in_ptr);<br />
fclose(test_out_ptr);<br />
fclose(ans_in_ptr);<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.py<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
<br />
test_in = open(sys.argv[1])<br />
test_out = open(sys.argv[2])<br />
ans_in = open(sys.argv[3])<br />
<br />
test_in.close()<br />
test_out.close()<br />
ans_in.close()<br />
</syntaxhighlight><br />
<br />
==== Verdict Message (Checker Message) ====<br />
對標準錯誤 (STDERR) 輸出 verdict message<br />
<br />
C/C++<br />
<syntaxhighlight lang="C++"><br />
#include <iostream><br />
std::cerr << "checker message" << std::endl;<br />
<br />
#include <cstdio><br />
fprintf(stderr, "checker message");<br />
</syntaxhighlight><br />
<br />
Python<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
print("checker message", sys.stderr)<br />
</syntaxhighlight><br />
<br />
==== Special Score & Status ====<br />
對標準輸出 (STDOUT) 輸出 Special Score & Status，輸出標準如下<br />
ScoreType;Score;Status<br />
<br />
===== Score =====<br />
ScoreType 可以是 NONE, CMS, CF<br />
<br />
NONE 代表 Judge 不會理會 Score 的值<br />
<br />
CMS 代表 Judge 會將 該題子任務分數乘上 Score (與 CMS 的 GroupMin 相同)，且 Score 範圍應該從 0.0 到 1.0，大於 1.0 將設定為 1.0，小於 0.0 將設定為 0.0<br />
<br />
CF 代表 Judge 會直接用 Score 覆蓋該子任務分數<br />
<br />
===== Status =====<br />
Status 可以是 TOJ 所支援的所有 Status (AC, PC, WA, RE, RESIG, TLE, MLE, OLE, CE, CLE, SJE, IE)<br />
<br />
如果 Status 為空 或 不在支援的 Status 中將按照 Checker 回傳值決定狀態 (return 0 為 AC，其餘為 WA)<br />
<br />
下面列出幾個作為參考<br />
{| class="wikitable"<br />
|-<br />
! STDOUT String !! Score !! Status<br />
|-<br />
| CMS;0.5;PC || 子任務分數 * 0.5 || PC (Partial Correct)<br />
|-<br />
| CF;32.27;AC || 32.27 || AC (Answer Correct)<br />
|-<br />
| NONE;3131;WA || 子任務分數 || WA (Wrong Answer)<br />
|-<br />
| CF;32.27; || 32.27 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| ;; || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| (沒有任何輸出) || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|}<br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
# python<br />
# cp check.py check<br />
# chmod +x check<br />
</syntaxhighlight><br />
<br />
=== IORedir ===<br />
將[https://github.com/TFcis/Problem-setting-tools/blob/master/TOJ-problem-example/conf.json conf.json]中的 check 從 diff 改成 ioredir，及設定 metadata 如下。<br />
如果 Checker 的 STDOUT 或 STDERR 沒有被佔用且有輸出內容，那 Verdict Message (Checker Message) 將會為該內容 (如果兩個同時都有，STDERR 優先於 STDOUT<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON">{<br />
"check": "ioredir",<br />
"metadata": {<br />
"redir_test": {<br />
"pipeout": 1,<br />
"testin": 0,<br />
"testout": -1,<br />
"pipein": -1<br />
},<br />
"redir_check": {<br />
"ansin": 2,<br />
"testin": -1,<br />
"pipeout": 0,<br />
"pipein": -1<br />
}<br />
}<br />
}</syntaxhighlight><br />
<br />
如果要用 ioredir 實現互動題， metadata 可以這樣寫<br />
<br />
從 STDERR 讀入測資，對 STDOUT 輸出測資<br />
從 STDIN 讀入答案<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"redir_test": {<br />
"pipein": 0,<br />
"testin": -1,<br />
"pipeout": 1,<br />
"testout": -1<br />
},<br />
"redir_check": {<br />
"ansin": -1,<br />
"pipein": 1,<br />
"testin": 2,<br />
"pipeout": 0<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
分別從答案及輸出分別讀入long double。<br />
<syntaxhighlight lang="C++"><br />
long double Answer, Output;<br />
FILE *ansf = fdopen(2, "r");<br />
<br />
scanf("%Lf", &Output);<br />
fscanf(ansf, "%Lf", &Answer);<br />
</syntaxhighlight><br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
</syntaxhighlight><br />
<br />
參考 https://hackmd.io/s/BkHdt57I<br />
<br />
=== Polygon to TOJ ===<br />
請參考 [https://github.com/TFcis/cf2toj cf2toj]<br />
<br />
=== TPS to TOJ ===<br />
請參考 [https://github.com/TFcis/tps2toj tps2toj]<br />
<br />
=== CMS to TOJ ===<br />
請參考 [https://github.com/TFcis/cms2toj cms2toj]<br />
<br />
== 參見 ==<br />
* [[TOJ API]]：API文檔<br />
* [https://github.com/pzread/judge judge原始碼]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=TOJ&diff=461
TOJ
2024-10-15T02:20:37Z
<p>Tobiichi3227：/* Polygon to TOJ */</p>
<hr />
<div>[[Category:TOJ]]<br />
<br />
https://toj.tfcis.org/oj/<br />
<br />
* 社團練習用的Online Judge<br />
* 由[[T13]]的[[吳哲宇]]([[pzread]])開發<br />
* [[T19]]的[[lys0829]]於2017年將judge更新<br />
* [[T24]]的[[tobiichi3227]]與[[ccccchhhheeenng]]於2022年將後端Server的軟硬體更新<br />
<br />
== 出題 ==<br />
以下內容均為 Problem Package 的形式，TOJ 已經支援用 UI 新增題目了<br />
=== 一般題目 ===<br />
limit欄位的 default 一定要存在，其餘可以填寫 TOJ 支援的編譯器 (gcc, g++, clang, clang++, python3, rust, java)<br />
<br />
記憶體限制的單位是 KB<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
},<br />
"python3": {<br />
"timelimit": 2500,<br />
"memlimit": 524288,<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
check欄位可以填 "diff", "diff-strict"<br />
{| class="wikitable"<br />
|-<br />
! Type !! 解釋<br />
|-<br />
| diff || 寬鬆比對<br />
|-<br />
| diff-strict || 嚴格比對<br />
|}<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": false,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
=== Makefile題目 (編譯互動題) ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": true,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
=== CMS/Testlib Checker ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"check": "cms",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
會傳入三個參數，分別為測資輸入，測資輸出，答案輸入<br />
<syntaxhighlight lang="C++"><br />
#include <fstream><br />
int main(int argc, char** argv) {<br />
std::ifstream test_in(argv[1]);<br />
std::ifstream test_out(argv[2]);<br />
std::ifstream ans_in(argv[3]);<br />
<br />
// C<br />
FILE* test_in_ptr = fopen(argv[1], "r");<br />
FILE* test_out_ptr = fopen(argv[2], "r");<br />
FILE* ans_in_ptr = fopen(argv[3], "r");<br />
<br />
fclose(test_in_ptr);<br />
fclose(test_out_ptr);<br />
fclose(ans_in_ptr);<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.py<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
<br />
test_in = open(sys.argv[1])<br />
test_out = open(sys.argv[2])<br />
ans_in = open(sys.argv[3])<br />
<br />
test_in.close()<br />
test_out.close()<br />
ans_in.close()<br />
</syntaxhighlight><br />
<br />
==== Verdict Message (Checker Message) ====<br />
對標準錯誤 (STDERR) 輸出 verdict message<br />
<br />
C/C++<br />
<syntaxhighlight lang="C++"><br />
#include <iostream><br />
std::cerr << "checker message" << std::endl;<br />
<br />
#include <cstdio><br />
fprintf(stderr, "checker message");<br />
</syntaxhighlight><br />
<br />
Python<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
print("checker message", sys.stderr)<br />
</syntaxhighlight><br />
<br />
==== Special Score & Status ====<br />
對標準輸出 (STDOUT) 輸出 Special Score & Status，輸出標準如下<br />
ScoreType;Score;Status<br />
<br />
===== Score =====<br />
ScoreType 可以是 NONE, CMS, CF<br />
<br />
NONE 代表 Judge 不會理會 Score 的值<br />
<br />
CMS 代表 Judge 會將 該題子任務分數乘上 Score (與 CMS 的 GroupMin 相同)，且 Score 範圍應該從 0.0 到 1.0，大於 1.0 將設定為 1.0，小於 0.0 將設定為 0.0<br />
<br />
CF 代表 Judge 會直接用 Score 覆蓋該子任務分數<br />
<br />
===== Status =====<br />
Status 可以是 TOJ 所支援的所有 Status (AC, PC, WA, RE, RESIG, TLE, MLE, OLE, CE, CLE, SJE, IE)<br />
<br />
如果 Status 為空 或 不在支援的 Status 中將按照 Checker 回傳值決定狀態 (return 0 為 AC，其餘為 WA)<br />
<br />
下面列出幾個作為參考<br />
{| class="wikitable"<br />
|-<br />
! STDOUT String !! Score !! Status<br />
|-<br />
| CMS;0.5;PC || 子任務分數 * 0.5 || PC (Partial Correct)<br />
|-<br />
| CF;32.27;AC || 32.27 || AC (Answer Correct)<br />
|-<br />
| NONE;3131;WA || 子任務分數 || WA (Wrong Answer)<br />
|-<br />
| CF;32.27; || 32.27 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| ;; || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| (沒有任何輸出) || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|}<br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
# python<br />
# cp check.py check<br />
# chmod +x check<br />
</syntaxhighlight><br />
<br />
=== IORedir ===<br />
將[https://github.com/TFcis/Problem-setting-tools/blob/master/TOJ-problem-example/conf.json conf.json]中的 check 從 diff 改成 ioredir，及設定 metadata 如下。<br />
如果 Checker 的 STDOUT 或 STDERR 沒有被佔用且有輸出內容，那 Verdict Message (Checker Message) 將會為該內容 (如果兩個同時都有，STDERR 優先於 STDOUT<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON">{<br />
"check": "ioredir",<br />
"metadata": {<br />
"redir_test": {<br />
"pipeout": 1,<br />
"testin": 0,<br />
"testout": -1,<br />
"pipein": -1<br />
},<br />
"redir_check": {<br />
"ansin": 2,<br />
"testin": -1,<br />
"pipeout": 0,<br />
"pipein": -1<br />
}<br />
}<br />
}</syntaxhighlight><br />
<br />
如果要用 ioredir 實現互動題， metadata 可以這樣寫<br />
<br />
從 STDERR 讀入測資，對 STDOUT 輸出測資<br />
從 STDIN 讀入答案<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"redir_test": {<br />
"pipein": 0,<br />
"testin": -1,<br />
"pipeout": 1,<br />
"testout": -1<br />
},<br />
"redir_check": {<br />
"ansin": -1,<br />
"pipein": 1,<br />
"testin": 2,<br />
"pipeout": 0<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
分別從答案及輸出分別讀入long double。<br />
<syntaxhighlight lang="C++"><br />
long double Answer, Output;<br />
FILE *ansf = fdopen(2, "r");<br />
<br />
scanf("%Lf", &Output);<br />
fscanf(ansf, "%Lf", &Answer);<br />
</syntaxhighlight><br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
</syntaxhighlight><br />
<br />
參考 https://hackmd.io/s/BkHdt57I<br />
<br />
=== Polygon to TOJ ===<br />
請參考 [https://github.com/TFcis/cf2toj cf2toj]<br />
<br />
=== TPS to TOJ ===<br />
請參考 [https://github.com/TFcis/tps2toj]<br />
<br />
=== CMS to TOJ ===<br />
請參考 [https://github.com/TFcis/cms2toj]<br />
<br />
== 參見 ==<br />
* [[TOJ API]]：API文檔<br />
* [https://github.com/pzread/judge judge原始碼]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=TOJ&diff=460
TOJ
2024-10-15T02:20:01Z
<p>Tobiichi3227：新增出題</p>
<hr />
<div>[[Category:TOJ]]<br />
<br />
https://toj.tfcis.org/oj/<br />
<br />
* 社團練習用的Online Judge<br />
* 由[[T13]]的[[吳哲宇]]([[pzread]])開發<br />
* [[T19]]的[[lys0829]]於2017年將judge更新<br />
* [[T24]]的[[tobiichi3227]]與[[ccccchhhheeenng]]於2022年將後端Server的軟硬體更新<br />
<br />
== 出題 ==<br />
以下內容均為 Problem Package 的形式，TOJ 已經支援用 UI 新增題目了<br />
=== 一般題目 ===<br />
limit欄位的 default 一定要存在，其餘可以填寫 TOJ 支援的編譯器 (gcc, g++, clang, clang++, python3, rust, java)<br />
<br />
記憶體限制的單位是 KB<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
},<br />
"python3": {<br />
"timelimit": 2500,<br />
"memlimit": 524288,<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
check欄位可以填 "diff", "diff-strict"<br />
{| class="wikitable"<br />
|-<br />
! Type !! 解釋<br />
|-<br />
| diff || 寬鬆比對<br />
|-<br />
| diff-strict || 嚴格比對<br />
|}<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": false,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
=== Makefile題目 (編譯互動題) ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"is_makefile": true,<br />
"check": "diff",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
=== CMS/Testlib Checker ===<br />
;/conf.json<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"limit": {<br />
"default": {<br />
"timelimit": 1000,<br />
"memlimit": 65536<br />
}<br />
},<br />
"check": "cms",<br />
"test": [<br />
{<br />
"data": [<br />
1, 2, 3, 4, 5<br />
],<br />
"weight": 100<br />
}<br />
]<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
會傳入三個參數，分別為測資輸入，測資輸出，答案輸入<br />
<syntaxhighlight lang="C++"><br />
#include <fstream><br />
int main(int argc, char** argv) {<br />
std::ifstream test_in(argv[1]);<br />
std::ifstream test_out(argv[2]);<br />
std::ifstream ans_in(argv[3]);<br />
<br />
// C<br />
FILE* test_in_ptr = fopen(argv[1], "r");<br />
FILE* test_out_ptr = fopen(argv[2], "r");<br />
FILE* ans_in_ptr = fopen(argv[3], "r");<br />
<br />
fclose(test_in_ptr);<br />
fclose(test_out_ptr);<br />
fclose(ans_in_ptr);<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.py<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
<br />
test_in = open(sys.argv[1])<br />
test_out = open(sys.argv[2])<br />
ans_in = open(sys.argv[3])<br />
<br />
test_in.close()<br />
test_out.close()<br />
ans_in.close()<br />
</syntaxhighlight><br />
<br />
==== Verdict Message (Checker Message) ====<br />
對標準錯誤 (STDERR) 輸出 verdict message<br />
<br />
C/C++<br />
<syntaxhighlight lang="C++"><br />
#include <iostream><br />
std::cerr << "checker message" << std::endl;<br />
<br />
#include <cstdio><br />
fprintf(stderr, "checker message");<br />
</syntaxhighlight><br />
<br />
Python<br />
<syntaxhighlight lang="Python"><br />
import sys<br />
print("checker message", sys.stderr)<br />
</syntaxhighlight><br />
<br />
==== Special Score & Status ====<br />
對標準輸出 (STDOUT) 輸出 Special Score & Status，輸出標準如下<br />
ScoreType;Score;Status<br />
<br />
===== Score =====<br />
ScoreType 可以是 NONE, CMS, CF<br />
<br />
NONE 代表 Judge 不會理會 Score 的值<br />
<br />
CMS 代表 Judge 會將 該題子任務分數乘上 Score (與 CMS 的 GroupMin 相同)，且 Score 範圍應該從 0.0 到 1.0，大於 1.0 將設定為 1.0，小於 0.0 將設定為 0.0<br />
<br />
CF 代表 Judge 會直接用 Score 覆蓋該子任務分數<br />
<br />
===== Status =====<br />
Status 可以是 TOJ 所支援的所有 Status (AC, PC, WA, RE, RESIG, TLE, MLE, OLE, CE, CLE, SJE, IE)<br />
<br />
如果 Status 為空 或 不在支援的 Status 中將按照 Checker 回傳值決定狀態 (return 0 為 AC，其餘為 WA)<br />
<br />
下面列出幾個作為參考<br />
{| class="wikitable"<br />
|-<br />
! STDOUT String !! Score !! Status<br />
|-<br />
| CMS;0.5;PC || 子任務分數 * 0.5 || PC (Partial Correct)<br />
|-<br />
| CF;32.27;AC || 32.27 || AC (Answer Correct)<br />
|-<br />
| NONE;3131;WA || 子任務分數 || WA (Wrong Answer)<br />
|-<br />
| CF;32.27; || 32.27 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| ;; || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|-<br />
| (沒有任何輸出) || 子任務分數 || 按照 Return 值決定是 AC 或 WA<br />
|}<br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
# python<br />
# cp check.py check<br />
# chmod +x check<br />
</syntaxhighlight><br />
<br />
=== IORedir ===<br />
將[https://github.com/TFcis/Problem-setting-tools/blob/master/TOJ-problem-example/conf.json conf.json]中的 check 從 diff 改成 ioredir，及設定 metadata 如下。<br />
如果 Checker 的 STDOUT 或 STDERR 沒有被佔用且有輸出內容，那 Verdict Message (Checker Message) 將會為該內容 (如果兩個同時都有，STDERR 優先於 STDOUT<br />
<br />
;/conf.json<br />
<syntaxhighlight lang="JSON">{<br />
"check": "ioredir",<br />
"metadata": {<br />
"redir_test": {<br />
"pipeout": 1,<br />
"testin": 0,<br />
"testout": -1,<br />
"pipein": -1<br />
},<br />
"redir_check": {<br />
"ansin": 2,<br />
"testin": -1,<br />
"pipeout": 0,<br />
"pipein": -1<br />
}<br />
}<br />
}</syntaxhighlight><br />
<br />
如果要用 ioredir 實現互動題， metadata 可以這樣寫<br />
<br />
從 STDERR 讀入測資，對 STDOUT 輸出測資<br />
從 STDIN 讀入答案<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"redir_test": {<br />
"pipein": 0,<br />
"testin": -1,<br />
"pipeout": 1,<br />
"testout": -1<br />
},<br />
"redir_check": {<br />
"ansin": -1,<br />
"pipein": 1,<br />
"testin": 2,<br />
"pipeout": 0<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
分別從答案及輸出分別讀入long double。<br />
<syntaxhighlight lang="C++"><br />
long double Answer, Output;<br />
FILE *ansf = fdopen(2, "r");<br />
<br />
scanf("%Lf", &Output);<br />
fscanf(ansf, "%Lf", &Answer);<br />
</syntaxhighlight><br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
</syntaxhighlight><br />
<br />
參考 https://hackmd.io/s/BkHdt57I<br />
<br />
=== Polygon to TOJ ===<br />
請參考 [https://github.com/TFcis/cf2toj]<br />
<br />
=== TPS to TOJ ===<br />
請參考 [https://github.com/TFcis/tps2toj]<br />
<br />
=== CMS to TOJ ===<br />
請參考 [https://github.com/TFcis/cms2toj]<br />
<br />
== 參見 ==<br />
* [[TOJ API]]：API文檔<br />
* [https://github.com/pzread/judge judge原始碼]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T24&diff=456
T24
2024-02-15T16:54:33Z
<p>Tobiichi3227：</p>
<hr />
<div>台南一中資訊社第24屆<br />
<br />
==社員名單==<br />
<section begin=club-members><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[姚政彣]] || [[Vincenttainan]]<br />
|-<br />
| [[副社長]] || [[林軒名]] || <br />
|-<br />
| [[程設教學]] || [[張丞漢]] || [[same0620]]<br />
|-<br />
| [[程設教學]] || [[郭育愷]] || [[bgg0516]]<br />
|-<br />
| [[網管教學]] || [[莊正誠]] || [[ccccchhhheeenng]]<br />
|-<br />
| [[網管教學]] || [[凃思寬]]|| [[YYOuO]]<br />
|-<br />
| [[網管教學]] || [[林大鈞]] || <br />
|-<br />
| [[開發教學]] || [[王傑宇]] || <br />
|-<br />
| [[網管]] || [[高斐凱]] || <br />
|-<br />
| [[總務]] || [[張赫倫]] || <br />
|-<br />
| [[美宣]] || || <br />
|-<br />
| [[文書]] || [[蘇宥恆]] || [[chocomint]]<br />
|- <br />
| [[公關]] || [[賴冠學]] || [[LenLai3652]]<br />
|- <br />
| [[庶務]] || [[馬道中]] || [[tobiichi3227]]<br />
|-<br />
| [[社員]] || [[林恩甫]] || [[EF Lin]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==<br />
更新[[TOJ]]後端Server的軟硬體<br />
<br />
更新社網</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T24&diff=455
T24
2024-02-15T16:54:18Z
<p>Tobiichi3227：</p>
<hr />
<div>台南一中資訊社第24屆<br />
<br />
==社員名單==<br />
<section begin=club-members><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[姚政彣]] || [[Vincenttainan]]<br />
|-<br />
| [[副社長]] || [[林軒名]] || <br />
|-<br />
| [[程設教學]] || [[張丞漢]] || [[same0620]]<br />
|-<br />
| [[程設教學]] || [[郭育愷]] || [[bgg0516]]<br />
|-<br />
| [[網管教學]] || [[莊正誠]] || [[ccccchhhheeenng]]<br />
|-<br />
| [[網管教學]] || [[凃思寬]]|| [[YYOuO]]<br />
|-<br />
| [[網管教學]] || [[林大鈞]] || <br />
|-<br />
| [[開發教學]] || [[王傑宇]] || <br />
|-<br />
| [[網管]] || [[高斐凱]] || <br />
|-<br />
| [[總務]] || [[張赫倫]] || <br />
|-<br />
| [[美宣]] || || <br />
|-<br />
| [[文書]] || [[蘇宥恆]] || [[chocomint]]<br />
|- <br />
| [[公關]] || [[賴冠學]] || LenLai3652<br />
|- <br />
| [[庶務]] || [[馬道中]] || [[tobiichi3227]]<br />
|-<br />
| [[社員]] || [[林恩甫]] || [[EF Lin]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==<br />
更新[[TOJ]]後端Server的軟硬體<br />
<br />
更新社網</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=%E8%87%BA%E5%8D%97%E4%B8%80%E4%B8%AD%E8%B3%87%E8%A8%8A%E7%A4%BE&diff=452
臺南一中資訊社
2023-11-17T08:00:36Z
<p>Tobiichi3227：Add T25</p>
<hr />
<div>臺南一中資訊社是臺南一中的自然科學類社團。該社團以學術研究為主要發展方向，也是全臺南一中唯一有考試的社團。<br /><br />
也因為資訊社強調以學術研討為主，並以程式解題競賽為主要訓練方向之一，該社歷來培養出許多資訊奧林匹亞及資訊能力競賽的好手，亦不乏國手級的人物。<ref>[[xeon]] (第一屆)，〈社團簡介〉，2001 年 08 月18 日更新。<br />其他[[社員]]或社友的口述歷史</ref><br />
<br />
== 簡史 ==<br />
<br />
== [[入社考]]與[[留社考]] ==<br />
在高一社團獨立招生時，會舉辦入社考，來篩選出較有經驗或較有熱誠的學弟入社，並要求高一同學必須通過兩個學期末的留社考，才能在高二生涯中繼續留在社團裡<ref>過去的試題可於[[TOJ]]上找到</ref>。高一上的[[留社考]]通常會以測驗語法能力為基準命題，高一下的[[留社考]]則會融合所有課程內容及其延伸命題。<br />
<br />
== [[暑訓]]與[[寒訓]] ==<br />
寒暑假都有長達一周的全天集訓(競程)，會有許多超強學長回歸，不乏有友社或是國中生專程前來旁聽。<br />
<br />
== 社團幹部 ==<br />
[[社長]]、[[副社長]]、[[程設教學]]、[[網管教學]]、[[網管]]、[[美工]]、[[總務]]<br />
各屆幹部請見[[社員名單]]<br />
<br />
每屆情況不同，視情況調整{{Fact|（甚至還有出現「[[社寵]]」及「[[社寵長]]」還有「[[總統]]」之類的奇異幹部名稱）}}<br />
<br />
== [[社團結構]] ==<br />
<br />
=== [[T16]]前 ===<br />
<br />
資訊社主要分為三個組：[[程設組]]、[[網頁組]]、[[網管組]]。各組由學長帶領學弟，在社課或空閒時間探討特定領域的知識。資訊社並沒有強制要求同學只能參加一個組，各組同學之間的學習領域也多少有重疊。<br />
<br />
==== [[程設組]] ====<br />
是資訊社2014年時主要的組別，且招收[[T17]][[社員]]時僅招收程設組。以資訊競賽為主要目標，每周的[[社課]]教學C++程式語言。<br />
<br />
==== [[網頁組]] ====<br />
負責HTML語言、CSS以及JavaScript的相關內容。<br />
<br />
已於102學年由僅存唯一一名的組員宣布停止招生，期望學弟能在網管組兼顧更多網路方面的能力，以避免偏頗於單純的網頁設計、落入故步自封的境地。且，程設組的許多社員都有涉獵網頁設計的部分。<br />
<br />
簡言之，招生困難+教學實力不足<br />
<br />
==== [[網管組]] ====<br />
<br />
[[網管組]]的前身為[[系統組]]。在社團草創之初，系統組的組員協助維護校內的伺服器，同時也在社內維護起屬於社團的[[伺服器]]群。<br />
<br />
在第 6 屆社長[[劉茂宏]]以半實驗性質成立新的 BBS 「[[索尼小站]]」後，網管組的其中一個任務便是維護這個 BBS。從程式原始碼修訂、作業系統管理等等，學習基本的 UNIX 作業系統操作，以及著重於系統程式 （System Program） 的大型程式開發與維護。<br />
<br />
目前社內主要實習的作業系統多為 UNIX-like 系列，並以架設各式[[伺服器]]為主要學習方向。<br />
<br />
=== [[T17]] ===<br />
<br />
由[[T16]]社長[[domen111]]提出，主要分為[[程設組]]和[[開發組]]。<br />
<br />
====[[程設組]]====<br />
即為先前的[[程設組]]。<br />
<br />
====[[開發組]]====<br />
由先前的[[網頁組]]和[[網管組]]整併而來，著重於網頁設計及[[伺服器]]架設。<br />
<br />
=== 現行分組方式（[[T21]]之後） ===<br />
<br />
====[[競賽組]]====<br />
即為先前的[[程設組]]。<br />
<br />
====[[網管組]]====<br />
著重於網頁設計及[[伺服器]]架設、資安相關領域研究。<br />
<br />
====[[開發組]]====<br />
著重開發Unity遊戲。<br />
<br />
==[[國中生程式設計營]]==<br />
<br />
==[[高一生程式設計排名賽]]==<br />
<br />
==各屆條目==<br />
可參考已經建立的頁面 <br><br />
[[T25]]<br />
[[T24]]<br />
[[T23]]<br />
[[T22]]<br />
[[T21]]<br />
[[T20]]<br />
[[T19]]<br />
[[T18]]<br />
[[T17]]<br />
[[T16]]<br />
[[T15]]<br />
[[T14]]<br />
[[T13]]<br />
[[T12]]<br />
[[T11]]<br />
[[T10]]<br />
[[T9]]<br />
[[T8]]<br />
[[T7]]<br />
[[T6]]<br />
[[T5]]<br />
[[T4]]<br />
[[T3]]<br />
[[T2]]<br />
[[T1]]<br />
[[T0]]<br />
<br />
== 參考資料 ==<br />
<references/><br />
== 外部連結 ==<br />
* [http://www.tfcis.org 社團網站]<br />
* [telnet://sony.tfcis.org 索尼小站BBS] 請使用BBS軟體連線，建議使用[http://pcman.openfoundry.org/ PCMan]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T25&diff=451
T25
2023-11-17T07:59:00Z
<p>Tobiichi3227：</p>
<hr />
<div>台南一中資訊社第25屆<br />
<br />
==社員名單==<br />
<section begin=club-members /><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[葉智揚]] || [[tw20000807]]<br />
|-<br />
| [[副社長]] || [[甘宸昌]] || [[KCC]]<br />
|-<br />
| [[程設教學]] || [[盧尚恩]] || [[life_adventurer]]<br />
|-<br />
| [[程設教學]] || [[陳善元]] || [[iwantnitro]]<br />
|-<br />
| [[網管教學]] || [[吳柏陞]] || [[kangroo.]]<br />
|-<br />
| [[網管教學]] || [[林利達]]|| [[rudalin]]<br />
|-<br />
| [[開發教學]] || [[陳佑豪]] || [[w35ucu7]]<br />
|-<br />
| [[開發教學]] || [[林承禧]] || [[blacklin01]] <br />
|-<br />
| [[總務]] || [[林利達]] || <br />
|-<br />
| [[美宣]] || [[葉晉瑋]] || [[想不到名字]]<br />
|-<br />
| [[文書]] || [[吳宬瑋]] || [[kindmeplease]]<br />
|- <br />
| [[公關]] || [[陳佑豪]] || <br />
|- <br />
| [[庶務]] || [[邱佑捷]] || [[rapelica]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T25&diff=450
T25
2023-11-17T07:58:50Z
<p>Tobiichi3227：</p>
<hr />
<div>台南一中資訊社第25屆<br />
<br />
==社員名單==<br />
<section begin=club-members /><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[葉智揚]] || [[tw20000807]]<br />
|-<br />
| [[副社長]] || [[甘宸昌]] || [[KCC]]<br />
|-<br />
| [[程設教學]] || [[盧尚恩]] || [[life_adventurer]]<br />
|-<br />
| [[程設教學]] || [[陳善元]] || [[iwantnitro]]<br />
|-<br />
| [[網管教學]] || [[吳柏陞]] || [[kangroo.]]<br />
|-<br />
| [[網管教學]] || [[林利達]]|| [[rudalin]]<br />
|-<br />
| [[開發教學]] || [[陳佑豪]] || [[w35ucu7]]<br />
|-<br />
| [[開發教學]] || [[林承禧]] || [[blacklin01]] <br />
|-<br />
| [[總務]] || [[林利達]] || <br />
|-<br />
| [[美宣]] || [[葉晉瑋]] || [[想不到名字]]<br />
|-<br />
| [[文書]] || [[吳宬瑋]] || [[kindmeplease]]<br />
|- <br />
| [[公關]] || [[陳佑豪]] || <br />
|- <br />
| [[庶務]] || [[邱佑捷]] || [[rapelica]]<br />
|} <br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T25&diff=449
T25
2023-11-17T07:58:37Z
<p>Tobiichi3227：</p>
<hr />
<div>台南一中資訊社第25屆<br />
<br />
==社員名單==<br />
<section begin=club-members /><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[葉智揚]] || [[tw20000807]]<br />
|-<br />
| [[副社長]] || [甘宸昌]] || [[KCC]]<br />
|-<br />
| [[程設教學]] || [[盧尚恩]] || [[life_adventurer]]<br />
|-<br />
| [[程設教學]] || [[陳善元]] || [[iwantnitro]]<br />
|-<br />
| [[網管教學]] || [[吳柏陞]] || [[kangroo.]]<br />
|-<br />
| [[網管教學]] || [[林利達]]|| [[rudalin]]<br />
|-<br />
| [[開發教學]] || [[陳佑豪] || [[w35ucu7]]<br />
|-<br />
| [[開發教學]] || [[林承禧]] || [[blacklin01]] <br />
|-<br />
| [[總務]] || [[林利達]] || <br />
|-<br />
| [[美宣]] || [[葉晉瑋]] || [[想不到名字]]<br />
|-<br />
| [[文書]] || [[吳宬瑋]] || [[kindmeplease]]<br />
|- <br />
| [[公關]] || [[陳佑豪]] || <br />
|- <br />
| [[庶務]] || [[邱佑捷]] || [[rapelica]]<br />
|} <br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T25&diff=448
T25
2023-11-16T15:49:50Z
<p>Tobiichi3227：</p>
<hr />
<div>台南一中資訊社第25屆<br />
<br />
==社員名單==<br />
<section begin=club-members /><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[葉智揚]] || [[tw20000807]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T25&diff=447
T25
2023-11-16T15:49:33Z
<p>Tobiichi3227：建立新頁面</p>
<hr />
<div>台南一中資訊社第25屆<br />
<br />
==社員名單==<br />
<section begin=club-members /><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[葉智揚]] || [[Vincenttainan]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T24&diff=446
T24
2023-11-16T15:46:20Z
<p>Tobiichi3227：</p>
<hr />
<div>台南一中資訊社第24屆<br />
<br />
==社員名單==<br />
<section begin=club-members><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[姚政彣]] || [[Vincenttainan]]<br />
|-<br />
| [[副社長]] || [[林軒名]] || <br />
|-<br />
| [[程設教學]] || [[張丞漢]] || [[same0620]]<br />
|-<br />
| [[程設教學]] || [[郭育愷]] || [[bgg0516]]<br />
|-<br />
| [[網管教學]] || [[莊正誠]] || [[ccccchhhheeenng]]<br />
|-<br />
| [[網管教學]] || [[凃思寬]]|| [[YYOuO]]<br />
|-<br />
| [[網管教學]] || [[林大鈞]] || <br />
|-<br />
| [[開發教學]] || [[王傑宇]] || <br />
|-<br />
| [[網管]] || [[高斐凱]] || <br />
|-<br />
| [[總務]] || [[張赫倫]] || <br />
|-<br />
| [[美宣]] || || <br />
|-<br />
| [[文書]] || [[蘇宥恆]] || [[chocomint]]<br />
|- <br />
| [[公關]] || [[賴冠學]] || <br />
|- <br />
| [[庶務]] || [[馬道中]] || [[tobiichi3227]]<br />
|-<br />
| [[社員]] || [[林恩甫]] || [[EF Lin]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==<br />
更新[[TOJ]]後端Server的軟硬體<br />
<br />
更新社網</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=Tobiichi3227&diff=445
Tobiichi3227
2022-11-05T15:38:59Z
<p>Tobiichi3227：</p>
<hr />
<div>{{社員資訊框<br />
|name=[[馬道中]]<br />
|year=[[T24]]<br />
|jobs=庶務<br />
|id=tobiichi3227<br />
}}<br />
<br />
==社員簡介==<br />
<br />
==專長==<br />
改[[TOJ]] <s>炸[[TOJ]]</s><br />
<br />
==豐功偉業==<br />
<br />
==經歷==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T24&diff=444
T24
2022-11-05T15:33:40Z
<p>Tobiichi3227：/* 豐功偉業 */</p>
<hr />
<div>台南一中資訊社第24屆<br />
<br />
==社員名單==<br />
<section begin=club-members /><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[姚政彣]] || [[Vincenttainan]]<br />
|-<br />
| [[副社長]] || [[林軒名]] || <br />
|-<br />
| [[程設教學]] || [[張丞漢]] || [[same0620]]<br />
|-<br />
| [[程設教學]] || [[郭育愷]] || [[bgg0516]]<br />
|-<br />
| [[網管教學]] || [[莊正誠]] || [[ccccchhhheeenng]]<br />
|-<br />
| [[網管教學]] || [[凃思寬]]|| [[YYOuO]]<br />
|-<br />
| [[網管教學]] || [[林大鈞]] || <br />
|-<br />
| [[開發教學]] || [[王傑宇]] || <br />
|-<br />
| [[網管]] || [[高斐凱]] || <br />
|-<br />
| [[總務]] || [[張赫倫]] || <br />
|-<br />
| [[美宣]] || || <br />
|-<br />
| [[文書]] || [[蘇宥恆]] || [[chocomint]]<br />
|- <br />
| [[公關]] || [[賴冠學]] || <br />
|- <br />
| [[庶務]] || [[馬道中]] || [[tobiichi3227]]<br />
|-<br />
| [[社員]] || [[林恩甫]] || [[EF Lin]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==<br />
更新[[TOJ]]後端Server的軟硬體<br />
<br />
更新社網</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T24&diff=443
T24
2022-11-05T15:33:22Z
<p>Tobiichi3227：/* 豐功偉業 */</p>
<hr />
<div>台南一中資訊社第24屆<br />
<br />
==社員名單==<br />
<section begin=club-members /><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[姚政彣]] || [[Vincenttainan]]<br />
|-<br />
| [[副社長]] || [[林軒名]] || <br />
|-<br />
| [[程設教學]] || [[張丞漢]] || [[same0620]]<br />
|-<br />
| [[程設教學]] || [[郭育愷]] || [[bgg0516]]<br />
|-<br />
| [[網管教學]] || [[莊正誠]] || [[ccccchhhheeenng]]<br />
|-<br />
| [[網管教學]] || [[凃思寬]]|| [[YYOuO]]<br />
|-<br />
| [[網管教學]] || [[林大鈞]] || <br />
|-<br />
| [[開發教學]] || [[王傑宇]] || <br />
|-<br />
| [[網管]] || [[高斐凱]] || <br />
|-<br />
| [[總務]] || [[張赫倫]] || <br />
|-<br />
| [[美宣]] || || <br />
|-<br />
| [[文書]] || [[蘇宥恆]] || [[chocomint]]<br />
|- <br />
| [[公關]] || [[賴冠學]] || <br />
|- <br />
| [[庶務]] || [[馬道中]] || [[tobiichi3227]]<br />
|-<br />
| [[社員]] || [[林恩甫]] || [[EF Lin]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==<br />
更新[[TOJ]]後端Server的軟硬體<br />
更新社網</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=YYOuO&diff=442
YYOuO
2022-11-05T15:32:01Z
<p>Tobiichi3227：</p>
<hr />
<div>{{社員資訊框<br />
|name=[[凃思寬]]<br />
|year=[[T24]]<br />
|jobs=網管教學<br />
|id=[[YYOuO]]<br />
}}<br />
<br />
==社員簡介==<br />
<br />
==專長==<br />
改社網 <s>炸社網</s><br />
<br />
==豐功偉業==<br />
<br />
==經歷==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=%E5%87%83%E6%80%9D%E5%AF%AC&diff=441
凃思寬
2022-11-05T15:31:50Z
<p>Tobiichi3227：頁面已重新導向至YYOuO</p>
<hr />
<div>#REDIRECT[[YYOuO]]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T24&diff=440
T24
2022-11-05T15:31:31Z
<p>Tobiichi3227：</p>
<hr />
<div>台南一中資訊社第24屆<br />
<br />
==社員名單==<br />
<section begin=club-members /><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[姚政彣]] || [[Vincenttainan]]<br />
|-<br />
| [[副社長]] || [[林軒名]] || <br />
|-<br />
| [[程設教學]] || [[張丞漢]] || [[same0620]]<br />
|-<br />
| [[程設教學]] || [[郭育愷]] || [[bgg0516]]<br />
|-<br />
| [[網管教學]] || [[莊正誠]] || [[ccccchhhheeenng]]<br />
|-<br />
| [[網管教學]] || [[凃思寬]]|| [[YYOuO]]<br />
|-<br />
| [[網管教學]] || [[林大鈞]] || <br />
|-<br />
| [[開發教學]] || [[王傑宇]] || <br />
|-<br />
| [[網管]] || [[高斐凱]] || <br />
|-<br />
| [[總務]] || [[張赫倫]] || <br />
|-<br />
| [[美宣]] || || <br />
|-<br />
| [[文書]] || [[蘇宥恆]] || [[chocomint]]<br />
|- <br />
| [[公關]] || [[賴冠學]] || <br />
|- <br />
| [[庶務]] || [[馬道中]] || [[tobiichi3227]]<br />
|-<br />
| [[社員]] || [[林恩甫]] || [[EF Lin]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==<br />
更新[[TOJ]]後端Server的軟硬體</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T24&diff=439
T24
2022-11-05T15:31:15Z
<p>Tobiichi3227：</p>
<hr />
<div>台南一中資訊社第24屆<br />
<br />
==社員名單==<br />
<section begin=club-members /><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[姚政彣]] || [[Vincenttainan]]<br />
|-<br />
| [[副社長]] || [[林軒名]] || <br />
|-<br />
| [[程設教學]] || [[張丞漢]] || [[same0620]]<br />
|-<br />
| [[程設教學]] || [[郭育愷]] || [[bgg0516]]<br />
|-<br />
| [[網管教學]] || [[莊正誠]] || [[ccccchhhheeenng]]<br />
|-<br />
| [[網管教學]] || 凃[[涂思寬|思寬]]|| [[YYOuO]]<br />
|-<br />
| [[網管教學]] || [[林大鈞]] || <br />
|-<br />
| [[開發教學]] || [[王傑宇]] || <br />
|-<br />
| [[網管]] || [[高斐凱]] || <br />
|-<br />
| [[總務]] || [[張赫倫]] || <br />
|-<br />
| [[美宣]] || || <br />
|-<br />
| [[文書]] || [[蘇宥恆]] || [[chocomint]]<br />
|- <br />
| [[公關]] || [[賴冠學]] || <br />
|- <br />
| [[庶務]] || [[馬道中]] || [[tobiichi3227]]<br />
|-<br />
| [[社員]] || [[林恩甫]] || [[EF Lin]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==<br />
更新[[TOJ]]後端Server的軟硬體</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=%E6%B6%82%E6%80%9D%E5%AF%AC&diff=438
涂思寬
2022-11-05T15:29:53Z
<p>Tobiichi3227：頁面已重新導向至YYOuO</p>
<hr />
<div>#REDIRECT[[YYOuO]]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=YYOuO&diff=437
YYOuO
2022-11-05T15:29:02Z
<p>Tobiichi3227：建立新頁面</p>
<hr />
<div>{{社員資訊框<br />
|name=[[涂思寬]]<br />
|year=[[T24]]<br />
|jobs=網管教學<br />
|id=[[YYOuO]]<br />
}}<br />
<br />
==社員簡介==<br />
<br />
==專長==<br />
改社網 <s>炸社網</s><br />
<br />
==豐功偉業==<br />
<br />
==經歷==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=%E5%A7%9A%E6%94%BF%E5%BD%A3&diff=436
姚政彣
2022-11-04T14:55:33Z
<p>Tobiichi3227：頁面已重新導向至Vincenttainan</p>
<hr />
<div>#REDIRECT [[vincenttainan]]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=Vincenttainan&diff=435
Vincenttainan
2022-11-04T14:55:00Z
<p>Tobiichi3227：/* 社長大人簡介 */</p>
<hr />
<div>{{社員資訊框<br />
|name=[[姚政彣]]<br />
|year=[[T24]]<br />
|jobs=[[社長]]<br />
|id=Vincenttainan<br />
}}<br />
<br />
==社長大人簡介==<br />
<s>印度人</s><br />
<br />
==專長==<br />
<br />
==豐功偉業==<br />
<s>試圖統一電機社</s><br />
<br />
==經歷==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=Vincenttainan&diff=434
Vincenttainan
2022-11-04T14:54:09Z
<p>Tobiichi3227：建立新頁面</p>
<hr />
<div>{{社員資訊框<br />
|name=姚政彣<br />
|year=[[T24]]<br />
|jobs=[[社長]]<br />
|id=Vincenttainan<br />
}}<br />
<br />
==社長大人簡介==<br />
~~印度人~~<br />
<br />
==專長==<br />
<br />
==豐功偉業==<br />
~~試圖統一電機社~~<br />
<br />
==經歷==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T24&diff=433
T24
2022-11-03T23:16:39Z
<p>Tobiichi3227：</p>
<hr />
<div>台南一中資訊社第24屆<br />
<br />
==社員名單==<br />
<section begin=club-members /><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[姚政彣]] || [[Vincenttainan]]<br />
|-<br />
| [[副社長]] || [[林軒名]] || <br />
|-<br />
| [[程設教學]] || [[張丞漢]] || [[same0620]]<br />
|-<br />
| [[程設教學]] || [[郭育愷]] || [[bgg0516]]<br />
|-<br />
| [[網管教學]] || [[莊正誠]] || [[ccccchhhheeenng]]<br />
|-<br />
| [[網管教學]] || [[涂思寬]] || [[YYOuO]]<br />
|-<br />
| [[網管教學]] || [[林大鈞]] || <br />
|-<br />
| [[開發教學]] || [[王傑宇]] || <br />
|-<br />
| [[網管]] || [[高斐凱]] || <br />
|-<br />
| [[總務]] || [[張赫倫]] || <br />
|-<br />
| [[美宣]] || || <br />
|-<br />
| [[文書]] || [[蘇宥恆]] || [[chocomint]]<br />
|- <br />
| [[公關]] || [[賴冠學]] || <br />
|- <br />
| [[庶務]] || [[馬道中]] || [[tobiichi3227]]<br />
|-<br />
| [[社員]] || [[林恩甫]] || [[EF Lin]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==<br />
更新[[TOJ]]後端Server的軟硬體</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T24&diff=432
T24
2022-11-03T23:12:50Z
<p>Tobiichi3227：</p>
<hr />
<div>台南一中資訊社第24屆<br />
<br />
==社員名單==<br />
<section begin=club-members /><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[姚政彣]] || [[Vincenttainan]]<br />
|-<br />
| [[副社長]] || [[林軒名]] || <br />
|-<br />
| [[程設教學]] || [[張丞漢]] || [[same0620]]<br />
|-<br />
| [[程設教學]] || [[郭育愷]] || [[bgg0516]]<br />
|-<br />
| [[網管教學]] || [[莊正誠]] || [[ccccchhhheeenng]]<br />
|-<br />
| [[網管教學]] || [[涂思寬]] || [[YYOuO]]<br />
|-<br />
| [[網管教學]] || [[林大鈞]] || <br />
|-<br />
| [[開發教學]] || [[王傑宇]] || <br />
|-<br />
| [[網管]] || [[高斐凱]] || <br />
|-<br />
| [[總務]] || [[張赫倫]] || <br />
|-<br />
| [[美宣]] || || <br />
|-<br />
| [[文書]] || [[蘇宥恆]] || [[chocomint]]<br />
|- <br />
| [[公關]] || [[賴冠學]] || <br />
|- <br />
| [[庶務]] || [[馬道中]] || [[tobiichi3227]]<br />
|-<br />
| [[社員]] || [[林恩甫]] || [[EF Lin]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==<br />
更新[[TOJ]]後端的軟硬體</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=Ccccchhhheeeng&diff=431
Ccccchhhheeeng
2022-11-03T23:10:02Z
<p>Tobiichi3227：Tobiichi3227移動頁面Ccccchhhheeeng至Ccccchhhheeenng：id打錯</p>
<hr />
<div>#重新導向 [[Ccccchhhheeenng]]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=Ccccchhhheeenng&diff=430
Ccccchhhheeenng
2022-11-03T23:10:02Z
<p>Tobiichi3227：Tobiichi3227移動頁面Ccccchhhheeeng至Ccccchhhheeenng：id打錯</p>
<hr />
<div>{{社員資訊框<br />
|name=[[莊正誠]]<br />
|year=[[T24]]<br />
|jobs=網管教學<br />
|id=ccccchhhheeenng<br />
}}<br />
<br />
==社員簡介==<br />
<br />
==專長==<br />
<br />
==豐功偉業==<br />
<br />
==經歷==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T24&diff=429
T24
2022-11-03T23:09:49Z
<p>Tobiichi3227：</p>
<hr />
<div>台南一中資訊社第24屆<br />
<br />
==社員名單==<br />
<section begin=club-members /><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[姚政彣]] || [[Vincenttainan]]<br />
|-<br />
| [[副社長]] || [[林軒名]] || <br />
|-<br />
| [[程設教學]] || [[張丞漢]] || [[same0620]]<br />
|-<br />
| [[程設教學]] || [[郭育愷]] || [[bgg0516]]<br />
|-<br />
| [[網管教學]] || [[莊正誠]] || [[ccccchhhheeenng]]<br />
|-<br />
| [[網管教學]] || [[涂思寬]] || [[YYOuO]]<br />
|-<br />
| [[網管教學]] || [[林大鈞]] || <br />
|-<br />
| [[開發教學]] || [[王傑宇]] || <br />
|-<br />
| [[網管]] || [[高斐凱]] || <br />
|-<br />
| [[總務]] || [[張赫倫]] || <br />
|-<br />
| [[美宣]] || || <br />
|-<br />
| [[文書]] || [[蘇宥恆]] || [[chocomint]]<br />
|- <br />
| [[公關]] || [[賴冠學]] || <br />
|- <br />
| [[庶務]] || [[馬道中]] || [[tobiichi3227]]<br />
|-<br />
| [[社員]] || [[林恩甫]] || [[EF Lin]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=Ccccchhheeeng&diff=428
Ccccchhheeeng
2022-11-03T23:09:09Z
<p>Tobiichi3227：Tobiichi3227移動頁面Ccccchhheeeng至Ccccchhhheeeng：id打錯</p>
<hr />
<div>#重新導向 [[Ccccchhhheeeng]]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=Ccccchhhheeenng&diff=427
Ccccchhhheeenng
2022-11-03T23:09:08Z
<p>Tobiichi3227：Tobiichi3227移動頁面Ccccchhheeeng至Ccccchhhheeeng：id打錯</p>
<hr />
<div>{{社員資訊框<br />
|name=[[莊正誠]]<br />
|year=[[T24]]<br />
|jobs=網管教學<br />
|id=ccccchhhheeenng<br />
}}<br />
<br />
==社員簡介==<br />
<br />
==專長==<br />
<br />
==豐功偉業==<br />
<br />
==經歷==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T24&diff=426
T24
2022-11-03T23:07:19Z
<p>Tobiichi3227：fix</p>
<hr />
<div>台南一中資訊社第24屆<br />
<br />
==社員名單==<br />
<section begin=club-members /><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[姚政彣]] || [[Vincenttainan]]<br />
|-<br />
| [[副社長]] || [[林軒名]] || <br />
|-<br />
| [[程設教學]] || [[張丞漢]] || [[same0620]]<br />
|-<br />
| [[程設教學]] || [[郭育愷]] || [[bgg0516]]<br />
|-<br />
| [[網管教學]] || [[莊正誠]] || [[ccccchhhheeeng]]<br />
|-<br />
| [[網管教學]] || [[涂思寬]] || [[YYOuO]]<br />
|-<br />
| [[網管教學]] || [[林大鈞]] || <br />
|-<br />
| [[開發教學]] || [[王傑宇]] || <br />
|-<br />
| [[網管]] || [[高斐凱]] || <br />
|-<br />
| [[總務]] || [[張赫倫]] || <br />
|-<br />
| [[美宣]] || || <br />
|-<br />
| [[文書]] || [[蘇宥恆]] || [[chocomint]]<br />
|- <br />
| [[公關]] || [[賴冠學]] || <br />
|- <br />
| [[庶務]] || [[馬道中]] || [[tobiichi3227]]<br />
|-<br />
| [[社員]] || [[林恩甫]] || [[EF Lin]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=%E8%8E%8A%E6%AD%A3%E8%AA%A0&diff=425
莊正誠
2022-11-03T23:06:39Z
<p>Tobiichi3227：頁面已重新導向至Ccccchhhheeenng</p>
<hr />
<div>#REDIRECT [[ccccchhhheeenng]]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=Ccccchhhheeenng&diff=424
Ccccchhhheeenng
2022-11-03T23:06:02Z
<p>Tobiichi3227：建立新頁面</p>
<hr />
<div>{{社員資訊框<br />
|name=[[莊正誠]]<br />
|year=[[T24]]<br />
|jobs=網管教學<br />
|id=ccccchhhheeenng<br />
}}<br />
<br />
==社員簡介==<br />
<br />
==專長==<br />
<br />
==豐功偉業==<br />
<br />
==經歷==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=TOJ&diff=423
TOJ
2022-11-03T13:08:15Z
<p>Tobiichi3227：</p>
<hr />
<div>[[Category:TOJ]]<br />
<br />
https://toj.tfcis.org/oj/<br />
<br />
* 社團練習用的Online Judge<br />
* 由[[T13]]的[[吳哲宇]]([[pzread]])開發<br />
* [[T19]]的[[lys0829]]於2017年將judge更新<br />
* [[T24]]的[[tobiichi3227]]與[[ccccchhhheeenng]]於2022年將後端Server的軟硬體更新<br />
<br />
== Special Judge ==<br />
將[https://github.com/TFcis/Problem-setting-tools/blob/master/TOJ-problem-example/conf.json conf.json]中的check從diff改成ioredir，及設定metadata如下。<br />
;/conf.json<br />
<syntaxhighlight lang="JSON">{<br />
"check": "ioredir",<br />
"metadata": {<br />
"redir_test": {<br />
"pipeout": 1,<br />
"testin": 0,<br />
"testout": -1,<br />
"pipein": -1<br />
},<br />
"redir_check": {<br />
"ansin": 2,<br />
"testin": -1,<br />
"pipeout": 0,<br />
"pipein": -1<br />
}<br />
}<br />
}</syntaxhighlight><br />
<br />
;/res/check/check.cpp<br />
分別從答案及輸出分別讀入long double。<br />
<syntaxhighlight lang="C++"><br />
long double Answer, Output;<br />
FILE *ansf = fdopen(2, "r");<br />
<br />
scanf("%Lf", &Output);<br />
fscanf(ansf, "%Lf", &Answer);<br />
</syntaxhighlight><br />
<br />
;/res/check/build<br />
<syntaxhighlight lang="Bash"><br />
#!/bin/sh<br />
g++ -o check check.cpp<br />
</syntaxhighlight><br />
<br />
參考 https://hackmd.io/s/BkHdt57I<br />
<br />
== 參見 ==<br />
* [[TOJ API]]：API文檔<br />
* [https://github.com/pzread/judge judge原始碼]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=%E9%A6%AC%E9%81%93%E4%B8%AD&diff=422
馬道中
2022-10-20T08:42:37Z
<p>Tobiichi3227：redirect to tobiichi3227 page</p>
<hr />
<div>#REDIRECT [[tobiichi3227]]</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T24&diff=421
T24
2022-10-20T08:38:12Z
<p>Tobiichi3227：/* 社員名單 */</p>
<hr />
<div>台南一中資訊社第24屆<br />
<br />
==社員名單==<br />
<section begin=club-members /><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[姚政彣]] || [[Vincenttainan]]<br />
|-<br />
| [[副社長]] || [[林軒名]] || <br />
|-<br />
| [[程設教學]] || [[張丞漢]] || [[same0620]]<br />
|-<br />
| [[程設教學]] || [[郭育愷]] || [[bgg0516]]<br />
|-<br />
| [[網管教學]] || [[莊正誠]] || [[ccccchhheeeng]]<br />
|-<br />
| [[網管教學]] || [[涂思寬]] || [[YYOuO]]<br />
|-<br />
| [[網管教學]] || [[林大鈞]] || <br />
|-<br />
| [[開發教學]] || [[王傑宇]] || <br />
|-<br />
| [[網管]] || [[高斐凱]] || <br />
|-<br />
| [[總務]] || [[張赫倫]] || <br />
|-<br />
| [[美宣]] || || <br />
|-<br />
| [[文書]] || [[蘇宥恆]] || [[chocomint]]<br />
|- <br />
| [[公關]] || [[賴冠學]] || <br />
|- <br />
| [[庶務]] || [[馬道中]] || [[tobiichi3227]]<br />
|-<br />
| [[社員]] || [[林恩甫]] || [[EF Lin]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=T24&diff=420
T24
2022-10-20T04:48:18Z
<p>Tobiichi3227：</p>
<hr />
<div>台南一中資訊社第24屆<br />
<br />
==社員名單==<br />
<section begin=club-members /><br />
{| class="wikitable"<br />
|-<br />
! 職位 !! 名字 !! id<br />
|-<br />
| [[社長]] || [[姚政彣]] || [[Vincenttainan]]<br />
|-<br />
| [[副社長]] || [[林軒名]] || <br />
|-<br />
| [[程設教學]] || [[張丞漢]] || [[same0620]]<br />
|-<br />
| [[程設教學]] || || <br />
|-<br />
| [[網管教學]] || || <br />
|-<br />
| [[網管教學]] || || <br />
|-<br />
| [[開發教學]] || || <br />
|-<br />
| [[網管]] || || <br />
|-<br />
| [[總務]] || || <br />
|-<br />
| [[美宣]] || || <br />
|-<br />
| [[文書]] || [[蘇宥恆]] || [[chocomint]]<br />
|- <br />
| [[庶務]] || [[馬道中]] || [[tobiichi3227]]<br />
|-<br />
| [[社員]] || [[林恩甫]] || [[EF Lin]]<br />
|}<br />
<section end=club-members /><br />
<br />
==活動==<br />
<br />
==豐功偉業==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=Tobiichi3227&diff=419
Tobiichi3227
2022-10-20T04:45:17Z
<p>Tobiichi3227：</p>
<hr />
<div>{{社員資訊框<br />
|name=[[馬道中]]<br />
|year=[[T24]]<br />
|jobs=庶務<br />
|id=tobiichi3227<br />
}}<br />
<br />
==社員簡介==<br />
<br />
==專長==<br />
<br />
==豐功偉業==<br />
<br />
==經歷==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=Tobiichi3227&diff=418
Tobiichi3227
2022-10-20T04:44:57Z
<p>Tobiichi3227：</p>
<hr />
<div>{{社員資訊框<br />
|name=馬道中<br />
|year=[[T24]]<br />
|jobs=庶務<br />
|id=tobiichi3227<br />
}}<br />
<br />
==社員簡介==<br />
<br />
==專長==<br />
<br />
==豐功偉業==<br />
<br />
==經歷==</div>
Tobiichi3227
https://wiki.tfcis.org/index.php?title=%E8%87%BA%E5%8D%97%E4%B8%80%E4%B8%AD%E8%B3%87%E8%A8%8A%E7%A4%BE&diff=417
臺南一中資訊社
2022-10-20T04:44:35Z
<p>Tobiichi3227：add T24 link</p>
<hr />
<div>臺南一中資訊社是臺南一中的自然科學類社團。該社團以學術研究為主要發展方向，也是全臺南一中唯一有考試的社團。<br /><br />
也因為資訊社強調以學術研討為主，並以程式解題競賽為主要訓練方向之一，該社歷來培養出許多資訊奧林匹亞及資訊能力競賽的好手，亦不乏國手級的人物。<ref>[[xeon]] (第一屆)，〈社團簡介〉，2001 年 08 月18 日更新。<br />其他[[社員]]或社友的口述歷史</ref><br />
<br />
== 簡史 ==<br />
<br />
== [[入社考]]與[[留社考]] ==<br />
在高一社團獨立招生時，會舉辦入社考，來篩選出較有經驗或較有熱誠的學弟入社，並要求高一同學必須通過兩個學期末的留社考，才能在高二生涯中繼續留在社團裡<ref>過去的試題可於[[TOJ]]上找到</ref>。高一上的[[留社考]]通常會以測驗語法能力為基準命題，高一下的[[留社考]]則會融合所有課程內容及其延伸命題。<br />
<br />
== [[暑訓]]與[[寒訓]] ==<br />
寒暑假都有長達一周的全天集訓(競程)，會有許多超強學長回歸，不乏有友社或是國中生專程前來旁聽。<br />
<br />
== 社團幹部 ==<br />
[[社長]]、[[副社長]]、[[程設教學]]、[[網管教學]]、[[網管]]、[[美工]]、[[總務]]<br />
各屆幹部請見[[社員名單]]<br />
<br />
每屆情況不同，視情況調整{{Fact|（甚至還有出現「[[社寵]]」及「[[社寵長]]」還有「[[總統]]」之類的奇異幹部名稱）}}<br />
<br />
== [[社團結構]] ==<br />
<br />
=== [[T16]]前 ===<br />
<br />
資訊社主要分為三個組：[[程設組]]、[[網頁組]]、[[網管組]]。各組由學長帶領學弟，在社課或空閒時間探討特定領域的知識。資訊社並沒有強制要求同學只能參加一個組，各組同學之間的學習領域也多少有重疊。<br />
<br />
==== [[程設組]] ====<br />
是資訊社2014年時主要的組別，且招收[[T17]][[社員]]時僅招收程設組。以資訊競賽為主要目標，每周的[[社課]]教學C++程式語言。<br />
<br />
==== [[網頁組]] ====<br />
負責HTML語言、CSS以及JavaScript的相關內容。<br />
<br />
已於102學年由僅存唯一一名的組員宣布停止招生，期望學弟能在網管組兼顧更多網路方面的能力，以避免偏頗於單純的網頁設計、落入故步自封的境地。且，程設組的許多社員都有涉獵網頁設計的部分。<br />
<br />
簡言之，招生困難+教學實力不足<br />
<br />
==== [[網管組]] ====<br />
<br />
[[網管組]]的前身為[[系統組]]。在社團草創之初，系統組的組員協助維護校內的伺服器，同時也在社內維護起屬於社團的[[伺服器]]群。<br />
<br />
在第 6 屆社長[[劉茂宏]]以半實驗性質成立新的 BBS 「[[索尼小站]]」後，網管組的其中一個任務便是維護這個 BBS。從程式原始碼修訂、作業系統管理等等，學習基本的 UNIX 作業系統操作，以及著重於系統程式 （System Program） 的大型程式開發與維護。<br />
<br />
目前社內主要實習的作業系統多為 UNIX-like 系列，並以架設各式[[伺服器]]為主要學習方向。<br />
<br />
=== [[T17]] ===<br />
<br />
由[[T16]]社長[[domen111]]提出，主要分為[[程設組]]和[[開發組]]。<br />
<br />
====[[程設組]]====<br />
即為先前的[[程設組]]。<br />
<br />
====[[開發組]]====<br />
由先前的[[網頁組]]和[[網管組]]整併而來，著重於網頁設計及[[伺服器]]架設。<br />
<br />
=== 現行分組方式（[[T21]]之後） ===<br />
<br />
====[[競賽組]]====<br />
即為先前的[[程設組]]。<br />
<br />
====[[網管組]]====<br />
著重於網頁設計及[[伺服器]]架設、資安相關領域研究。<br />
<br />
====[[開發組]]====<br />
著重開發Unity遊戲。<br />
<br />
==[[國中生程式設計營]]==<br />
<br />
==[[高一生程式設計排名賽]]==<br />
<br />
==各屆條目==<br />
可參考已經建立的頁面 <br><br />
[[T24]]<br />
[[T23]]<br />
[[T22]]<br />
[[T21]]<br />
[[T20]]<br />
[[T19]]<br />
[[T18]]<br />
[[T17]]<br />
[[T16]]<br />
[[T15]]<br />
[[T14]]<br />
[[T13]]<br />
[[T12]]<br />
[[T11]]<br />
[[T10]]<br />
[[T9]]<br />
[[T8]]<br />
[[T7]]<br />
[[T6]]<br />
[[T5]]<br />
[[T4]]<br />
[[T3]]<br />
[[T2]]<br />
[[T1]]<br />
[[T0]]<br />
<br />
== 參考資料 ==<br />
<references/><br />
== 外部連結 ==<br />
* [http://www.tfcis.org 社團網站]<br />
* [telnet://sony.tfcis.org 索尼小站BBS] 請使用BBS軟體連線，建議使用[http://pcman.openfoundry.org/ PCMan]</div>
Tobiichi3227