使用者:Digipunk/XXT/TOP8：修訂版本之間的差異

2016年7月25日 (一) 19:33的修訂版本

八強線形圖（XXT/TOP8）

輸入：以「位置」為依據，以「場次」為單位，填寫初始隊名（第一輪）、各場比分、場次資訊。
輸出：自動判斷晉級球隊、畫出晉級粗線。

除錯模式

XXT 系列提供一種特殊的除錯模式，在此模式下暫時不呈現使用者輸入值，而是以參數名稱顯示。
除錯模式的用途在於：一方面讓使用者對線形圖外觀有個概念，二方面也清楚該填入哪些參數。
正式呈現時只要關閉除錯模式（DEBUG=0 或不設定此參數）即可，亦可於填寫資料過程中隨時切換至除錯模式檢視參數名稱。

TOP8-DESCR

TOP4-DESCR

TOP2-DESCR

Debug Mode

紅字：必填
綠字：選填
~~黑字：免填~~

TOP8-M1-TEAM1 S1

TOP8-M1-INFO

TOP8-M1-TEAM2 S2 S1

TOP4-M1-INFO

TOP8-M2-TEAM1 S1 S2

TOP8-M2-INFO

TOP8-M2-TEAM2 S2 S1 TITLE-1ST

TOP2-M1-INFO

TOP8-M3-TEAM1 S1 S2 TITLE-2ND

TOP8-M3-INFO

TOP8-M3-TEAM2 S2 S1

TOP4-M2-INFO

TOP8-M4-TEAM1 S1 S2 S1 TITLE-3RD

TOP8-M4-INFO

TOP2-M2-INFO

TOP8-M4-TEAM2 S2 S1 S2 TITLE-4TH

TOP4-M3-INFO

S2 S1 TITLE-5TH

TOP2-M3-INFO

S1 S2 TITLE-6TH

TOP4-M4-INFO

S2 S1 TITLE-7TH

TOP2-M4-INFO

S2 TITLE-8TH

語法


