nDiki : BracketName

bracket で囲まれた名前。

bracket で囲まれた

 [[pagename]]

という文字列。

多くの(特に国産の)WikiEngineで、WikiPage への参照として解釈される。

WikiName 形式では日本語ページ名を表現できない。 日本語の PageName のページへのリンクを表すには、通常何らかのマークアップが必要であり BracketName はその一つの形式である。

また、多くのWikiEngine では BracketName で囲まれた文字列の形式(# で始まる、: を含む等)に応じた拡張機能を提供している。

WiKicker WRI URI 識別子 CafeWiki 検索 WikiForum URN URL ISBN 実装 AutomaticLink NaneyOrgWiki WRN trie 自動リンク RWRN YukiWiki CGI InterWiki hns RFC Wiki Amazon.co.jp W3CDTF PATH_INFO キャッシュ Naney 日記 AsWiki

■ [ WiKicker ] wikiの編集機能を学習

NaneyOrgWiki を掲示板的に使っていたユーザの一人が、「編集」できる事に気がつきつつある様子。 不適切な(気にいらない)コメントを削除とかしているみたい。 そのページのコミュニティが成長しつつあるのかもしれない。ページ新規作成機能等や BracketName まで使いこなせるまで行くのか?

• [ WiKicker ] WiKicker へ脚注機能追加 (2004-02-10)
• [ WiKicker ] 続L10N改善と、ページ名リスト処理の高速化 (2004-05-29)
• DiKicker の出力する HTML コードを小さく (2006-10-05)
• [ WiKicker ] 久しぶりにメンテナンス (2004-04-02)
• [ WiKicker ] 古くても検索キャッシュを返す (2004-01-20)

■ [ WiKicker ] 自動InterWiki

一昨日実装した、 複数のキーワード集合による、AutomaticLinkモジュールを WiKicker CGI プログラムから使えるようにしてみた。

ローカルにおいておいたキーワードリストファイルを読み込み AutomaticLink 処理(WikiForum 内で AutomaticLink でマッチしていない部分文字列に対して)。 マッチした場合は InterWiki を使ってURIに変換しリンク化する。

あわせてIndexPage.txtでWiKicker WikiForum 内の PageName を取得できるようにした。

これで例えば、2つの WiKicker WikiForum が cron で互いの IndexPage.txt を定期的に取得し、AutomaticLink するようにすれば、相補的に連携する事ができるようになる(ただし AutomaticLink のみ。WikiName や BracketName は依然としてその WikiForum 内のみ)。

AutomaticLink でのリンク先は(指定した)任意の InterWiki で定義できるので、あるキーワード集合について Google の検索結果ページや「はてなダイアリーキーワード」への自動リンクも実現可能(はてなダイアリーキーワード自動リンクAPIはキーワードリストではなく正規表現を返してくるので、元に戻す必要有り。またあれだけ巨大なキーワードリストだと毎回 AutomaticLink のために、trie 再生成するのも辛いのでもう一工夫必要)。

• [ WiKicker ] 複数のキーワード集合による、AutomaticLink (2004-02-07)
• [ WiKicker ] 「最近のアクセスログ」処理思案 (2004-01-17)
• [ WiKicker ] WiKicker へ脚注機能追加 (2004-02-10)
• ケータイ用にプライベート Wiki を設置 (2008-01-07)
• WiKicker / DiKicker の AutomaticLink 長... (2007-03-01)

■ [ WiKicker ] WiKicker へ脚注機能追加

WiKicker スタイルで日記を記述するにあたり欠けている機能として「脚注」がある。 Wiki としては必須でないので WiKicker には導入していないのだが、日記としては無いと困る。 脚注が使えると文を書く時に正直手を抜ける。 また hns 上の旧記事をコンバートする時にも無いといろいろ面倒だし。

ということで実装。

@ インラインブロック

さてどうしたものか。 WiKicker の WRI (BracketName 等を含む識別子)としての実装なら、parser の変更もなく新しいWRI scheme の追加と対応するクラスを書くだけですむ。 しかし WRI は終端記号なので、そうすると脚注の中でWRIを使えなくなる。 それは困る。

ということで、やはり非終端記号が必要。 悩んだあげく、

 {{scheme: ... }}

という「インラインブロック非終端記号」を導入。 {{..}} というのは確かいくつかの WikiEngine でプラグイン呼び出しで使っている記法だったような。

• 一般的な文章中には現れず、
• かといって文章中に混ぜてもそれほど違和感なく(wiki ではこれが重要)
• これ以上文法を追加したくないので、今後機能追加の際に利用できるように scheme 指定できる

といった点から、このようにしてみた。 2番目の点で合格点の出せる記法かどうかは微妙だが、まぁ許せる範囲かな。

{{ }} は、1行中に現れる必要有り。 「...」は scheme specific part だが、今のところ scheme によらず、InlineParser で解析されて部分木になるため、WRI とか ... とかも書ける。 InlineParser では正規表現を使っていて括弧の数は数えないので、今のところ {{ }} の中に {{ }} は書けないが、まぁ問題ないでしょう。

@ 脚注記法

で脚注は、

 {{fn: ...}}

となる。 普通。

@ 実装

• InlineParser の拡張
• InlineBlockNode クラスの追加
• 各 Visitor に visit_InlineBlockNode を追加。
• HtmlFragmentVisitor に fn: の処理を追加。

いざ実装してみると、ちょこっとのコードで実現。 脚注番号の降り方とか、今後改良する点はあるけど、大枠は完成。

• Wikiの文法の標準化 (2004-02-10)
• [ WiKicker ] hell mode - HTMLタグ付けブロックの導入 (2005-09-13)
• 私的10大ニュース2004 [ web ] (2004-12-31)
• [ WiKicker ] 複数のキーワード集合による、AutomaticLink (2004-02-07)
• [ WiKicker ] 書き込みをパターンでチェック (2004-12-13)