Template:Xiangqi diagram/doc

概要

用於展示象棋棋譜,具有標框、標點、標叉、箭頭等功能,可以更快讀懂棋譜想表達的意思。

使用方法

基本參數
第一個參數 對其方式,有center、tleft、tright,預設為tleft。
第二個參數 標題
第三個

第九十二個參數
棋子種類和顏色,以下表為示:

沒有棋子可以填入「_」或者空白鍵。
暗棋可以填寫「rs」或「暗」。
可以用「..」來在特定的位置標點
可以用「XX」來在特定的位置標示叉符號
可以用「[]」來在框出特定的位置

黑方 (dark) 紅方 (light)
將/ (general) gd、将、將 gl、帅、帥
士/ (assistant) ad、士 al、仕
象/ (elephant) ed、象 el、相
車/ (rook) rd、车、車 rl、伡、俥
馬/ (horse) hd、马、馬 hl、㐷、傌
砲/ (cannon) cd、包、砲 cl、炮
卒/ (soldier) sd、卒 sl、兵
第九十三個參數 說明
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

參見

模板结构

编辑注意