1	{{XXT/TOP8
2	<!-- 【必填參數】完整賽事的必要參數 -->
3	<!-- 決定最終有幾個名次 -->		必填參數
4	\| RANKING	= <指定欲排名的隊數。預設值：8>
5
6	<!-- 八強隊名 -->
7	\| TOP8-M1-TEAMS	= <八強，第Ⅰ場比賽，隊名：第Ⅰ隊代碼/第Ⅱ隊代碼。參考「隊名表示法」說明>
8	\| TOP8-M2-TEAMS	= <八強，第Ⅱ場比賽，隊名：第Ⅰ隊代碼/第Ⅱ隊代碼>
9	\| TOP8-M3-TEAMS	= <八強，第Ⅲ場比賽，隊名：第Ⅰ隊代碼/第Ⅱ隊代碼>
10	\| TOP8-M4-TEAMS	= <八強，第Ⅳ場比賽，隊名：第Ⅰ隊代碼/第Ⅱ隊代碼>
11
12	<!-- 八強比分 -->
13	\| TOP8-M1-SCORES	= <八強，第Ⅰ場比賽。比數：第Ⅰ隊分數/第Ⅱ隊分數。參考「比分表示法」說明>
14	\| TOP8-M2-SCORES	= <八強，第Ⅱ場比賽。比數：第Ⅰ隊分數/第Ⅱ隊分數>
15	\| TOP8-M3-SCORES	= <八強，第Ⅲ場比賽。比數：第Ⅰ隊分數/第Ⅱ隊分數>
16	\| TOP8-M4-SCORES	= <八強，第Ⅳ場比賽。比數：第Ⅰ隊分數/第Ⅱ隊分數>
17
18	<!-- 四強比分 -->
19	\| TOP4-M1-SCORES	= <四強，第Ⅰ場比賽。比數：第Ⅰ隊分數/第Ⅱ隊分數>
20	\| TOP4-M2-SCORES	= <四強，第Ⅱ場比賽。比數：第Ⅰ隊分數/第Ⅱ隊分數>
21	\| TOP4-M3-SCORES	= <四強，第Ⅲ場比賽。比數：第Ⅰ隊分數/第Ⅱ隊分數，若有排名賽的話>
22	\| TOP4-M4-SCORES	= <四強，第Ⅳ場比賽。比數：第Ⅰ隊分數/第Ⅱ隊分數，若有排名賽的話>
23
24	<!-- 決賽比分 -->
25	\| TOP2-M1-SCORES	= <二強，第Ⅰ場比賽。比數：第Ⅰ隊分數/第Ⅱ隊分數>
26	\| TOP2-M2-SCORES	= <二強，第Ⅱ場比賽。比數：第Ⅰ隊分數/第Ⅱ隊分數，若有排名賽的話>
27	\| TOP2-M3-SCORES	= <二強，第Ⅲ場比賽。比數：第Ⅰ隊分數/第Ⅱ隊分數，若有排名賽的話>
28	\| TOP2-M4-SCORES	= <二強，第Ⅳ場比賽。比數：第Ⅰ隊分數/第Ⅱ隊分數，若有排名賽的話>
29
30	<!-- 【選填參數／可省略】場次資訊 -->
31	<!-- 八強場次資訊 -->		選填參數
32	\| TOP8-M1-INFO	= <八強，第Ⅰ場比賽，資訊：場次/地點/時間。參考「場次資訊表示法」說明>
33	\| TOP8-M2-INFO	= <八強，第Ⅱ場比賽，資訊：場次/地點/時間>
34	\| TOP8-M3-INFO	= <八強，第Ⅲ場比賽，資訊：場次/地點/時間>
35	\| TOP8-M4-INFO	= <八強，第Ⅳ場比賽，資訊：場次/地點/時間>
36
37	<!-- 四強場次資訊 -->
38	\| TOP4-M1-INFO	= <四強，第Ⅰ場比賽，資訊：場次/地點/時間>
39	\| TOP4-M2-INFO	= <四強，第Ⅱ場比賽，資訊：場次/地點/時間>
40	\| TOP4-M3-INFO	= <四強，第Ⅲ場比賽，資訊：場次/地點/時間，若有排名賽的話>
41	\| TOP4-M4-INFO	= <四強，第Ⅳ場比賽，資訊：場次/地點/時間，若有排名賽的話>
42
43	<!-- 決賽場次資訊 -->
44	\| TOP2-M1-INFO	= <二強，第Ⅰ場比賽，資訊：場次/地點/時間>
45	\| TOP2-M2-INFO	= <二強，第Ⅱ場比賽，資訊：場次/地點/時間，若有排名賽的話>
46	\| TOP2-M3-INFO	= <二強，第Ⅲ場比賽，資訊：場次/地點/時間，若有排名賽的話>
47	\| TOP2-M4-INFO	= <二強，第Ⅳ場比賽，資訊：場次/地點/時間，若有排名賽的話>
48
49	<!-- 【進階參數／可省略】除錯模式、樣式設定等 -->
50	<!-- 除錯模式 -->		進階參數
51	\| DEBUG	= <設為 1 表示進入除錯模式，顯示此模板所需的主要參數。預設值：0>
52	\| SHOW-PHASE	= <設為 0 表示不顯示階段提示（八強、準決賽、決賽）。預設值：1>
53	\| PR	= <在隊名後面附加全型空格至 PR 指定的長度。預設值：3>
54	\| X-LOSER	= <TOP4-M2-TEAM2 是來自哪一場比賽的敗隊。預設值為 TOP8-M2。參考「注意事項」說明>
55
56	<!-- 樣式設定 -->
57	\| RND-LEFT	= <隊名框格左方圓角半徑值。數字值，不加單位，單位固定為 px。預設值：5>
58	\| RND-RIGHT	= <分數框格右方圓角半徑值。數字值，不加單位，單位固定為 px。預設值：5>
59	\| STL-DIV	= <外框樣式>
60	\| STL-TABLE	= <表格樣式>
61	\| STL-TEAM	= <隊名框格樣式。預設值：漸層灰>
62	\| STL-SCORES	= <分數框格樣式。預設值：漸層灰>
63	\| STL-SCORES-WIN	= <勝隊分數框格樣式。預設值：漸層藍>
64	\| STL-SCORES-LOSS	= <敗隊分數框格樣式。預設值：漸層暗紅>
65	\| STL-PLACE-1ST	= <冠軍隊名框格樣式。預設值：漸層黃>
66	\| STL-PLACE-REST	= <其它名次隊名框格樣式。預設值：白>
67
68	<!-- 頭銜描述 -->
69	\| TITLE-1ST	= <第一名頭銜。預設值：冠　軍>
70	\| TITLE-2ND	= <第二名頭銜。預設值：亞　軍>
71	\| TITLE-3RD	= <第三名頭銜。預設值：季　軍>
72	\| TITLE-4TH	= <第四名頭銜。預設值：殿　軍>
73	\| TITLE-5TH	= <第五名頭銜。預設值：第五名>
74	\| TITLE-6TH	= <第六名頭銜。預設值：第六名>
75	\| TITLE-7TH	= <第七名頭銜。預設值：第七名>
76	\| TITLE-8TH	= <第八名頭銜。預設值：第八名>
77	}}

