トップ
April 掲示板 取扱説明書(設置編)
April 掲示板の設置を考えているウェブサイト管理者様向けの取扱説明書です。
CGIやPerlについての基本的な知識があり、ファイルの編集、アップロード、パーミッションの設定ができる方に利用をお勧めします(不明な場合にはs-スクリプト内のサポート掲示板までお問い合わせください)。
また、April 掲示板の利用には、
①日本語を読むことができ、理解できること。
②正しい利用法を守り、また掲示板利用者にその指導ができること。
③このスクリプトは開発途中のものであり、利用する際、また利用中に起こった損害、損失などの責任を開発者は負えないこと。
④このスクリプト利用中は掲示板下にs-スクリプトへのリンクが表示されること。
に同意していただく必要があります。
同意できない場合には利用を中止してください。
また、この取扱説明書はバージョン0.1.6時点で執筆しています。
右のリンクから必要な説明に進んでください。
初期設定 パーミッションの設定 注意事項 主な仕様・今後の開発予定など 開発情報
初期設定

ここではダウンロードしたファイルを展開して、アップロードするまでに必要な設定を説明します。

1.展開されたファイルの中身を確認する。
ダウンロードしたファイルを解凍すると、以下のファイルが展開されます。
	april/
		help/
			main.html	#設置手順などの説明。このページです。
		omake/	#おまけファイルです。
			blue1.css	#青デザインのCSSです。
			pink1.css	#赤デザインのCSSです。
			font.zip	#画像認証用の別フォントの画像です。
		script/
			dat/	#ログ保存用ディレクトリです。
				del/	#除去済みスレッドのログが保存されます。
					.htaccess	#アクセス制限用ファイルです。
				user/	#ユーザー情報が保存されます。
				xml/	#終了済みスレッドのログが保存されます。
			img/
				***.gif	#画像認証用の画像です。
			lib/	#ライブラリファイルが保存されているディレクトリです。
				cgi-lib.pl	#投稿処理用ライブラリ
				gifcat.pl	#GIF画像連結ライブラリ
				main.cgi	#設定ファイル
			april.css	#CSSファイル
			script.js	#JavaScriptファイル
			april_dat.dtd	#XML用のファイル
			april.xsl	#XML用のファイル
			admin.cgi	#管理者用掲示板管理スクリプト
			april.cgi	#掲示板スクリプト
			img.cgi		#画像認証用画像表示スクリプト
			rss.cgi		#RSS出力スプリクト
			up.cgi		#投稿ファイル表示スクリプト
		readme.txt	#その他
2.【april/script/lib/main.cgi】の初期設定をする。
1.まず、テキストエディタなどで【april/script/lib/main.cgi】を開いてください。正しく表示されない場合には文字コードを【UTF-8】に変更するなどを試してください。
2.次に、ファイルを開いて初めのほうの行数にある、以下の部分の編集をします(以下の順序などは実際は異なっている場合があります)。
##########     変更必須部分     ##########


	$bbstitle='April 掲示板';
	$subtitle='桜さくら。';
	$endtitle='終了済みスレッド一覧です。
