これは上級者向けの複数ディレクトリモードの説明文です.


↓最初に読んでください(^^)/.

複数ディレクトリモードとは,ひとつのCGIを使い回して複数テーマの写真公開ページを作成できるモードの事です.やや上級者向けのモードなので,初めて一覧君をインストールされる方は,この文章を無視し,Readmex.htmlのインストールガイドに従ってCGIをインストールして下さい.

〜以下の話は設置経験者限定〜〜〜
一覧君CGIは,設定を簡単にするために、全部のファイルを一つのディレクトリに入れる単純なファイル配置構成を前提としています.この配置の場合、画像ファイルが入っているディレクトリにcgiや関連ファイルを入れ,パーミションの設定さえすれば,特に設定を書換えなくても動きます.従って初心者でも設置可能です.

しかしのCGIをしばらく使い,複数の公開ディレクトリを持つようになると,一覧君やアイコン画像を,新規公開テーマ毎に,画像ディレクトリに入れることが,面倒だと感じられると思います.また,同じファイルやアイコンをダブって持つことになるので,WWWサーバの容量の無駄にもなります。

 そこで当CGIでは,CGIの使い回し可能な、複数ディレクトリモードを追加しました.このモードを使うと,従来よりもはるかに少ない手間で公開ディレクトリを追加できます

[インストール]

例えば温泉旅行に行ったとしましょう.仮にその写真が20枚あるとします.あなたは”温泉旅行”というテーマで,一緒に温泉に行ったメンバーに対して,写真公開をしたいという状況です.

まず,以下のファイルをFTPでアップロードして下さい. ファイルはみんな同一ディレクトリに入れ, パーミションを()内の数値に指定します.
index.html(当ファイル)
disp_sl.cgi(755)
admin_sl.cgi(755)
disp_snl.cgi(755)
imgsize.pl(755)
jcode.pl(755)
next.gif(644)
top.gif(644)
back.gif(644)
exit.gif(644)

#ここまではシングルモードと同じ
ここで,onsenという名前のサブディレクトリを新しくこの中に作って,そのパーミションを一時的に777にして下さい.で,その中に温泉の写真20枚を入れ,各画像のパーミションを(644)に指定します。これで onsen公開ディレクトリの準備は完了です.

呼び出す場合は,以下のようなアンカーで呼び出して下さい.
<A HREF=./disp_sl.cgi?directory_name=onsen>温泉旅行</a>
温泉旅行
そうすると、画像が一覧君で見れるようになると思います。
ただ「テキスト保存用ファイルmessage.txtがない」と小さなエラーメッセージが左上にでると思いますので、editボタンを押してアドミンモードに入り、メッセージ指示に従って、テキスト保存用ファイルを自動作成してください。(ここでは、できるだけ自動作成してください)なお、自動作成にどうしても失敗する場合は、手動でmessage.txtという名前の空ファイルをonsenディレクトリに置くと解決します。

ここで、自動作成が終わったら、onsenディレクトリのパーミションを755に変更してください。そして後はWeb経由でeditモードでコメントを入れれば,もう公開ですね(^^)/.

また翌週にでも,ダイビング仲間と海へ行き,写真を30枚ほど撮ったと仮定します.今度はこの仲間達に一連の写真を公開するとします.

すでにCGIは設置してあるので,CGIやアイコンのFTPアップロードは不要です.CGI等のあるディレクトリ中に,umiという名前のサブディレクトリを作成し,パーミションをまた一時的に777にして,その中に海の写真30枚を入れればひとまず準備完了です.

参考図(ファイルの配置関係)

これを今度は

で呼び出し、またeditモードに入って、コメントファイルmessage.txtを自動作成し 後でmessage.txtパーミションを755に変更するだけで公開可能です。
#呼び出すcgiからの相対パスをdirectory_nameというパラメータで渡す仕組みです.?以降のパラメータ指定が含まれる場合,自動的に複数ディレクトリモードになります.また,アンカーだけでなく,URLからもパラメータを渡すことができます.

   メールで周知する場合は”http://XXX/XXX/disp_sl.cgi?directory_name=umiを見てね!”という風に周知して下さい.

なお,message.txtは各サブディレクトリ内に作成されます。このファイルに戻り先やパラメータ設定などが書込まれます。従って、戻り先ディレクトリをそれぞれの公開ディレクトリで別にしたい場合はサブディレクトリに入った状態で、ウィザードを起動し、URLを指定してください。デフォルトではひとつ上のディレクトリへ移動するようになっています。

[うまく動かない場合]

  • message.txtの自動作成にどうしても失敗する場合は、手動でmessage.txtという名前の空ファイルをonsenディレクトリに置くと解決します。
  • コメント書込み時にエラーが出てファイルに書込めない場合、message.txtのパーミッションを666に指定してください。
    
        WWWサーバ上での,ファイルの配置構成    
    
     public_html(ホームページディレクトリ)
     |
     |-- cgi-bin(任意のディレクトリ)
       |
       |--onsen(755)(温泉画像公開用ディレクトリ)
       |   |----message.txt(666)←自動作成される
       |   |----0001.JPG   (644)
       |   |----0002.JPG   (644)
       |   |      :
       |   |----00XX.JPG   (644)
       |
       |--umi (755)(海画像公開用ディレクトリ)
       |   |----message.txt(666)←自動作成される
       |   |----0001.JPG   (644)
       |   |----0002.JPG   (644)
       |   |      :
       |   |----00XX.JPG   (644)
       |
       |-- jcode.pl (755)
       |-- imgsize.pl  (755)
       |-- disp_sl.cgi (755)
       |-- admin_sl.cgi(755)
       |-- disp_snl.cgi(755)
       |-- next.gif (644)
       |-- back.gif (644)
       |-- exit.gif (644)
       |-- top.gif  (644)
       |-- index.html(644)←なくても良い