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

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

1.展開されたファイルの中身を確認する。
バージョンによっても異なりますが、【april.cgi】【admin.cgi】【april.css】【script.js】【april_dat.dtd】があることを確認してください。
2.【april.cgi】の初期設定をする。
1.まず、テキストエディタなどで【april.cgi】を開いてください。正しく表示されない場合には文字コードを【UTF-8】に変更するなどを試してください。
2.次に、ファイルを開いて初めのほうの行数にある、以下の部分の編集をします(以下の順序などは実際は異なっている場合があります)。
#!usr/bin/perl

	$bbstitle='April 掲示板';
	$subtitle='桜さくら。';
	$endtitle='終了済みスレッド一覧です。<br />管理者のみ復旧させることができます。';
	$milink='<a href="../index.html">HOME</a>';
	$datdir='./dat/';#ログ格納庫
	$xmldat='./dat/xml/';#終了済みスレ格納庫(XML
	$deldat='./dat/del/';#除去済みスレ格納庫(XML
#	$thisdir='/newtest/neo/';#このファイルのあるディレクトリまでのパス(cookieで使用

	@admincrypt=('aa:matto#管理人ライク');#F's:crypt#表示する文字列
	@usercrypt=('bb:user#ウー');


	$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
	$wantcrypt=0;#くりぷと必須なら1
	$wantfs=0;#サブキー必須なら1
	$mailok=1;#SkypeID入力おkなら1
	$uriok=1;#uriおkなら1
	$mypage='HP';#uriリンクの文字列

	$maxkaigyo=100;#改行限界
	$maxdata=10000;#文字数限界(半角
	$maxthname=100;#スレッドタイトル限界(半角
	$maxmail=100;#メールアドレス限界(半角
	$maxuri=200;#URI限界(半角
	$maxname=100;#名前限界
	$maxthread=1024;#スレ限界
	$maxres=512;#レス限界
	$maxendlog=1024;#仮終了済みスレ保存数
	$maxadd=10;#追記数限界

	$checkddbyte=20;#(二重投稿確認用バイト数
	$checkddmin=10;#(確保数(多くすると投稿処理が重くなると思う

	$xml='<?xml version="1.0" encoding="UTF-8" ?>';#XML宣言
	$docutype='<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">';#ドキュメントタイプ宣言
	$html='<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja">';#HTMLタグ
	$type='<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />';

	$cssfile='april.css';
	$jsfile='script.js';
	$xml_dtd='april_dat.dtd';
#	$cssfile='green.css';
#	$cssfile='skyblue.css';

	$cookielife=60*24*60*60;#クッキーの保持時間(秒)
以下はそれぞれの説明です(#が名前の前についているところは変更は必要ではありません)。
#!usr/bin/perl	必要に応じて変更してください。

	$bbstitle	掲示板名です。
	$subtitle	掲示板名の下に表示される説明などです。
#	$endtitle	終了済みスレッド一覧を表示したときにタイトルの下に表示されます。
	$milink	タイトルの上に表示される小さなリンクです。
#	$datdir	ログの保存場所です
#	$xmldat	終了済みスレッドの保存場所です。
#	$deldat	除去済みスレッドの保存場所です。
#	$thisdir='/newtest/neo/';#このファイルのあるディレクトリまでのパス(cookieで使用

	@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	二重投稿の確認をする投稿数です。

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

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

#	$cookielife	クッキーの有効期限です。*は掛け算です。初期設定は30日です。
変更が必要な箇所は少ないはずですので、変更が完了したら上書き保存してください。
3.【admin.cgi】の初期設定をする。
1.まず、テキストエディタなどで【april.cgi】を開いてください。正しく表示されない場合には文字コードを【UTF-8】に変更するなどを試してください。
2.次に、ファイルを開いて初めのほうの行数にある、以下の部分の編集をします(以下の順序などは実際は異なっている場合があります)。
#!usr/bin/perl

	$bbstitle='April 掲示板';
	$milink='<a href="../index.html">HOME</a>';

	$tttnum=40;#スレ一覧表示数(+1?
	$ttpnum=40;#過去スレ一覧表示数(+1?
	$newsl=50;#指定なしでスレ表示した際に表示される最新の書き込み数(+1?

	$maxthread=1024;#スレ限界
	$maxres=512;#レス限界
	$maxendlog=1024;#仮終了済みスレ保存数


	$datdir='./dat/';#ログ格納庫
	$xmldat='./dat/xml/';#終了済みスレ格納庫(XML
	$deldat='./dat/del/';#除去済みスレ格納庫(XML

	@admincrypt=('aa:matto#管理人ライク');#F's:crypt#表示する文字列
	$adminpass='abcd';
	$sakujoname='null';
	$sakujobun='削除されました。';
	$mypage='HP';#uriリンクの文字列

	$target=0;#記事中リンク0=同一ページ【推奨】(nun.nuあり)1=フレーム解除同一ページ(nun.nuあり)2=新規ページ(nun.nuあり)3=新規ページ(nun.nuなし非推奨)


	$xml='<?xml version="1.0" encoding="UTF-8" ?>';#XML宣言
	$docutype='<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">';#ドキュメントタイプ宣言
	$html='<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja">';#HTMLタグ
	$type='<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />';

	$cssfile='april.css';
	$jsfile='script.js';
	$xml_dtd='april_dat.dtd';


	$cookielife=60*24*60*60;#クッキーの保持時間(秒)
以下はそれぞれの説明ですが、【april.cgi】にも書かれているところは【april.cgi】と同じ内容にしてください。(#が名前の前についているところは変更は必要ではありません)。
	$adminpass	【admin.cgi】にログインする際のパスワードです。必ず変更してください。
	$sakujoname	レスを削除したときに表示される名前の文字列です。
	$sakujobun	レスを削除したときに表示される名前の文字列です。
変更が必要な箇所は少ないはずですので、変更が完了したら上書き保存してください。
4.アップロードする。
アップロードしてください。
必要に応じて【april.css】なども変更してください。
このページの一番上へ
パーミッションの設定

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

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

	april/	755/777
		april.cgi	755/705
		admin.cgi	755/705
		script.js	644/604
		april.css	644/604
		april_dat.dtd	644/604
		
		dat/	777/707
		
			del/	777/707
				.htaccess	644/604

			xml/	777/707

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

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

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

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

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

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

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

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

英数字のみの本文は投稿できません。

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

ファイル投稿機能は今後実装予定です。

レスコメント機能は実装するかどうかは未定です。

RSSの生成は今後実装予定です。

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

IDによる投稿制限は今後実装予定です。

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

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

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

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

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

s-スクリプト