================================================================ BestBBS!! v.0.4.3 取扱説明書 1999/04/02 Taichi Maruyama ================================================================ ■ I N D E X =================================================== ◆ 1. 概要 ｜ ◆ 2. 特徴 ｜ ◆ 3. 動作環境 ｜ ◆ 4. 使用条件 ｜ ◆ 5. インストール方法 ｜ ◆ 6. 認証がうまくいかない場合... ｜ ◆ 7. 高度な設定 ｜ ◆ 8. バージョンアップ ｜ ◆ 9. 著作権について ｜ ◆ 10. サポート ｜ ◆ 11. 開発履歴 ■ 1. 概要 ===================================================== BestBBS!! は Web上で動作するスレッド式の掲示板です。Perl4スクリ プトで記述され、CGIを使用できるサーバならどこでも動きます。 ■ 2. 特徴 ===================================================== ★ 設置や管理が非常に簡単。 ★ ユーティリティが充実。細かい設定がブラウザから行える。 ★ 今後のバージョンアップも上書きするだけで簡単に行える。 ★ ツリー表示・時間順表示切替 ★ クリッカブルURL機能 ★ ユーザーデータ保存機能 ★ 記事検索機能 ★ あとは普通の掲示板 ■ 3.動作環境 ================================================== CGIが動作するサーバならどこでも動作するように作ってあるつもりで す。UNIXもしくはUNIX互換のOS上であれば、間違いなく動作すると思い ます。 ■ 4.使用条件 ================================================== 本スクリプトはフリーソフトです。本スクリプトを公開するにあたり、 動作には万全を期しているつもりですが、本スクリプトによって起きた、 いかなる損害も作者は責任を持ちませんので、各自の責任にてお使いく ださい。また、本スクリプトの欠陥・不良を発見された場合には、作者 まで、ご連絡頂ければ幸いです。 【連絡先】 丸山泰地 maruyama@infosite.co.jp また、バージョン番号が、0.x.x となっているものは、開発途上のベー タ版であるものとご理解ください。バージョンアップが頻繁に行われま す。バージョンアップの方法については、「■ 8. バージョンアップ」 の項をご覧ください。 ■ 5. インストール方法 ========================================= 本プログラムは以下のファイルによって構成されています。 bbs.cgi 掲示板プログラム本体 jcode.pl 日本語処理プログラム config.txt 設定ファイル utter.log ログファイル（中味は空です） readme.txt 貴方が今読んでいるこの説明書 まず bbs.cgi をエディタで開きます。ここでは先頭行が #!/usr/local/bin/perl となってますが、各プロバイダのご指定に基づき、書き換えて下さい。 書き換えたら、保存してください。 次に、改行コードに気をつけながら、所定の位置にファイルを転送しま す。改行コードは必ずサーバにあわせてください。サーバがUNIX、また はUNIX互換のものであれば、具体的には以下のようになります。 【Windowsで作業されている方】 次に、readme.txt を除く全てのファイルをサーバに、ASCIIモードでア ップロードして下さい。必ず CGIスクリプトの動作するディレクトリに 置いて下さい。 【Macintoshで作業されている方】 readme.txt をのぞく、全てのファイルをエディタで開き、 改行コード を UNIX(LF) にして、保存し直します。 その後、FTPでアップロードし ます。バイナリ転送でＯＫです。 【UNIXで作業されている方】 readme.txt をのぞく全てのファイルを、 スクリプトを動かしたいディ レクトリにコピー・転送してください。 アップロードが終わったら、次にファイルの属性を変更します。プロバ イダによっては、属性の変更が必要の無い場合もあります。その場合は 属性の変更の必要はありません。 ファイルの属性を以下のように変更します。属性の変更は FTPソフトや telnet を利用します。 bbs.cgi 755 config.txt 666 utter.log 666 jcode.pl 変更不要(変えるとしたら 644) インストールはこれで終了です。ここでは、 http://your.domain/cgi-bin/bbs.cgi にインストールしたとして、これを例にして、話を進めていきます。 まず、ブラウザでインストールした場所にアクセスします。例の場合、 http://your.domain/cgi-bin/bbs.cgi にアクセスして、メイン画面が出てきたらＯＫです。 次に画面上部にあるメニューの中から、[管理ページ]をクリックします。 パスワードを要求されますが、パスワードは何も設定されていないので、 何も入力しないで、[送信]ボタンを押します。管理用画面が出てきたら ＯＫです。もし認証に失敗したというような画面が出てきた場合には、 本ドキュメントの「■ 6. 認証がうまく行かない場合」の項をご覧くだ さい。 次に設定を自分の好み通りに書き換えます。上から順番に説明します。 ★会議室のタイトル メインタイトルです。あなたのお好みの名前に変えて下さい。 ★ホームページ あなたのホームページのURLを書き込んで下さい。 ★新規投稿フォームURL 基本的にはデフォルトの bbs.cgi?md=nf のままで結構です。 ★記事にタイトルがない場合のタイトル 記事の投稿者が記事にタイトルを付けなかった場合、プログラムが自動 的につける記事の名前です。デフォルトは「無題」となっています。 ★使用する日本語コード（初期状態のみ変更可） 表示する時に使用する日本語コードを、JIS(jis)、シフトJIS(sjis)、 EUC(euc)の中から選択できます。 ★日本との時差 サーバが海外にある場合、 サーバの所在地と日本との時差をここで設 定します。 ★デフォルトの表示件数 記事をツリーで表示する時に、 表示するスレッドのデフォルト数を設 定します。 ★デフォルトの表示件数（時間順） 記事を時間順で表示する時に、表示する記事のデフォルト数を設定しま す。 ★記事最大保存数 ログに保存するスレッドの数を設定します。 スレッドがここで設定し た数だけたまると、 新しいスレッドが出来るごとに古いスレッドを削 除します。 ★最新の記事判定数 プログラムは新しく投稿された記事は色分けをして表示します。 最新 何件分を色分けして表示するのかを決定します。 ★時間順表示の際の記事本体表示 試験的にv.0.4.0で追加した機能です。 時間順表示の際に、記事本体も同時に表示させる場合は"ON"に設定します。 百聞は一見にしかず。一度試してみてください。 ★バックグラウンドカラー ★テキストカラー ★リンクカラー ★リンクカラー（アクセス済み） 使用する色をしてします。HTML同様、RGB16進数での記述をして下さい。 ★最新記事の色 新しく投稿された記事は色分けして表示しますが、 その時の色をここ で指定してください。ここで設定された色は、時間順表示の際の記事本 体表示をONにした際、タイトルの色にも利用されます。 ★壁紙URL 背景に使う画像ファイルがあれば、そのURLを指定します。ない場合は 未記入のままにしておいて下さい。 ★メイン画面の説明 プログラムのメイン画面をHTMLでデザインします。
タグを使わな いと改行されない事に注意して下さい。 ★パスワード（変更したい人のみ入力） 管理者用パスワードの変更ができます。 インストールした後は何も設 定されていませんので、必ず指定して下さい。 万が一のため銀行の通 帳の暗証番号のような大事な暗証番号は使わない方がいいでしょう。 ★パスワード（変更したい場合のみ上と同じデータを入力） 確認のため、新しいパスワードを再度入力して下さい。 ★パスワードを入力して設定変更ボタンを押して下さい。 管理者用パスワードを入力して 「設定変更」ボタンを押すと設定は完 了します。最初はパスワードが設定されていませんので、 空白のまま 設定変更ボタンを押して下さい。 ★記事を削除 この項目は上の設定メニューとは関係ありません。 投稿された記事を 削除する時にお使いください。 削除すると子記事も削除されますので ご注意ください。本格的な記事管理ユーティリティを現在開発中です。 ■ 6. 認証がうまくいかない場合 ================================= サーバによっては、設定時の認証がうまくいかない場合があります。 （特にサーバにNT等、UNIX以外のものを利用している場合） その場合は、次の処置を行ってください。 (1) プログラム bbs.cgi をメモ帳やJEDIT等のエディタで開きます。 bbs.cgiの24行目、 $USE_CRYPT = 1; を $USE_CRYPT = 0; に書き換えます。 (2) 次に33行目、 $CONF_FILE = "config.txt"; これは、設定ファイルの名前です。これを何らかの別の名前に書き換え ます。 名前はなんでも構いません。例えば、 $CONF_FILE = "tama.txt"; という具合に自分の好きな名前にしてください。 (3) これだけ書き換えたら、bbs.cgiを保存します。 (4) 次に、設定ファイル "config.txt" を (2)で決めた名前に書き換え ます。 例えば、(2)で、 $CONF_FILE = "tama.txt"; としたならば、 tama.txt に名前を変更します。 (5) bbs.cgiと設定ファイル（config.txtから名前を変えたファイル） をサーバにアップロードします。 (6) パーミッションの設定をします。（しなくてもいいプロバイダもあ ります） bbs.cgi -- 755 config.txt から名前を変えた設定ファイル -- 666 utter.log -- 666 (7) あとは「■ 5.インストール方法」に書いてあるとおり、 パスワー ドの変更を行ってください。 ■ 7. 高度な設定 =============================================== 【HTMLタグの許可設定】 これは、スクリプトを書き換えていただく必要があります。 bbs.cgi をエディタで開いて、63行目ぐらいにある -------------------------------- %UTTER_TAG = ( '
', '', '', '', '', '', ']*>', '' ); -------------------------------- を書き換えます。必ず２つで１組です。これに
タグを追加してみ ましょう。 -------------------------------- %UTTER_TAG = ( '
', '', '', '', '', '' ']*>', '', '
, '' ); --------------------------------
は閉じるタグはありませんので、 対になるタグがありませんが、 その場合でも、 '' として、空のデータを入れておいてください。 ※
は絶対に削除しないで下さい。 編集が終わったら、サーバにアップロードしてください。 【bbs.cgi のファイル名を変える】 これは簡単。ファイル名はFTPクライアントソフトで変えるのが楽です ね。ローカルマシンで（自分のマシン） 書き換えてアップロードする とパーミッションを書き換える必要がありますから。 ファイル名を変えただけではいけません。 例えば、bbs.cgiをindex.cgi にしたとしたら、設定画面で、「新規投 稿フォームURL」を bbs.cgi?md=nf から index.cgi?md=nf に書き換え] てください。まあ、index.cgi なら、 ./?md=nf とやった方が綺麗かも しれません。以上でファイル名の書き換えは完了です。 ■ 8. バージョンアップ ======================================== バージョンアップは「基本的に」、bbs.cgiを上書きするだけです。 その他のファイルはアップロードしないで下さい。 bbs.cgiの先頭行を書き換える必要がある人は必ず書き換えてから、 ア ップロードして下さい。デフォルトは #!/usr/local/bin/perl になっ ています。 v.0.3.4以前のバージョンからバージョンアップされる場合は、設定に変 更がなくても設定画面で、設定を一度更新してください。 ■ 9. 著作権について =========================================== ・本スクリプトの著作権は、作者にあります。 ・本スクリプトを転載・再配布する場合には必ず作者の許可をとってく ださい。 ・本スクリプトを改造して利用しても構いませんが、メイン画面右下に 表示されるコピーライトは消さないでください。 ■ 10. サポート ================================================ 本スクリプトのサポートは基本的に、BestBBS!!の Web Pageで行ってい ます。 [BestBBS!! WebPage] http://www.infosite.co.jp/~maruyama/bestbbs/ バグ報告・ご意見・ご質問は、BestBBS!! Web Pageの掲示板、もしくは メールにてご連絡ください。作者多忙につき返信が遅れることが、しば しばありますが、ご了承ください。 [メールの送信先] 丸山 泰地 maruyama@infosite.ne.jp ■ 11. 開発履歴 ================================================ v.0.4.1 -> v.0.4.3 (99/04/02) v.0.4.2 は欠番 - 大文字と小文字を区別せずに検索をするように改善。 - 名前やタイトルにシングルクォーテーションが含まれている場合に、 JavaScriptエラーが発生するのを修正。 - エラー発生時の掲示板へのリンクがおかしかったのを修正。 v.0.4.0 -> v.0.4.1 (99/02/16) - Perl4で検索機能使用時でサーバーエラーが出る不具合について検証。 検索関連のルーチンを改変。(DOS版 Perl4.036で動作確認を実施） - Perl4を利用していて、改行を含む記事を投稿するとログが壊れてしま うことがある不具合を修正。 - 時間順表示＆記事本体表示モードで、URLやメールアドレスも表示する ようにした。 - 記事表示時に、余分なHTMLタグが混入していたのを削除した。 - ファイルロック（同時書き込みによるファイル破壊の防止）を強化。 - 過去ログの閲覧をページ切替方式に変更。同時に一度に閲覧できる記 事の数を減らした。（サーバへの負担がぐっと少なくなりました） v.0.3.4 -> v.0.4.0 (99/02/11) - 検索機能を追加 - サーバーによって名前・メールアドレス等の保存ができない不具合へ の対策（アプローチをちょっと変えてみた）。 - $WIN_MODE の廃止。$USE_CRYPT に変更（名前が紛らわしかった）。 - 時間順表示の際、記事本体も同時に表示させる機能を追加。 - 記事表示画面中のツリー表示で、カレントの記事を矢印で示すように した。 - 名前・URL・メールアドレス・タイトル中の改行コードもフィルタリン グするようにした。 - スクリプト自体をShift-JIS以外の文字コードで動かしても、文字化け が起こらないように修正。 - 投稿後の画面で文字が化けることがある不具合を修正。 - 古い記事も永久保存できるモードを追加。（99/02/16加筆） v.0.3.3 -> v.0.3.4 (99/01/28) - v.0.3.3だけのバグ。[時間順で表示]がうまく表示されなかった不具合 を修正。（これは大変申し訳ないです。 m(..)m） - ついでに時間順で表示モードの表示方法も変更しました。 v.0.3.2 -> v.0.3.3 (99/01/26) - 漢字コードを変更した場合、文字化けが発生することがある不具合を 完全修正（のつもり） - 漢字コードはいつでも変更できるように改善。 - 発言中のアンカー、発言者のURLのアンカーのTARGETを_blank にして、 別ウィンドウを表示させるようにした。 - 添付しているjcode.pl をv.2.0からv2.10に変更。 v.0.3.1 -> v.0.3.2 (98/10/29) - 管理画面で、意味のないテキストボックスが表示される不具合を修正。 v.0.3.0 -> v.0.3.1 (98/10/28) - 管理用ページの認証をアクセス前にも行う、二段階認証方式に変更。 - メニューに管理ページへのアンカーを追加。 - NT+IIS で動作するようデータの受け渡し方法を一部修正。 - 記事最大保存件数の最小を50件、最大を1000件に変更。 - 日本との時差を-5〜+19で設定できるように変更。 - readme.txt の全面改訂。 v.0.3.0b -> v.0.3.0 (98/10/20) - 一定条件で認証がうまくいかない不具合を修正 v.0.2.5 -> v.0.3.0b (98/09/05) - 内部処理の大幅(?)改良（古くなった記事の処理等） - NTサーバ等で認証が上手く行かない場合の対応をできるようにした。 - 記事を引用した時に、引用文の最後に改行コードを追加した。 - タグをデフォルトで利用できるようにした。 - 投稿後、ありがとうメッセージを表示するように変更。投稿後のリロ ードで二重投稿になってしまうのを防止。 - クッキーが効かない場所があるらしいので、クッキーの食べ方をちょ っと変更。（それでも、だめかもしれない・・・ ^^;） - 掲示板のデザインで、
タグが再読み込みした時に消えてしまう 不具合を修正 v.0.2.4 -> v.0.2.5（98/07/07） - 親記事が存在するのに、関連記事が表示されない不具合を修正。 v.0.2.3 -> v.0.2.4（98/07/06） - 時間順表示で、記事番号のカラーが設定通りに反映されない不具合を 修正 - 記事表示画面で、その記事に関連記事がない場合は、関連記事の項目 を表示しないように修正。 - 記事の自動引用で、Internet Explorer 3.0 で正常に動作しない不具 合を修正。 v.0.2.2 -> v.0.2.3（98/06/25） - クリッカブルURLの ftp:// 対応 - クリッカブルURLは行の先頭時のみ機能するようにした。（ タグとの混合使用による不具合が一部解消） - クリッカブルURLでチルダ(~)の後にアンカーがかからない不具合を修 正。 - 説明書の不具合修正。^^; v.0.2.1 -> v.0.2.2（98/06/17） - Perl4 を使っているサーバでサーバエラーになってしまう不具合を修 正。 v.0.2.1 -> v.0.2.1（98/06/16） - スレッドを削除した場合、完全に削除されない不具合を修正。 （完全に修正できたかどうかは疑わしい。^^;） - 削除確認メッセージで、 v.0.1.5 -> v.0.2.0（98/06/11） - クッキーに対応。名前、メール、URLの保存を可能にした。 - クリッカブルURL機能を追加した。 - クリッカブルURL機能の追加に伴い、タグは使用禁止にした。 - パスワード認証の強化。 v.0.1.4 -> v.0.1.5（98/05/31） - フォロー記事を削除して直後に、フォロー発言を投稿すると、同じ記事 が２つできてしまう不具合を修正。 v.0.1.3 -> v.0.1.4（98/05/04） - デフォルトの表示件数を、 ツリー表示の場合と記事表示の場合と分 けて設定できるようにした。 - 「記事の削除」で子記事が完全に削除されない不具合を修正 - 発言中にダブルクォーテーション・ シングルクォーテーションがあ ると、場合によってJavaScriptエラーが発生する事があるのを修正。 - タグを標準で使用可能にした。 v.0.1.2 -> v.0.1.3 (98/04/18) - 発言中にダブルクォーテーションがあるとJavaScriptエラーが 起こるのを修正。 v.0.1.1 -> v.0.1.2 (98/04/18) - 引用マークを全角の＞に訂正 - レスのタイトル自動生成で、レスのレスが「Re:Re:」となるのを 「Re[2]:」となるようにした。 - メイン画面で 「投稿者:」は消した。 v.0.1.0 -> v.0.1.1 (98/04/03) - 引用文に引用元の説明を追加した。 - 最新の記事の色が変わらない不具合を修正。 v.0.0.1 -> v.0.1.0 (98/03/28) - 記事を時間順に表示させる機能を追加 - 記事の詳細表示画面のインターフェイスを大幅に変更。 それに伴い 「記事表示のメインカラー」の設定項目廃止 - ツリー表示における時間の方法の変更表示 - 設定した色が新規投稿画面に反映されないのを修正 - ソースコードの最適化 v.0.0.1 (98/03/26) - 初公開