| 6 |
<subtitle></subtitle> |
<subtitle></subtitle> |
| 7 |
<author>Atsushi Konno</author> |
<author>Atsushi Konno</author> |
| 8 |
<date>29 Mar 2005</date> |
<date>29 Mar 2005</date> |
| 9 |
<date>Last modified: 21 Jan 2008</date> |
<date>Last modified: Tue, 5 Feb 2008 13:20:28 +0900</date> |
| 10 |
</head> |
</head> |
| 11 |
<body> |
<body> |
| 12 |
<section title="Overview"> |
<section title="Overview"> |
| 13 |
|
|
| 14 |
mod_chxjはオープンソースの携帯向けコンテンツ変換Apache2.x用モジュールであり、 |
mod_chxjはオープンソースの携帯向けコンテンツ変換Apache2.0用モジュールであり、 |
| 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)。 |
| 18 |
<note>Apache2.2はバージョン0.8.1から対応</note> |
|
| 19 |
|
|
| 20 |
</section> |
</section> |
| 21 |
<section title="インストール"> |
<section title="インストール"> |
| 22 |
<subsection title="準備"> |
<subsection title="準備"> |
| 23 |
mod_chxjをインストールする前に、下記のものを用意する必要があります。 |
mod_chxjをインストールする前に、下記のものを用意する必要があります。 |
| 24 |
<ol> |
<ol> |
| 25 |
<li>Apache2.xのヘッダーファイル群</li> |
<li>Apache2.0のヘッダーファイル群</li> |
| 26 |
<li>Apache2.x用のapxs</li> |
<li>Apache2.0用の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> |
| 30 |
<li>libiconvまたはlibiconv_hook(SJIS-WIN、EUCJP-WIN対応が望ましい)</li> |
<li>libiconvまたはlibiconv_hook</li> |
| 31 |
<li>Linux</li> |
<li>Linux</li> |
| 32 |
</ol> |
</ol> |
| 33 |
</subsection> |
</subsection> |
| 44 |
</li> |
</li> |
| 45 |
<li>Configure |
<li>Configure |
| 46 |
|
|
| 47 |
以下は、/usr/include/apache2.xに、Apache2.xのヘッダーファイルが存在する場合です。 |
以下は、/usr/include/apache2.0に、Apache2.0のヘッダーファイルが存在する場合です。 |
| 48 |
<program title="Configure"> |
<program title="Configure"> |
| 49 |
$ ./configure --with-apache-header=/usr/include/apache2.x |
$ ./configure --with-apache-header=/usr/include/apache2.0 |
| 50 |
</program> |
</program> |
| 51 |
<note>--with-apache-headerは必須です。</note> |
<note>--with-apache-headerは必須です。</note> |
| 52 |
<note>環境によっては--with-iconvや--with-apr、--with-apuも必要です</note> |
<note>FreeBSD等の場合は--with-iconvも必須です。</note> |
| 53 |
|
<note>場合によっては--with-aprや--with-apuも必要です。</note> |
| 54 |
</li> |
</li> |
| 55 |
<li>mod_chxj.soを生成します |
<li>mod_chxj.soを生成します |
| 56 |
<program title="make"> |
<program title="make"> |
| 89 |
|
|
| 90 |
<program title="httpd.conf"> |
<program title="httpd.conf"> |
| 91 |
#==================================================================================== |
#==================================================================================== |
| 92 |
# モジュールをApache2.xにロード |
# モジュールをApache2.0にロード |
| 93 |
#==================================================================================== |
#==================================================================================== |
| 94 |
LoadModule chxj_module /usr/lib/apache2/modules/mod_chxj.so |
LoadModule chxj_module /usr/lib/apache2/modules/mod_chxj.so |
| 95 |
|
|
| 123 |
|
|
| 124 |
<program title="httpd.conf"> |
<program title="httpd.conf"> |
| 125 |
#==================================================================================== |
#==================================================================================== |
| 126 |
# モジュールをApache2.xにロード |
# モジュールをApache2.0にロード |
| 127 |
#==================================================================================== |
#==================================================================================== |
| 128 |
LoadModule chxj_module /usr/lib/apache2/modules/mod_chxj.so |
LoadModule chxj_module /usr/lib/apache2/modules/mod_chxj.so |
| 129 |
|
|
| 159 |
|
|
| 160 |
<program title="httpd.conf"> |
<program title="httpd.conf"> |
| 161 |
#==================================================================================== |
#==================================================================================== |
| 162 |
# モジュールをApache2.xにロード |
# モジュールをApache2.0にロード |
| 163 |
#==================================================================================== |
#==================================================================================== |
| 164 |
LoadModule chxj_module /usr/lib/apache2/modules/mod_chxj.so |
LoadModule chxj_module /usr/lib/apache2/modules/mod_chxj.so |
| 165 |
|
|
| 267 |
<br /> |
<br /> |
| 268 |
</li> |
</li> |
| 269 |
|
|
| 270 |
|
<li>ChxjImageCacheLimit<br /> |
| 271 |
|
mod_chxj画像変換ハンドラが使用する変換後の画像をおいておくディレクトリの許容量を指定します。 |
| 272 |
|
単位はbyte。 |
| 273 |
|
|
| 274 |
|
<program title="ChxjImageCacheLimit"> |
| 275 |
|
ChxjImageCacheLimit 1024 |
| 276 |
|
</program> |
| 277 |
|
|
| 278 |
|
mod_chxjに画像変換キャッシュ最大サイズとして1kbyteと指定。 |
| 279 |
|
※このとき変換結果が1kbyte以上あるような場合にはINTERNAL_SERVER_ERRORを返します。 |
| 280 |
|
十分な領域を確保するか、画像サイズを小さくしてください。 |
| 281 |
|
<br /> |
| 282 |
|
<br /> |
| 283 |
|
</li> |
| 284 |
|
|
| 285 |
|
|
| 286 |
<li>ChxjImageCopyright<br /> |
<li>ChxjImageCopyright<br /> |
| 287 |
mod_chxjの画像変換ハンドラに、転送禁止設定を行うよう指示します。 |
mod_chxjの画像変換ハンドラに、転送禁止設定を行うよう指示します。 |
| 383 |
ChxjImageCacheDir /tmp |
ChxjImageCacheDir /tmp |
| 384 |
</program> |
</program> |
| 385 |
</li> |
</li> |
| 386 |
|
<li>ChxjImageCacheLimit<br /> |
| 387 |
|
イメージの一時ファイル保存許容量を指定します。 |
| 388 |
|
下記は1MByteの例。 |
| 389 |
|
<program title="ex)"> |
| 390 |
|
ChxjImageCacheLimit 1048576 |
| 391 |
|
</program> |
| 392 |
|
</li> |
| 393 |
<li>ChxjImageCopyright<br /> |
<li>ChxjImageCopyright<br /> |
| 394 |
イメージに著作権情報を付与します。 |
イメージに著作権情報を付与します。 |
| 395 |
<program title="ex)"> |
<program title="ex)"> |
| 396 |
ChxjImageCacheDir "chosakuken jyoho" |
ChxjImageCopyright "chosakuken jyoho" |
| 397 |
</program> |
</program> |
| 398 |
</li> |
</li> |
| 399 |
<li>ChxjConvertRule<br /> |
<li>ChxjConvertRule<br /> |