シングルスレッドBBS 説明書

  1. 特徴と動作環境
  2. 掲示板の設置方法
  3. 管理について
  4. プラグイン
  5. FAQと補足説明
  6. 更新履歴

1. 特徴と動作環境

1-1. 特徴

1-2. 動作環境

Windows9x系やUnix系の一部のサーバではflock関数(ファイルロック)が機能しません。
このプログラムはflock関数が使えない環境でも動きますが、同時書き込みがあった場合などにスレッドが消滅する可能性があるので動作はお勧めできません。


2. 掲示板の設置方法

2-1. ダウンロードと解凍

プログラムのダウンロードはホームページからどうぞ。
ダウンロードしたら解凍してください。

2-2. 掲示板の設定

  1. bbs.cgiを開いて1行目にあるPerlのパスを通す
  2. bbs.cgiを開いて15行目あたりから始まる掲示板の設定を各自の環境にあわせて修正する

2-3. 掲示板の設置

掲示板の設定が済んだら、ファイルをFTPでアップロードしてください。

 ○標準的な配置例○
   掲示板のアドレス→http://サイトのアドレス/cgi-bin/bbs/index.html

 cgi-bin/                | パーミッション | 文字コード | 転送モード | 改行コード |
     |                   |                |            |            |            |
     +--bbs/             | 707(701)       | -          | -          | -          |
     |  bbs/index.html   | 606(604)       | Shift-JIS  | 指定なし   | 指定なし   |
     |  bbs/index.css    | 644(644)       | Shift-JIS  | 指定なし   | 指定なし   |
     |  |                |                |            |            |            |
     |  +--dat/index.dat | 606(604)       | Shift-JIS  | バイナリ   | LF(Unix)   |
     |                   |                |            |            |            |
     +--test/bbs.cgi     | 705(700)       | Shift-JIS  | アスキー   | 指定なし   |
            /jcode.pl    | 644(644)       | 指定なし   | 指定なし   | 指定なし   |

 基本的に、ファイル・ディレクトリは以上の通りに設置してください。(cgi-bin/は除く)
 名前や設置場所を変更すると動きませんよ。
 ※各ファイルの詳細に興味があるのならFAQをお読みください。

パーミッション例の前者は、CGIプログラムがnobody権限で動く場合での一例です。 括弧付きの後者は、CGIプログラムがプログラムファイルの所有者権限で動く場合(suEXECとか)での一例になります。 パーミッションはサーバによって設定が異なるので、サーバに合わせて各自変更してください。

設置が完了したら、掲示板にアクセスします。
そして、管理画面に入り、スレッドの初期化を行えば掲示板の設置は完了です。(管理画面への入り方は次章で説明します)


3. 管理について

