Install_Config - img0ch Wiki - img0ch

img0ch-config.cgiの設定

/img0ch/test/ ディレクトリに移動し、その中の img0ch-config.cgi.default を開きます。編集が完了したら img0ch-config.cgi.default を img0ch-config.cgi にファイルの名前を変更 (リネーム) してください。

以下の設定値を自分のサイトのディレクトリ構造にあわせて変更してください。なお、config もあわせて参照してください。通常、変更が必要な値は以下の項目です。

• RepositoryRoot
• Static
• zeromin2.session_dir

BBSPath

自分のサイトに設置する全ての掲示板を格納するディレクトリのパスを指定します

• 通常 (CGI 環境) はテストディレクトリと一緒に格納するディレクトリの位置を示す .. を指定する

Server

自分のサイトに設置する BBSPath までの絶対 URL を指定します。絶対パスではありません。

CGIServer

test ディレクトリまでの絶対 URL を指定します。これは以下の目的の為にあります。

• BBSPath がテストディレクトリとは別の場所に設置したい
• CGI を実行する為のサーバがあるのでそこで実行させたい

RepositoryType

レポジトリで使用するモジュール名を指定します。

• 通常 !Simple を使用する
• 指定しなくても !Simple を利用する

RepositoryRoot

レポジトリまでのディレクトリのパスを指定します。RepositoryRoot までのディレクトリは予め作成する必要があります。

• 極力全ての人からアクセス出来ないパスまでを指定してください。
• public_html ディレクトリがあるならそのディレクトリよりも上に

public_html 等の公開されたパスに指定しなければならない場合は以下の方法を試してください

• ディレクトリ名の最初にドット (.) をつける
• 直接ディレクトリまたはファイルにアクセスされても403を返し、アクセス出来なくさせる
• RepositoryFileExtension を cgi に指定する
• 直接レポジトリファイルをアクセスされても 500 で返し、アクセス出来なくさせる

Static

静的ファイルを格納したディレクトリ (static) までの絶対URLを指定します

• 理由として read.cgi にアクセスしたとき JavaScript の URL が意図と異なる
• すなわち、read.cgi へのアクセス頻度が高くなると同時に負荷が大きく上昇する問題が発生する

TemplatePath

テンプレートファイルを格納したディレクトリを指定します。

• 基本的にこの値は変更する必要はない

TemplateEngine

テンプレートを解析するエンジンとなるモジュールを指定します。

• 指定しなければ、HTML::Template を使用する
• 他に使用出来るテンプレートエンジンは以下の通り
• HTML::Template::Compiled
  • HTML::Template の派生版。より高度なカスタマイズが可能
  • 歴史的な理由からデフォルトにはなっていない
• ClearSilver
  • HTML::Template よりも処理が高速だが記述方法に互換性が無い
  • 予め ClearSilver と Perl バインディングをインストールする必要がある

TemplateFileExtension

テンプレートファイルの拡張子を指定します。

• HTML::Template (::Compiled) を使用する場合は変更する必要はない
• ClearSilverを使用する場合はこの項目の値をcsに指定する必要がある

zeromin2.session_dir

Zeromin2で利用するセッションを保存するためのディレクトリを指定します。

* このパス先は RepositoryRoot と同じく極力全ての人からアクセス出来ないパスまでを指定する

• 詳細は RepositoryRoot の項目を参照

このディレクトリは作成されていなくてもモジュール側が自動的にディレクトリを作成しますが、予め作成しておいた方がトラブルが少なく済みます。

注意事項

• !Windows で img0ch-config.cgi.default を編集する時ノートパッドで保存で保存するとエラーが発生します。
• ノートパッド以外のアプリケーション、例えばワードパッドで保存してください。
• img0ch-config.cgi は !Windows の ini 形式を採用しています。その為、書き方を間違えると正しく動作しなくなります。

  # 間違い
  [zeromin2]
  session_dir = /path/to/session
  
  BBSPath = /path/to/bbs
  

• 上記はBBSPathをzeromin2の下に持っていってしまったことが原因になり、zeromin2.BBSPath と認識されてしまいます。

  # 正しい
  BBSPath = /path/to/bbs
  
  [zeromin2]
  session_dir = /path/to/session
  

• 値の名前の最初が大文字で始まるものは全て角括弧より上の方へ持っていってください。