main

Pai-board設定方法

Preludeが定めた標準の画像を用い、標準のディレクトリ構成を用いる方法(デフォルト設定:初心者推奨)と、自分で画像などをカスタマイズする拡張設定の二通りで説明します。なお、ある程度perlスクリプトとhtmlの分かる方などのための上級カスタマイズのため資料も用意してあります。テクニカル情報を参照してください。

ファイル内容

実行に必要な全ファイルとパーミッションの設定は以下の通りです。

ファイル名パーミッション目的
paires.cgi755(実行可能)メインCGI。投稿を担当
paidel.cgiメンテナンスCGI
paiboard.dat666(書き込み可能)データファイル(投稿記事保存)
paicount.datデータファイル(投稿者数カウント)
paitree.datデータファイル(投稿一覧表示用)
paitree.htmlCGIが更新するhtml(投稿一覧表示)
paiall.htmlCGIが更新するhtml(全投稿記事表示)
paiboard.html変更なしメインhtml
paidel.htmlメンテナンスhtml
paiall.txthtml雛形ファイル
paidel.txt
painew.txt
paires.txt
paitree.txt
pre.gif画像(Preludeアイコン)
home.gif画像(home)
main.gif画像(main)
back.gif画像(背景)

実行にはjcode.plも必要です。どこかから取ってきてパーミッション755(実行可能)で転送してください。

以上のファイルの他に以下のファイルがlzhファイルに納められています。標準設定ではすべて必要のないファイルですが、拡張設定では[trouble.html]が必要になります。

ファイル名目的備考
index.htmlヘルプ目次
cgiset.html設定説明(このファイル)
help.htmlPai-bordの使い方修正してご自分のホームページに設置すると良いでしょう
delete.htmlメンテナンスCGIも使い方
tec.htmlテクニカル情報CGIを改造されたい方向けの情報です。
trouble.htmlエラー詳細CGIが出力したエラーの情報です。
pai.cssスタイルシートヘルプファイル(上の6つ)に適応されるスタイルシートです。

デフォルト設定

Preludeの標準画像を用い、すべてのファイルが同じディレクトリにあるという想定の元で設定します。この設定が最も簡単です。

1.CGIスクリプトの変更

まず、paires.cgiをメモ帳などテキストエディタで開きます。1行目にあるperlへのパスをまず変更します。perlの場所はサーバー管理者にお問い合わせください。次に、最初の部分にある重要設定を変更します。以下がその説明です。paidel.cgiもpaires.cgiと全く同様に設定してください。コピー&ペーストすると良いかもしれません。

CGIのURL

['']の間にCGIへのURLを指定します。相対URLを使用せず、絶対URL(http:://から始まる)を使用してください。

リンク

['']の間にhtml文書へのURLを指定します。これも絶対URLを推奨します。

掲示板のタイトル

掲示板のタイトルです。お好きな名前を付けてください。

管理者のメールアドレス

管理者であるあなたのメールアドレスを入力してください。CGIにエラーが発生した場合の送り先です。

管理者削除用パスワード

ふさわしくないコメントなどを削除するためのパスワードです。

2.html文書の変更

CGIが更新しないhtml文書はそのまま使われるので変更する必要があります。変更するファイルは「paiboard.html」と「paidel.html」の2つです。それぞれ、タイトルとリンクを書き直してください。

paiboard.html

htmlを書いたことのある方ならすぐおわかりだと思いますが、タイトル部分が[Pai-board (C)Prelude]ですので、ご自分の掲示板のタイトルへ変更ください。

paidel.html

同じくタイトルを変更ください。framesetで上部に[paidel.cgi]、下部に[paiall.html]があります。一部のサーバーではCGIへは絶対URLを設定した方が無難です。心配の方は絶対URLに書き換えてください。(例えば、InterQMemebersの場合はCGIへは専用のcgi.members.interq.or.jpから始まるURLでアクセスしないと動作しません)

3.転送

CGIが実行可能な領域にすべてのファイル(jcode.plも含む)を同一のディレクトリに転送します。ftpソフトをご利用ください。

4.パーミッション変更

ファイル内容を参照してパーミッションをそれぞれ変更します。

5.稼動開始

はじめに誰かが投稿しないといけません。[paires.cgi]にアクセスして(ブラウザのアドレスに設置したpaires.cgiへのURLを記入する)一番はじめの投稿をして、稼動させてください。

うまく、投稿が処理されると[paiboard.html]、つまりメインに自動的に切り替わり投稿内容が表示されます。これで稼動開始です。お疲れさまでした。リンクは、[paiboard.html]を指定してください。

拡張設定

標準画像を用いない、CGIと各ソースを別の場所に置くなどをやる場合の設定方法をご説明します。

1.CGIスクリプトの変更

まず、paires.cgiをメモ帳などテキストエディタで開きます。1行目のperlへのパスと、3行目にあるjcode.plへのパス「require './jcode.pl';」を変更します。次に、最初の部分にある重要設定を変更し、拡張設定を変更します。以下がその説明です。重要設定の詳細は標準設定を参照してください。拡張設定もpaidel.cgiとpaires.cgiは全く同一である必要があります。

最新投稿数

最新x投稿にNewを表示します。

表示コメント

保存する最大のコメント数です。表示されるのもこのコメント数です。ただ、厳密にこの数だけ残すわけではありません。Pai-Boardはツリー形式を基本にしていますので、ここで指定したコメント数を越えた場合、もっとも古い親コメントと「その返信記事すべて」が削除されます。ですから、2,3個、多めに設定するとよいでしょう。

エラー解説

CGIによってエラーが発生した場合(ファイルが足りないなど)Pai-boardはエラーメッセージを出力します。そのとき、「詳細」というリンクがあり、エラーメッセージの細かな説明ページへジャンプすることが期待されています。そのURLを記入します。デフォルトではPreludeにあるエラー解説ページへリンクされていますが、デザインなどを自分のホームページと一致させたいなどという場合は、エラー解説[trouble.html]を参考にエラー詳細を記述し、そのファイルへのリンクへ書き直してください。絶対URL推奨です。

データファイル

CGIによって更新されるファイルへのパスを記述します。CGIのディレクトリを基準にパスを記述してください。

HTML雛形ファイル

CGIによって参照されるHTMLの雛形ファイルへのパスを記述します。これらのファイルをカスタマイズしたい方はテクニカル情報を参照してください。

body開始タグ

Pai-boardに関連するすべてのhtml文書に適応されるBODY開始タグです。['']の中に記述してください。特に、backgroundに背景画像を指定することでPrelude標準画像を使用せず自分の好きな画像が使えます。もちろん、画像を使いたくない場合は指定しないことにより背景画像をなくすことができます。

ボタン画像

Pai-boardから自分のホームページ戻るボタン画像と、Pai-boardの投稿などのページからPai-boardのメインのページに戻るボタン画像を指定します。自分の好きな画像を設定する事ができます。['']を書き換えます。ここで、imgタグを文字に書き換えることで画像ではなく文字をリンクとして用いることができます。

Preludeアイコン

Preludeのアイコンです。画像自体は修正禁止ですが、画像のディレクトリをカスタマイズしたいときに変更してください。

Cookie名

使用するCookieの名前です。同一サイト内で同じ名前のCookieを用いる2種類のCGIを用いるとCookieの機能がうまく動作しない可能性があります。ユニークな名前を付けてください。

Cookieの保存日数

ブラウザがPai-boardのCookieを保存する日数です。

2.残りの設定

拡張設定の残りの設定手順は標準設定通りです。そちらを参照してください。ただし、転送は今指定したディレクトリ構成に合うようにしなければなりません。