59bbs 1.3 仕様書

----------

■59bbs 1.3 プログラム構成(CGI)

59bbs 1.3のプログラム一覧です。

comment.cgi   --- コメントの投稿
config.cgi    --- システム情報の設定
control.cgi   --- システム管理機能（フィルター、デフォルト広告）
delete.cgi    --- コメント、トラックバックの削除
detail.cgi    --- トピック管理画面の表示
link.cgi      --- 関連情報の追加、編集、削除
logout.cgi    --- ログアウト
login.cgi     --- ログイン
newtopic.cgi  --- トピックの新規作成（非ログイン）
password.cgi  --- パスワード変更
rcvtb.cgi     --- トラックバックの受信
rebuild.cgi   --- 再構築機能（HTMLの再構築、サイトマップ生成）
register.cgi  --- ユーザー登録機能
search.cgi    --- トピックの検索、登録ユーザー用管理画面（トピック一覧、タグクラウド）
template.cgi  --- テンプレートおよびスタイルシート編集機能
topic.cgi     --- トピックの新規作成、編集（ログイン）
user.cgi      --- ユーザーデータ編集機能（新規登録、ユーザー情報変更）
userlist.cgi  --- ユーザー一覧の表示
view.cgi      --- トップページ、アーカイブページの表示

----------

■59bbs 1.3 モジュール構成

59bbs 1.3 のモジュールファイルは以下の通りです。

Ad.pm          --- デフォルト広告の管理
Archive.pm     --- トピック一覧の表示、更新情報の管理
Calendar.pm    --- カレンダーの作成
DateTime.pm    --- 日時の取得
Logger.pm      --- ログ出力
Message.pm     --- メッセージ表示
Notify.pm      --- メール通知
Ping.pm        --- Ping送信（トラックバック、更新Ping）
Search.pm      --- 全文検索用インデックスの生成、全文検索、タグ検索
Session.pm     --- セッション管理
String.pm      --- 文字列操作
Tag.pm         --- タグ情報の入出力
Topic.pm       --- トピック情報の管理、トピック詳細ページの生成、トピックに付属する情報の管理
User.pm        --- ユーザー情報の入出力
View.pm        --- トップページ、アーカイブページの生成、RSSフィードの生成
Comment.pm     --- コメントデータの入出力(1.2で追加)
Trackback.pm   --- トラックバックデータの入出力(1.2で追加)
Conf.pm        --- システム情報の保持(1.2で追加)

----------

■59bbs 1.3 テンプレートファイル

59bbs 1.3 で使用しているテンプレートファイルは以下の通りです。

adlink.htmlt   --- デフォルト広告設定画面
control.htmlt  --- システム情報編集画面
delete.htmlt   --- 削除確認画面(コメント、トラックバック)
detail.htmlt   --- トピック詳細ページ
index.htmlt    --- トップページ、アーカイブページ
link.htmlt     --- 関連情報登録、編集画面
login.htmlt    --- ログイン画面
newtopic.htmlt --- 新規トピック作成画面(未ログイン)
notify.htmlt   --- メール送信通知画面
password.htmlt --- パスワード変更画面
register.htmlt --- ユーザー登録画面
search.htmlt   --- 検索結果ページ
template.htmlt --- テンプレート編集画面
topic.htmlt    --- トピック作成、編集画面
user.htmlt     --- ユーザー登録、編集画面
userlist.htmlt --- ユーザー管理画面

----------

■59bbs 1.3 のインストール方法

59bbs 1.3 のインストールと初期設定の方法は以下の通りです。

1.書庫ファイルの取得と解凍
59bbs 1.3 の書庫ファイル(zip形式)を取得し、任意のディレクトリで解凍します。

2.config.cgiの変更
config.cgi の内容を使用するサーバーの環境に合せて変更します。変更内容については 59bbs 1.3 config.cgi 仕様を参照してください。

3.ファイルのアップロード
FTPソフトなどを使用してWebサーバーに59bbsのファイル(.htaccess、cgi及びAPPLIB配下のモジュール、データファイル、システムファイル等)をアップロードします。転送モードは、アスキー、無変換で転送してください。

4.ディレクトリの作成
config.cgiの$data_dirの配下にsearch、tagの各ディレクトリを作成し属性を755に変更します。また、$system_dirの配下にadmin、sessionの各ディレクトリを作成し属性を755に変更します。

