Airemix/HP_CGI/Mireille

Airemix Mireille Board System

 ■■■■■■■

: The Intoroduction to Mireille :

◇Mireilleの特徴

◇設置の説明書

この説明ファイルは、HTMLのみで構成されたサイトは作れる方、
とりあえず圧縮解凍、FTPによるアップロードは知っている人に書かれています
「ホームページって何？どうやって作るの？」という方は想定していません
そこまで範囲を広げると「設置の説明書」のレベルを越えてしまうため、ご了承ください
また、このCGIでは漢字コードにEUC-JPを使用しているため、Windows標準のメモ帳では読めません
TeraPad、秀丸エディタ、さくらエディタなどのEUC-JPも読めるエディタをお使いください
CGI自体を編集する場合は、以上に挙げたエディタに搭載されている、
「色づけ機能」を使うと効率が格段に上がるとおもいます

ちなみに、以上に挙げたエディタを使っても、文字化けして表示される場合は、
メニューバーの「ファイル」→「漢字指定コード指定再読み込み」→「EUC」（TeraPadの場合）
としたり、「ファイル」→「開く」で、「漢字コード」を「EUC」にして開いたりしてください

TeraPadの場合には、オプション設定自体を変更して、
「表示」→「 オプション」→「ウィンドウ/漢字コード」タブ→「漢字コード」グループで、
・漢字/改行コードを自動認識する　にチェックをつける
・下の二つで両方「読み込み時の○○コードと同じ」を選ぶ
とすれば、自動で文字化けしないようにしてくれます

  1. DLから解凍まで

    まずダウンロードした圧縮ファイル（例えばMirR1233.ZIP）を適当なフォルダ内に解凍します
    この時フォルダ内には
    パス備考
    /Mireille.txt MireilleのReadme
    /Mireille.html Mireilleの説明書
    /log/ ログ保存フォルダ
    /log/0.cgi 記事情報ファイル
    /init/ 最初設置するときに使うファイル群
    /init/index.cgi CGI起動ファイル兼設定
    /init/icon.txt アイコンリスト
    /init/icon.html アイコンリスト
    /init/style.css スタイルシート
    /scpt/ スクリプト本体のファイル群
    /scpt/core.cgi Mireille本体
    /scpt/style.pl Mireilleスタイル設定
    /scpt/help.pl ヘルプ
    /scpt/artnavi.js 記事ナビJavaScript
    /opti/ 設置してもしなくてもいいファイル群
    /opti/manage.cgi 管理CGI
    /opti/convert12.cgiログファイルを他形式から1.2形式に変換する
    /opti/notify.pl メールによるお知らせ機能を使うときに設置する
    /opti/.htaccess .htaccessファイル
    となっているはずです

  2. 初期設定

    まずindex.cgiを開いて一番最初の一行を設定します
    #!/usr/local/bin/perl
    #!/usr/bin/perl
    のどちらかで大部分は動くと思います
    （Biglobeでは #!/usr/local/bin/perl5 です）
    設定項目は他にもありますが、とりあえずまずここだけ設定してちゃんと動くか試してください

  3. FTPからアップロード

    設置したいサーバーのディレクトリ（例えばbbs/）に
    パス属性用途
    /bbs 777(755)掲示板のディレクトリ
    /bbs/log 777(755)ログ保存ディレクトリ
    /bbs/log/0.cgi 666記事情報ファイル
    /bbs/index.cgi 755(700)CGI起動ファイル兼設定
    /bbs/core.cgi 644Mireille本体
    /bbs/style.pl 644Mireilleスタイル設定
    /bbs/artnavi.js644記事ナビ
    /bbs/icon.txt 666アイコンリスト
    /bbs/icon.html 666アイコン見本
    /bbs/help.pl 644ヘルプ
    /bbs/style.css 666スタイルシート
    のように設置します
    ちなみに、
    ・ここに挙げたものは一般的な場合で、パーミッションがサーバー側から指定されていればそれを最優先してください、
    ・ErrorScreenがでても、「Can't write...」系でなければパーミッションはあっています
    ・「500InternalServerError」か「Can't write...」系のエラーがでたら、パーミッションが原因かもしれません

    これで、おそらく、もう動作する状態になっているはずです
    最初は0.cgiの内容が表示されていますが、これは何か新しい書き込みがあると、
    自動的に表示されないようになるのでご安心を
    さっそく、テスト書き込みをしてみましょう

    もし動かなかった場合は Mireilleの設置でつまづいたら を参照してください

    テストがちゃんとできるようになれば、この掲示板を設置するのに最低限必要なことは終わりです
    サイト本体からリンクをはって使用してください♪

    ただ、この状態ではアイコンの設定は行っていないため、当然アイコンは表示されません
    アイコンの設定についての説明は Mireilleの注意事項 - アイコン を参照してください
    またCSSを使ったデザインの変更や、style.plにまで踏み込んだ細かい改造については、
    Mireille.htmlやMireille.txtを隅々まで見るとヒントが載っているかもしれません

  4. もうちょっと細かく設定とか、さらには改造とか

    Mireilleをより細かくカスタマイズしたいときは、Mireille.txtの内容も参照してください
    Mireilleでの処理に関する情報などはMireille.txtにしか書いてないものも多いです
    core.cgiに対しての要望はMireille.txtを見てからにしていただけると、成瀬側もやりやすいので

    一般的な事例に関しては以下のとおりです
    • アイコンまわり
      アイコンリスト(icon.txt)に関しては Mireilleの注意事項 - アイコン や、
      Mireille.txtを参照してください
      アイコンリスト(icon.txt)からアイコン見本(icon.html)を生成するには、
      管理CGIの「アイコン見本の更新」を使います

      注意！
      アイコンを調達する際には、必ず製作者のサイトから頂いてきてください
      他の掲示板のアイコンをそのまま拝借するのは好ましいことではありません
      また欲しいアイコンが既に配布が終了されている場合は潔くあきらめてください＾＾；；
    • 外部CSSまわり
      core.cgi,style.pl自体のソースや、Mireilleの生成したHTMLソース、HTMLおよびCSSのリファレンスなどと、
      にらめっこしながらがんばってください（ぉ
      core.cgiやstyle.plのCSSのクラス構造が不明瞭だったりおかしい、修正するべきだという場合は、
      成瀬に説明を求めるか、改善したものを教えてください
      それを元にこちら側でも修正します
    • style.pl
      MireilleのPerlスクリプトの中で、デザインに関連するものを抽出したファイルです
      お好みに合わせて改造し、配布することができます
      また、index.cgi内でcore.cgiより後に読み込んでいるため、
      core.cgiのサブルーチンを上書き（オーバーライド）することも可能なため、
      応用次第で全く違う掲示板のようににしてしまうこともできます
    • index.cgi後半の処理部、core.cgi、help.pl、manage.cgiなど
      改造するのは自由ですし、規定の範囲内で改造したものを配布することもできます
      ただ、多くの利用者がこれらのCGIを変更したいと思う、という状態は、
      「バグだ」と判断しているので、変更点を教えてくだされば、標準で変更するかもしれません
    • Mireilleを複数設置する際の横着
      一つのcore.cgi, style.pl, style.css, help.pl, artnavi.jsを兼用することが出来ます
      パス属性用途
      /bbs 755(777)掲示板のディレクトリ
      /bbs/log 755(777)ログ保存ディレクトリ
      /bbs/log/0.cgi 666記事情報ファイル
      /bbs/index.cgi 755(700)CGI起動ファイル兼設定
      /bbs/core.cgi 644Mireille本体
      /bbs/style.pl 644Mireilleスタイル設定
      /bbs/artnavi.js644記事ナビ
      /bbs/icon.txt 666アイコンリスト
      /bbs/icon.html 666アイコン見本
      /bbs/help.pl 644ヘルプ
      /bbs/style.css 666スタイルシート
      /bbs2 755(777)掲示板のディレクトリ
      /bbs2/log 755(777)ログ保存ディレクトリ
      /bbs2/log/0.cgi666 記事情報ファイル
      /bbs2/index.cgi755(700)CGI起動ファイル兼設定
      /bbs2/icon.html666アイコン見本
      例えば上のように設置した上で、/bbs2/index.cgi内の設定を
      #アイコンリスト
