AskaVML BBS

• 特徴
• お絵描き機能の使い方 v1.2〜
• サンプル
• CGIスクリプト利用規定
• ダウンロード
• 設定(初期導入手順)
• バージョンアップ手順・解説
• オリジナル版からの移行について
• お絵かきエディタ設定解説(各ソフト共通) v1.2〜
• 変更履歴

特徴

• 'AskaVML BBS' はKentWebさんのポピュラーな掲示板のひとつ'ASKA BBS'(シンプル掲示板) (以後"オリジナル(版)"と表記) に
  VMLによるお絵描き・その他の機能を付加したものです。
  
  
  
• 掲示板の基本機能(オリジナルの機能)
  
  ※掲示板の基本機能はオリジナルのままです。
  • シンプルで動作が軽い。
  • 投稿記事を管理人に自動でメール通知させることできます。(サーバメールプログラムは、sendmail と BlatJ に対応しています)
  • 投稿者自身による記事削除が可能です。(投稿時に暗証キー入力の場合)
  • 管理者はすべての記事の修正および削除が可能です。
  • 各記事に「返信」リンクがつき、返信メッセージを付けやすい構造になっています。
  • キーワードから過去の投稿記事のワード検索を行うことができます。
  
  
  
• 追加機能  
  
  
  • WEBブラウザによる環境設定機能。(ほとんどの設定を行うことが出来ます。)
    
    
  • お絵描き機能
    • 作画機能(VMLお絵かきエディタ)
      • 図形種類:フリーハンド、直線、折れ線、四角形、角丸四角形、楕円、円弧、カーブ
      • 線の色、太さ、透明度を指定できます。
      • 塗潰しの色、透明度を指定できます。
      • 各図形に文字列を出力できます。
      • アンドゥ、リドゥ、削除機能。
    • VMLお絵かきエディタ
      
      • 投稿部から別ウィンドウで開かれます。
        基本スタイルを変更することができます。
        タグ広告・独自のメッセージなどを画面の予備領域(上下左右)に配置させることができます。
        何れもブラウザによる環境設定で手軽に編集することができます。
      • お絵かきエディタはv1.2で３タイプ添付しています。
        将来デザインや機能を増やしたエディタを提供することも考えています。
        そのような時にファイルの追加をしやすくなっています。
    
    
  • スパム投稿対策。利用者が特に投稿キー入力などの余分な操作をせずにすみます。
    (非常に些細な対策ですが効果は確認済みです。サンプルは書き込み可ですが多くのスパムを防ぐことが出来ています)(*1)
    
    
  • タグ広告を設定しやすくしました。(こちらもブラウザによる環境設定対応です)
  
  *1 : 全てのスパムを防ぐことを保証するものではありません。
  
  
• 動作条件
  
  
  • Perlが動くサーバーであれば設置できます。(*2)
    ※GDモジュールなどは不要です。
  • お絵描きする時はJavascriptをオンにしてお使い下さい
  • お絵かき閲覧・作画にはInternetExplorerまたはIE互換ブラウザが必要です。
    文字のコミュニケーションではこの限りではありません。
    
  
  *2 : 全てのサーバーで正常に動作する事を保証するものではありません。
  

サンプル

• AskaVML BBS v1.3     テスト書込み可能です。
  ※ご質問・リクエストなどは サポート掲示板 にお願いします。
  
  
• 管理画面サンプル(設定)    　変更はできません。
  
  
• 管理画面サンプル(お絵かきエディタ設定)    　変更はできません。
  

CGIスクリプト利用規定

• CGIスクリプト利用規定(Kent-web)
  
  
• このスクリプトはフリーソフトです。このスクリプトを使用したいかなる損害に対しても作者は一切の責任を負いません。
  
  
• 使用者はスクリプトの著作権表示を削除することはできません。
  

ダウンロード

• ダウンロードされた時点で上のCGIスクリプト利用規定に同意したものとみなします。
  
  
• askavml.lzh   v1.3
  askavml.zip   v1.3
  
  
• askavmlup.lzh v1.3 (アップデート用)
  askavmlup.zip v1.3 (アップデート用)
  　実行に必要なファイル全てとアップデート作業用スクリプト類を含みます。
  
  
• 説明文は添付していません。
  
  • 設定(初期導入手順)
  • バージョンアップ手順・解説
  • お絵かきエディタ設定 v1.2〜
  
  
