KBOARD manual ver12.10対応版
    update 2002/05/01

















■はじめに

このたびは、KBOARDをダウンロードしていただき、ありがとうございました。
このマニュアルには、設置方法などいくつか大切な記述がありますので、左のメニューを参考に目を通してください。
KBOARDをご利用するにあたり、利用規定に同意する必要があります。



■同梱ファイル

kboardフォルダ内 manualフォルダ内


■準備

以下の事項を、設置先のプロバイダ・サーバーに問い合わせてください。
/スラッシュからはじまるフルパス指定の方法とは、例えば、
http://www.xxx.ne.jp/~you/index.html
というファイルのとき
/home/you/public_html/index.html
というように指定するものです。
知っていて損はないので、この機会に調べて見てください。

以下のソフトを用意してください。 FTPソフトに関しては、フリーのソフトで使いやすいものが多数あるので、
http://download.yahoo.co.jp/vector/
等でダウンロードしてください。
有名どころではFFFTPかな？ちなみに、僕はROOT FTPというものを使っています(お薦め)
テキストエディタは、メモ帳・ワードパッドでも良いですが、何か用意するのがよいでしょう。
これもフリーで良いものがありますので、これを機会にゲットしてみては？



■設定

kboard.cgiの設定 kboard.iniの設定


■アップ

FTPソフトでアップロードしましょう。
パーミッションの指定が必要なファイルは、 [カッコ]で囲まれている数字は、そのファイルのパーミッションです。
* 私書箱機能を使う場合必要です。
** 過去ログ機能を使う場合必要です。

フォルダ構成は、htmlファイルとcgiファイルを同じ場所にアップしてもよいのなら、 kboardフォルダをそのままアップすればオッケーです。
htmlファイルとcgiファイルが別の場所にアップする必要がある場合は、 gifフォルダとkboar_pフォルダは、いつもhtmlファイルをアップする場所にアップして下さい。
当然、manualフォルダはアップする必要はありませんよ。

注意！！
アップするときには、転送モードに注意してください。
gifフォルダ内のファイル以外はすべてアスキーモードです。
転送モードは、自動ではなく、面倒かもしれませんが手動で行なってください。

アップが終了したら、パーミッションの指定をします。
上記のファイル・フォルダはパーミッションの設定が必要です。
各数字の意味は
各ユーザーに対してのアクセス権を示していて、それぞれの数字は 各数字の和で表しています。
例えば
kboard.cgi [755]
であれば、
となります。
まれに、パーミッションを数字ではなく、アルファベットで指定する場合があります。
その場合は、[755]ならば、
となります。
先頭の-ハイフンは、ファイルかフォルダかを区別する場所で、フォルダならdとなります。
以下、アルファベット３文字づつが、オーナー、グループ、他人のアクセス権を示しています。 許可しない場合は、-ハイフンとします。

ブラウザで、kboard.cgiを開いてみてください。掲示板らしきものが表示されれば、設置は完了です。
もし、何か問題があれば、トラブルの種類によって、左のメニューから該当する項目を参考にして下さい。
kboard.iniの設定が途中であれば、再度kboard.iniファイルを開き、適宜設定・変更してください。



■バージョンアップ

v5.x以下をご使用の方は、ログ形式が変更になったため、ログを移行することはできません。 申し訳ありませんが、新規としてお使いください。

それ以降の方は、今までお使いのログをそのまま使用できますので、ログファイル以外を上書きアップしてください。



■持ち家成長機能

この掲示板の売りである、持ち家成長機能に関して説明します。
投稿するたびに自分の家が成長していくという、そのままの機能です。
で、家は、投稿者の名前で制御しているので、他の名前を使えば、家が新たに立ちます。
成長スピードは、正確に投稿数に比例していません。 この機能の目的は、一見さんをいかにして虜にするかということなので、 最初の数回は、投稿毎で家が成長します。掴みということです。
投稿数が多くなればなるほど、成長スピードはおそくなります。
成長は、投稿数１００回で終了します。そのあとは、名前の前に、「肩書き」なるものがつき、 家の大きさは、１回にもどります。
「肩書き」は１００回毎に変化し、一応６００回まで用意しています。それ以上になれば、肩書きも変化しなくなります。
「肩書き」は、僕がさくっと作ったものなので、かなりオダサです。 これを、自分なりにカスタマイズしたいときは、kboard.cgiをエディタで開き、「肩書き」などで検索をかければ、変更する場所がわかるかと思います。

rankieフォルダにある１〜１３までの家画像が、成長するたびに変化していく画像です。
俺は家じゃなくて、植物を成長させたい！！なんていう人は、１〜１３までの画像を、成長の度合いに合わせて用意すれば、 簡単にカスタマイズすることが可能です。
ただ、幾つかの説明部分を「家」から「植物」へと変更する必要がありますが・・・。

