辞書ファイルに登録しておいた複数の文章をランダムに表示させます。 UNIX系OSであれば大抵はついてくるfortuneプログラムの辞書ファイルと同じファイルフォーマットですので、インターネット上で数多く公開されている辞書ファイルを使うことができます。 もちろん、自分で文章を作ることもできます。

• tDiary-1.3.x or later
• ruby-1.6.x or later

fortune.rb

ヘッダもしくはフッタ

本プラグインには２つのメソッドがありますが、引数はどちらも同じです。

• path - fortune辞書ファイルのパス
• div - 文章区切り(省略可能：デフォルトは%)
• html - HTMLタグはHTMLタグとして扱う場合はtrue、そうでない場合はfalse(省略可能：デフォルトはfalse)

3つ目のhtml引数の扱いには注意してください。これをtrueにするとセキュリティ上問題になる場合があります。 信頼のおける（あるいは自分自身で作った）辞書ファイル以外では使用しないでください。

fortune(path, div = "%", html = false)

フォーチュンを表示します。フォーチュンファイルはテキスト形式ですので、通常はこちらを使ってpreタグで括ります。フォントも等幅フォントを使うと良いと思います。

例：
<pre style="font-family: monospace">
<%= fortune "/home/hoge/fortune/uranai" %>
</pre>

fortune_br(path, div = "%", html = false)

フォーチュンを表示します。改行は<br>にします。辞書ファイルによってはフォーマットがくずれます。

例：
<%= fortune "/home/hoge/fortune/uranai" %>

<pre style="text-align:center">大吉：今日のあなたはハッピーな一日になるでしょう。でも、赤い色をしたカエルに注意。</pre>

fortuneプログラムは、テキスト・バイナリの2つのファイルで1組になっています(例：hoge, hoge.dat)。しかし、本プラグインでは、テキストファイルしか使用しません(hoge.datは不要です)。

辞書ファイルのフォーマット

テキストファイルの内容は以下の通りです。文章の区切り文字は通常%のみの行です。

文章１
%
文章2
改行とかもできます。
%
%% '%'がつく行はコメント行です。
文章3
%

• 区切り文字は違う文字で代用することも可能ですが、特に理由がない限り%を使いましょう
• 最終行は%があっても無くても大丈夫みたいです
• 日本語を使う場合はJIS形式で保存することが多いようですが、EUC-JP等でも大丈夫です

辞書ファイルはどこにあるの？

様々な辞書ファイルが、多くの人々の手によってインターネット上で公開されています。検索エンジンにfortune cookie等として検索してみてください。

Linuxでは大抵のディストリビューションに入っていますのでそれを使うのも手です。例えば、Kondara MNU/Linux 1.2の場合は /usr/share/games/fortunes 配下に辞書ファイルがあります。 RPM系ディストリビューションでは、

rpm -ql fortune-mod

とすれば、どこに辞書ファイルがあるかわかると思います。

インターネット上で公開されているfortune辞書ファイルを使用する場合は、その使用条件（ライセンス）を守るようにしてください。

Copyright (C) 2002-2008 MUTOH Masao <mutoh@highwhay.ne.jp>

本ソフトウェアはGNU General Public License Version 2(GNU一般公有使用許諾書バージョン2)に基づいてリリースされるフリーソフトウェアです。 また、本プログラムは無保証です。本プログラムの利用により何らかのトラブルが生じても、当方は一切責任を負いません。

本ソフトウェアについてのご意見・バグレポートは武藤まで。 MUTOH Masao <mutoh at highway.ne.jp>

2008-05-19 MUTOH Masao <mutoh at highway.ne.jp>

• "%%" で始まる行はコメントとして扱うようにした。 Reported by T.P.S.Nakagawa
• <br> -> <br/>
• version 1.1.0

2002-05-19 MUTOH Masao <mutoh at highway.ne.jp>

• ドキュメントアップデート
• version 1.0.2

2002-04-28 MUTOH Masao <mutoh at highway.ne.jp>

• require 'cgi'は不要なので削除した
• version 1.0.1

2002-03-28 MUTOH Masao <mutoh at highway.ne.jp>

• version 1.0.0