59Tracker 2.0 beta 仕様書 -------- ■プログラム構成 59Tracker 2.0 beta のプログラム一覧。 config.cgi --- システム情報の設定 view.cgi --- トピック閲覧（年月、年月日） detail.cgi --- トピックの表示 topic.cgi --- トピックの新規作成、編集 file.cgi --- 添付ファイルのアップロード、削除 ps.cgi --- 追記の新規作成、編集、削除 link.cgi --- 関連情報の新規作成、編集、削除 comment.cgi --- コメントの投稿 rcvtb.cgi --- トラックバックの受信 delete.cgi --- コメント、トラックバックの削除 login.cgi --- ログイン logout.cgi --- ログアウト search.cgi --- 公開トピックの検索機能 rebuild.cgi --- 再構築機能（HTMLの再構築、サイトマップ生成） control.cgi --- システム管理機能（拒否リスト、更新ping送信先、デフォルト広告） user.cgi --- ユーザー管理機能（新規登録、ユーザー情報変更） userlist.cgi --- ユーザー管理機能（ユーザー一覧の表示） password.cgi --- パスワード変更 template.cgi --- テンプレートおよびスタイルシート編集機能 tag.cgi --- トピックのタグ編集 bookmark.cgi --- 共有ブックマークの追加と管理 register.cgi --- ユーザー登録 invite.cgi --- 編集者（ユーザー）の招待 summary.cgi --- ブックマーク情報の表示 -------- ■モジュール一覧 59Tracker 2.0 beta のモジュールファイル一覧。 Ad.pm --- デフォルト広告の管理 Archive.pm --- アーカイブページ、新着トピックの管理 Bookmark.pm --- ブックマークデータの管理 Calendar.pm --- カレンダーの作成 Comment.pm --- 新着トピックコメントの入出力 DateTime.pm --- 日時の取得 Logger.pm --- ログ出力 Message.pm --- メッセージ表示 Notify.pm --- メール通知 Search.pm --- 全文検索用インデックスの生成、全文検索 Session.pm --- セッション管理 String.pm --- 文字列操作 Tag.pm --- タグ管理 Topic.pm --- トピックデータの管理、トピック詳細ページの生成 Trackback.pm --- 新着トラックバック、トラックバックの入出力 Ping.pm --- Pingの送信、トラックバックPingの送信 User.pm --- ユーザー情報の入出力 View.pm --- トップページの生成、RSSフィードの生成 Conf.pm --- システム情報の保持 -------- ■データファイル仕様 --- ブックマークデータファイル バージョン：59Tracker 2.0 beta以降 ファイル名：{BMID}bm.data ブックマークデータを管理するためのファイル。 番号 項目 概要 1 BMID ブックマークID 2 TITLE ブックマーク先のページタイトル 3 URL ブックマーク先のページURL 4 SUMMARY ブックマーク先のコンテンツの概要 5 REGISTRANT 登録者 6 DATETIME 登録日時 7 TAGS タグ 8 POINT 累計ポイント（参照1回で1ポイント加算） --- ブックマークコメントデータファイル バージョン：59Tracker 2.0 beta以降 ファイル名：{BMID}bc.data 番号 項目 概要 1 COMMENTID 0:削除されたコメントデータ、1〜の整数値:有効な追記 2 POSTDATE コメントの投稿日 YYYY/MM/DD HH:MM:SS 3 AUTHOR コメントの著者（任意） 4 MAILADDR メールアドレス（任意） 5 HPURL ホームページURL（任意） 6 TEXT コメント本文 7 IPADDR コメント投稿者のIPアドレス 8 EVALUATE 評価点（良い:1、普通:0、悪い:-1） -------- ■システムファイル仕様 --- 招待リストファイル バージョン：59Tracker 2.0 beta以降 ファイル名：invite.txt 未登録の招待者を管理するためのファイル。 番号 項目 概要 1 INVITECODE 招待コード 2 MAILADDR 招待者のメールアドレス --- ユーザー情報ファイル バージョン：59Tracker 2.0 beta以降 ファイル名：userlist.txt ユーザーの一覧とユーザーに関する情報を格納するためのファイル。ユーザー認証に使用する。 番号 項目 概要 1 USERID 英数字 2 PASSWORD 英数字 3 MAILADDR メールアドレス 4 SITEURL WebサイトURL 5 USERNAME ユーザー名 6 AUTH 権限 0:管理者 1:編集者 2:読者 7 STATUS 0:無効 1:有効 8 ADLINK1 広告リンク１（記事下） 9 ADLINK2 広告リンク２（サイドバー） 10 ADLINK3 広告リンク３（記事上） -------- ■59Tracker 2.0 betaのインストールと初期設定 59Tracker 2.0 betaのインストールと設定方法は以下の通りです。 59Tracker 2.0 beta版の書庫ファイル(.zip形式)を取得し、任意のディレクトリで解凍 します。 config.cgi の内容を使用するサーバーの環境に合せて変更します。変更内容については 59Tracker 2.0 beta版 の config.cgi 仕様を参照してください。 FTPソフトなどを使用してWebサーバーに各ファイル(.htaccess、cgi及びAPPLIB配下の モジュール、データファイル、システムファイル等)をアップロードします。転送モード は、アスキー、無変換で転送してください。 $data_dirの配下にsearch、bookmark、tagの各ディレクトリを作成します。 $system_dirの配下にadmin、sessionの各ディレクトリを作成します。 config.cgi の$system_dir、$data_dir、$docroot_dir、$system_dir/admin、 $system_dir配下の *.txtファイル、 トピックデータファイル(topic0.data、newtopic.data)、 XMLファイル(*.xml、*.rdf)をCGIから書き込みできるファイル属性に変更します。また、 添付ファイルを使用する場合は、$docroot_dirの配下にfilesという名前のディレクトリ を作成しします。 拡張子が.cgiのファイルを、すべてCGIとして実行できるファイル属性(755)に変更しま す。 http://search.cpan.org/~byrne/SOAP-Lite-0.60a/ から、SOAP-Lite-0.60a.tar.gzをダ ウンロードし、任意のディレクトリで解凍します。解凍されたディレクトリの中のSOAP、 XMLRPCを59Trackerが動作するディレクトリの配下にFTPソフトを使用してアップロード します。 59Trackerが動作するWebサーバーのURLをブラウザで開き、ユーザーID:adimn、 パスワード:0000でログインします。初期状態のパスワードのままでは誰でも管理者とし てログインできてしまうので、まずadimnのパスワードを変更します。 トピック一覧に表示されているトピック「59Trackerとは」を編集して、あなたのサイト を説明する内容の記事に変更します。 検索結果ページ（adminでログインしたときに表示される画面）のメニューの再構築を クリックし、システムの再構築を行います。 -------- ■59Tracker 2.0 beta の config.cgi 仕様 #!/usr/bin/perl perlのディレクトリを使用するサーバーの環境に合せて指定してください。 $system_dir = "../system"; テンプレート、ユーザー一覧ファイル、トピックカウンターファイル等が格納されるディ レクトリです。Webから見ることのできない階層にディレクトリを作成し、そのディレク トリを相対パスで設定してください。 $data_dir = "../data"; 各種データファイルが格納されるディレクトリです。Webから見ることのできない階層に ディレクトリを作成し、そのディレクトリを相対パスで設定してください。 $docroot_dir = "http://www.aaaaaa.bbb"; 59Trackerが動作するディレクトリで、CGIファイル、HTMLファイル、スタイルシートなど を配置します。 $files_dir = "files"; 添付ファイルを格納するためのディレクトリです。 $notify_mail = 0; メールで通知するかどうか(0:非通知 1:通知)のフラグです。 コメントが書き込まれたとき、トラックバックが付いたときにメールで通知するかどうか 設定します。 $sendmail = '/usr/sbin/sendmail'; sendmailのパスです。用意したサーバーの環境に合せて変更してください。 $to_address = 'aaaabbb@xxxxxx.aa'; コメントやトラックバックがついたときのメールの送り先を指定してください。 $from_address = 'aaaabbb@xxxxxx.aa'; コメントやトラックバックがついたときのメールの送信元を指定してください。 $excerpt_length = 200; トラックバックの要約の長さの最大値を指定してください。 $summary_length = 200; トピック、コメントなどを要約する長さの最大値を指定してください。 $anonymous = "名無しです"; コメント投稿者の名前が未入力の場合に、投稿者名として表示される文字列を設定して ください。 $site_title = "59Tracker Project"; 59Trackerを運用するサイト（ブログ）の名前を設定してください。 $sub_title = "Perlで記述されたシンプルなブログツール"; 59Trackerを運用するサイトのサイトのサブタイトルを指定してください。キャプション やヘーダーの直下に表示されます。 $new_topic_num = 15; トップページに表示するトピック（エントリ）数を指定します。 $open_topic_num = 5; オープンされた状態で表示されるトピック（エントリ）数を指定します。 $new_comment_num = 5; 新着コメント(RECENT COMMENT)として表示する数を指定します。 $new_tb_num = 5; 新着トラックバック(RECENT TRACKBAK)として表示する数を指定します。 $new_bookmark_num = 5; 新着ブックマークとして表示する数を指定します。 $used_bookmark_num = 10; 使用ブックマークとして表示する数を指定します。 $target_default = 0; トピックとブックマークのどちらをデフォルト表示するか設定します。 （0:トピック 1:ブックマーク） $comment_target = "target=\"_blank\""; コメント中のアンカータグでの「target="_blank"」を指定します。 $trackback_target = ""; トラックバックのアンカータグでの「target="_blank"」を指定します。 $link_target = ""; 関連情報のアンカータグでの「target="_blank"」を指定します。 $bookmark_target = "target=\"_blank\""; ブックマークのアンカータグでの「target="_blank"」の指定します。 $result_count = 20; 検索結果ページで1ページに表示するトピック数を指定します。 $date_update = 0; トピックの更新時に日時を更新するかのデフォルト値(0:更新しない 1:更新する)を指定 します。 $bookmark_maxnum = 20; マイビュ-画面に表示するユーザーブックマーク一覧の最大数を指定します。 $index_rebuild = 1; リビルド時に検索用インデックスの再構築を行なうかを指定します。検索用インデックス の再構築は時間がかかる処理ですのでトピック数が多い場合は注意が必要です。 # コメント、トラックバック時の $good_point = 4; # コメントの評価が良い（おすすめ）の場合の加算ポイント。 $normal_point = 1; # コメントの評価が普通、トラックバックの場合の加算ポイント。 $bad_point = -2; # コメントの評価が コメントの評価が悪い場合の加算ポイント。 -------- ■59Tracker 2.0 alpha から beta へのデータ変換方法 59Tracker 2.0 alpha から 59Tracker 2.0 beta へのデータ変換は、tools配下のプログ ラムを使用して行います。 まず、tools配下に59Tracker 2.0 alphaのデータディレクトリ、システムディレクトリを コピーします。 dataconv.pl(元データがUTF-8の場合は不要)、bmconv.pl、userconv.plの順でプログラム を実行します。 データディレクトリ/bookmark/bmindex.data削除します。 データディレクトリをすべて59Tracker 2.0 betaのデータディレクトリにコピーします。 システムディレクトリの*.txtファイルを59Tracker 2.0 betaのシステムディレクトリに コピーします。 --------