廃墟とは、一定期間書きこみがない人の持ち家の画像を、old.gifに取りかえる処理のことを言います。
ただ、売却される前に、書きこみがされれば、持ち家は以前の大きさに戻ります。 つまり、一回に家が戻るわけではありません。

売却とは、一定期間書きこみがない人の持ち家画像を、削除する処理のことを言います。
この機能と連動する機能が、不動産売却機能です。
売却処理は、書きこみされるたびに、売却対象になっている持ち家がないかを、持ち家データからさがしだし、 もしも、売却対象があれば、削除されます。
つまり、売却と誰かの書きこみは連動しています。
そこで、売却に追いやった書きこみをした人に、売却対象の投稿数を追加する機能のことを不動産売却機能といいます。
不動産売却処理が行なわれると、掲示板にその旨の書きこみがされます。

持ち家データは管理者のみ変更可能です。
修正するときは、「管理用」リンクからマスターキーを入力して編集フォームにいってください。
家主の名前、投稿数を変更、家を削除、することができます。
投稿者名をかえたいよーーー、なんていうリクエストがあったら、ここで修正してあげてください。



■管理者レス機能

管理者のみ投稿記事にレスをつけることが出来ます。
レスの付けかたは、各記事の右下にある、削除フォームにマスターキーを入力して、レスフォームで書きこんでください。
レス文字の色、レスを書きこんだ人（管理者）の名前は、kboard.iniファイルで設定することが可能です。



■私書箱・置き手紙機能

kboardは、管理者だけレスを付けることが可能です。
なぜかというと、僕の個人的嗜好です。今後、投稿者が自由にレスがつけれるようにするつもりはありません。
で、それではさびしーーーーー、という声が多かったので、私書箱・置き手紙機能というものをつけました。
これは、投稿者それぞれに持ち家があるという点を最大限に利用したものです。
機能のイメージとしては、普通の掲示板で、Aさんあての記事だけを表示するというものです。
つまり、各家に単独で掲示板があるように思えますが、実際は、1つの掲示板で、表示する記事を選択しているだけです。
で、置き手紙の保存数ですが、全体での最大数と、各家での最大表示数で決まっています。
各家の最大表示数が１０件で、全体の最大数が１００件であれば、各家で表示される置き手紙の数は、 全体の最大数が１００を越えていなければ、最大１０件表示されますが、全体の最大数が１００を超えると、 古い手紙から削除されていくので、各家で表示される置き手紙の数は、１０件より少なくなってしまいます。
よって、置き手紙が１０件保存されてない！！といっても、バグではありません。
それでは、全体の最大数を３００とか５００とかにすれば、いいかあ！！なんて思うかもしれませんが、 そのように設定してしまうと、その３００件の記事から、特定の人への記事を探し出して表示するという処理は、 ものすごくサーバーに負担をかけることになり、また、処理が遅くなるかと思います。
よって、全体の最大数は１００件ぐらいで我慢してください。
ベースは１つの掲示板である、ということをご理解ください。

削除したい置き手紙があった場合、管理者のみ削除することが出来ます。
削除する場合は、「管理用」リンクからマスターキーを入力して、フォームページに行きます。
持ち家データから、削除したい置き手紙がある家を探して、「置き手紙を編集」ボタンをクリックしてください。
その家にある置き手紙がずらーーーと表示されますので、該当する置き手紙を削除してください。

未読の置手紙があると、ポストにお手紙がぴこぴこしています。（v12.00より）
読むと、ぴこぴこはとまります。

v11.00までは、ポストに鍵をかけたとしても、表の掲示板で名前を偽ると、新しい鍵をかけることができてしまいました。
ただ、これはあまりにも・・・ということで、v12.00より、名前とキーのチェックをすることにしました。
つまり、名前とキーが一致しない場合は、新規投稿を受け付けないというものです。
しかし、もしもキーを忘れてしまった場合は、新たな名前でカキコしていただくしかありません。
まあ、おうちをいったん削除して、再度おうちを立ててもらって、カウントをプラスしてあげたりしてもいいかもしれませんが、かなり管理者の負担が増えるかと思うので、その辺はうまくやってください。
なお、この名前・キーのチェックはkboard.iniで選択設定が可能ですので、お好きな方を選んでください。

v12.00より、置手紙を受け取った場合、そのカキコした人がお家をもっていれば、その人の名前に、置手紙を書き込むフォームへのリンクを張るようにしました。
これで、お手紙のお返事をストレスなくカキコできるようになりました。

