Emacs内で囲碁の盤面を表示し、棋譜(SGF形式)を編集します。

Emacs 27.1

init.elに次のコードを追加してください。

(with-eval-after-load "org"
  (require 'igo-org)
  (igo-org-setup))

また、HTMLとしてエクスポートしたときに盤面を表示したい場合は後述の設定も追加してください。

org文書内にigo特殊ブロックを挿入します。(操作例: C-c C-, SPC i g o RET)

#+begin_igo
#+end_igo

ブロックの中に (;SZ[9]) と入力すると9路盤が表示されます。またはブロック内で C-c i を押すと盤面サイズを指定して初期化できるようになっています。

後は適当に石を置いたり、フリー編集モードで初期盤面を設定したり、コメントを設定したりすると、その操作毎にバッファのテキストが書き換わります。

#+begin_igo の後にブロック毎のオプションを指定できます。

例えば次のようにするとブロックが盤面化されたとき(orgファイルを開いたとき等)に最初から手順番号が表示されます。

#+begin_igo :move-number t
(;FF[4]GM[1]SZ[9];B[fd];W[df];B[ff];W[dd])
#+end_igo

有効なオプションには次のものがあります。

orgファイル内に #+IGO_BLOCK_DEFAULTS: を記述することで、ファイル内でのオプションのデフォルト値を設定できます。(注意:現在の所、変更時はファイルを開き直す必要があります)

例:

#+IGO_BLOCK_DEFAULTS: :grid-interval 24 :move-number t

:path オプションは最初に表示する盤面(ゲーム木のノード)を指定します。

パス(盤面へたどり着く経路)は次の要素を並べたもので、最初の盤面(ルート)から各要素が指定する盤面を順番にたどり最終的に到達した盤面が選択されます。

例:

• 0 : 最初の盤面
• 12 : 最初から12手目の盤面
• cd : 最初に3の4に着手する盤面
• cc/fc : 最初に左上三々(cc)に着手した後、次に最初に二間開き(fc)した盤面
• cc/2 : 最初に着手した後の2手目
• A/B/A : 分岐をA、B、Aの順に選択した盤面
• _ : 最初の分岐(無ければ最後の盤面)
• _/-1 : 最初の分岐(無ければ最後の盤面)の一つ前

init.elに次のコードを追加してください。

(autoload 'igo-sgf-mode "igo-sgf-mode")
(add-to-list 'auto-mode-alist '("\\.sgf$" . igo-sgf-mode))

sgfファイルを開くと自動的に盤面が表示されます。

注意: sgfファイルはオセロ、チェス、バックギャモンなど囲碁以外のゲームの棋譜も表現できます。あなたがそれらを扱う場合は、GMプロパティが1以外のときにigo-sgf-modeを起動しないようにする必要があります(未実装)。

任意のSGFテキストをリージョンで囲った上で M-x igo-edit-region を実行すると、その範囲がエディタ化されます。

igo-sgf-mode.el も igo-org.el も igo-editor.el を使って実装されています。igo-sgf-mode.elはバッファ全体を、igo-org.elはbegin_igo～end_igoの間を自動的にエディタ化します。

エディタは大きく分けて次のようなモードを持っています。

• テキストモード
  • 固定モード(エラーが無くなってもテキストのまま)
  • 自動回復モード(エラーが無くなったときに自動的にグラフィカルモードに移行する)

各モードで使えるキー操作は次の通りです。

(現在の所、一番最初の盤面でのみ使用できます)

前の手に戻って別の場所に打つと自動的に分岐が作られます。エディタは全ての分岐をツリー構造で記録しています。

分岐は分岐直前の盤面でAから始まるアルファベットで表示されます。

分岐箇所を示すアルファベットを「左クリック」すると、その分岐に進みます。

「次へ進む」ボタンは最後に選んだ分岐へ進みますが、もしまだ選択していない場合は明示的に指定する必要があります。

分岐を削除したい場合や分岐の(アルファベットの)順番を変更したい場合は、アルファベットを 「右クリック」 してください。分岐に対する操作がポップアップメニューで表示されます。

org-mode文書中に棋譜を埋め込んだのならエクスポート後の文書にも盤面が表示されて欲しいと思うことでしょう。ここではHTMLでのエクスポート時に盤面を出力する方法について説明します。

標準のHTMLバックエンドは特殊ブロックをdivタグで囲んだ形で出力します。 #+begin_igo ～ #+end_igo も特殊ブロックなので、HTMLで出力すると <div class="igo"><p> SGFテキスト </p></div> の形で出力されます。

盤面の形で表示させたい場合は、ページ読み込み完了時にJavaScriptで一括変換すると良いでしょう。

例えば拙作のJavaScript碁盤を使用するならば misohena/js_igo: JavaScript Go Game Board より igo.js, igo_view.js, igo.css をダウンロードした上で、次のようにします。

#+HTML_HEAD: <script src="igo.js"></script>
#+HTML_HEAD: <script src="igo_view.js"></script>
#+HTML_HEAD: <link rel="stylesheet" href="igo.css" />
#+HTML_HEAD: <script>window.addEventListener("load", ev=>{ for(elem of document.querySelectorAll("div.igo")){ let sgf = elem.textContent; while(elem.hasChildNodes()){elem.removeChild(elem.firstChild);} new igo.GameView(elem, sgf, {"showBranchText": true, "showLastMoveMark": true, "showComment": true, "path":1000}); }});</script>

お互いに二連星したところ。

#+begin_igo
(;FF[4]GM[1]SZ[9];B[fd];W[df];B[ff];W[dd])
#+end_igo

igo特殊ブロックの出力(変換結果)自体を変える方法もあります。

igo特殊ブロックの出力を変えるためにはorg-modeのエクスポータをカスタマイズしなければなりませんが、その方法として次の三つを用意しました。

• 既存のHTMLバックエンドを修正する
• HTMLバックエンドから派生した新しいバックエンドを定義する
• バッファローカル変数を書き替える

最も使い勝手の良い方法は既存のHTMLバックエンドを修正することです。一度設定してしまえばファイル毎に設定する必要はありませんし、普段通りの操作でエクスポートできます。

次のコードを init.el に追加してください。

(with-eval-after-load "ox-html"
  (require 'igo-org-export-html)
  (igo-org-modify-html-backend))

すると org-mode のHTMLバックエンドが読み込まれた直後にそれを書き替えてigo特殊ブロック( #+begin_igo ～ #+end_igo 部分)を特別に処理するようにします。

デフォルトは拙作のJavaScript碁盤を使うHTMLを出力するので、 misohena/js_igo: JavaScript Go Game Board より igo.js, igo_view.js, igo.css をダウンロードしてhtmlと同じ場所に配置してください。

あとは通常通りHTMLとしてエクスポートするだけです。

何らかの理由でHTMLバックエンドを直接修正して欲しくない場合、新しく専用のバックエンドを定義することも出来ます。

次のコードを実行すると igo-html という名前のバックエンドが登録されます。

(require 'igo-org-export-html)
(igo-org-define-html-backend t)

igo-org-define-html-backend の引数に t を指定するとメニューに項目を追加します。

C-c C-e でエクスポートのメニューを出した後、 g を押すことでこのバックエンドを指定できます。

バックエンドをカスタマイズしなくても、ファイルごとにバッファローカル変数を設定することで変換処理を変更できます。

この方法を使うには、org-mode文書の中に次のコードを追加してください。

#+begin_src emacs-lisp :exports results :results none
(require 'igo-org-export-html)
(igo-org-set-html-filters-local)
#+end_src

:exports results を指定することでエクスポートのたびにソースブロックを評価させ、 :results none を指定することで結果の出力を抑制しています。

後は通常通りHTMLとしてエクスポートしてください。

org-modeのデフォルト設定ではエクスポートするたびにソースブロックを評価するか聞いてくるので yes を入力してください。

するとバッファローカル変数に変換フィルタが設定され、igo特殊ブロックが特別に変換されます。

igo-org-export-html.el を使用して変換する場合、次のオプションが使用できます。

#+IGO_ENABLE: nil を指定するとファイル内で一切の変換を抑制できます。

#+IGO_DISPLAY: には次のいずれかを指定できます。

また、表示方法はブロック毎に #+begin_igo :display <display-type> の形でも指定できます。

例:

#+IGO_JS_PATH: ./js_igo/
#+IGO_DISPLAY: svg

#+begin_igo :move-number t :path A/A/B
....省略(SVGで表示)....
#+end_igo

#+begin_igo :read-only t :move-number t :path 5 :display js
....省略(js_igoで表示)....
#+end_igo

表示方法によってはテンプレート文字列を指定できます。

オプションの <header-template> の部分は、HTMLのHEAD要素内に挿入するテキストの雛形です。表示方法が js であるブロックが存在する場合、 #+IGO_JS_TEMPLATE: オプションで指定した雛形が使われます。また、表示方法が custom であるブロックが存在する場合、 #+IGO_HEADER_TEMPLATE: オプションで指定した雛形も使われます。

<header-template> の中では次の記法が使用できます。

オプションの <block-template> の部分は、igo特殊ブロックの中に挿入するテキストの雛形です。表示方法が lazy-js のブロックには #+IGO_LAZY_JS_TEMPLATE: オプションで指定した雛形が使われます。また、表示方法が custom であるブロックには #+IGO_BLOCK_TEMPLATE: オプションで指定した雛形が使われます。

<header-template> の中では次の記法が使用できます。

また、%の後に次のいずれかを指定することでテキスト内の一部の文字をエスケープできます。

つまり、HTMLの属性の中に記述するときは%ATTR_を、HTMLの内容部分に記述するときは%HTML_を、JavaScriptの文字列リテラル内に記述するときは%LITERAL_を使用してください。例えばSGFをJavaScriptの文字列にして解析したい場合、 parseSGF("%LITERAL_SGF%") のように記述します。