[Welcome to Sensei's Library!]

StartingPoints
ReferenceSection
About


Paths
UsingAndContribut...

Referenced by
FrontPage
HowToUseWiki
WikiNews
TextFormattingRules
FrontPageDraft
WinmgtToSlfConverter
SGFFile
test

 

How Diagrams Work
Path: UsingAndContributingToSenseisLibrary   · Prev: AboutPageHeaders   · Next: HowPathsWork
    Keywords: SL description

Basics

[Diagram]
Diag.: A taisha variation

Diagrams make discussing Go much easier. Don't worry, they are quite easy to use. You may want to click on [Edit page] to the left in order to see the way diagrams work.

Diagrams are automatically made available as SGF files - clicking on their graphic will start a download for you.

All diagram lines start with two dollar signs "$$ ".

The first line is the title line - use a short descriptive title.

The diagram itself looks just like you are used from newsgroups or email discussions:

  • a dot "." is an empty intersection, an "O" is a white stone, and an "X" is a black stone.
  • a hoshi (star-point) can be inserted by using a comma "," instead of a dot.
  • the edge can be marked with one of "|", "+", or "-"

[Diagram]
Diag.: some simple markup

You can also include markup:

  • to mark with a square:
    • square on white stone: "@"
    • square on black stone: "#"
    • square on empty intersection: "S"
  • to mark with a circle:
    • circle on white stone: "W"
    • circle on black stone: "B"
    • circle on empty intersection: "C"
  • you can use letters on empty intersections by using the lowercase characters a-z.

Moves

You can use numbers 1-9 and 0 on stones ('0' is used for '10'). By default "1" is a black stone with the color alternating (i.e. 2 is white, 3 is black, 4 is white ....) You can change that behaviour by using "$$W" in the title line: "1" is then a white stone.

[Diagram]
Diag.: Diagram starting with '$$B'

[Diagram]
Diag.: Diagram starting with '$$W'


Coordinates and board size

You can add coordinates to the board as well. In the first line of a diagram add 'c' for coordinate after the color tag (B/W). For example, "$$Bc diagram title".

[Diagram]
Diag.: Taisha variation with coordinates


By adding a size indicator, you can influence the coordinates on the board. Note: this also influences the size of the board in the generated SGF file.

You don't have to specify the size, if the diagram shows the full board (i.e. including all 4 edges, the size is calculated automatically then).

[Diagram]
Diag.: Taisha variation on 13x13

Example. Note, how the top left is now A13, instead of A19.


Summary of title line

The first line of a diagram is the title line. It has the format of

 $$Xczz title

where

  • X is either 'B' or 'W', depending who is to play first
  • c is used if the diagram should contain coordinates
  • zz is the board size, e.g. 9, 13, or 19.
  • title is the title of the diagram as shown on the page

The first three parts are optional, but have to appear in that order - without any space in between.


If you are in edit-mode and scroll down the window you will see that we have put two diagrams there for you to copy & paste. Also, there's a quick help included as well. Any questions left?


Discussion

AvatarDJFlux Yes, please. How do you number the diagrams in their titles? So that it reads: Diag. 1: Title of diagram

ArnoHollosi: Is there a need for such a feature? Won't renumbering diagrams be painful, when you add/move diagrams?

unkx80: Numbering of diagrams does pose quite a lot of problems when inserting/deleting diagrams, such as the mess in BigQuestionMarkProblem8 before WikiMasterEditing. As such, there was consensus that we don't want to number diagrams. That's why I have stripped all the diagram numbers when I WikiMasterEdited that page.

AvatarDJFlux Thx mates, there's some sense in what you say... ;-)
Sorry for making silly remarks!


HolIgor has made a utility which formats a text diagram such as given by WinMGT to a format suitable for copy-and-pasting into SL.

More details on WinMGTtoSLFconverter.



Path: UsingAndContributingToSenseisLibrary   · Prev: AboutPageHeaders   · Next: HowPathsWork
This is a copy of the living page "How Diagrams Work" at Sensei's Library.
(C) the Authors, published under the OpenContent License V1.0.