「TPS」:修訂間差異

出自TFcisWiki
跳至導覽 跳至搜尋
無編輯摘要
行 8: 行 8:
# 進入[https://github.com/TNFSH-Programming-Contest/tps-starter/generate tps-starter]。
# 進入[https://github.com/TNFSH-Programming-Contest/tps-starter/generate tps-starter]。
# 填寫Repo資訊
# 填寫Repo資訊
#* Repository name填入競賽英文名,例如「{{#time:Y}}NHSPC-TNFSH-Preliminary」。
#* Repository name 填入競賽英文名,例如「{{#time:Y}}NHSPC-TNFSH-Preliminary」。
#* Description填入競賽中文名,例如「{{#expr:{{#time:Y}}-1911}}學年度資訊學科能力競賽臺南一中校內初選」。
#* Description 填入競賽中文名,例如「{{#expr:{{#time:Y}}-1911}}學年度資訊學科能力競賽臺南一中校內初選」。
#* [[File:OOjs UI icon alert-destructive.svg|20px]] '''非常重要:'''可見度必須選擇'''Private'''
#* [[File:OOjs UI icon alert-destructive.svg|20px]] '''注意:'''可見度必須選擇 '''Private'''。
#* 點擊Create repository from template
#* 點擊 Create repository from template。

=== 建立新題目 ===
# 進入由 tps-starter 建立的 Github repo。
# 點擊 Actions。
# 在 Workflows 段落,點擊 New problem。
# 點擊 Run workflow,在 Folder name to create 輸入要建立的資料夾名稱。
#* 資料夾名稱僅供命題人員識別用,不會顯示給參賽者。如果已排定題目順序,可用[[#題目編號|「pA、pB...」命名]],亦可用題目的[[#題目英文名稱|英文簡稱]]。
# 點擊藍色 Run workflow 按鈕。
# 等待約 1 分鐘。

=== 競賽名稱 ===
競賽名稱使用於:
# CMS 參賽介面左上角。
# 題本封面第一行。
# 題本內文各頁的左上角。

需寫入以下檔案:
# [https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/e3baed3f28e5d855f0a208492a7211a84b037878/cover.tex#L16 cover.tex]。
# 各題目 [https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/e3baed3f28e5d855f0a208492a7211a84b037878/pA/problem.json#L2 problem.json] 的 contest_name 欄位。

=== 題目名稱 ===
題目名稱使用於:
# CMS 題目敘述頁面。
# 題目標題(第一頁第一行)。
# 該題目各頁右上角。

需寫入於 [https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/e3baed3f28e5d855f0a208492a7211a84b037878/pA/problem.json#L5 problem.json] 的 title 欄位。

=== 題目英文名稱 ===
題目英文名稱應足以讓所有命題人員識別個別題目即可,通常取自於中文題目名稱,並盡量僅使用一個英文詞,首字大寫,若需要兩個英文詞以上,則使用[[zhwiki:駝峰式大小寫|PascalCase]]。使用於:
# CMS 參賽介面題目列表。
# CMS 題目敘述。
# CMS 系統內部用來識別題目的 [[zhwiki:主鍵|Primary key]]。
#* 由於同一 CMS 系統上的名稱無法重複,若與其他競賽題目衝突<ref>https://github.com/cms-dev/cms/issues/765</ref>,建議加上競賽名稱的英文縮寫作為前綴(例如「2022P-」)。
# 可能作為 Github repo 內的題目資料夾名稱。

需寫入於 [https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/e3baed3f28e5d855f0a208492a7211a84b037878/pA/problem.json#L4 problem.json] 的 name 欄位。

=== 題目編號 ===
題目編號為 A, B, C... 的流水號,在決定題目順序後才會確定,使用於:
# 題目標題(第一頁第一行)。
# 該題目各頁右上角。
# 該題目各頁頁碼處。

== 註解 ==
<references/>

於 2022年8月15日 (一) 19:42 的修訂

TPS(Task Preparation System)是一套可以方便產生題目測試資料以及題本的工具,關於 TPS 可以參考以下的 Github Repo:

使用方式

建立Github Repo

  1. 進入tps-starter
  2. 填寫Repo資訊
    • Repository name 填入競賽英文名,例如「2024NHSPC-TNFSH-Preliminary」。
    • Description 填入競賽中文名,例如「113學年度資訊學科能力競賽臺南一中校內初選」。
    • OOjs UI icon alert-destructive.svg 注意:可見度必須選擇 Private
    • 點擊 Create repository from template。

建立新題目

  1. 進入由 tps-starter 建立的 Github repo。
  2. 點擊 Actions。
  3. 在 Workflows 段落,點擊 New problem。
  4. 點擊 Run workflow,在 Folder name to create 輸入要建立的資料夾名稱。
  5. 點擊藍色 Run workflow 按鈕。
  6. 等待約 1 分鐘。

競賽名稱

競賽名稱使用於:

  1. CMS 參賽介面左上角。
  2. 題本封面第一行。
  3. 題本內文各頁的左上角。

需寫入以下檔案:

  1. cover.tex
  2. 各題目 problem.json 的 contest_name 欄位。

題目名稱

題目名稱使用於:

  1. CMS 題目敘述頁面。
  2. 題目標題(第一頁第一行)。
  3. 該題目各頁右上角。

需寫入於 problem.json 的 title 欄位。

題目英文名稱

題目英文名稱應足以讓所有命題人員識別個別題目即可,通常取自於中文題目名稱,並盡量僅使用一個英文詞,首字大寫,若需要兩個英文詞以上,則使用PascalCase。使用於:

  1. CMS 參賽介面題目列表。
  2. CMS 題目敘述。
  3. CMS 系統內部用來識別題目的 Primary key
    • 由於同一 CMS 系統上的名稱無法重複,若與其他競賽題目衝突[1],建議加上競賽名稱的英文縮寫作為前綴(例如「2022P-」)。
  4. 可能作為 Github repo 內的題目資料夾名稱。

需寫入於 problem.json 的 name 欄位。

題目編號

題目編號為 A, B, C... 的流水號,在決定題目順序後才會確定,使用於:

  1. 題目標題(第一頁第一行)。
  2. 該題目各頁右上角。
  3. 該題目各頁頁碼處。

註解