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

這類模板名稱只要簡短、有意義即可，不要落落長，也不要毫無意義的名稱。

XXT 勉強符合要求，夠簡短，意義方面可聯想為「線形圖」漢語拼音的字首（Xian-Xing-Tu）。

設計此系列模板時，原本使用正式英文縮寫做為名稱，例如：

• EF = Eighth Finals，十六強。
• QF = Quarter Finals，八強（準々決賽）。
• SF = Semi Finals，四強（準決賽）。
• FF = Final，二強（決賽）。

瞬間又覺得這些名稱不夠直覺，我自己寫到一半都可能搞混，不如來個「台式邏輯」，改成現在的 TOPn 形式，直覺多了：

• TOP16，十六強。
• TOP8，八強。
• TOP4，四強。
• TOP2，二強。

個人能力有限，僅止於顯示至多十六強的單淘汰線形圖，別問怎麼沒有卅二強以上或雙淘汰，那些寫下去我會爆炸。

在這個 XXT 線形圖系統裡：

• 若以「階層」劃分，依隊數之不同而分成不同階層的模板：TOP[1..16]，這些層級並非獨立運作，而是資料一層層傳遞，緊密結合。（TOP1 在現實世界裡沒有意義，但在這個 XXT 架構裡可能是最重要的一個層級，因為各層級的資料最終將彙整於此）
• 若以「功能」劃分，各個層級又分成前端模板（用於讓使用者直接使用，並且層層整理、包裝、傳遞資訊給下一階段的負責者），以及進行最後實際輸出的線形圖產生者。

下列模板不僅是可直接使用的前端介面，彼此間亦為階層式關係，資料會整理成下一階段所需的參數並逐層傳遞。

• 模板 {{XXT/TOP16}} 設定 TOP16 資訊並整理為 TOP8 所需參數。
• 模板 {{XXT/TOP8}} 設定 TOP8 資訊並整理為 TOP4 所需參數。
• 模板 {{XXT/TOP4}} 設定 TOP4 資訊並整理為 TOP2 所需參數。
• 模板 {{XXT/TOP2}} 設定 TOP2 資訊並整理為 TOP1 所需參數。
• 模板 {{XXT/TOP1}} 設定 TOP1 資訊並整理為最終參數、呼叫指定的 Renderer。

這裡將實際產生線形圖的後端運作者稱為 Renderer（故此系列名稱結尾為 "R"），參數複雜而繁多，不適合人類直接使用。

• 模板 {{XXT/TOP16R}} 根據已知參數產生 TOP16 線形圖，並為勝隊畫出晉級粗線。
• 模板 {{XXT/TOP8R}} 根據已知參數產生 TOP8 線形圖，並為勝隊畫出晉級粗線。
• 模板 {{XXT/TOP4R}} 根據已知參數產生 TOP4 線形圖，並為勝隊畫出晉級粗線。
• 模板 {{XXT/TOP2R}} 根據已知參數產生 TOP2 線形圖，並為勝隊畫出晉級粗線。
• 模板 {{XXT/TOP1R}} 根據已知參數產生 TOP1 線形圖，並為勝隊畫出晉級粗線。（此模板無前端意義，只是為了配合隊型。會用到此模板的人應該是很無聊）

• 使用者想畫出怎麼樣的線形圖，就直接使用 TOPn 系列的模板。
• 至於 TOPnR 系列是幕後工作者，使用者不宜直接呼叫。

此系列線形圖以「場次」為單位，以 TOPn-Mx- 表示「n 強階段，第 x 場」比賽。

• 兩隊名稱：TOPn-Mx-TEAMS  = team1/team2
• 兩隊得分：TOPn-Mx-SCORES = score1/score2
• 場次資訊：TOPn-Mx-INFO   = game/field/time

使用的格式都是合併寫法（以 "/" 分隔）。其中，兩隊得分與場次資訊沒有什麼問題，前者只是單純數字，後者可以控制不在文字裡出現 "/"，但是隊名的問題就大了。

為了擁有合併寫法的簡潔便利，此系列模板以國家代碼形式接受隊名，將自動呼叫 {{TeamX}} 顯示成小國旗與中文隊名。

| TOP8-M2-TEAMS  = ROC / KOR
| TOP8-M2-SCORES = 18 / 0
| TOP8-M2-INFO   = Game 2 / 台中洲際 / 2016-07-25 17:30

• 模板在接受這種合併寫法時，必須利用 "/" 將字串切開，然而此功能的原始目的是進行路徑解析，也就是說，特殊符號不應該出現在 "/" 的兩邊，包括中括號、大括號等等，這意味著我們不能直接在隊名中使用其它模板（如 {{TeamX}} ），否則將造成解析失敗，無法判斷 "/" 兩邊的子字串。
• 即使這種表示法只能以代碼表示球隊，但已滿足絕大部份國際賽所需。

某些時候，上述輸入法不適用，例如：