置き手紙機能は、kboard.iniで使わないように設定が可能です。
その場合は、rankieフォルダ内のkanban.gifが必要になります。



■過去ログ機能

投稿記事は、kboard.iniで設定した最大記事保存数を超えると、古いものから削除されるようになっています。
もしも、昔の記事も思い出として取っておきたい！！という場合は、この機能を使うことによって、古い記事をhtmlファイルとして作成することができます。
ただ、しらないうちに、ものすごい数のhtmlファイルが作成されていくので注意が必要です。
また、この機能を利用するには、/スラッシュからはじまるフルパスの指定方法を知る必要が出る場合があります。
過去ログを見るときは、「過去ログ」リンクから見ます。 このリンクは、過去ログが生成された時点で、自動的に表示されるようになります。
なので、過去ログの設定がうまくいっていないと、ある日突然、「過去ログ機能の設定を確認してください」 というメッセージが表示され、書きこみが出来なくなります。
もしも、過去ログ機能の設定に自信がもてないのであれば、PAST LOG CHECKERというスクリプトを用意していますので、 合わせてご利用ください。
v9.00から、すこし機能が追加されました。先にも述べたように、ものすごい数のhtmlファイルでまいってしまっている人がいるようなので、 生成されるhtmlファイルの数を自動で調整できるようにしました。
つまり、「３つまで」と決めておけば、1,2,3のhtmlファイルがあって、4.htmlファイルが生成されるときに、1.htmlが削除され、2,3,4.htmlファイルへのリンクが張られるということです。
リンクが張られなくなる、つまり、見た目だけ「３つ」となるのでなく、実質的にも「３つ」となり、それ以外は「削除」されます。これは注意しておいてください。



■その他の機能

以上の機能のほかに、いくつか他の掲示板でもあるような機能があります。
詳細は、kboard.iniファイルにありますので、そちらを参考にしてください。
管理者のみが行なえる機能は、すべてマスターキーで制御しています。
記事の右下にある削除フォームに入力したり、「管理用」リンクから行なってください。



■サーバーエラーが出る

原因は、いくつか考えられます。 cgiが設置できない
これは、そのままですね。プロバイダー・サーバーに連絡してください。

cgiファイルのアップする場所
これは、サーバー側での決まりをよく理解してください。
htmlファイルと、cgiファイルのアップする場所が異なる場合です。

perlのパス
設置しようとしているプロバイダー・サーバーに問い合わせてください。
また、kboard.cgiの一行目に指定するときにありがちなミスは、
等です。
当然、半角英数で設定します。

ファイルを間違って修正した。
cgiファイルは、とてもデリケートで、1箇所でも文法エラーがあると、サーバーエラーが出ます。
この場合、自分でその文法エラーを探すのは大変難しいので、その恐れがあるようであれば、 再度ダウンロードしなおすことをお薦めします。

パーミッションの設定
パーミッションの指定が間違っている場合というのは、単なるポカミスなので、もう一度パーミッションの指定を確認すれば良いだけです。

転送モード
このエラーが一番たちが悪いです。
設定・パーミッション・perlのパス、ぜーーーーーぶ大丈夫！！なのにどうしてーーーー！！
という場合は、ほとんどの場合がこれが原因です。
どうしてこのようなミスが起るのか？というと、それは、いままではファイルをアップするとき、 ほとんどの人が、自動で転送モードを決定しています。
つまり、FTPソフトにまかせているのです。
この場合、gifファイルとか、htmlとかはFTPソフトはある程度賢いので、gifはバイナリー、htmlはアスキー（テキスト)でアップしよう！！ と判断してくれます。
ただ、cgiファイル、iniファイル、plファイルとなると、悩んじゃうんですよ。
で、悩んだ時はどうするかというと、バイナリーでおくっちゃえ！！となります。
そうなると、当然エラーが生じます。
これを回避するには、１つづつ手動で転送モードを選択して、アップするのが確実です。
gif画像は１つのフォルダ以下にまとめて入っているので、それはバイナリーでアップして、 それ以外は、アスキーでアップとすれば少しは楽になるでしょう。
でも、それも面倒！！自動でやりたい！！というのなら、FTPソフトに教えてあげましょう。 つまり、〜の拡張子のファイルはアスキーでアップするんだよ！！って。
おそらく、そのように設定ができるかと思います。 一度、そのように設定してあげれば、これから先、cgiスクリプトを設置するときはかなり楽になるかと思います。
ちなみに僕の使っているROOT FTPというソフトは、これが出来ます。 また、拡張子から、パーミッションの指定まで自動でできます。 かなり、吸収力のよい奴です（笑）。

