ГоБиблиотека: Диаграммы

Как оформлять диаграммы



[Diagram]
A taisha variation
Диаграммы делают обсуждение Го проще. Не беспокойтесь! Они достаточно просты для использования.

SGF файлы генерируются автоматически по описаниям диаграмм. Щелкнув по диаграмме можно скачать соответствующий SGF файл. Вы можете захотеть прогнать некоторые диаграммы с помощью вашего любимого SGF редактора?.

Вместе с чтением этой инструкции для вас будет полезным выбирать время от времени ссылку «Правка», чтобы посмотреть как эти диаграммы были сделаны.

Важно: Обратите внимание на то, что синтаксис описания диаграмм хоть и очень похож на таковой в Senseis Library, но несколько отличается от него.


Основы

$$ A taisha variation
$$  ------------------
$$ | . . . . . . . . .
$$ | . . . . . . . . .
$$ | . . 7 3 X d . . .
$$ | . . O 1 O 6 . . .
$$ | . . 4 2 5 c . . .
$$ | . . 8 X a . . . .
$$ | . . . b . . . . .
$$ | . . . . . . . . .
$$ | . . . . . . . . .
Диаграммы обрамляются в двойные проценты ("%%"). Все строки начинаются с двух знаков доллара ("$$"), перед которыми не должны находиться пробелы.

Заголовок диаграммы указывается в первой строке, отделенным от знаков доллара пробелом (" ").

Остальные строки описывают доску. Используемый синтакс похож на таковой в новостных группах и электронной почте:
  • Точка (".") — пустое пересечение.
  • “X” — черный камень, а “O” — белый.
  • Запятая (",") — хоси (звездный пункт).
  • Края обозначаются с помощью "|", "+" и “-".

Чтобы вставить «разрыв» до конца диаграммы, необходимо после нее или поясняющего текста вставить 4 знака процента ("%%%%"). Это позволит избежать «сюрпризов» в виде висящих или накладывающихся диаграмм.

Ходы


Вы можете изобразить последовательность ходов цифрами 1-9 и 0 (0 представляет ход с номером 10), а также буквами A-J (ходы с номерами от 11 до 20).

По умолчанию ход 1 и все ходы с нечетными номерами принадлежат черным, а с четными — белым. Вы можете сменить это, указав “W” после знаков доллара в первой строчке: "$$W”. Использование “B” явно задает поведение по умолчанию, когда черные ходят первыми. Строка, начинающаяся с "$$B” означает «Ход черных».

[Diagram]
Ход черных
[Diagram]
Ход белых





[Diagram]
Ко (5 в 1, 8 в 2)
Если два хода сделаны в одну точку поместите второй ход в заголовок диаграммы в виде «a в b» (например, «5 в 1" ). Это позволит включить ход в генерируемый SGF файл.


Метки


[Diagram]
Метки на доске



Диаграммы могут содержать метки:
  • "*" — круг на пустом пересечении.
  • “K” — круг на черном камне.
  • “W” — круг на белом камне.
  • “S” — квадрат на пустом пересечении.
  • "#" — квадрат на черном камне.
  • "@" — квадрат на белом камне.
  • Любая строчная буква помечает собой пустое пересечение.

Координатные метки и размер доски


[Diagram]
Nadare joseki
Вы можете потребовать отобоажения координат на диаграмме, указав “c” после знаков доллара в первой строчке: "$$c”. “c” должно следовать за индикатором цвета ("B” или “W”), если таковой присутствует: "$$Bc”.

Диаграмма должна отображать как минимум два перпендикулярных края доски для отображения координатных меток.



[Diagram]
Nadare joseki on a small board
Если диаграмма показывает доску целиком (т.е. отображаются все четыре ее края), то ее размеры будут вычислены автоматически. Вы можете указать размер при отображении участка доски, указав его после знаков доллара в первой строке: "$$13". Размер должен следовать после индикатора цвета и “c”, если таковые присутствуют: "$$B13", "$$c13" или "$$Bc13". Без указания точного размера участка доски считается, что доска имеет размеры 19x19.

Заметьте, что координатные маркеры слева на примере диаграммы растут до 13 вместо 19.


Ссылки в диаграммах


Синтаксис:
$$ [ СимволМетки | ИмяСтраницы ]

Просто добавьте строки подобные приведенной выше в конец диаграммы для создания ссылки между помеченным камнем/точкой и страницей.
  • СимволМетки — символ используемый на доске для пометки.
  • ИмяСтраницы — любое Вики Имя, внешняя ссылка или локальная метка (якорь).

Примеры:

Следующая диаграмма содержит три примера. Это результат кода приведенного справа.

[Diagram]
Ссылки в диаграммах — примеры
$$ Ссылки в диаграммах -- примеры
$$  --------------
$$ | . . . . . . .
$$ | . * . . . . .
$$ | . . . 1 6 . .
$$ | . . 5 4 . . .
$$ | . . 3 2 . . .
$$ | . . a . . * .
$$ | . . . . . . .
$$ [2|NadareJoseki]
$$ [a|http://gtl.jeudego.org/members/info?p_key=349]
$$ [*|#1]

Здесь присутствуют следующие ссылки:
  • ссылается на страницу с названием Nadare Joseki?.
  • a ссылается на внешнюю страницу.
  • все  ссылаются на сноску (якорь с именем "#1").

Работает с любыми видами меток или помеченных камней. Не работает с обычными камнями или пустой доской.

Камни в тексте


В тексте вы можете ссылаться на камни следующим образом:

%%B1%%, %%W2%% ... %%W0%%, %%BA%%, %%BB%% ... %%BJ%%, %%BZ%%, %%BS%%, %%B%%, %%WZ%%, %%WS%%, %%W%%, %%ES%%, %%EZ%%

В результате получим:

, ... , , ... , , , , , , , ,

Обсуждение


Так как диаграммы здесь являются плавающими объектами, то не забудьте после них (или поясняющего текства) добавить %%%% во избежание побочных эффектов (Обратите внимание на исходный текст данной страницы).
В режиме редактирования вы можете наблюдать несколько шаблонов, которые можно скопировать (щелчек мышью на соответствующей картинке) и вставить в текст. Остались ли еще какие-нибудь вопросы?



[1] – Это сноска, на которую есть ссылка в приведенном выше примере диаграммы [#2].