install - img0chのインストール方法

TABLE OF CONTENTS


NAME

install - img0chのインストール方法


SYNOPSYS


DESCRIPTION

STEP.1

img0ch.zipあるいはimg0ch.tar.bz2を解凍します。

img0chそのもののインストール

STEP.2

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

以下の設定値を自分のサイトのディレクトリ構造にあわせて変更してください。 なお、configもあわせて参照してください。

BBSPath

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

Server

自分のサイトに設置するBBSPathまでの絶対URLを指定します。

RepositoryType

レポジトリで使用するモジュール名を指定します。通常Simpleを使用します。 指定しなくてもSimpleが利用されます。

RepositoryRoot

レポジトリまでのディレクトリのパスを指定します。 極力全ての人からアクセス出来ないパスまでを指定してください。 (public_htmlディレクトリがあるならそのディレクトリよりも上に) どうしても事情があって公開せざるをえないパスに指定しなければならない場合は RepositoryFileExtensionをcgiに指定してください。 直接レポジトリファイルをアクセスされても500で返してアクセス出来なくさせます。

Static

静的ファイルを格納したディレクトリ(/static)までの絶対URLを指定します。 基本的にこの値は変更する必要はありません。

TemplatePath

テンプレートファイルを格納したディレクトリを指定します。 Static同様、基本的にこの値は変更する必要はありません。

TemplateEngine

テンプレートを解析するエンジンとなるモジュールを指定します。 通常はHTML::Templateを使用しますが、高速化をねらうのであれば インストールされていればClearSilverを利用することが出来ます。

TemplateFileExtension

テンプレートファイルの拡張子を指定します。 HTML::Templateを使用する場合は変更する必要はありません。 ClearSilverを使用する場合は"cs"を指定する必要があります。

STEP.3

img0chディレクトリに移動し、以下のディレクトリをFTP経由でアップロードします。 (readmeディレクトリは説明用なのでアップロードする必要はありません)

  _system
  _template
  static
  test

なお、このとき拡張子がcgiのファイルはASCIIモードで、 それ以外のファイルはBINARYモードでアップロードする必要があります。

CAUTION

一部モジュールがバイナリになっているので、拡張子がpmのファイルを ASCIIモードで転送すると動作しなくなります。 (Unicode::Japaneseというモジュールが該当します)

STEP.4

RepositoryRootのパスを存在しなければ作成し、 パーミッションを0700にします。

インストール作業に失敗するのであればパーミッションを0770、0777と段階的に上げていきます。 ただし、その分セキュリティ的なリスクが大きいので、なるべく0700にするべきです。

STEP.5

アップロードしたディレクトリの/testディレクトリに移動して、 以下のファイルのパーミッションを0755あるいは0705に変更します。

  bbs.cgi
  r.cgi
  read.cgi
  zeromin.cgi

STEP.6

zeromin.cgiにアクセスし、インストール作業を行います。 インストールウィザード画面が表示されますので、それに従ってください。

ウィザードに従ってインストール作業を行うとログイン画面になります。

過去のバージョンとの互換性確保

STEP.2でimg0ch-config.cgi.defaultに記述されている[compatible]と 以下の値の情報の前にあるコメント(#)を削除することで過去のバージョンとの互換性を 確保してデータを引き継ぐことが出来ます。

過去のバージョンのデータは読み出し専用で読み出し、保存するときデータは全て レポジトリに保存されるため、過去のバージョンのデータが上書きされることはありませんが、 レポジトリに保存されたデータが優先的に利用されます。

typeテンプレートの使用方法

typeテンプレートはtDiary互換のXHTMLを出力するテンプレートです。 若干の作業が必要になるため、インストール直後からtypeテンプレートを 利用することは出来ません。以下の手順を踏まえる必要があります。

STEP.1

http://www.tdiary.org のダウンロードからtdiary-full-x.x.x.tar.gzを 入手します(x.x.xはバージョン番号)。

STEP.2

解凍したディレクトリの中のthemeディレクトリの中のファイル及びディレクトリを /static/tdiaryにコピーします。

STEP.3

掲示板設定から「使用するテンプレート名」(BBS_TEMPLATE)に「type」を指定します。

STEP.4

掲示板設定から「typeに適用するテーマ名(BBS_TEMPLATEをtypeにする必要があります。)」 (BBS_TYPE_TEMPLATE)の値に/static/tdiary内にある好きなテンプレート名 (ディレクトリ名)を指定します。指定されない場合はdefaultになります。

STEP.5

インデックスを更新するとBBS_TYPE_TEMPLATEに応じたデザインのHTMLが出力されます。 tdiaryのテーマによってはデザイン構成が崩れることがあります。

read.cgiをread.htmlに変更する

read.htmlはブラウザに内蔵されている非同期通信機能を使ってdatを直接取得し、 ブラウザ側でレスを描写するHTMLファイルです。これにより、サーバー側はdatのみを 送るだけでよくなるため、サーバーへの負荷を大幅に抑えることが出来ます。

ただし、テンプレートが使用できなくなるため、デザイン変更は自分で行う必要があります。 また、サーバー側の処理をクライアントで行うことになるため、描写処理の負荷が大きい問題が あります。さらに、utf8にエンコードされたdatを生成するため、書き込み処理が若干 大きくなることとサーバーへの使用容量を増やすことになります。

STEP.1

zerominにログインし、「プラグイン」からプラグインの一覧を表示します。 一覧からImg0ch::Plugin::BBS::UTF8Datに絞りこみ、 表示された結果を全て有効にします。

次のSTEP.2の作業は全てあるいはほとんどのutf8のdatが生成されるまで 作業しない方がよいでしょう。

STEP.2

img0ch-config.cgiを編集し、RendererRendererSeparatorを以下のように設定します。

  Renderer = read.html
  RendererSeparator = #

変更したらインデックスの更新を行うか、書き込みを待ちましょう。


SEE ALSO

Img0ch::Config

http://hikarin.jp ( alias to http://img0ch.sourceforge.jp )


AUTHOR

hkrn <hikarin at users dot sourceforge dot jp>

install - img0chのインストール方法

INDEX

install - img0chのインストール方法