TPS - 修訂歷史

Tobiichi3227 於 2025年8月1日 (五) 06:36

2025-08-01T06:36:09Z

←上個修訂		於 2025年8月1日 (五) 14:36 的修訂
行 120：		行 120：
	## 前往 Settings -> Actions -> General		## 前往 Settings -> Actions -> General
	## 找到 Workflow permissions		## 找到 Workflow permissions
	## 選取 Read ~~repository contents~~ and ~~packages~~ ~~permissions~~ 並保存設定		## 選取 Read and write Permissions 並保存設定
	# （可選）若要將 GitHub Repo 更新傳送到 Discord，請參考 [https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks Intro to Webhooks – Discord] 操作。		# （可選）若要將 GitHub Repo 更新傳送到 Discord，請參考 [https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks Intro to Webhooks – Discord] 操作。

Tobiichi3227：根目錄新增 appendix.tex

2025-07-15T14:21:44Z

根目錄新增 appendix.tex

←上個修訂		於 2025年7月15日 (二) 22:21 的修訂
行 30：		行 30：

	範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/cover.tex		範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/cover.tex

			==== appendix.tex ====
			題本附錄。

			範例：https://github.com/TNFSH-Programming-Contest/tps-starter/blob/main/appendix.tex

	==== template.tex ====		==== template.tex ====

Tobiichi3227：建立 Github Repo 加入修改 Github Action 權限教學

2025-03-28T02:56:15Z

建立 Github Repo 加入修改 Github Action 權限教學

←上個修訂		於 2025年3月28日 (五) 10:56 的修訂
行 112：		行 112：
	#* [[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。
			# 開啟 Github Action 權限
			## 前往 Settings -> Actions -> General
			## 找到 Workflow permissions
			## 選取 Read repository contents and packages permissions 並保存設定
	# （可選）若要將 GitHub Repo 更新傳送到 Discord，請參考 [https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks Intro to Webhooks – Discord] 操作。		# （可選）若要將 GitHub Repo 更新傳送到 Discord，請參考 [https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks Intro to Webhooks – Discord] 操作。

Xiplus：/* 手產測資檔 */

2022-08-31T03:23:47Z

手產測資檔

←上個修訂		於 2022年8月31日 (三) 11:23 的修訂
行 195：		行 195：
	==== 手產測資檔 ====		==== 手產測資檔 ====
	{{Memo\|'''最佳實踐：'''		{{Memo\|'''最佳實踐：'''
	# 僅在~~範例測資和~~ [[:zhwiki:en:Edge case\|edge case]] 使用手產測資檔，其他使用產測程式。		# 僅在 [[:zhwiki:en:Edge case\|edge case]] 使用手產測資檔，其他使用產測程式。
			# 範例測資亦可隨機產生，若想要手動指定，亦可使用手產測資檔。
	# 在 gen/manual 保存與題本相同的範例測資。
	\|}}		\|}}

	手產測資檔應放置在{{slink\|\|gen/manual}}資料夾內，檔名無限制，但建議副檔名為 .in。		手產測資檔應放置在{{slink\|\|gen/manual}}資料夾內，檔名無限制，但建議副檔名為 .in。

	本範例包含一個固定測資檔 sample-01.in<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/gen/manual/sample-01.in</ref> 作為範例測資。		本範例有 2 個範例測資，其中一個使用手產測資檔 sample-01.in<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/gen/manual/sample-01.in</ref>，另一個為隨機測資。

	{{reflist-talk}}		{{reflist-talk}}

Xiplus：/* 自動建置 */

2022-08-30T09:51:10Z

自動建置