• 画像ファイルはお絵かきエディタメニューボタン用(私の自作品)のもの以外は添付しておりません。
  
  
• ダウンロードされた方は(強制ではありませんが) 掲示板 に報告お願いします。
  設置に関する疑問・質問などもこちらにお寄せください。
  

設定

1. public_html (ホームディレクトリ) の下に、「bbsディレクトリ」(例)を作成し、さらにその下に次のディレクトリを作成します。
   
   • 「lockディレクトリ」(ロックファイル用)
   • 「imgディレクトリ」(gifファイル用)
   • 「vmlディレクトリ」(お絵かきデータ用)
   
   
   
2. 全体のディレクトリ構成とファイル位置は以下のとおりです。（かっこ内はパーミッションの設定値）

   【ディレクトリ構成例】 public_html / index.html (トップページ) | +-- bbs / askavml.cgi [705] | askavml_conf.cgi [606] | askavml_log.cgi [606] | jcode.pl [604] | vmlno.cgi [606] | vml0.js [604] | vml.js [604] | vmledit1.html [606] ... 〜3.html | +----- lock [707] / | +----- img [604] / *.gif [604] | +----- vml [707] / 1.cgi , 2.cgi ... [606] お絵かきデータ

3. askavml.cgi を エディタ で開いて以下の箇所を修正します。

   　#!/usr/local/bin/perl

   　（プロバイダで定められたPerlへのパスを指定します）
   
   