5.ファイル属性の変更
config.cgi の$system_dir、$data_dir、$docroot_dir 配下の *.txtファイル、
トピックデータファイル(topic0.data、newtopic.data)、HTMLファイル(index.html、detail.html)、XMLファイル(*.xml、*.rdf)をCGIから書き込みできるファイル属性(ディレクトリ:755、各種ファイル:666)に変更します。
また、config.cgi以外の拡張子が.cgiのファイルを、すべてCGIとして実行できるファイル属性(755)に変更します。

6.外部モジュールのアップロード
59bbsを動作させるには外部モジュールとして、CGI、Jcode、MIME、SOAP-Lite等が必要です。
日本でサービス提供してしているレンタルサーバーであれば、CGI、Jcode、MIMEについてはインストールされていないということはまずないようですが、
SOAP-Liteについてはインストールされていないことが多いようです。

SOAP-Liteがインストールされていない場合は、http://search.cpan.org/~byrne/SOAP-Lite-0.60a/ から、SOAP-Lite-0.60a.tar.gzををダウンロードし、任意のディレクトリで解凍します。解凍されたディレクトリの中のSOAP、 XMLRPCをFTPソフトを使用してドキュメントルートととなるディレクトリにアップロード(転送モード：アスキー、無変換)します。

7.管理者パスワードの変更
59bbsが動作するWebサーバーのURLをブラウザで開き、ユーザーID:adimn、パスワード:0000でログインします。初期状態のパスワードのままでは誰でも管理者としてログインできてしまうので、adimnのパスワードを変更します。

8.最初のトピックの変更
検索結果ページ（管理画面）に表示されているトピックを編集して、あなたのサイトを説明する内容の記事に変更します。

9.サイトの再構築
検索結果ページ（管理画面）のメニューの再構築をクリックし、サイトの再構築を行います。

----------

■59bbs 1.3 のconfig.cgi 仕様

59bbs 1.3 の config.cgi で設定される設定値の説明です。

#!/usr/bin/perl
perlのディレクトリを使用するサーバーの環境に合せて指定します。

$system_dir = "../system";
テンプレート、ユーザー一覧ファイル、トピックカウンターファイル等が格納されるディレクトリです。
Webディレクトリの外側にディレクトリを作成し、そのディレクトリを相対パスで設定します。

$data_dir = "../data";
各種データファイルが格納されるディレクトリです。
Webディレクトリの外側にディレクトリを作成し、そのディレクトリを相対パスで設定します。

$docroot_dir = 'your site url';
59bbsが動作するディレクトリで、CGIファイル、HTMLファイル、スタイルシートなどを配置します。

$notify_mail = "0";
メールで通知するかどうか(0:非通知 1:通知)のフラグです。
コメントが書き込まれたとき、トラックバックが付いたときにメールで通知するかどうか設定します。

$sendmail = '/usr/sbin/sendmail';
sendmailのパスです。用意したサーバー環境に合せて変更します。

$to_address = 'your mail address';
コメントやトラックバックがついたときのメールの送り先を指定します。

$excerpt_length = 200;
トラックバックの要約の長さの最大値を指定します。

$summary_length = 150;
トピック、コメントなどを要約する長さの最大値を指定します。

$anonymous = "名無しさん";
トピック及びコメントの投稿者名が未入力の場合に、投稿者名として表示される文字列を設定します。

$site_title = "59bbs";
59bbsを運用するサイトの名前を設定します。

$sub_title = "匿名で気軽に投稿できるブログ風掲示板";
59bbsを運用するサイトのサブタイトルを指定します。

$new_topic_num = 10;
トップページに表示するトピック（エントリ）数を指定します。

$comment_target = "target=\"_blank\"";
コメント中のアンカータグでの「target="_blank"」を指定します。

$trackback_target = "target=\"_blank\"";
トラックバックのアンカータグでの「target="_blank"」を指定します。

$link_target = "";
関連情報のアンカータグでの「target="_blank"」を指定します。

$result_count = 20;
検索結果、マイビューで表示するトピック数を指定します。

$date_update = 0;
トピック更新時に日時を更新するかどうかを指定します。 0:更新しない 1:更新する

$add_update = 0;
トピック更新時に更新情報に追加するかどうかを指定します。 0:追加しない 1:追加する

$index_rebuild = 0;
リビルド時に検索用インデックスの再構築を行なうかを指定します。 0:再構築しない 1:再構築する

$good_point = 4;
コメントの評価が良い場合の加算ポイント

$normal_point = 1;
コメントの評価が普通、トラックバックの場合の加算ポイント

$bad_point = -2;
コメントの評価が悪い場合の加算ポイント

----------