←上個修訂		於 2022年8月30日 (二) 17:51 的修訂
行 527：		行 527：

	{{reflist-talk}}		{{reflist-talk}}

			=== 跳過自動建置 ===
			若已經啟用自動建置，但想在特定一筆 Commit 跳過自動建置，請在 Commit message 加上 <code>[no ci]</code>，例如：
			<syntaxhighlight lang="text">pA Add wa.cpp

			Add WA solution without swap
			[no ci]
			</syntaxhighlight>

			完整說明參見 [https://docs.github.com/en/actions/managing-workflow-runs/skipping-workflow-runs Skipping workflow runs - GitHub Docs]。

Xiplus：/* 自動建置測資 */

2022-08-29T01:22:53Z

自動建置測資

←上個修訂		於 2022年8月29日 (一) 09:22 的修訂
行 514：		行 514：

	=== 自動建置測資 ===		=== 自動建置測資 ===
	若產測資程式和標程皆已定稿，可開啟自動建置功能，之後對於相關檔案的修改都會觸發自動建置。刪除 gen/DISABLE_AUTO_BUILD<ref>https://github.com/TNFSH-Programming-Contest/tps-task-templates/blob/main/default/~~tests~~/DISABLE_AUTO_BUILD</ref> 即可開啟自動建置測資。		若產測資程式和標程皆已定稿，可開啟自動建置功能，之後對於相關檔案的修改都會觸發自動建置。刪除 gen/DISABLE_AUTO_BUILD<ref>https://github.com/TNFSH-Programming-Contest/tps-task-templates/blob/main/default/gen/DISABLE_AUTO_BUILD</ref> 即可開啟自動建置測資。

	修改以下檔案將會觸發自動建置 input：		修改以下檔案將會觸發自動建置 input：

Xiplus：/* 自動建置測資 */

2022-08-29T01:21:40Z

自動建置測資

←上個修訂		於 2022年8月29日 (一) 09:21 的修訂
行 514：		行 514：

	=== 自動建置測資 ===		=== 自動建置測資 ===
	若產測資程式和標程皆已定稿，可開啟自動建置功能，之後對於相關檔案的修改都會觸發自動建置。刪除 ~~tests~~/DISABLE_AUTO_BUILD<ref>https://github.com/TNFSH-Programming-Contest/tps-task-templates/blob/main/default/tests/DISABLE_AUTO_BUILD</ref> 即可開啟自動建置測資。		若產測資程式和標程皆已定稿，可開啟自動建置功能，之後對於相關檔案的修改都會觸發自動建置。刪除 gen/DISABLE_AUTO_BUILD<ref>https://github.com/TNFSH-Programming-Contest/tps-task-templates/blob/main/default/tests/DISABLE_AUTO_BUILD</ref> 即可開啟自動建置測資。

	修改以下檔案將會觸發自動建置 input：		修改以下檔案將會觸發自動建置 input：

Xiplus：/* 建立GitHub Repo */

2022-08-27T13:58:02Z

建立GitHub Repo

←上個修訂		於 2022年8月27日 (六) 21:58 的修訂
行 112：		行 112：
	#* [[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。
			# （可選）若要將 GitHub Repo 更新傳送到 Discord，請參考 [https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks Intro to Webhooks – Discord] 操作。

	{{reflist-talk}}		{{reflist-talk}}

Xiplus：/* 準備TPS資料 */

2022-08-24T15:08:04Z

準備TPS資料

←上個修訂		於 2022年8月24日 (三) 23:08 的修訂
行 147：		行 147：

	=== 題目名稱 ===		=== 題目名稱 ===
	題目名稱使用於：		題目名稱（problem title）使用於：
	# CMS 競賽概況的題目列表。		# CMS 競賽概況的題目列表。
	# CMS 題目敘述頁面。		# CMS 題目敘述頁面。
行 156：		行 156：

	=== 題目英文名稱 ===		=== 題目英文名稱 ===
	題目英文名稱應足以讓所有命題人員識別個別題目即可，通常取自於中文題目名稱，並盡量僅使用一個英文詞，首字大寫，若需要兩個英文詞以上，則使用[[zhwiki:駝峰式大小寫\|PascalCase]]。使用於：		題目英文名稱（problem name）應足以讓所有命題人員識別個別題目即可，通常取自於中文題目名稱，並盡量僅使用一個英文詞，首字大寫，若需要兩個英文詞以上，則使用[[zhwiki:駝峰式大小寫\|PascalCase]]。使用於：
	# CMS 競賽概況的題目列表。		# CMS 競賽概況的題目列表。
	# CMS 題目敘述。		# CMS 題目敘述。
行 168：		行 168：

	=== 題目編號 ===		=== 題目編號 ===
	題目編號為 A, B, C... 的流水號，在決定題目順序後才會確定，使用於：（範例為「B」）		題目編號（problem label）為 A, B, C... 的流水號，在決定題目順序後才會確定，使用於：（範例為「B」）
	# CMS 競賽概況的題目列表。		# CMS 競賽概況的題目列表。
	# 題目標題（第一頁第一行）。		# 題目標題（第一頁第一行）。
行 181：		行 181：

	=== 標程 ===		=== 標程 ===
	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>。		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>。

	其他 AC code 亦按照前述方式操作，verdict 必須標記為 correct。		其他 AC code 亦按照前述方式操作，verdict 必須標記為 correct。
行 212：		行 212：
	\|inline:notice}}		\|inline:notice}}

	產測資程式應放置在{{slink\|\|gen}}資料夾內，檔名無限制。‎		產測資程式（generator）應放置在{{slink\|\|gen}}資料夾內，檔名無限制。‎

	以下說明請配合範例檔案 gen/gen.cpp<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/gen/gen.cpp</ref>。		以下說明請配合範例檔案 gen/gen.cpp<ref>https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/gen/gen.cpp</ref>。