• 全壘打大賽，參賽者為個人，若我們想在人名前面加上球隊 logo，上述輸入法就不適用了，因為球隊 logo 並沒有對應的國家代碼。
• 基於某些因素，在一場賽事裡有國家用兩個以上的分隊參賽，則上述表示法也不適用。例如日本以三個分隊參賽，而上述表示法只能以代碼 JPN 或 JP 代入，顯示出來的中文隊名都是日本，無法辨別其分隊。（2008年第五屆亞洲青少棒錦標賽便有三個日本分隊）

任何情況下都可以用另一種形式「單獨指定」隊名（或人名），而且不受限於所使用的文字或符號，只要把 -TEAMS 拆成 -TEAM1 與 -TEAM2 即可。以下三種寫法同義：

<!-- 寫法一：合併寫法，必須使用國名縮寫，將自動轉換成小國旗與國名 -->
| TOP8-M3-TEAMS = USA / MEX

<!-- 寫法二：單獨指定，若為國名縮寫，則自動轉換成小國旗與國名 -->
| TOP8-M3-TEAM1 = USA
| TOP8-M3-TEAM2 = MEX

<!-- 寫法三：單獨指定，若非國名縮寫，則直接輸出 -->
| TOP8-M3-TEAM1 = {{TeamX|USA|美國　}}
| TOP8-M3-TEAM2 = {{TeamX|MEX|墨西哥}}

這種單獨指定的形式，自然也可以套用在球員：

<!-- 2016年中職全壘打大賽，八強階段，第二場，陽耀勳 vs 高國輝 -->
| TOP8-M2-TEAM1 = {{Lamigo桃猿}} [[陽耀勳]]
| TOP8-M2-TEAM2 = {{義大犀牛}} [[高國輝]]

以及分隊的情況：

<!-- 2008 BFA U15，以隊名為例，並非實際賽程，該比賽不是單淘汰制 -->
| TOP8-M1-TEAM1 = {{TeamX|JPN|日本伊豆}}
| TOP8-M1-TEAM2 = {{TeamX|JPN|日本座間}}

個人認為單獨指定的項目，優先權應該高於合併寫法，於是做了下列設計。

假設使用此系列模板時做了下列設定（同時使用兩種寫法），則以單獨指定者為優先，無關乎書寫順序：

| TOP8-M3-TEAM2 = JPN
| TOP8-M3-TEAMS = USA / MEX
| TOP8-M3-TEAM1 = RUS
<!-- 該場次的兩隊將為：俄羅斯 vs 日本 -->

這部份值得一提，此系列模板可利用「特殊值」處理某些狀況：

• 發生球隊棄賽的狀況。例如，不小心遇到印度隊。
• 參賽隊數不足。例如，欲使用八強圖，但晉級隊數僅有六隊，這種情況必須手動使其中兩個位置消失。

• 方法一：不需處理，直接填入最終判決的比數即可，如此一來，讓該晉級的球隊就自動晉級，該淘汰的自動淘汰。舉例而言，正規九局的比賽，其中一隊棄賽後，依規定通常判決為 9:0；同理，七局的比賽便是 7:0。
• 方法二：使用此系列模板的特殊值 -1。其意義同上，但會把棄賽球隊的背景塗成較暗的顏色，而且分數欄標示為「棄」。（對於晉級的另一隊，應參照上述方式，將其比分正確填為「比賽局數」）

範例

{{XXT/TOP4
  | TOP4-M1-TEAMS  = JPN / ZAF
  | TOP4-M2-TEAMS  = IND / NZL
  | TOP4-M1-SCORES = 2/11
  | TOP4-M2-SCORES = -1/9
  ...
}}

準　決　賽

決　賽

排　名

日本

2

南非

11

南非

冠　軍

印度

-1

紐西蘭

亞　軍

紐西蘭

9

日本

季　軍

紐西蘭

印度

殿　軍

碎碎唸Ⅰ

碎碎唸Ⅱ

賽程調整

範例

{{XXT/TOP4
  | TOP4-M1-TEAMS  = JPN / ZAF
  | TOP4-M2-TEAMS  = IND / NZL
  | TOP4-M1-SCORES = 8/-2
  | TOP4-M2-SCORES = 2/5
  ...
}}

準　決　賽

決　賽

排　名

日本

8

南非

-2

日本

冠　軍

印度

2

紐西蘭

亞　軍

紐西蘭

5

南非

季　軍

紐西蘭

印度

殿　軍

在以上的賽程裡，更好的寫法是把兩隊都取消，直接把 JPN 填入下一輪：

{{XXT/TOP4
  | TOP4-M1-TEAMS  = JPN / ZAF
  | TOP4-M2-TEAMS  = IND / NZL
  | TOP4-M1-SCORES = -2/-2
  | TOP4-M2-SCORES = 2/5

  | TOP2-M1-TEAM1  = JPN
  ...
}}

準　決　賽

決　賽

排　名

日本

-2

南非

-2

日本

冠　軍

印度

2

紐西蘭

亞　軍

紐西蘭

5

季　軍

紐西蘭

印度

殿　軍

開發記錄