說明

概念：以位置為依據、以場次為單位

參數名稱中的 TOPn- 顧名思義，分別表示八強階段（TOP8-）、四強階段（TOP4-）、二強階段（TOP2-）。
參數名稱中的 Mx- 表示該階段中的第 x 場比賽（Match），由上而下，純粹取決於圖中的位置順序。

這裡用 M 而不用 G，是為了避免與實際賽事的場次名稱搞混，兩者必然有所出入，刻意避開。

根據上述邏輯，圖中八強階段、第三場比賽，便是以 TOP8-M3- 開頭。
加上 TEAMS 為兩隊名稱、加上 SCORES 為兩隊比分、加上 INFO 為場次資訊。

八強階段第三場比賽的兩隊： TOP8-M3-TEAMS
八強階段第三場比賽的比分： TOP8-M3-SCORES
八強階段第三場比賽的資訊： TOP8-M3-INFO

具備這些觀念，便足以建立一份八強線形圖。

隊名表示法

此線形圖以「場次」為單位，以 TOPn-Mx-TEAMS 表示「n 強階段，第 x 場」的兩隊名稱。
球隊名稱格式為：第Ⅰ隊代碼/第Ⅱ隊代碼。
其中代碼指「兩字母縮寫」或「三字母縮寫」，此模板將自動代入 {{TeamX}} 顯示小國旗與中文隊名。

<!-- 八強階段，第二場，中華 vs 韓國 -->
| TOP8-M2-TEAMS = ROC / KOR

替代寫法

任何情況下都可以用另一種形式「單獨指定」隊名（或人名），而且不受限於所使用的文字或符號。以下兩種寫法同義：

<!-- 八強階段，第三場，美國 vs 墨西哥 -->
| TOP8-M3-TEAMS = USA / MEX

<!-- 八強階段，第三場，美國 vs 墨西哥 -->
| TOP8-M3-TEAM1 = {{TeamX|USA|美國　}}
| TOP8-M3-TEAM2 = {{TeamX|MEX|墨西哥}}

比分表示法

此線形圖以「場次」為單位，以 TOPn-Mx-SCORES 表示「n 強階段，第 x 場」的兩隊分數。
比分格式為：第Ⅰ隊分數/第Ⅱ隊分數。

<!-- 八強階段，第二場，兩隊比分 -->
| TOP8-M2-SCORES = 11 / 3

場次資訊表示法

此線形圖以「場次」為單位，以 TOPn-Mx-INFO 表示「n 強階段，第 x 場」的場次資訊。
場次資訊格式為：場次名稱/地點/時間。

<!-- 八強階段，第二場，場次資訊 -->
| TOP8-M2-INFO = Game 2 / 台中洲際 / 2016-07-25 17:30