$CF{'icls'}='../bbs/icon.txt';
#スタイルシート
$CF{'style'}='../bbs/style.css';
#記事ナビJavaScript
$CF{'navjs'}='../bbs/artnavi.js';
#ヘルプファイル
$CF{'help'}='../bbs/help.pl';

require '../bbs/core.cgi';
require '../bbs/style.pl';
      などとすれば、CGIバージョンアップ時には/bbs/にあるcore.cgiなどを入れ替えればいいだけになります
      実際にAiremixでも/bbs/にあるCGIをサイト内の何ヶ所かで、この方法によって共有して使っています

  5. 管理CGIの設置

    よりMireilleを有効に使うためのCGI、Manage.cgiの説明です
    必須ではないので、使いたい人だけ設置しましょう

    まずmanage.cgiを開いて、一行目を設定します
    その後21行目の$AM{'pass'}を設定してください
    設定したらFTPで以下のように設置します
    この際必ずファイル名を変更してアップロードしてください
    /bbs/E36Vj4tGiHQ.cgi 755(700) 管理CGI（'E36Vj4tGiHQ.cgi'にファイル名を変更した場合）
    使用法は表示にしたがってください
    わかりにくいところがあれば、言ってください
    表記を変えるなり、これに書き加えるなりします

    ちなみに、管理CGIの設定機能を使っていて「Can't write...」というエラーが出た場合は、
    該当するファイルのパーミッションを、上のほうの説明の、括弧内のものに変えみてください
    ちゃんと書き込めれば設定があっていると断定してよいでしょう

    ※警告！
    アップロードする際には、ファイルの名前を予測のつかない名前、
    （例えばE36Vj4tGiHQ.cgiのような）に変更してからアップロードしてください
    このCGIは破壊的な機能（index.cgiの設定やログの削除など）持っているので、
    悪意を持った人に場所を知られると非常に危険です
    ちなみに、ファイル名を変えると動かなくなるのではないか、と思う方もいるでしょうが、
    管理CGIはファイル名を変えても大丈夫なように作っているので、ご安心ください

◇Mireilleの注意事項

◇Mireilleの設置でつまづいたら

◇お世話になったところ

■■■■■■■

BACK to INDEX
[ $Id: Mireille.html,v 1.2.3.3 2002/08/10 07:08:16 naruse Exp $ ]
- Airemix Mireille -