■ [Hiki][tDiary]プラグインに埋め込まれた表示文字列の言語を選択可能に

昨日の話をちょっと考えてみたのだが、以下のような案はどうだろう。

実は、この考え方自体はtDiary本体が採用しているので新しくはないのだが、プラグインには使われていないので、これを機会にtDiaryプラグインでもこのルールが適用されれば良いなとはちょっと思う...が自分で作ったプラグインを適用させるのはちょっとめんどくさいか(^^;)。

＃すでに切り出されているプラグインがあるとのこと。知らんかった＜アホ

■ 試しに、Hiki-0.5系添付のreferer.rbのshow_refererというメソッドを例に考えてみる。

def show_referer(db)
  s = '<div class="referer">このページへのリンク元<ul>'
 
  referers(db).each do |ref|
    disp = replace_url(ref[0].unescape).escapeHTML
     s << %!<li>#{ref[1]} <a href="#{ref[0]}">#{disp}</a>!
  end
 
  s << '</ul></div>'
end

■ で、これだと思いっきり日本語が埋め込まれてしまっているので英語サイトでは使えない。

■ そこで、表示文字列のみを別メソッドに括りだすというプラグインコーディング上のルールを作る。

def show_referer_label
  'このページへのリンク元'
end
 
def show_referer(db)
  s = '<div class="referer">#{show_referer_label}<ul>'
 
  referers(db).each do |ref|
    disp = replace_url(ref[0].unescape).escapeHTML
     s << %!<li>#{ref[1]} <a href="#{ref[0]}">#{disp}</a>!
  end
 
  s << '</ul></div>'
end

■ 英語で使いたい人は、以下のようなプラグインを別途用意する。例えば、referer_en.rbとでもしてpluginディレクトリに置けば、表示時にはこちらが使われることになる。

def show_referer_label
  'Referrer'
end

■ このreferer_en.rbをプラグイン提供者が用意するのがベストだが、少なくともこの仕組みに準じるように作っておけば、ユーザ自身が作ることもできなくはない。 きたさんの指摘のような場合は仕掛けだけ仕込んで、あとはユーザに任せてしまえば良い...とすればプラグイン作者も少しは気が楽になる...かな。

幸い、このような文字列は１つのプラグインにそれほど数があるモノでもないので対応するのはそれほど大変ではないだろう。

それに、バージョンアップの度にプラグイン自体を書き換えたりする必要がないのは非常に助かる。もちろん、バージョンアップの際に元になる文字列の意味が変更されたり、表示項目が増えたりしたら対応しないといけないけど、それはまぁしょうがないと。

■ ただ、この案で難しいのがRuby-GNOME2のように、１つのHikiで英語・日本語のサイトを運用している場合だ。

そのような場合、上記の仕組みだけだと全部英語（あるいは日本語）になってしまう。

そこで、Hikiを拡張して、plugin/*.rbを読み込む直後に、plugin/#{$lang}/*.rbも一緒に読み込むようにする。$langのディレクトリが存在しない場合は読み込まない。

■ こうしておけば、上記例のreferer_en.rbは、plugin/en/referer.rbとでもしておけば良い。

■ まとめると、

1. Hiki本体としては、plugin/*.rbを読み込んだ直後にplugin/#{$lang}/*.rbを読み込むような仕掛けを用意する。
2. 各プラグインは、日本語文字列を別メソッド化しておく
3. 標準添付のモノに関しては、misc/plugin/en/ディレクトリを作ってそこに上記に対応した英語のリソースを追加してもらえるとよりベター

■ ＃きたさんのツッコミの後にこの文章自体を見直して一部書き直してます。