4. 修正が完了したら上記ファイルをFTP転送し、以下のとおり パーミッション を設定します。

   ファイル名	パーミッション		転送モード
   	一般サーバ	suEXECサーバ CGIWrapサーバ
   askavml.cgi	755 or 705	701 or 700	アスキー
   askavml_log.cgi	666 or 606	600	アスキー
   askavml_conf.cgi	666 or 606	600	アスキー
   jcode.pl	644 or 604	600	アスキー
   vmlno.cgi	666 or 606	600	アスキー
   vml0.js	644 or 604	600	アスキー
   vml.js	644 or 604	600	アスキー
   vmledit1.html 〜3.html	666 or 606	600	アスキー
   lockディレクトリ	777 or 707	701 or 700	-
   imgディレクトリ	644 or 604	600	-
   img/*.gif	644 or 604	600	バイナリ
   vmlディレクトリ	777 or 707	701 or 700	-

5. 以上、設定が完了したらチェックモードで動作チェックを行ないます。

   【チェックモード】：askavml.cgi の末尾に「?mode=check」と付けて呼び出す

   例　http://〜〜/bbs/askavml.cgi?mode=check

   
   

6. askavml.cgi にアクセスして次の手順で環境設定を行います
   
   
   1. 掲示板上部リンクで[管理用]を選択する
      
      
   2. ログイン画面で、[設定]を選択しパスワード(初期値)"0123"でログインする
      
      
   3. 設定画面で任意の項目を変更する
      (主要な項目には解説がありますので参考にして下さい)
      ***パスワードは初期値のままにせず必ず変更して下さい***
      (ローカルサーバでテストする時にも変更して下さい)
      
      
   4. 設定を保存する
      
      
   5. 関連項目を変更した時は前記のチェックモードを実行して下さい
      
      
   
   ※環境設定について以上の説明では不足という方は現在工事中ですが設定の補足を見て下さい。
   
   
   

7. チェックモードが正常ならば、HTMLから askavml.cgi にリンクします。
   
   

   【記述例】

   <a href="http://〜〜/bbs/askavml.cgi">掲示板</a>

バージョンアップ手順・解説

アップデート作業の概要

1. 旧バージョンのディレクトリ以下のファイルをバックアップする。
   
2. 新しいディレクトリ「newdir」を作成し、新バージョンのファイルを転送する。
   
3. 「newdir」でupdate.cgiを実行する。
4. 「olddir」ディレクトリを適当な名前「例:oldbak」にリネーム、
   「newdir」ディレクトリを「olddir」にリネームする。
   「olddir」でaskavml.cgiを実行し最終的な環境設定とテストを行う。

アップデート作業

1. ダウンロード で (アップデート用) のファイルを入手して下さい。
   
   
   
2. 現在お使いの "AskaVML BBS" のバージョン確認。
   askavml.cgiをエディタで開いて、上部著作権表示内の 〜 vX.X 〜 を確認しておいて下さい。 (例: v1.0 , v1.2 など)
   
   
   
3. バックアップ
   以降の作業に入る前に必ずバックアップを行って下さい。
   (旧バージョンのディレクトリ「olddir」以下のディレクトリとファイル)
   
   
   
4. askavml.cgi(v1.3) を エディタ で開いて以下の箇所を修正します。
   
   
   • #!/usr/local/bin/perl
     　（プロバイダで定められたPerlへのパスを指定します）
   
   
   
5. update.cgi を エディタ で開いて以下の箇所を修正します。(重要項目のみ)
   
   
   1. #!/usr/local/bin/perl
      （プロバイダで定められたPerlへのパスを指定します）
      
      
   2. # ■ パスワード
      # 　　このパスワードはアップデート作業に限り使用されるもので、askavml.cgi本体のそれとは異なります。
      $pass = '0123';
      
      
   3. # ■ ロックファイル
      #　 0 : 行なわない
      #　 1 : 行なう（symlink関数式）
      #　 2 : 行なう（mkdir関数式）
      $lockkey = 0;
      
      
   4. # ■ 旧設定ファイル
      #　 旧バージョンが v1.2 の場合は旧設定ファイル( askavml_conf.cgi ) のパスを正しく指定して下さい。
      #　 旧バージョンが v1.0〜v1.1b の場合は設定ファイルがありませんので、$setfile_v1_3 と同じ './askavml_conf_1_3.cgi' を指定します。
      #$setfile_old = './askavml_conf_1_3.cgi'; #v1.0〜v1.1b の例
      $setfile_old = '../olddir/askavml_conf.cgi'; #v1.2 の例
      
      
   5. # ■ 旧ログファイル
      # 旧バージョンのログファイルパスを正しく指定して下さい
      #　例 : v1.0〜v1.1b → v1.3 の場合は標準では '../olddir/askalog.cgi' とします。
      #　例 : v1.2 → v1.3 の場合は標準では '../olddir/askavml_log.cgi' とします。
      $logfile_old = '../olddir/askavml_log.cgi';
      
      
   6. # ■ 新ログファイル(v1.3)
      # 旧バージョンでログファイルの名前を標準と異なるものに設定していた場合はその名前を指定して下さい。
      # その他の場合は特に変更の必要はありません。
      # 注意1 : ディレクトリは newdir を指定します。
      # 注意2 : $logfile_old と同じディレクトリ・ファイルを指定しないで下さい。
      $logfile_new = './askavml_log.cgi';
      
   
   ※$logfile_old , $setfile_old 共 ’．．／ｏｌｄｄｉｒ／〜’ の「olddir」部分は旧バージョンの実際のディレクトリ名を指定して下さい。
   これらの設定に間違いがあると後の作業が正しく行えなくなりますので慎重に設定して下さい。
   
   
   
   
6. 新しいディレクトリ「newdir」を「olddir」ディレクトリと同じ階層に作成します。
   例:
   http://xxx.xxx/cgi-bin/olddir が旧ディレクトリであったら
   http://xxx.xxx/cgi-bin/newdir というディレクトリを作成します。
   http://xxx.xxx/cgi-bin/xxx/newdir ← このような異なる階層は ×
   
   
   
   
7. 「newdir」の下に次のディレクトリを作成して下さい。([xxx]はパーミッション例)
   
   
   • 「lockディレクトリ」[707] (ロックファイル用)
   • 「imgディレクトリ」[604] (gifファイル用)
   • 「vmlディレクトリ」[707] (お絵かきデータ保存用)
   
   
   
8. 「newdir」以下のディレクトリ構成とファイル位置は以下のとおりです。（かっこ内はパーミッションの設定値）
   
   

   【ディレクトリ構成例】 public_html / index.html (トップページ) | +-- <olddir> / 〜 略 〜 | | +-- <newdir> / | askavml.cgi [705] | askavml_log.cgi [606] (*1) | askavml_conf.cgi [606] (*1) | jcode.pl [604] | vml0.js [604] | vml.js [604] | vmledit1.html [606] ... 〜3.html | vmlno.cgi [606] | | askavml_conf_1_3.cgi [604] (*2) | update.cgi [705] (*2) | +------ <lock> [707] / | +------ <img> [604] / *.gif [604] | +------ <vml> [707] / 1.cgi , 2.cgi ... [606] お絵かきデータ (*1) *1 : update.cgi実行後生成されます *2 : アップデート作業完了後削除可

   
   
   
9. ファイルを「newdir」以下にFTP転送し、以下のとおり パーミッション を設定します。
   
   
   

   ファイル名	パーミッション		転送モード
   	一般サーバ	suEXECサーバ CGIWrapサーバ
   askavml.cgi	755 or 705	701 or 700	アスキー
   askavml_log.cgi (update.cgiで自動生成)	−	−	−
   askavml_conf.cgi (update.cgiで自動生成)	−	−	−
   jcode.pl	644 or 604	600	アスキー
   vml0.js	644 or 604	600	アスキー
   vml.js	644 or 604	600	アスキー
   vmledit1.html 〜3.html	666 or 606	600	アスキー
   vmlno.cgi	666 or 606	600	アスキー
   update.cgi	755 or 705	701 or 700	アスキー
   askavml_conf_1_3.cgi	644 or 604	600	アスキー
   lockディレクトリ	777 or 707	701 or 700	-
   imgディレクトリ	644 or 604	600	-
   img/*.gif	644 or 604	600	バイナリ
   vmlディレクトリ	777 or 707	701 or 700	-
   vml/1.cgi ... (update.cgiで自動生成)	666 or 606	600	アスキー

   
   
   
   
10. アップデート作業中、旧バージョンのデータにアクセスされないようにする。
    
    以降の作業の前に、 http://〜/olddir/askavml.cgi を 仮に askavml_.cgi などの名前に変更する。
    これは一例に過ぎません。その他適当な方法で旧バージョンファイルにアクセスされないようにして下さい。
    (尚アップデート作業では 旧バージョンのaskavml.cgiにアクセスすることはありません。)
    
    
    
11. http://〜/newdir/update.cgi にアクセスして次の手順で作業を行います。
    
    
    1. 設定ファイル作成
       
       v1.2 → v1.3 の場合は旧設定情報を引き継いで新しい設定ファイルが作成されます。
       v1.0〜v1.1b → v1.3 の場合は別途環境設定(最終設定の項で説明)が必要になります。
       
       [設定ファイル作成]を選択。 5-2. で設定したパスワードを入力して[実行]をクリックする。
       
       
       1. 「処理が終了しました。」となったら 例〜/newdir/askavml_conf.cgi が生成されています。
          
          
       2. エラーが出たときは次の点を確認・修正後再実行して下さい。(注)
          
          • "Open Error: 〜"　の場合　　(関連: update.cgiの$setfile_old )
            　　ファイル又はディレクトリの指定が正しくない可能性があります。
            
          • "Write Error: 〜"　の場合　　(関連: update.cgiの$setfile_new )
            　　ディレクトリのパーミッションが正しくない可能性があります。
            
          
          
       
       
       
    2. ログ変換・更新
       
       旧ログファイル(例 : 〜/olddir/askavml_log.cgi)をv1.3形式に変換して
       新しいファイル(例 : 〜/newdir/askavml_log.cgi)が作成されます。
       
       [ログ更新]を選択。 5-2. で設定したパスワードを入力して[実行]をクリックする。
       
       
       1. 「正常に処理されました。」となったら以下の状態になっています。
          
          
          • newdir/askavml_log.cgiが作成されます。
          • newdir/vmlディレクトリ の中にいくつかの 1.cgi , 2.cgi ... ができています。
            　　(お絵かき作品の数だけファイルが作られます)
            　　(ちなみにファイル名の番号は記事の番号とは無関係で又古い順という訳でもありません)
            
          
          
       2. エラーが出たときは次の点を確認・修正後再実行して下さい。(注)
          
          • "(reg_vml)Open Error: 〜"　の場合　　(関連: update.cgiの$vml_nofile )
            
          • "(reg_vml)Write Error: 〜"　の場合　　(関連: update.cgiの$vml_nofile 又は $vml_dir(規定値 ./vml) )
            　　ファイルかディレクトリが見つからない又はパーミッションが正しくない可能性があります。
            
          • "Open Error: 〜"　の場合　　(関連: update.cgiの$logfile_old )
            　　ファイル又はディレクトリの指定が正しくない可能性があります。
            
          • "Write Error: 〜"　の場合　　(関連: update.cgiの$logfile_new )
            　　ディレクトリのパーミッションが正しくない可能性があります。
            
          
          
    
    1.設定ファイル作成 、 2.ログ変換・更新 共に正常に処理できた時は、次の最終設定・動作確認の作業に移ります。
    
    
    注 : エラーその他の理由でupdate.cgiの実行をやり直すときは下記のようにして下さい。
    
    
    1. 設定ファイル作成 をやり直す時
       
       
       • newdir/askavml_conf.cgi を削除する。(ファイルがあった場合)
       
       
       
    2. ログ変換・更新 をやり直す時
       
       
       • newdir/askavml_log.cgi を削除する。(ファイルがあった場合)
       • newdir/vmlディレクトリ内の 1.cgi , 2.cgi ... 全てを削除する。(ファイルがあった場合)
       
       
       
    
    
    
    
12. 最終設定・動作確認
    
    
    1. 「olddir」ディレクトリを適当な名前 例 :「oldbak」にリネームする
       
       
    2. 「newdir」ディレクトリを「olddir」にリネームする
       
       
    3. http://〜/olddir/askavml.cgiにアクセスして以下の作業を行います。
       旧バージョンv1.2でスクリプト名をaskavml.cgiと異なる名前に設定していた場合はアクセス前にファイル名自体をその名前に変更しておく必要があります。
       
       
       1. 記事・お絵かき作品が正常に表示されていることを確認する。
          
          エラーが出た時は以下の点を確認・修正する
          
          • サーバエラーが出る時
            
            1. askavml.cgi の修正箇所 (例: #!/usr/local/bin/perl ) が正しいか
            2. askavml.cgi のパーミッションが正しいか
            
            
          • 掲示板は表示されるが記事部分に「Open Error : 〜」などのエラー表示が出る時
            　　管理画面にログイン(後述)して以下の項目を確認修正します。
            1. [ログファイル] (例: ./askavml_log.cgi ) が正しいか。
               ファイル名、パーミッションは正しいか。
            
            
          • 記事は表示されるが画像表示部分に「Open Error 〜」のエラー表示が出る時
            　　管理画面にログイン(後述)して以下の項目を確認修正します。
            1. [お絵かきデータ保存ディレクトリ] (例: ./vml )
               
            2. [お絵かきデータNo管理ファイル] (例: ./vmlno.cgi )
               ファイル名、パーミッションは正しいか。
          
          
       2. 管理画面(設定)にログイン・設定をする。
          
          • v1.2 → v1.3 は以前使っていたパスワードでログインできて設定情報が引き継がれていれば問題ありません。
            もしログインできない、設定が引き継がれていない等の場合はupdate.cgiの$setfile_oldで指定したファイルが正しいか再確認、前項の[設定ファイル作成]を再実行して下さい
            
            
          • v1.0〜v1.1b → v1.3 では以下のように環境設定を行って下さい。
            
            1. 掲示板上部リンクで[管理用]を選択する
               
               
            2. ログイン画面で、[設定]を選択しパスワード(初期値)"0123"でログインする
               
               
            3. 設定画面で任意の項目を変更する
               (主要な項目には解説がありますので参考にして下さい)
               ***パスワードは初期値のままにせず必ず変更して下さい***
               
               
            4. 設定を保存する
               
          
          
       3. 「お絵かきエディタ」の環境設定をして下さい。
          
          • この設定が初めての方は解説ページの「お絵かきエディタ設定」をご覧下さい。
            
            
          • v1.2 → v1.3 の場合
            　　v1.2 と同じ設定手順で行えます。
            　　vmledit1.html , vmledit2.html は v1.2のものを v1.3のディレクトリに上書きコピーして構いません。
            　　vmledit3.html はバグ修正してありますので v1.3のファイルを使って下さい。
            
          
          
       4. お絵かきを含めたテスト投稿と削除が正常にできることを確認する。
          エラーが出た時は以下の点を確認・修正する
          
          1. ./vmlディレクトリのパーミッションが正しいか
          2. vmlno.cgi のパーミッションが正しいか
          3. ログファイル askavml_log.cgi のパーミッションが正しいか
       
       ※この段階では以下の手順で旧バージョンの環境に戻すことができます。
       
       1. 「olddir」ディレクトリを「newdir」にリネームする
          
       2. 「oldbak」ディレクトリを「olddir」にリネームする
          
       3. 10. でリネームしていた場合は、 〜/olddir/askavml_.cgi(例) を元の名前に戻す
          
    
    
    
    
13. 後処理
    
    動作確認に問題なかったらアップデート作業は終了です。以下の作業が可能です。
    
    
    • 下記のファイルは削除して問題ありません
      
      • update.cgi
      • askavml_conf_1_3.cgi
      
      
    • 旧バージョンのディレクトリ (例 :「oldbak」) は削除して問題ありません。
      バックアップデータは保管することをお勧めします。
      
      
    
    
    

オリジナル版からの移行について

• ログファイル(例:askalog.cgi) はそのまま移行できます。
• 特にデータのバックアップを取るなど注意して行って下さい。