原因不明のエラーが出る場合で一番多いのが、kboard.iniファイルを自動で転送してしまい、バイナリーでアップしていた、 というものです。



■kaismからのエラーメッセージが表示される

原因をあげると、
kboard.iniでの設定
ファイルの指定の仕方は大きく分けて二つあります。
相対パスと絶対パス（フルパス）です。
相対パスとは、
../hoge/hogehoge/index.html
といったように、今いる場所から相対的にみて、特定のファイルを指定する仕方です。
絶対パスには、二通りあります。
http://www.xxx.xxx./~hoge/index.html
/home/public_html/hoge/index.html
の二つです。
で、この3つの指定の仕方を使い分ける必要があります。
kboard.iniファイルに書いてあるとおりに、ちゃんと正しい指定の仕方でファイルを指定してください。

パーミッション
これはそのままです。
〜ファイルが開けませんでした、などのメッセージが出た場合は、FTPソフトでパーミッションを確認してみてください。

過去ログ
このエラーがでる場合が多いようです。
しかも、過去ログのエラーがでるのは、ちゃんと動作していて、最大記事保存数を超えたときに、突然でます。
突然だから、びっくりしてしまうようです。
で、これでは皆様にストレスを与えてしまうので、PAST LOG CHECKERなる、過去ログ設定がちゃんと出来ているかをチェックするためだけのスクリプトを作成してあります。
このスクリプトを使って、過去ログ設定を再度確認してください。
注意する場合は、htmlファイルとcgiファイルの置く場所が異なる場合です。
この時は、/スラッシュからはじまるフルパス指定を知る必要があります。

バージョンアップ
v6.00から、ログ形式が変換されています。なので、cgiファイル、iniファイルの上書きだけではバージョンアップすることができません。申し訳ありませんが、新規のご利用となります。



■画像に関して

画像が×になる場合は、kboard.iniでの画像フォルダの指定が間違っています。
もしくは、cgiファイルとhtmlファイルのアップする場所が異なる場合です。
適切な場所にアップし、ちゃんと画像フォルダを指定してあげてください。
この場合は、ソースを表示してみて、つぶれている画像のリンク先が正しいかをチェックしてみると、 どこが間違っているのかがわかるかと思います。
ブラウザで直接そのリンク先を開いてみて、ちゃんと画像が表示されるか確認してみてください。

画像がぐちゃぐちゃである場合は、転送モードが間違っているのが原因です。
画像を再度、バイナリーモードでアップしなおしてください。



■その他

すべての環境でkboardが動作すことは保障されていません。
どうしても設置できない、という場合は、ご連絡ください。
少しは御力になれるかもしれません・・・・。



■利用規定

　kaismで配布されているスクリプトを利用する場合、無条件で以下の規定に同意するものとします。
上記の利用規定は、かいに著作権があるものに対してのみ及びます。
他に著作権のあるものに対しては、合わせてその利用規定を守る必要があります。 （感謝！！参照)




■感謝！！

KBOARDは多くの方のご協力のもと完成いたしました。
この場で、感謝申し上げます。


この掲示板で使用している画像のほとんどが「牛飼いとアイコンの部屋」さんからお借りしているものです。
http://www.ushikai.com/index.html
著作権はきしのさんにあります。


jcode.plファイルはKazumasa Utashiroさんがフリーで配布しているものです。
著作権はutashiroさんにあります。


ポスト画像(2つ)は、kboard userのinoさんにご提供頂きました。
著作権はinoさんにありますが、画像の修正・変更・再配布などには一切、制限はないとのことです。
ino@apple-house.net





■更新履歴

version 12.10(2002.05.01) version 12.01(2002.04.30) version 12.00(2002.04.27) version 11.00(2001.05.25) version 10.01(2001.05.07) version 9.01(2000.10.11) version 9.00(2000.09.20) version 8.00(2000.08.25) version 7.00(2000.07.08) version 6.03(2000.06.30) version 6.02(2000.06.30) version 6.01(2000.06.29) version 6.00(2000.06.28) version 5.00(2000.06.21) version 4.10(2000.06.15) version 4.00(2000.06.14) version 3.20(2000.06.12) version 3.11(2000.06.12) version 3.1 (2000.06.09) version 3.0 (2000.06.07) version 2.0 (2000.06.06)


■最後に

私かいの喜びは、多くの方に楽しんでもらうことです。
そして、このkboardが皆様の楽しみに少しでも貢献できたとしたら最高です。
どうぞ、皆さんで私かいをシアワセモノにしてやってくださいな。
でわでは。
2001.05.07
かい [kaism]
kai@kaism.com
http://www.kaism.com