模板:Xiangqi diagram/doc
 | 此模板使用Lua語言： |
 | 本模板使用以下模板樣式： |
概要
用於展示象棋棋譜，具有標框、標點、標叉、箭頭等功能，可以更快讀懂棋譜想表達的意思。
使用方法
| 基本參數 | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 第一個參數 | 對其方式，有center、tleft、tright，預設為tleft。 | |||||||||||||||||||||||||
| 第二個參數 | 標題 | |||||||||||||||||||||||||
| 第三個 至 第九十二個參數 |
棋子種類和顏色，以下表為示： 沒有棋子可以填入「_」或者空白鍵。
| |||||||||||||||||||||||||
| 第九十三個參數 | 說明 | |||||||||||||||||||||||||
| size | 棋子大小 | 這三個參數三選一，也可以都不寫會自動用預設大小，預設是棋子大小25px。 | ||||||||||||||||||||||||
| width | 寬度 | |||||||||||||||||||||||||
| height | 高度 | |||||||||||||||||||||||||
| startrow | 開始顯示行 | 顯示範圍 | ||||||||||||||||||||||||
| rows | 要顯示行數 | |||||||||||||||||||||||||
| startcol | 開始顯示列 | |||||||||||||||||||||||||
| cols | 要顯示列數 | |||||||||||||||||||||||||
| arrow arrow2 arrow3...... |
顯示箭頭 | |||||||||||||||||||||||||
使用範例
基本功能
| 源代碼 | 頁面顯示效果 |
|---|---|
{{Xiangqi diagram
|tleft
|示例（空棋盘）
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
|展示一个空棋盘
|size=25
}}
|
示例（空棋盤） 展示一個空棋盤 |
{{Xiangqi diagram
|tleft
|示例（英文代码）
|rd|hd|ed|ad|gd|ad|ed|hd|rd
| | | | | | | | |
| |cd| | | | | |cd|
|sd| |sd| |sd| |sd| |sd
| | | | | | | | |
| | | | | | | | |
|sl| |sl| |sl| |sl| |sl
| |cl| | | | | |cl|
| | | | | | | | |
|rl|hl|el|al|gl|al|el|hl|rl
|左浮动
|size=25
}}
|
示例（英文代碼） 左浮動 |
{{Xiangqi diagram
|tright
|示例（简体版）
|车|马|象|士|将|士|象|马|车
| | | | | | | | |
| |砲| | | | | |砲|
|卒| |卒| |卒| |卒| |卒
| | | | | | | | |
| | | | | | | | |
|兵| |兵| |兵| |兵| |兵
| |炮| | | | | |炮|
| | | | | | | | |
|伡|㐷|相|仕|帅|仕|相|㐷|伡
|右浮动
|size=25
}}
|
示例（簡體版） 右浮動 |
{{Xiangqi diagram
|center
|示例（繁體版）
|車|馬|象|士|將|士|象|馬|車
| | | | | | | | |
| |砲| | | | | |砲|
|卒| |卒| |卒| |卒| |卒
| | | | | | | | |
| | | | | | | | |
|兵| |兵| |兵| |兵| |兵
| |炮| | | | | |炮|
| | | | | | | | |
|俥|傌|相|仕|帥|仕|相|傌|俥
|居中
|size=25
}}
|
示例（繁體版） 居中 |
顯示特殊標記
在從第3到第92個參數中，除了填入棋子的中文名或英文代碼外，還可以填入某些特定代碼，在棋盤上顯示相對應的標記。
- 輸入「[]」，可在相應位置顯示一個方框。可用於突出強調某塊區域、某個棋子，或表示當前正在移動的棋子。
| 源代碼 | 頁面顯示效果 |
|---|---|
{{Xiangqi diagram
|tleft
|示例2
| | | | |将| | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | |砲|
| | | | | | | | |
| | | | | | |[㐷]| |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | |帅| | |
|“㐷”
|size=25
}}
|
示例2 「傌」 |
- 輸入「..」，可在相應位置顯示一個圓點，可用於表示某個棋子的起落點、允許着法等。
| 源代碼 | 頁面顯示效果 |
|---|---|
{{Xiangqi diagram
|tleft
|示例3
| | | | |将| | | |
| | | | | | | | |
| | | | | | | | |
| | | | | |..| |.砲.|
| | | | |..| | | |..
| | | | | | |[㐷]| |
| | | | |..| | | |..
| | | | | |..| |..|
| | | | | | | | |
| | | | | |帅| | |
|马踏八方
|size=25
}}
|
示例3 馬踏八方 |
- 輸入「xx」，可在相應位置顯示一個叉號，可用於表示某個棋子的禁止着法等。
| 源代碼 | 頁面顯示效果 |
|---|---|
{{Xiangqi diagram
|tleft
|示例4
| | | | |将| | | |
| | | | | | | | |
| | | | | | | | |
| | | | | |.砲.| |..|
| | | | |..| | | |xx
| | | | | | |[㐷]|卒|
| | | | |..| | | |xx
| | | | | |xx| |..|
| | | | | | | | |
| | | | | |帅| | |
|“蹩马腿”/禁止“送将”
|size=25
}}
|
示例4 「蹩馬腿」/禁止「送將」 |
指定範圍
可使用rows、startrow、cols、startcol等參數讓棋圖的一部分可見，其餘部分則隱藏：
- rows參數用以控制需要顯示的行數，startrow參數指定起始行數。
| 源代碼 | 頁面顯示效果 |
|---|---|
{{Xiangqi diagram
|tleft
|示例5
| | | | |将| | | |
| | | | | | | | |
| | | | | | | | |
| | | | | |..| |.砲.|
| | | | |..| | | |..
| | | | | | |[㐷]| |
| | | | |..| | | |..
| | | | | |..| |..|
| | | | | | | | |
| | | | | |帅| | |
|从第三行开始显示，共显示6行
|size=40
|rows=6
|startrow=3
}}
|
示例5 從第三行開始顯示，共顯示6行 |
- cols參數用以控制需要顯示的列數，startcol參數指定起始列數。
| 源代碼 | 頁面顯示效果 |
|---|---|
{{Xiangqi diagram
|tleft
|示例6
| | | | |将| | | |
| | | | | | | | |
| | | | | | | | |
| | | | | |..| |.砲.|
| | | | |..| | | |..
| | | | | | |[㐷]| |
| | | | |..| | | |..
| | | | | |..| |..|
| | | | | | | | |
| | | | | |帅| | |
|从第三行开始显示，共显示6行<br/>从第四列开始显示，共显示6列
|size=50
|rows=6
|startrow=3
|cols=6
|startcol=4
}}
|
示例6 從第三行開始顯示，共顯示6行 從第四列開始顯示，共顯示6列 |
箭頭指示
此功能需要CSS3（層疊樣式表第三份標準）的支持，不支持CSS3的瀏覽器（如Internet Explorer 8等）可能無法正確顯示
- arrow參數用於顯示箭頭，可更直觀的展示某個棋子的行棋路線。
- 格式：
arrow = a, b, c, d
- arrow由四個數字組成，用英文逗號分隔。第一個數（a）為箭頭的起始橫坐標，第二個數（b）為箭頭的起始縱坐標，第三個數（c）為箭頭長度，第四個數（d）為箭頭的旋轉角度。坐標以最左上角的交叉點位作為原點（1, 1）。角度以右箭頭（→）作為0°，按順時針旋轉。
- 若要使用多個箭頭可以用arrow2或者是更大的數字和arrow組合，但需要從2開始且必須是連續數字，例如需要五個箭頭則必須設定arrow、arrow2、arrow3、arrow4、arrow5。
| 源代碼 | 頁面顯示效果 |
|---|---|
{{Xiangqi diagram
|tleft
|示例7
| | | |士|将|士| | |
| | | | | | | | |
| | | | |傌| | | |
| | | | | | | | |
| | | | | | | | |
| | |炮| | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | |帅| | |
|
|size=25
|arrow=3, 6, 2, 0
}}
|
示例7 |
{{Xiangqi diagram
|tleft
|示例8
|车| | | |将| | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | |帅| | |
|
|size=25
|arrow=1, 1, 9, 90
}}
|
示例8 |
{{Xiangqi diagram
|tleft
|示例9
|车| | | |将|士| | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |伡
| | | | | | | | |
| | | | | |帅| | |
|
|size=25
|arrow=9, 8, 4, 180
}}
|
示例9 |
{{Xiangqi diagram
|tleft
|示例10
|车| | | |将|士| | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |炮
| | | | | | | | |
| | | | | |帅| | |
|
|size=25
|arrow=9, 8, 7, 270
}}
|
示例10 |
{{Xiangqi diagram
|tleft
|示例11
| | | |士|将|士| | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | |炮| | | |
| | |相| | |帅| | |
|
|size=25
|arrow=3, 10, 2.8, 315
}}
|
示例11 |
{{Xiangqi diagram
|tleft
|示例12
| | | |士|将|士| | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | |傌| | | | |
| | | | | | | | |
| | | | | | | | |
| | | | |炮| | | |
| | | | | |帅| | |
|
|size=25
|arrow=4, 6, 2.2, 63.4
}}
|
示例12 |
{{Xiangqi diagram
|tleft
|示例13
| | | |士|将|士| | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | |傌| | | | | |
| | | | | | | | |
| | | | |炮| | | |
| | | | | |帅| | |
|
|size=25
|arrow=3, 7, 2.2, 26.6
}}
|
示例13 |
{{Xiangqi diagram
|tleft
|示例14
| | | |士|将|士| | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | | | | | | |
| | | |仕| | | | |
| | | | | | | | |
| | | | |炮|帅| | |
|
|size=25
|arrow=4, 8, 1.4, 45
}}
|
示例14 |