GoPlugins is a set of plugins which are useful to go-players. If you don't know what go (aka baduk, weichi) is, check out the Wikipedia article.

They have been tested on JSPWiki 2.8.x series, though they should also work on 2.6. They are currently in use at the Finnish go-wiki at http://www.suomigo.net.

Installation#

Currently you need to check out the source code from the SVN repository, and then build it with "ant zip". Unzip the resulting file into your main JSPWiki directory.

Contact#

If you have suggestions or questions, please email Janne Jalkanen.

GoDiagram#

GoDiagram allows you to embed a go diagram on your wiki page as a set of images, and enhance it with some custom syntax. The GoWrite program allows you to directly cut-n-paste a diagram from an SGF editor in this format.

Parameters#

label

Label for the diagram.

first

If you have numbered moves, who plays the first move? Options: "white" or "black".

The body of the plugin then creates the board. Following markers can be used in the body:

• "X" marks black stones
• "O" marks white stones
• "." marks empty intersection.
• "," is hoshi (star) point
• "Xt" black stone marked with a triangle
• "Ot" white stone marked with a triangle (duh)
• "1", "2", "3", ..., "99" Numbered move
• "a", "b", "c", ... "z" A point with a letter

Example#

[{GoDiagram  
label='Some label here'
first='white'

| . . . .
| 1 . 2 .
| . X . .
| . . . .
+--------
}]

Sgf#

Most go games are stored online in the so-called Smart Game Format. Thanks to the Eidogo Javascript player, you can also embed a game directly in a wikipage.

Parameters#

src

The address of the SGF file to embed. May be either a fully fledged URL (http://..), or the name of an attachment. Note that due to Javascript security rules, it is not possible to use an URL pointing to another site than where the wiki is..

align

Where the diagram should be put with respect to the flow of the text. Possible values are "right", "left", or "none" (for no flow).

Example#

[{Sgf src='ProGames/13cwf2.sgf' align=left}]

GoRankAggregator#

This plugin allows you to distribute go player ranking lists on multiple pages, and then aggregate them together on a single page. To see this in action, check out the up-to-date Finnish go rankings at http://www.suomigo.net/wiki/Luokituslista.

Parameters#

pages

A comma-separated list of pages from which the ranks are aggregated. See below for the accepted format.

egfurl

If defined, fetches the EGF GOR data from this URL, and displays the GOR data alongside with the ranking. (For the uninitiated: GOR is just like ELO in chess and is sort of used to determine who's best.)

kgsurl

If a player has defined a KGS nick, this URL is used to link to his game records. Any occurrence of the string "%n" is substituted with the KGS nick.

The accepted player format is as follows.

The list is separated from the rest of the page by a horizontal ruler ----. Each player is represented by a line in the following format:

<Last name>, <First name>, <strength> [, server:nick] [,server:nick]...

You may assign a club to the player by using the magic line "Club:" before a set of players. It is recommended that the list is encapsulated in a preformatted block (with the three braces) so that it is more readable.

Example#

The list found at http://www.suomigo.net/wiki/Luokituslista is generated with the following statement:

%%luokituslista
%%zebra-table
%%sortable
[{GoRankAggregator pages='HelsinginLuokitukset,PogonLuokitukset,OulunLuokitukset,TurunLuokitukset,YligonLuokitukset,BoshinLuokitukset,TengeninLuokitukset,TampereenLuokitukset,KetunKonLuokitukset,LappeenrannanLuokitukset,GotekinLuokitukset,DangonLuokitukset,MuutLuokitukset' 
egfurl='http://gemma.ujf.cas.cz/~cieply/GO/allfi.html'
kgsurl='http://www.gokgs.com/gameArchives.jsp?user=%n'
}]
%%
%%
%%

The pages themselves might look like this:

This is a page from which rankings are made.  This text is ignored until the first horizontal line.

----

{{{
Club: Unknown
Grönholm, Alex, 4k
Salojärvi, Marko, 4k
Kaskinen, Kimmo, 4k
Moilanen, Pessi, 6k
Uusitupa , Ville , 7K , kgs:vma
Schildt, Henri, 8k
Virolainen, Santtu, 10k, kgs:santtu
Koistinen, Olli, 10k, kgs:sokk
Järvinen , Rauno , 11k
Salojärvi, Tuomas, 11k
Ahtiainen, Jukka, 12k
Luovula, Thomas, 20k

Club: Animefin GO Club
Roine, Toni, 13k, kgs:tchan

Club: Hyrynsalmi
Karjalainen, Perttu, 16 kyu, kgs: norsupossu

Club: Iisalmi
Huttunen, Valtteri, 4k

Results#

The results plugin visualizes the results of a go tournament. Just surround the results from the MacMahon tournament software (or any other compatible one) with the plugin and enjoy a nicely formatted table with Javascript visualization.

[{Results

Pl. Name                 Str Cl. MMS   1    2    3    4    5    6    7   Pt  SOS  SOSOS  
  1 Perkkiö, Ari-Pekka    1d Hel  7   10+   5+   6+   2-   6+   8+   7+  6    35    248½ 
  2 Holappa, Antti        3d PoG  6    3+   8+   9+   1+   7-  11+   4-  5    37    234  
  3 Siukola, Mikko        4d Yli  6    2-  13+  12+   6+   5+   7-  11+  5    33    234  
  4 Urtela, Mika          4d Yli  6    9-  10-  19+  16+  14+   5+   2+  5    28½   206  
  5 Paatero, Lauri        4d Hel  5   13+   1-  10+   8+   3-   4-   9+  4    36    226  
  6 Rovio, Teemu          2d Kan  5   11+  12+   1-   3-   1-  14+  10+  4    36    224  
  7 Nikula, Miika         3d Yli  5    8-  16+  11+   9-   2+   3+   1-  4    35½   225  
  8 Siivola, Matti        5d Hel  5    7+   2-  15+   5-   9+   1-  12+  4    35    233½ 
  9 Hella, Tuomas         2d PoG  4    4+  14+   2-   7+   8-  12-   5-  3    35    228  
 10 Lajunen, Pekka        3d Hel  4    1-   4+   5-  20+  11-  13+   6-  3    33    214  
 11 Nikula, Janne         2d Yli  4    6-  18+   7-  15+  10+   2-   3-  3    32    221½ 
 12 Hella, Olli           2d Yli  4   15+   6-   3-  14-  17+   9+   8-  3    31    207½ 
 13 Leppänen, Suvi        1d Kan  4    5-   3-  16-  19+  15+  10-  18+  3    26½   189  
 14 Karttunen, Reino      1k PoG  4   20+   9-  18+  12+   4-   6-  19+  4    25    195½ 
 15 Virtanen, Jaakko      2d Hay  4   12-  17+   8-  11-  13-  18+  20+  3    24    187  
 16 Piiroinen, Annika     1k Yli  3½  17+   7-  13+   4-  --   --   --   2    18    110  
 17 Ylönen, Joonas        2k Yli  3   16-  15-  20-  18+  12-  19+ free  3    19½   157½ 
 18 Arlander, Markus      2k Hel  2   19+  11-  14-  17-  20+  15-  13-  2    23    169  
 19 Pulkkinen, Olli       2k Yli  2   18-  20+   4-  13- free  17-  14-  2    22    164½ 
 20 Valkonen, Jouni       1k Hay  2   14-  19-  17+  10-  18- free  15-  2    20    166½ 
}]