行 320：		行 320：
	{{Memo\|'''最佳實踐：'''撰寫驗測資程式來自動檢查測資範圍及其他條件是否有符合題目的規定，避免測資範圍錯誤。\|}}		{{Memo\|'''最佳實踐：'''撰寫驗測資程式來自動檢查測資範圍及其他條件是否有符合題目的規定，避免測資範圍錯誤。\|}}

	驗測資程式~~（又稱 validator）~~應該放置在{{slink\|\|validator}}資料夾內，檔名無限制，並將檔名寫入{{slink\|\|subtasks.json}}的 global_validators 或 subtasks 的 validators。		驗測資程式（validator）應該放置在{{slink\|\|validator}}資料夾內，檔名無限制，並將檔名寫入{{slink\|\|subtasks.json}}的 global_validators 或 subtasks 的 validators。

	本範例包含 2 個 validator。		本範例包含 2 個 validator。
行 337：		行 337：

	=== 子任務 ===		=== 子任務 ===
	子任務設定於{{slink\|\|subtasks.json}}，包含各子任務的配分、文字描述、{{slink\|\|驗測資程式}}。以下說明請參考範例。		子任務（subtask）設定於{{slink\|\|subtasks.json}}，包含各子任務的配分、文字描述、{{slink\|\|驗測資程式}}。以下說明請參考範例。

	subtasks.json 最外層包含兩個 key：		subtasks.json 最外層包含兩個 key：
行 352：		行 352：

	=== 題目敘述 ===		=== 題目敘述 ===
	題本檔案放置於{{slink\|\|statement/index.md}}。使用 [[zhwiki:Markdown\|Markdown]] 及 [[zhwiki:XeTeX\|XeTeX]] 語法。		題目敘述（statement）的檔案放置於{{slink\|\|statement/index.md}}。使用 [[zhwiki:Markdown\|Markdown]] 及 [[zhwiki:XeTeX\|XeTeX]] 語法。

	結構由上到下依序為：		結構由上到下依序為：

Xiplus：/* 題目資料夾 */

2022-08-23T14:34:10Z

題目資料夾

←上個修訂		於 2022年8月23日 (二) 22:34 的修訂
行 37：		行 37：
	==== attachments ====		==== attachments ====
	放在此處的所有檔案將會上傳到 CMS 上，供參賽者在題目敘述頁的「附件」，通常僅會在 pA 的附件放置{{slink\|\|合併題本}}。		放在此處的所有檔案將會上傳到 CMS 上，供參賽者在題目敘述頁的「附件」，通常僅會在 pA 的附件放置{{slink\|\|合併題本}}。

			[[File:Crystal Clear action run.png\|20px]] 本目錄內容通常由程式自動產生。

	範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pA/attachments		範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pA/attachments
行 54：		行 56：

	==== scripts ====		==== scripts ====
	TPS scripts，不需修改。		[[File:Crystal Clear action run.png\|20px]] 本目錄保存 TPS scripts，不需修改。

	範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/scripts		範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/scripts
行 71：		行 73：
	==== tests ====		==== tests ====
	{{slink\|\|產測資}}後的檔案會存放於此，參見{{slink\|\|建置測資}}。		{{slink\|\|產測資}}後的檔案會存放於此，參見{{slink\|\|建置測資}}。

			[[File:Crystal Clear action run.png\|20px]] 本目錄內容由程式自動產生，不應手動編輯。

	範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/tests		範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/tree/main/pB/tests
行 84：		行 88：
	==== solutions-check.txt ====		==== solutions-check.txt ====
	所有標程的執行結果報告。		所有標程的執行結果報告。

			[[File:Crystal Clear action run.png\|20px]] 本檔案由程式自動產生，不應手動編輯。

	範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/solutions-check.txt		範例：https://github.com/TNFSH-Programming-Contest/cms-environment-testing-problem/blob/main/pB/solutions-check.txt

TPS - 修訂歷史

Tobiichi3227 於 2025年8月1日 (五) 06:36

Tobiichi3227：​根目錄新增 appendix.tex

Tobiichi3227：​建立 Github Repo 加入修改 Github Action 權限教學

Xiplus：​/* 手產測資檔 */

Xiplus：​/* 自動建置 */

Xiplus：​/* 自動建置測資 */

Xiplus：​/* 自動建置測資 */

Xiplus：​/* 建立GitHub Repo */

Xiplus：​/* 準備TPS資料 */

Xiplus：​/* 題目資料夾 */

Tobiichi3227：根目錄新增 appendix.tex

Tobiichi3227：建立 Github Repo 加入修改 Github Action 權限教學

Xiplus：/* 手產測資檔 */

Xiplus：/* 自動建置 */

Xiplus：/* 自動建置測資 */

Xiplus：/* 自動建置測資 */

Xiplus：/* 建立GitHub Repo */

Xiplus：/* 準備TPS資料 */

Xiplus：/* 題目資料夾 */