範例

讓我們以「2015年第一屆世界12強棒球賽」的八強賽為例，產生線形圖的邏輯為：

最後排名為四名，故 RANKING=4。（亦可設為 3，不會影響比賽流程，只是最後不顯示第四名而已）
填入八強隊名。
填入各階段分數。
填入比賽場地、時間等資訊（以下範例省略此步驟）。

根據這些資訊，即可輕鬆產生八強線形圖，它會自動判斷晉級球隊、劃出晉級粗線、整調最終需顯示的名次。

{{XXT/TOP8
  | RANKING = 4

  | TOP8-M1-TEAMS = CAN / MEX
  | TOP8-M2-TEAMS = NED / USA
  | TOP8-M3-TEAMS = CUB / KOR
  | TOP8-M4-TEAMS = PRI / JPN
<!-- 以下寫法同義
  | TOP8-M1-TEAM1 = {{TeamX|CAN|加拿大}}
  | TOP8-M1-TEAM2 = {{TeamX|MEX|墨西哥}}
  | TOP8-M2-TEAM1 = {{TeamX|NED|荷蘭　}}
  | TOP8-M2-TEAM2 = {{TeamX|USA|美國　}}
  | TOP8-M3-TEAM1 = {{TeamX|CUB|古巴　}}
  | TOP8-M3-TEAM2 = {{TeamX|KOR|韓國　}}
  | TOP8-M4-TEAM1 = {{TeamX|PRI|波多黎各}}
  | TOP8-M4-TEAM2 = {{TeamX|JPN|日本　}}
-->

  | TOP8-M1-SCORES = 3 / 4
  | TOP8-M2-SCORES = 1 / 6
  | TOP8-M3-SCORES = 2 / 7
  | TOP8-M4-SCORES = 3 / 9

  | TOP4-M1-SCORES = 1 / 6
  | TOP4-M2-SCORES = 4 / 3

  | TOP2-M1-SCORES = 0 / 8
  | TOP2-M2-SCORES = 1 / 11   <!-- 排名賽 -->
}}

八　強　賽準　決　賽決　賽排　名

加拿大

3

墨西哥

4

墨西哥

1

荷蘭　

1

美國　

6

美國　

6

美國　

0

冠　軍

韓國　

古巴　

2

韓國　

8

亞　軍

美國　

韓國　

7

韓國　

4

波多黎各

3

日本　

3

墨西哥

1

季　軍

日本　

9

加拿大

日本　

11

殿　軍

墨西哥

荷蘭　

第五名

古巴　

第六名

波多黎各

第七名

第八名

注意事項

線圖形只顧「對戰組合」，不顧主客隊身份。在一場比賽裡，只要兩隊正確即可，哪一隊寫在上面、哪一隊寫在下面，沒有關係。
雖然八強線形圖只需填入最初八隊，之後會根據比數自動處理晉級狀況。但在某些我暫時想不到的情況下，或許需要手動指定後續階段裡的晉級球隊。此模板保留將球隊名稱填入後續階段的空間，填寫邏輯不變（例如要手動指定四強第一場比賽的第二隊，直接將隊名設定在 TOP4-M1-Team2 即可）。
請特別留意排名五隊以上的情況：當最後排名是五隊以上時，意味著必須進行場次 TOP4-M3 與 TOP4-M4 的比賽，必須特別留意八強賽的四支敗隊在此階段是否進行交叉排列。為了處理可能的交叉排列情況，此模板的特別設計是：TOP4-M3-TEAM1 一定是 TOP8-M1 的敗隊，其對手 TOP4-M3-TEAM2 則以參數 X-LOSER 指定來自哪一場比賽，只要設定了此參數，模板便知道怎麼處理這兩組對戰組合。（參數 X-LOSER 可省略，預設值為 TOP8-M2。合法值為 TOP8-M2、TOP8-M3、TOP8-M4）

開發記錄

[2016-07-20] 建立模板。