关于我的blog上flash棋谱(flashgoban)的使用方法

今天在bloggerspaces的论坛上看到有人想要这个棋谱的效果。现在我把它的使用方法公布出来。flashgoban是一个俄罗斯人弄出来的flash打谱软件，它的特点是载入快（不象有的java打谱程序载入要几十秒）；适用性广（不是每台电脑都安装有java虚拟机，但是几乎每台电脑都有flashplayer）。目前中文网站上只有中国围棋网和本站看到，希望大家推广使用。

说了那么多，现在开始了~ flashgoban包含三个文件：flash_goban.js、 sgf_view.swf 、skin.xml（这几个下载即可使用）。js文件有兴趣、有能力的同志可以改改，swf文件就不必改了（反编译flash还不成熟），skin.xml是棋盘样式文件。

首先，在要显示flashgoban的网页中放入js <script language="JavaScript" src="flash_goban.js"></script>

其次，在要出现棋谱的地方放入 <script language="JavaScript"> placeGoban( "sgf1", "", "", "400", "550", "" );</script>

可以看到，上面的代码由六个""组成，

第一个""是固定的sgf1，也就是不能改的；

第二个是棋谱文件的地址，可以是绝对地址（url）也可以是相对地址，如：08.sgf、09.sgf，*.sgf。也可以是棋谱内容，也就是*.sgf中的内容（可以用记事本打开，然后复制到""中） 注意：*.sgf中的内容一般例子为： (;AB[kq][jp][iq][kr][rq][pn] [qp][ro][qo][on][nn][no] [np][op][pp][mp][lp][mq][sp][mr]AW[sr][rr][qq][pq][oq] [nr][ms][ls][lr][lq][kp][ko][lo][mn][mm][nm][pm][ql][qn] [rn][sn][om][nq]C[ 黑先 中级]AP[MultiGo:4.2.1])

看到没有？内容之间有换行，而这用在flashgoban中不能被识别出来，因此必须把换行去掉，如： (;AB[kq][jp][iq][kr][rq][pn][qp][ro][qo][on][nn][no][np][op][pp][mp][lp][mq][sp][mr]AW[sr][rr][qq][pq][oq][nr][ms][ls][lr][lq][kp][ko][lo][mn][mm][nm][pm][ql][qn][rn][sn][om][nq]C[ 黑先 中级]AP[MultiGo:4.2.1])

注意比较两个例子的区别，内容一样，一个有换行一个没有。

第三个""是棋盘样式文件一般为skin.xml。翻阅了俄文原版对skin.xml的解释后，我把skin.xml的内容注解如下：

<skin stonesType="0" 棋子类型0或1
clBoard="#CC9966" 棋盘颜色
isSolid="Solid" 不明
indentScale="1.5" 棋盘相邻两点距离
crdScale="1" 是否显示坐标
crdLeft="1" 坐标1为数字坐标，a为小写字母坐标A为大写字母坐标
crdTop="a" top:顶部left:左边right:右边bottom:底部.
crdRight="1"
crdBottom="a"
showToolbar="1" 是否显示工具栏
hideEaten="1" 是否隐藏吃子数
lastStLbl="lblXSolid" 当前棋子显示方式
lblScale="0.5"
showComments="1" 显示评论
clToolB="#cccccc" 工具栏背景
clLastB="#cccccc" 当前棋子标记颜色（黑）
clLastW="#cccccc" 当前棋子标记颜色（白）
clVarB="#ffffff"
clVarW="#ffffff" 评论标志的颜色
lStL="drwN" 棋盘上标志的区域形状
lStL="drwC"
lStL="drwP"
lStL="drwZ"
markVarB="BSt0"
markVarW="WSt0"
></skin>

在使用的skin.xml中只能象skin.xml，不能含有其他注解之类的文字。不过我建议不用棋盘样式，默认已经够好看了。

第四、五个""分别是宽度、高度，单位是px（象素）。

第六个""是sgf_view.swf所在的文件夹，如果sgf_view.swf 和网页在同一文件夹中则留空，如果不在就要填写地址，如 "http://www.imtho.com/theme/" 注意，后面一定要有“/”。

现在介绍已经完全了，我举个使用例子

<script language="JavaScript"> placeGoban( "sgf1", "(;AP[MultiGo:4.2.1]SZ[19]MULTIGOGM[0];B[pd];W[pp];B[cp];W[dd];B[nq];W[qn];B[pr];W[lq])", "/theme/skin.xml", "400", "550", "/theme/");</script>

效果