| 11 |
<body> |
<body> |
| 12 |
<section title="Overview"> |
<section title="Overview"> |
| 13 |
|
|
| 14 |
mod_chxjはオープンソースの携帯向けコンテンツ変換Apache2.0用モジュールであり、 |
mod_chxjはオープンソースの携帯向けコンテンツ変換Apache2.x用モジュールであり、 |
| 15 |
CHTML(DoCoMo i-Mode用 CHTML3.0)で記述された文書や通常のHTMLで記述された文書を、アクセスに来た端末のUser-Agentヘッダを見て、それぞれの端末にあった形式に変換します。 |
CHTML(DoCoMo i-Mode用 CHTML3.0)で記述された文書や通常のHTMLで記述された文書を、アクセスに来た端末のUser-Agentヘッダを見て、それぞれの端末にあった形式に変換します。 |
| 16 |
HTML文書に限らず、画像(jpg、gif、png)、絵文字についても、定義ファイルに従ってそれぞれのキャリアにあった絵文字に変換します。 |
HTML文書に限らず、画像(jpg、gif、png)、絵文字についても、定義ファイルに従ってそれぞれのキャリアにあった絵文字に変換します。 |
| 17 |
Cookie非対応端末、Refer非対応端末のために、Set-Cookie、CookieヘッダやRefererヘッダをシミュレートすることもできます(EXPERIMENTAL)。 |
Cookie非対応端末、Refer非対応端末のために、Set-Cookie、CookieヘッダやRefererヘッダをシミュレートすることもできます(EXPERIMENTAL)。 |
| 22 |
<subsection title="準備"> |
<subsection title="準備"> |
| 23 |
mod_chxjをインストールする前に、下記のものを用意する必要があります。 |
mod_chxjをインストールする前に、下記のものを用意する必要があります。 |
| 24 |
<ol> |
<ol> |
| 25 |
<li>Apache2.0のヘッダーファイル群</li> |
<li>Apache2.xのヘッダーファイル群</li> |
| 26 |
<li>Apache2.0用のapxs</li> |
<li>Apache2.x用のapxs</li> |
| 27 |
<li>apr(Apache Portable Runtime)ライブラリとそのヘッダファイル郡(apu含む)</li> |
<li>apr(Apache Portable Runtime)ライブラリとそのヘッダファイル郡(apu含む)</li> |
| 28 |
<li>automake、autoconf、libtool1.3.X</li> |
<li>automake、autoconf、libtool1.3.X</li> |
| 29 |
<li>ImageMagick(MagickWand)</li> |
<li>ImageMagick(MagickWand)</li> |
|
<li>libiconvまたはlibiconv_hook</li> |
|
| 30 |
<li>Linux</li> |
<li>Linux</li> |
| 31 |
</ol> |
</ol> |
| 32 |
</subsection> |
</subsection> |
| 36 |
<subsection title="インストール"> |
<subsection title="インストール"> |
| 37 |
以下にmod_chxjインストール手順を示します。 |
以下にmod_chxjインストール手順を示します。 |
| 38 |
<ol> |
<ol> |
| 39 |
<li>Configure スクリプトを生成します<program title="Configure スクリプトの生成"> |
<li>Configure スクリプトを生成します(必須ではない)<program title="Configure スクリプトの生成"> |
| 40 |
$ ./buildconf.sh |
$ ./buildconf.sh |
| 41 |
</program> |
</program> |
| 42 |
<note>"$"はプロンプトをあらわします。</note> |
<note>"$"はプロンプトをあらわします。</note> |
| 43 |
</li> |
</li> |
| 44 |
<li>Configure |
<li>Configure |
| 45 |
|
|
|
以下は、/usr/include/apache2.0に、Apache2.0のヘッダーファイルが存在する場合です。 |
|
| 46 |
<program title="Configure"> |
<program title="Configure"> |
| 47 |
$ ./configure --with-apache-header=/usr/include/apache2.0 |
$ ./configure |
| 48 |
</program> |
</program> |
|
<note>--with-apache-headerは必須です。</note> |
|
|
<note>FreeBSD等の場合は--with-iconvも必須です。</note> |
|
| 49 |
<note>場合によっては--with-aprや--with-apuも必要です。</note> |
<note>場合によっては--with-aprや--with-apuも必要です。</note> |
| 50 |
|
<note>0.8.xの場合には--with-apache-headerが必須です</note> |
| 51 |
</li> |
</li> |
| 52 |
<li>mod_chxj.soを生成します |
<li>mod_chxj.soを生成します |
| 53 |
<program title="make"> |
<program title="make"> |
| 62 |
<li>データの設置 |
<li>データの設置 |
| 63 |
etcディレクトリは以下のdevice_data.xmlとemoji.xmlをApache |
etcディレクトリは以下のdevice_data.xmlとemoji.xmlをApache |
| 64 |
からアクセスできるところに配置します。 |
からアクセスできるところに配置します。 |
| 65 |
|
<note>0.9.0からemoji.xml、device_data.xmlの定義フォーマットを変更しましたのでバージョンをあわせてください</note> |
| 66 |
|
|
| 67 |
以下、/etc/apache2/chxjディレクトリにchxj用設定ファイルを用意する場合 |
以下、/etc/apache2/chxjディレクトリにchxj用設定ファイルを用意する場合 |
| 68 |
|
|
| 237 |
ChxjImageEngine On |
ChxjImageEngine On |
| 238 |
ChxjImageCacheDir /tmp |
ChxjImageCacheDir /tmp |
| 239 |
ChxjImageCopyright "A.Konno" |
ChxjImageCopyright "A.Konno" |
| 240 |
|
ChxjImageCacheLimit 10485760 |
| 241 |
</Location> |
</Location> |
| 242 |
</program> |
</program> |
| 243 |
|
|
| 266 |
<br /> |
<br /> |
| 267 |
</li> |
</li> |
| 268 |
|
|
|
<li>ChxjImageCacheLimit<br /> |
|
|
mod_chxj画像変換ハンドラが使用する変換後の画像をおいておくディレクトリの許容量を指定します。 |
|
|
単位はbyte。 |
|
|
|
|
|
<program title="ChxjImageCacheLimit"> |
|
|
ChxjImageCacheLimit 1024 |
|
|
</program> |
|
|
|
|
|
mod_chxjに画像変換キャッシュ最大サイズとして1kbyteと指定。 |
|
|
※このとき変換結果が1kbyte以上あるような場合にはINTERNAL_SERVER_ERRORを返します。 |
|
|
十分な領域を確保するか、画像サイズを小さくしてください。 |
|
|
<br /> |
|
|
<br /> |
|
|
</li> |
|
| 269 |
|
|
| 270 |
|
|
| 271 |
<li>ChxjImageCopyright<br /> |
<li>ChxjImageCopyright<br /> |
| 298 |
を埋め込みます。 |
を埋め込みます。 |
| 299 |
<note>SoftBank/Vodafoneの場合は、リクエストURLの最後が.pnzか、.jpzで終わるようにダミーを付けなければなりません。</note> |
<note>SoftBank/Vodafoneの場合は、リクエストURLの最後が.pnzか、.jpzで終わるようにダミーを付けなければなりません。</note> |
| 300 |
</li> |
</li> |
| 301 |
|
|
| 302 |
|
<li>ChxjImageCacheLimit<br /> |
| 303 |
|
mod_chxj画像変換ハンドラが使用する変換後の画像をおいておくディレクトリの許容量を指定します。 |
| 304 |
|
単位はbyte。 |
| 305 |
|
|
| 306 |
|
<program title="ChxjImageCacheLimit"> |
| 307 |
|
ChxjImageCacheLimit 1024 |
| 308 |
|
</program> |
| 309 |
|
|
| 310 |
|
mod_chxjに画像変換キャッシュ最大サイズとして1kbyteと指定。 |
| 311 |
|
※このとき変換結果が1kbyte以上あるような場合にはINTERNAL_SERVER_ERRORを返します。 |
| 312 |
|
十分な領域を確保するか、画像サイズを小さくしてください。 |
| 313 |
|
<br /> |
| 314 |
|
<br /> |
| 315 |
|
</li> |
| 316 |
</ol> |
</ol> |
| 317 |
</li> |
</li> |
| 318 |
</ol> |
</ol> |