Edit and display Go diagrams (boards) in DokuWiki
Table of Contents
Go Diagram Plugin
Compatible with DokuWiki
2005-05-05+
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
Similar to chessdiagram, weiqi
This plugin allows to create board setting diagrams for the Asian game Go. The board is displayed as image and can be downloaded in SGF format. Hyperlinks can be added to single stones of the board.
Download and Installation
Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
This plugin needs PHP with libGD and Freetype support.
Changes
- Version upped (2016-07-06 20:43)
- Version upped (2016-02-03 18:16)
- Merge pull request #2 from splitbrain-forks/php7-signature (2016-02-02 16:25)
- Adjust method signatures to match parent (2016-02-02 16:05)
- Version upped (2016-01-24 14:11)
- Version upped (2014-05-21 19:41)
- Merge pull request #1 from araname/patch-1 (2014-01-23 15:31)
- Add Korean translation (2013-12-18 08:09)
Usage and Syntax
The plugin is a more or less direct port of the Go diagrams extension for MediaWiki, so the same syntax applies1).
The syntax has to be placed between <go></go> tags. The first line then starts with $$ and some optional switches, followed by a description of the board.
The following switches can be used after the $$ preamble.
B | black player makes move 1 (default) |
W | white player makes move 1 |
b | insert a break after the image; The following text will appear below the image. |
c | draw coordinate markers |
l | float left |
r | float right (default) |
1–40 | specify board size (default is 19). Useful for sizes above 19 and as a hint to SGF. |
The following lines then define the board with each line representing one row on the board. You can use these symbols:
| | vertical border |
- | horizontal border |
. | unoccupied point |
, | hoshi point |
X | black |
O | white |
B | black circled |
W | white circled |
# | black with square |
@ | white with square |
C | circled point |
S | point with square |
0-9 | numbered moves (0=10); black is first by default |
a-z | marked points |
_ | empty space (useful as separator and for other effects) |
After the board layout, hyperlinks can be added to marked stones using square brackets like this:
[a|WikiPageAboutMarkedPointA] [3|WikiPageAboutMarkedStone3] [C|http://link.to.example.com/circled-point.html]
Adding “X at Y” hints to the SGF generator in the title, e.g. “A mysterious disappearance (9 at 3)” will create an SGF with moves 3 and 9 on the same spot.
Simple Example
<go> $$c A simple example with extra spacing ------------------- | . . . . . . . . . | | . . . . . . . . . | | . . , . 2 . , . . | | . . . . . . . . . | | . . . . 1 . . . . | | . . . . . . . . . | | . . , . . . , . . | | . . . . . . . . . | | . . . . . . . . . | ------------------- </go>
Complex Example
<go> $$ A complicated example with marks, numbers, hyperlinks, border just on one side |..1.__.2. |..a.__.b. |..W.__.@. |..B.__.#. |..C.__.S. [2|wikipage] [a|http://example.com] [S|wiki:page2] [@|wikipage3] </go>
Limitations
- No interwiki, mail or windows share links are supported for hyperlinks
- Generated images and SGF files are not protected by ACL, everyone who knows the URL to the image can download it
1)
Exception: different styles are not supported