3-1. 管理画面への入り方

  1. アップロードした掲示板へアクセスする (ex. http://サイトのアドレス/cgi-bin/bbs/index.html)
  2. フォームの名前欄に管理人キャップのパスワードを入力して、書き込みボタンを押す(本文欄には何も入力しないでください)

これで管理画面に入れます。

3-2. 管理画面の説明

管理画面では、次のことが行えます。

レスの削除
レス番号を1つ指定して、そのレスを削除(あぼーん)することができます。
スレッドの更新
掲示板を最新の状態に更新したい時は、スレッドの更新を行ってください。
また、なんらかの原因でスレッド(HTMLファイル)が壊れた場合、スレッドの更新を行ってみてください。運が良ければスレッドを復旧することができます。

スレッドの更新はどのような作業をするかというと、ただ単純にindex.datからindex.htmlを生成するだけです。

スレッドの初期化
現在のスレッドを過去ログ化または破棄して、新規のスレッドを作成します。

現在のスレッドのDATファイルは初期化されるので、必ずバックアップしておいてください。

エラー検出
管理画面には、設定ミスやエラーなどを検知し、警告する機能があります。
管理画面を開き、もし警告が表示されたら、指示に従って対処してください。

3-3. キャップの出し方

 ★(キャップの印)を出すには、名前欄にキャップパスを入れて書き込んでください。


4. プラグイン

4-1. スキン

シングルスレッドBBSでは、掲示板のデザインをスタイルシート(以下スキン)で制御しているので、 スキンを変更するだけで簡単にデザインを変更することができます。

スキンの使い方
HTMLファイルと同じディレクトリに、スキンファイルを置くだけでOKです。
※スキンのファイル名は必ずindex.cssとしてください。
スキンの変更
新しいスキンファイルを上書きアップロードすれば、自動で反映されます。

スキンのダウンロードはホームページからどうぞ。

4-2. ローカルルール(Ver0.4以上)

bbsディレクトリにhead.txtファイルを置くことで、ローカルルールやお知らせ、広告などを掲示板のトップに表示させることができます。 表示される場所はタイトルと>>1の間になります。head.txtはHTMLタグで記述してください。

ローカルルールはHTMLの途中に挿入されるので、<html>タグや<body>タグは不要です。

ローカルルールの設置
  1. head.txtを作成する
  2. bbsディレクトリにアップロードする
  3. 管理画面に入って、スレッドの更新を行う
ローカルルールの更新
  1. head.txtを上書きアップロードする
  2. 管理画面に入って、スレッドの更新を行う
ローカルルールの削除
  1. head.txtを削除する
  2. 管理画面に入って、スレッドの更新を行う

4-3. 2重カキコ防止(Ver0.5以上)

testディレクトリにngrepeat.txtファイルを置くことで、2重カキコを防止することができます。
空のngrepeat.txtファイルを設置するだけで、2重カキコ防止機能が有効になります。無効にしたい場合はファイルを削除してください。

ngrepeat.txtのパーミッションは書き込み可能にしておいください。
分からないのならindex.htmlと同じにすればOK


5. FAQと補足説明

[一般] シングルスレッドBBS 豆知識

ショートカットキー(利用者向け)
フォームの書き込み欄へのショートカットキーを"M"に設定してあるのでWindowsユーザなら"Alt+M"でジャンプできます。 ちなみに、名前欄へのショートカットキーは"N"に設定してあります。
かちゅ〜しゃから掲示板にアクセスする(利用者向け)
かちゅ〜しゃのアドレス欄に、次のようなURLを打ち込めばOKです。
http://サイトのアドレス/cgi-bin/test/read.cgi?bbs=bbs&key=index
read.cgiが存在しなくても、かちゅ〜しゃはスレッドを開いてくれます。
かちゅ〜しゃのタブからブラウザを開いて掲示板に飛ぶ(管理者向け)
bbs.cgiと同じディレクトリに、次の2行を記述したread.cgiを置いておけば、かちゅ〜しゃからブラウザを開いて掲示板へ飛べるようになります。
#!/usr/local/bin/perl
print "Location: 掲示板のURL\r\n\r\n";
レスの削除をコマンド方式で行う(かちゅ〜しゃ使いの管理者向け)
レスの削除は、管理画面から行うと説明しましたが、コマンド方式でも行うこともできます。 名前欄に管理人キャップのパスワード#aborn削除したいレスの番号と入力して、書き込みボタンを押せば 管理画面に入らなくても、レスの削除ができます。

具体的な例を挙げると、管理人キャップのパスワードが「#mokorikomo」で、削除したいレスの番号が「10」の時は 名前欄に「#mokorikomo#aborn10」と入力して書き込めば、10番のレスが削除できます。

[一般] 2ch掲示板との主な相違点

sage
スレが1つしかないから必要ないです
メール欄
必要性を感じないので実装する予定はありません
アクセス規制、書き込み規制
「荒らしは放置」という原則に則って規制機能はほとんど付けていません。(面倒なのもありますが。) あまりにも荒らしが酷い場合には、プログラムのパーミッションを実行不可にして掲示板を一時凍結するのが、最良の解決策だと思います。
ID
いちおう実装していますが、プログラム的に無効にしてあります。
クッキーの発行
必要性がなきに等しいので実装する予定はありません
IP記録
2chと違いIPは記録していません。
もし削除依頼がありそれが正当と思えるのなら、きちんと対処してあげてください。
IPが知りたいのなら、サーバ管理者に問い合わせてくださいです。。
複数へのキャップ発行
キャップ★というのは原則的に管理側の証なので、複数発行する必要性がありません。利用者側の証には1人キャップ(トリップ◆)があるのです。
マルチスレッド
2ch型マルチスレッド掲示板は、他のたくさんのサイトで配布してますのでそちらをお使いください。

[一般] ライセンスは?

フリーです。
改変、再配布もご自由にどうぞ。

無補償なので自己責任でお使いください。
基本的な設置方法や改造についてのくだ質はご遠慮ください。。

[一般] 各ファイルの詳細は?

testディレクトリ
プログラム類が設置されるディレクトリ。
2chと互換性を保つためにtestという名前になっています。名前を変更することはできません。
test/bbs.cgi
メインプログラム。
書き込み処理や管理処理を一手に引き受けます。これも2chと互換を保つため名前の変更は不可能です。
bbsディレクトリ
スレッドや過去ログが作成されるディレクトリ。
(設定を行えば名前を変更することができますが、非推奨です)
bbs/index.html
スレッド。
bbs/dat/index.dat
書き込みされたデータが生の状態で収められている、非常に重要なテキストファイル。
このファイルを元にスレッドが生成されます。かちゅ〜しゃが読みに来るファイルでもあります。
かちゅ〜しゃのためにdatディレクトリに置き、改行コードをLFにしておく必要があります。

[管理] HTMLファイルが壊れて、掲示板から管理画面に入れない

この場合は、bbs.cgiを直接叩くことで管理画面に入ることができます。
例を挙げると、管理人キャップのパスワードが「#mokorikomo」の場合は http://サイトのアドレス/cgi-bin/test/bbs.cgi?mokorikomoとアクセスすると、管理画面に入ることができます。

パスワード先頭文字の#を取り除くことがポイント。

[設置] cgi-binディレクトリの中にHTMLファイルを置けないサーバ

いくつかのサーバではcgiディレクトリにHTMLファイルが置けないようです。
この場合は、index.htmlの設置場所を変更する必要があります。

 ○配置例○
    掲示板のアドレス→http://サイトのアドレス/bbs/index.html

 cgi-bin/
     |
     +--bbs/
     |  |
     |  +--dat/index.dat
     |
     +--test/bbs.cgi
            /jcode.pl

 public_html/
     |
     +--bbs/
     |  bbs/index.html
     |  bbs/index.css

また、index.htmlを開いて
><form method="post" action="../test/bbs.cgi">

><form method="post" action="bbs.cgiのURL">
と書き換える必要があります。

HTMLの設置場所を変更した場合は、掲示板の設定で☆マークの項目を必ず変更してください。

[設置] 広告を挿入するには?

一部の無料サーバでは、スクリプト内に広告を埋め込み、ページ上部に表示させる必要があります。
シングルスレッドBBSでは、ローカルルール機能を使うことにより、スクリプトを改造せずに広告を挿入することができます。

[設置] 掲示板のアップグレード方法

  1. 最新のバージョンをダウンロードする
  2. bbs.cgiを開いて、設定を変更する
  3. bbs.cgiだけを上書きアップロードする
  4. 管理画面に入り、スレッドの更新を行う

これでアップグレード完了です。


6. 更新履歴

★マークは重要な仕様変更です。アップグレードする場合は、それぞれ対処してください。

Ver0.54 2003/06/26
Ver0.53 2003/05/30
Ver 0.52 2003/01/24
Ver 0.51 2002/01/19
Ver0.50 2002/01/03
Ver0.45 2002/12/31
Ver0.40 2002/12/28
Ver0.30 2002/11/05

シングルスレッドBBS
http://age.s22.xrea.com/