管理者のみ復旧させることができます。'; $milink='HOME'; $datdir='./dat/';#ログ格納庫 $xmldat='./dat/xml/';#終了済みスレ格納庫(XML $deldat='./dat/del/';#除去済みスレ格納庫(XML $ipdir='./dat/user/';#各種情報 @admincrypt=('aa:matto#管理人');#F's:crypt#表示する文字列 @usercrypt=('bb:user#ウー'); $adminpass='abcd'; ########## 任意変更部分 ########## $sakujoname='null'; $sakujobun='削除されました。'; $tttnum=40;#スレ一覧表示数(+1? $ttpnum=40;#過去スレ一覧表示数(+1? $newsl=50;#指定なしでスレ表示した際に表示される最新の書き込み数(+1? $target=0;#記事中リンク0=同一ページ【推奨】(nun.nuあり)1=フレーム解除同一ページ(nun.nuあり)2=新規ページ(nun.nuあり)3=新規ページ(nun.nuなし非推奨) $wantname=0;#名前必須なら1 $nanashi='ななし';#名前の入力がなかったときの表示 $wantcrypt=0;#くりぷと必須なら1 $wantfs=0;#サブキー必須なら1 $mailok=1;#SkypeID入力おkなら1 $uriok=1;#uriおkなら1 $mypage='HP';#uriリンクの文字列 $fileok=1;#ファイル投稿を許可するなら1 @imgfiletype=('jpg','jpeg','gif');#画像として認識する拡張子一覧#####PNG形式は表示できない模様 @umimgfiletype=('png','zip','lzh','rar');#画像以外のファイルとして認識する拡張子一覧 $maxkaigyo=100;#改行限界 $maxdata=10000;#文字数限界(半角 $maxthname=100;#スレッドタイトル限界(半角 $maxmail=100;#メールアドレス限界(半角 $maxuri=200;#URI限界(半角 $maxname=100;#名前限界 $maxthread=1024;#スレ限界 $maxres=512;#レス限界 $maxendlog=1024;#仮終了済みスレ保存数 $maxadd=10;#追記数限界 $checkddbyte=200;#(二重投稿確認用バイト数 $checkddmin=5;#(確保数(多くすると投稿処理が重くなると思う $checktime=120;#画像認証間隔(秒 $useics=1;#投稿間隔が短い場合とファイルを投稿する場合に画像認証を利用するなら1 $xml='';#XML宣言 $docutype='';#ドキュメントタイプ宣言 $html='';#HTMLタグ $type=''; $cssfile='april.css'; $jsfile='script.js'; $xml_dtd='april_dat.dtd'; $cookielife=60*24*60*60;#クッキーの保持時間(秒) $hankaku=1;#半角英数字のみの投稿の制限 $maxitem='15';#RSSitem要素数の上限
以下はそれぞれの説明です(#が名前の前についているところは変更は必要ではありません)。
	$bbstitle	掲示板名です。
	$subtitle	掲示板名の下に表示される説明などです。
#	$endtitle	終了済みスレッド一覧を表示したときにタイトルの下に表示されます。
	$milink	タイトルの上に表示される小さなリンクです。
#	$datdir	ログの保存場所です
#	$xmldat	終了済みスレッドの保存場所です。
#	$deldat	除去済みスレッドの保存場所です。

	@admincrypt	管理者の使うクリプトです。【F's:material#表示する文字列】の形式で書いてください。
			認証の際に使われますので必ず変更してください。
			また、複数設定する場合は、('F's:material#表示する文字列','F's:material#表示する文字列')のようにしてください。
	@usercrypt	一般の利用者が利用できるクリプトです。
			基本的には上と同様です。


#	$tttnum	スレッド一覧で一画面に表示するスレッドの数です。
#	$ttpnum	終了済みスレッド一覧で一画面に表示するスレッドの数です。
#	$newsl	一度に表示されるレスの数です。+1されているのは秘密です。

#	$target	リンクのtargetの設定です。変更したい場合は変更してください。

#	$wantname	1にすると名前がないとエラーになります。
#	$wantcrypt	1にするとmaretialがないとエラーになります。
#	$wantfs	1にするとF'sがないとエラーになります。
#	$mailok	スカイプのIDの入力、表示を許可します。0だと不許可。
#	$uriok	アドレスの入力を許可します。0だと不許可。
#	$mypage	上のアドレスに飛ぶためのリンクの文字列を設定します。

#	$maxkaigyo	投稿できる最大の改行数を設定します。
#	$maxdata	投稿できる最大の文字数を設定します。半角計算です。
#	$maxthname	作成できるスレッド名の最大の文字数を設定します。半角計算です。
#	$maxmail	投稿できる最大のメールアドレスの文字数を設定します。
#	$maxuri	投稿できる最大のURIの文字数を設定します。
#	$maxname	投稿できる最大の名前の文字数を設定します。半角計算です。
#	$maxthread	作成できるスレッドの最大数を設定します。
#	$maxres	投稿できるレスの最大数を設定します。
#	$maxendlog	仮終了スレッドとして保存する最大のスレッド数を設定します。
#	$maxadd	投稿できる最大の追記数を設定します。

#	$checkddbyte	二重投稿を確認するデータ量です。
#	$checkddmin	二重投稿の確認をする投稿数です。
#	$checktime	画像認証をする最大投稿間隔です。単位は秒。
#	$useics	画像認証を利用するかどうかの設定です。

#	$xml	XML宣言です。
#	$docutype	DOCTYPE宣言です。
#	$html	htmlタグです。
#	$type	文字コードの設定です。

	$cssfile	スタイルシートの場所を相対パスで指定します。
#	$jsfile	JavaScriptの書かれたファイルを指定します。
#	$xml_dtd	XMLの作成の際に必要なデータファイルです。

#	$cookielife	クッキーの有効期限です。*は掛け算です。初期設定は30日です。

#	$hankaku	半角英数字のみの投稿を規制する設定です。
	
#	$maxitem	RSSでのitem要素の保持数の設定です。
変更が必要な箇所は少ないはずですので、変更が完了したら上書き保存してください。
3.他のスクリプトの初期設定をする。
1.まず、テキストエディタなどで【april/script/april.cgi】などのスクリプトを開いてください。正しく表示されない場合には文字コードを【UTF-8】に変更するなどを試してください。
2.次に、ファイルを開いて初めのほうの行数にある、以下の部分の編集をします(以下の順序などは実際は異なっている場合があります)。
#!usr/bin/perl
各サーバーなどによって設定が異なりますので確認してください。
4.アップロードする。
アップロードしてください。
必要に応じて【april/script/april.css】なども変更してください。
このページの一番上へ
パーミッションの設定

ここでは各ディレクトリ、ファイルのパーミッションの推奨設定を紹介します。
各サーバーによって設定は異なります。

ダウンロードしたファイルを展開すると、下のような構造になっています。
下の一覧のディレクトリ名、ファイル名の右に書かれている数字が推奨パーミッション設定です。

	script/	755/777
			dat/	777/707
				del/	777/707
					.htaccess	644/604
				user/	777/707
				xml/	777/707
			img/	755/705
				***.gif	644/604
			lib/	755/705
				cgi-lib.pl	644/604
				gifcat.pl	644/604
				main.cgi	644/604
			april.css	644/604
			script.js	644/604
			april_dat.dtd	644/604
			april.xsl	644/604
			admin.cgi	755/705
			april.cgi	755/705
			img.cgi		755/705
			rss.cgi		755/705
			up.cgi		755/705

パーミッションの設定が終わったら【april.cgi】にアクセスすると利用することができます。
掲示板内では【april.cgi?read】に取扱説明書がありますのでそちらもご覧ください。

このページの一番上へ
注意事項

現段階ではいくつかの機能が実装されていません。そのため今後の開発しだいでログファイルが利用できなくなる場合があります。

仮終了(投稿不可能になります)・本終了(XMLファイルとして格納されます)・除去(XMLファイルとして保存され、閲覧不可能なディレクトリに移動します)を十分に確認してから作業をしてください。

本終了・除去でXMLとなったファイルは元には戻せません(ビュアーは開発予定ですが時期は未定です)。

このページの一番上へ
主な仕様・今後の開発予定など

スレッド作成の際にパスワードを設定すると追記やスレッドの仮終了が可能です。

スカイプIDを入力すると名前の文字列がスカイプのチャット欄を開くリンクになります。

英数字のみの本文を規制することができます。

日本語のアドレスに対する自動リンクは対応していません。

ファイル投稿機能が実装されました。

RSSの生成が実装されました。

終了済みスレッドがXML+XSLによって表示されるようになりました。april.cssの位置・名前を変更した場合はXSLファイルの設定も変える必要があります。

スタイルシートのユーザーによる変更は今後実装予定です。

IDによる投稿制限が実装されました(管理用スクリプトadmin.cgiから設定ができます)。

ユーザーによるクリプトの設定は今後実装予定です。

複数同時レス削除は今後実装予定です。

このページの一番上へ
開発情報
	開発環境
		XAMPP (basic package) version 1.6.4
			Apache 2.2.6
		Active Perl5.8.8
		ez-HTML 7.46
		TeraPad 0.89a
		Sleipnir 2.6.0
	開発者情報
		マット
		s-スクリプト
このページの一番上へ

不具合、不明な点などを発見しましたら、s-スクリプト内のサポート掲示板までおねがいします。

改造なども歓迎ですが、無断での再配布はご遠慮ください。

s-スクリプト