Develop and Download Open Source Software

Browse CVS Repository

Diff of /modchxj/mod_chxj/doc/modchxj.html

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph | View Patch Patch

revision 1.24 by konn, Tue Feb 5 13:06:06 2008 UTC revision 1.25 by konn, Wed Feb 6 06:51:25 2008 UTC
# Line 702  function setOHPHandler() { Line 702  function setOHPHandler() {
702  <li> <a href="#doc1_20" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">インストール</a>  <li> <a href="#doc1_20" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">インストール</a>
703  <ul>  <ul>
704  <li> <a href="#doc1_22" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">準備</a>  <li> <a href="#doc1_22" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">準備</a>
705  <li> <a href="#doc1_49" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">mod_chxjの入手</a>  <li> <a href="#doc1_46" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">mod_chxjの入手</a>
706  <li> <a href="#doc1_55" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">インストール</a>  <li> <a href="#doc1_52" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">インストール</a>
707  </ul>  </ul>
708  <li> <a href="#doc1_104" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">Configuration</a>  <li> <a href="#doc1_101" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">Configuration</a>
709  <ul>  <ul>
710  <li> <a href="#doc1_106" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">htmlファイルが変換対象の場合</a>  <li> <a href="#doc1_103" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">htmlファイルが変換対象の場合</a>
711  <li> <a href="#doc1_121" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">php等の出力結果が変換対象の場合</a>  <li> <a href="#doc1_118" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">php等の出力結果が変換対象の場合</a>
712  <li> <a href="#doc1_136" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">xoopsを使用し、且つwordpress、bwikiを使用している場合</a>  <li> <a href="#doc1_133" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">xoopsを使用し、且つwordpress、bwikiを使用している場合</a>
713  <li> <a href="#doc1_151" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">画像自動変換機能を使用する場合</a>  <li> <a href="#doc1_148" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">画像自動変換機能を使用する場合</a>
714  <li> <a href="#doc1_228" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">文字コードを変換したい場合(EXPERIMENTAL)</a>  <li> <a href="#doc1_225" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">文字コードを変換したい場合(EXPERIMENTAL)</a>
715  <li> <a href="#doc1_272" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">ディレクティブ</a>  <li> <a href="#doc1_269" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">ディレクティブ</a>
716  </ul>  </ul>
717  <li> <a href="#doc1_397" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">対応するCHTMLタグ</a>  <li> <a href="#doc1_394" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">対応するCHTMLタグ</a>
718  <li> <a href="#doc1_1105" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">独自拡張タグ</a>  <li> <a href="#doc1_1102" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">独自拡張タグ</a>
719  <li> <a href="#doc1_1142" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">絵文字について</a>  <li> <a href="#doc1_1139" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">絵文字について</a>
720  <ul>  <ul>
721  <li> <a href="#doc1_1147" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">絵文字変換定義</a>  <li> <a href="#doc1_1144" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">絵文字変換定義</a>
722  </ul>  </ul>
723  <li> <a href="#doc1_1192" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">デバイス定義 device_data.xml</a>  <li> <a href="#doc1_1189" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">デバイス定義 device_data.xml</a>
724  <li> <a href="#doc1_1195" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">イメージ画像変換機能</a>  <li> <a href="#doc1_1192" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">イメージ画像変換機能</a>
725  <ul>  <ul>
726  <li> <a href="#doc1_1204" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">サムネイルモード</a>  <li> <a href="#doc1_1201" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">サムネイルモード</a>
727  <li> <a href="#doc1_1210" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">壁紙モード</a>  <li> <a href="#doc1_1207" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">壁紙モード</a>
728  <li> <a href="#doc1_1216" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">EzGetモード</a>  <li> <a href="#doc1_1213" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">EzGetモード</a>
729  <li> <a href="#doc1_1222" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">その他の機能</a>  <li> <a href="#doc1_1219" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">その他の機能</a>
730  </ul>  </ul>
731  <li> <a href="#doc1_1253" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">QRコード出力機能</a>  <li> <a href="#doc1_1250" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">QRコード出力機能</a>
732  <ul>  <ul>
733  <li> <a href="#doc1_1255" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">QRコード出力ハンドラの登録</a>  <li> <a href="#doc1_1252" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">QRコード出力ハンドラの登録</a>
734  <li> <a href="#doc1_1261" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">QRコードソースファイルの設置</a>  <li> <a href="#doc1_1258" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">QRコードソースファイルの設置</a>
735  <li> <a href="#doc1_1285" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">QRコードの動的出力機能</a>  <li> <a href="#doc1_1282" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">QRコードの動的出力機能</a>
736  </ul>  </ul>
737  <li> <a href="#doc1_1292" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">Cookieシミュレート機能(EXPERIMENTAL)</a>  <li> <a href="#doc1_1289" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">Cookieシミュレート機能(EXPERIMENTAL)</a>
738  <ul>  <ul>
739  <li> <a href="#doc1_1294" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">Cookieシミュレート機能(EXPERIMENTAL)</a>  <li> <a href="#doc1_1291" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">Cookieシミュレート機能(EXPERIMENTAL)</a>
740  <li> <a href="#doc1_1300" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">One-Time ID</a>  <li> <a href="#doc1_1297" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">One-Time ID</a>
741  <li> <a href="#doc1_1303" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">Cookieの保存場所</a>  <li> <a href="#doc1_1300" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">Cookieの保存場所</a>
742  <li> <a href="#doc1_1309" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">Cookieの保持期間</a>  <li> <a href="#doc1_1306" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">Cookieの保持期間</a>
743  </ul>  </ul>
744  <li> <a href="#doc1_1316" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">Refererシミュレート機能(EXPERIMENTAL)</a>  <li> <a href="#doc1_1313" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">Refererシミュレート機能(EXPERIMENTAL)</a>
745  <ul>  <ul>
746  <li> <a href="#doc1_1318" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">Refererシミュレート機能(EXPERIMENTAL)</a>  <li> <a href="#doc1_1315" onmouseover="hilightSelflink(this)" onmouseout="normal(this)">Refererシミュレート機能(EXPERIMENTAL)</a>
747  </ul>  </ul>
748  </ul>  </ul>
749  </div>  </div>
750    
751  <h2 id="doc1_17">Overview</h2>  <h2 id="doc1_17">Overview</h2>
752    
753  <p class="first_ja">mod_chxjはオープンソースの携帯向けコンテンツ変換Apache2.0用モジュールであり、CHTML(DoCoMo i-Mode用CHTML3.0)で記述された文書や通常のHTMLで記述された文書を、アクセスに来た端末のUser-Agentヘッダを見て、それぞれの端末にあった形式に変換します。HTML文書に限らず、画像(jpg、gif、png)、絵文字についても、定義ファイルに従ってそれぞれのキャリアにあった絵文字に変換します。Cookie非対応端末、Refer非対応端末のために、Set-Cookie、CookieヘッダやRefererヘッダをシミュレートすることもできます(EXPERIMENTAL)。</p>  <p class="first_ja">mod_chxjはオープンソースの携帯向けコンテンツ変換Apache2.x用モジュールであり、CHTML(DoCoMo i-Mode用CHTML3.0)で記述された文書や通常のHTMLで記述された文書を、アクセスに来た端末のUser-Agentヘッダを見て、それぞれの端末にあった形式に変換します。HTML文書に限らず、画像(jpg、gif、png)、絵文字についても、定義ファイルに従ってそれぞれのキャリアにあった絵文字に変換します。Cookie非対応端末、Refer非対応端末のために、Set-Cookie、CookieヘッダやRefererヘッダをシミュレートすることもできます(EXPERIMENTAL)。</p>
754    
755  <h2 id="doc1_20">インストール</h2>  <h2 id="doc1_20">インストール</h2>
756    
# Line 760  function setOHPHandler() { Line 760  function setOHPHandler() {
760  <p class="first_ja">mod_chxjをインストールする前に、下記のものを用意する必要があります。</p>  <p class="first_ja">mod_chxjをインストールする前に、下記のものを用意する必要があります。</p>
761    
762  <ol>  <ol>
763  <li> Apache2.0のヘッダーファイル群  <li> Apache2.xのヘッダーファイル群
764  <li> Apache2.0用のapxs  <li> Apache2.x用のapxs
765  <li> apr(Apache Portable Runtime)ライブラリとそのヘッダファイル郡(apu含む)  <li> apr(Apache Portable Runtime)ライブラリとそのヘッダファイル郡(apu含む)
766  <li> automake、autoconf、libtool1.3.X  <li> automake、autoconf、libtool1.3.X
767  <li> ImageMagick(MagickWand)  <li> ImageMagick(MagickWand)
 <li> libiconvまたはlibiconv_hook  
768  <li> Linux</ol>  <li> Linux</ol>
769    
770    
771  <h3 id="doc1_49">mod_chxjの入手</h3>  <h3 id="doc1_46">mod_chxjの入手</h3>
772    
773  <p class="first_ja">mod_chxjは<a href="http://sourceforge.jp/projects/modchxj/" target="_top" onmouseover="hilightExternallink(this)" onmouseout="normal(this)">こちら</a>からダウンロードすることができます。</p>  <p class="first_ja">mod_chxjは<a href="http://sourceforge.jp/projects/modchxj/" target="_top" onmouseover="hilightExternallink(this)" onmouseout="normal(this)">こちら</a>からダウンロードすることができます。</p>
774    
775  <h3 id="doc1_55">インストール</h3>  <h3 id="doc1_52">インストール</h3>
776    
777  <p class="first_ja">以下にmod_chxjインストール手順を示します。</p>  <p class="first_ja">以下にmod_chxjインストール手順を示します。</p>
778    
779  <ol>  <ol>
780  <li> <p>Configureスクリプトを生成します</p>  <li> <p>Configureスクリプトを生成します(必須ではない)</p>
781    
782  <div id="doc1_61" class="caption">Configure スクリプトの生成</div>  <div id="doc1_58" class="caption">Configure スクリプトの生成</div>
783  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
784  $ ./buildconf.sh  $ ./buildconf.sh
785  </pre>  </pre>
786    
787  <p><span class="note"><a href="#doc1_64" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="&quot;$&quot;はプロンプトをあらわします。"><sup>(1)</sup></a></span></p>  <p><span class="note"><a href="#doc1_61" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="&quot;$&quot;はプロンプトをあらわします。"><sup>(1)</sup></a></span></p>
788  <li> <p>Configure</p>  <li> <p>Configure</p>
 <p>以下は、/usr/include/apache2.0に、Apache2.0のヘッダーファイルが存在する場合です。</p>  
789    
790  <div id="doc1_70" class="caption">Configure</div>  <div id="doc1_67" class="caption">Configure</div>
791  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
792  $ ./configure --with-apache-header=/usr/include/apache2.0  $ ./configure
793  </pre>  </pre>
794    
795  <p><span class="note"><a href="#doc1_73" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="--with-apache-headerは必須です。"><sup>(2)</sup></a></span><span class="note"><a href="#doc1_76" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="FreeBSD等の場合は--with-iconvも必須です。"><sup>(3)</sup></a></span><span class="note"><a href="#doc1_79" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="場合によっては--with-aprや--with-apuも必要です。"><sup>(4)</sup></a></span></p>  <p><span class="note"><a href="#doc1_70" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="場合によっては--with-aprや--with-apuも必要です。"><sup>(2)</sup></a></span><span class="note"><a href="#doc1_73" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="0.8.xの場合には--with-apache-headerが必須です"><sup>(3)</sup></a></span></p>
796  <li> mod_chxj.soを生成します  <li> mod_chxj.soを生成します
797  <div id="doc1_85" class="caption">make</div>  <div id="doc1_79" class="caption">make</div>
798  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
799  $ make  $ make
800  </pre>  </pre>
801  <li> apacheにインストールします  <li> apacheにインストールします
802  <div id="doc1_91" class="caption">install</div>  <div id="doc1_85" class="caption">install</div>
803  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
804  $ make install  $ make install
805  </pre>  </pre>
806  <li> <p>データの設置etcディレクトリは以下のdevice_data.xmlとemoji.xmlをApacheからアクセスできるところに配置します。</p>  <li> <p>データの設置etcディレクトリは以下のdevice_data.xmlとemoji.xmlをApacheからアクセスできるところに配置します。<span class="note"><a href="#doc1_91" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="0.9.0からemoji.xml、device_data.xmlの定義フォーマットを変更しましたのでバージョンをあわせてください"><sup>(4)</sup></a></span></p>
807  <p>以下、/etc/apache2/chxjディレクトリにchxj用設定ファイルを用意する場合</p>  <p>以下、/etc/apache2/chxjディレクトリにchxj用設定ファイルを用意する場合</p>
808    
809  <div id="doc1_97" class="caption">データの設置</div>  <div id="doc1_94" class="caption">データの設置</div>
810  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
811  $ mkdir -p /etc/apache2/chxj  $ mkdir -p /etc/apache2/chxj
812  $ cp etc/device_data.xml /etc/apache2/chxj  $ cp etc/device_data.xml /etc/apache2/chxj
# Line 818  $ cp etc/emoji.xml /etc/apache2/chxj Line 816  $ cp etc/emoji.xml /etc/apache2/chxj
816    
817  <div class="footnote">  <div class="footnote">
818  <ol>  <ol>
819  <li id="doc1_64" value="1"> &quot;$&quot;はプロンプトをあらわします。<li id="doc1_73" value="2"> --with-apache-headerは必須です。<li id="doc1_76" value="3"> FreeBSD等の場合は--with-iconvも必須です。<li id="doc1_79" value="4"> 場合によっては--with-aprや--with-apuも必要です。</ol>  <li id="doc1_61" value="1"> &quot;$&quot;はプロンプトをあらわします。<li id="doc1_70" value="2"> 場合によっては--with-aprや--with-apuも必要です。<li id="doc1_73" value="3"> 0.8.xの場合には--with-apache-headerが必須です<li id="doc1_91" value="4"> 0.9.0からemoji.xml、device_data.xmlの定義フォーマットを変更しましたのでバージョンをあわせてください</ol>
820  </div>  </div>
821    
822    
823  <h2 id="doc1_104">Configuration</h2>  <h2 id="doc1_101">Configuration</h2>
824    
825  <p class="first_ja">以下はmod_chxjが/usr/lib/apache2/modulesディレクトリ配下に設置されたものとしています</p>  <p class="first_ja">以下はmod_chxjが/usr/lib/apache2/modulesディレクトリ配下に設置されたものとしています</p>
826    
827  <h3 id="doc1_106">htmlファイルが変換対象の場合</h3>  <h3 id="doc1_103">htmlファイルが変換対象の場合</h3>
828    
829  <p class="first_ja">例として、Locationが&quot;/chxj&quot;以下のものは全て変換する場合を説明します。</p>  <p class="first_ja">例として、Locationが&quot;/chxj&quot;以下のものは全て変換する場合を説明します。</p>
830    
831  <ol>  <ol>
832  <li> httpd.confに以下を追加します。  <li> httpd.confに以下を追加します。
833  <div id="doc1_112" class="caption">httpd.conf</div>  <div id="doc1_109" class="caption">httpd.conf</div>
834  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
835  #====================================================================================  #====================================================================================
836  # モジュールをApache2.0にロード  # モジュールをApache2.0にロード
# Line 861  ChxjConvertRule &quot;^/chxj.+$&quot; &q Line 859  ChxjConvertRule &quot;^/chxj.+$&quot; &q
859  <li> apacheの再起動。</ol>  <li> apacheの再起動。</ol>
860    
861    
862  <h3 id="doc1_121">php等の出力結果が変換対象の場合</h3>  <h3 id="doc1_118">php等の出力結果が変換対象の場合</h3>
863    
864    
865  <ol>  <ol>
866  <li> httpd.confに以下を追加します  <li> httpd.confに以下を追加します
867  <div id="doc1_127" class="caption">httpd.conf</div>  <div id="doc1_124" class="caption">httpd.conf</div>
868  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
869  #====================================================================================  #====================================================================================
870  # モジュールをApache2.0にロード  # モジュールをApache2.0にロード
# Line 896  ChxjConvertRule &quot;^/chxj.+$&quot; &q Line 894  ChxjConvertRule &quot;^/chxj.+$&quot; &q
894  <li> apacheの再起動。</ol>  <li> apacheの再起動。</ol>
895    
896    
897  <h3 id="doc1_136">xoopsを使用し、且つwordpress、bwikiを使用している場合</h3>  <h3 id="doc1_133">xoopsを使用し、且つwordpress、bwikiを使用している場合</h3>
898    
899    
900  <ol>  <ol>
901  <li> httpd.confに以下を追加します  <li> httpd.confに以下を追加します
902  <div id="doc1_142" class="caption">httpd.conf</div>  <div id="doc1_139" class="caption">httpd.conf</div>
903  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
904  #====================================================================================  #====================================================================================
905  # モジュールをApache2.0にロード  # モジュールをApache2.0にロード
# Line 971  ChxjConvertRule &quot;^/.+$&quot; &quot; Line 969  ChxjConvertRule &quot;^/.+$&quot; &quot;
969  <li> apacheの再起動。</ol>  <li> apacheの再起動。</ol>
970    
971    
972  <h3 id="doc1_151">画像自動変換機能を使用する場合</h3>  <h3 id="doc1_148">画像自動変換機能を使用する場合</h3>
973    
974    
975  <ol>  <ol>
976  <li> <p>httpd.confに以下を追加します。下記は、URIが/imgで始まる全ての画像に対して動作するようmod_chxjに指示しています。</p>  <li> <p>httpd.confに以下を追加します。下記は、URIが/imgで始まる全ての画像に対して動作するようmod_chxjに指示しています。</p>
977    
978  <div id="doc1_157" class="caption">httpd.conf</div>  <div id="doc1_154" class="caption">httpd.conf</div>
979  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
980  &lt;Location /img&gt;  &lt;Location /img&gt;
981  ChxjImageEngine On  ChxjImageEngine On
982  ChxjImageCacheDir /tmp  ChxjImageCacheDir /tmp
983  ChxjImageCopyright &quot;A.Konno&quot;  ChxjImageCopyright &quot;A.Konno&quot;
984    ChxjImageCacheLimit 10485760
985  &lt;/Location&gt;  &lt;/Location&gt;
986  </pre>  </pre>
987    
# Line 993  ChxjImageCopyright &quot;A.Konno&quot; Line 992  ChxjImageCopyright &quot;A.Konno&quot;
992  <p><br></br> <br></br></p>  <p><br></br> <br></br></p>
993  <li> <p>ChxjImageCacheDir<br></br> mod_chxj画像変換ハンドラが使用する変換後の画像をおいておくディレクトリを指定します。デフォルトは/tmp。</p>  <li> <p>ChxjImageCacheDir<br></br> mod_chxj画像変換ハンドラが使用する変換後の画像をおいておくディレクトリを指定します。デフォルトは/tmp。</p>
994    
995  <div id="doc1_175" class="caption">ChxjImageCacheDir</div>  <div id="doc1_172" class="caption">ChxjImageCacheDir</div>
996  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
997        ChxjImageCacheDir /tmp        ChxjImageCacheDir /tmp
998                
999  </pre>  </pre>
1000    
1001  <p>mod_chxjに画像変換キャッシュとして/tmpを使用するよう指示します。<br></br><br></br></p>  <p>mod_chxjに画像変換キャッシュとして/tmpを使用するよう指示します。<br></br><br></br></p>
 <li> <p>ChxjImageCacheLimit<br></br> mod_chxj画像変換ハンドラが使用する変換後の画像をおいておくディレクトリの許容量を指定します。単位はbyte。</p>  
   
 <div id="doc1_187" class="caption">ChxjImageCacheLimit</div>  
 <pre class="program" style="margin-top:0">  
       ChxjImageCacheLimit 1024  
         
 </pre>  
   
 <p>mod_chxjに画像変換キャッシュ最大サイズとして1kbyteと指定。※このとき変換結果が1kbyte以上あるような場合にはINTERNAL_SERVER_ERRORを返します。十分な領域を確保するか、画像サイズを小さくしてください。<br></br><br></br></p>  
1002  <li> <p>ChxjImageCopyright<br></br> mod_chxjの画像変換ハンドラに、転送禁止設定を行うよう指示します。パラメータとして任意の文字列をとります。ChxjImageCopyrightディレクティブで指定された文字列は、それぞれのイメージのコメント部に埋め込まれます。</p>  <li> <p>ChxjImageCopyright<br></br> mod_chxjの画像変換ハンドラに、転送禁止設定を行うよう指示します。パラメータとして任意の文字列をとります。ChxjImageCopyrightディレクティブで指定された文字列は、それぞれのイメージのコメント部に埋め込まれます。</p>
1003    
1004  <div id="doc1_199" class="caption">ChxjImageCopyright</div>  <div id="doc1_184" class="caption">ChxjImageCopyright</div>
1005  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1006        ChxjImageCopyright &quot;A.Konno&quot;        ChxjImageCopyright &quot;A.Konno&quot;
1007                
# Line 1020  ChxjImageCopyright &quot;A.Konno&quot; Line 1010  ChxjImageCopyright &quot;A.Konno&quot;
1010  <p>mod_chxjに転送禁止設定を行うよう指示しています。変換後イメージのコメント部分には、キャリア毎に以下の文字列を埋め込みます。</p>  <p>mod_chxjに転送禁止設定を行うよう指示しています。変換後イメージのコメント部分には、キャリア毎に以下の文字列を埋め込みます。</p>
1011  <p><b>AU の場合</b></p>  <p><b>AU の場合</b></p>
1012    
1013  <div id="doc1_205" class="caption">AU</div>  <div id="doc1_190" class="caption">AU</div>
1014  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1015         kddi_copyright=on,A.Konno         kddi_copyright=on,A.Konno
1016                
# Line 1028  ChxjImageCopyright &quot;A.Konno&quot; Line 1018  ChxjImageCopyright &quot;A.Konno&quot;
1018    
1019  <p><b>DoCoMoの場合</b></p>  <p><b>DoCoMoの場合</b></p>
1020    
1021  <div id="doc1_211" class="caption">DoCoMo</div>  <div id="doc1_196" class="caption">DoCoMo</div>
1022  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1023  copy=&quot;NO&quot;,A.Konno  copy=&quot;NO&quot;,A.Konno
1024  </pre>  </pre>
1025    
1026  <p><b>SoftBank/Vodafone</b>の場合は、レスポンスヘッダに</p>  <p><b>SoftBank/Vodafone</b>の場合は、レスポンスヘッダに</p>
1027    
1028  <div id="doc1_217" class="caption">SoftBank/Vodafone/J-PHONE</div>  <div id="doc1_202" class="caption">SoftBank/Vodafone/J-PHONE</div>
1029  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1030           x-jphone-copyright:no-transfer           x-jphone-copyright:no-transfer
1031                
1032  </pre>  </pre>
1033    
1034  <p>を埋め込みます。<span class="note"><a href="#doc1_220" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="SoftBank/Vodafoneの場合は、リクエストURLの最後が.pnzか、.jpzで終わるようにダミーを付けなければなりません。"><sup>(5)</sup></a></span></p></ol></ol>  <p>を埋め込みます。<span class="note"><a href="#doc1_205" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="SoftBank/Vodafoneの場合は、リクエストURLの最後が.pnzか、.jpzで終わるようにダミーを付けなければなりません。"><sup>(5)</sup></a></span></p>
1035    <li> <p>ChxjImageCacheLimit<br></br> mod_chxj画像変換ハンドラが使用する変換後の画像をおいておくディレクトリの許容量を指定します。単位はbyte。</p>
1036    
1037    <div id="doc1_213" class="caption">ChxjImageCacheLimit</div>
1038    <pre class="program" style="margin-top:0">
1039          ChxjImageCacheLimit 1024
1040          
1041    </pre>
1042    
1043    <p>mod_chxjに画像変換キャッシュ最大サイズとして1kbyteと指定。※このとき変換結果が1kbyte以上あるような場合にはINTERNAL_SERVER_ERRORを返します。十分な領域を確保するか、画像サイズを小さくしてください。<br></br><br></br></p></ol></ol>
1044    
1045    
1046  <div class="footnote">  <div class="footnote">
1047  <ol>  <ol>
1048  <li id="doc1_220" value="5"> SoftBank/Vodafoneの場合は、リクエストURLの最後が.pnzか、.jpzで終わるようにダミーを付けなければなりません。</ol>  <li id="doc1_205" value="5"> SoftBank/Vodafoneの場合は、リクエストURLの最後が.pnzか、.jpzで終わるようにダミーを付けなければなりません。</ol>
1049  </div>  </div>
1050    
1051    
1052  <h3 id="doc1_228">文字コードを変換したい場合(EXPERIMENTAL)</h3>  <h3 id="doc1_225">文字コードを変換したい場合(EXPERIMENTAL)</h3>
1053    
1054    
1055  <ol>  <ol>
1056  <li> <p>httpd.confに以下を追加します。下記は、URIが/chxjで始まる全てのコンテンツに対して動作するようmod_chxjに指示しています。サーバ側はEUC-JPであった場合の例です。mod_chxjによってSJISに変換するように指示しています。サーバ側がShift_JISで無い場合は、Shift_JISコードの10進参照文字列表記を記述することによってShift_JISコードの絵文字2バイトコードに変換しクライアントへ返します。</p>  <li> <p>httpd.confに以下を追加します。下記は、URIが/chxjで始まる全てのコンテンツに対して動作するようmod_chxjに指示しています。サーバ側はEUC-JPであった場合の例です。mod_chxjによってSJISに変換するように指示しています。サーバ側がShift_JISで無い場合は、Shift_JISコードの10進参照文字列表記を記述することによってShift_JISコードの絵文字2バイトコードに変換しクライアントへ返します。</p>
1057    
1058  <div id="doc1_234" class="caption">httpd.conf</div>  <div id="doc1_231" class="caption">httpd.conf</div>
1059  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1060  ChxjConvRule &quot;^/chxj.+$&quot; &quot;EngineOn&quot; &quot;EUC-JP&quot;  ChxjConvRule &quot;^/chxj.+$&quot; &quot;EngineOn&quot; &quot;EUC-JP&quot;
1061  </pre>  </pre>
# Line 1072  ChxjConvRule &quot;^/chxj.+$&quot; &quot Line 1071  ChxjConvRule &quot;^/chxj.+$&quot; &quot
1071  <p><br></br><br></br></p></ol></ol>  <p><br></br><br></br></p></ol></ol>
1072    
1073    
1074  <h3 id="doc1_272">ディレクティブ</h3>  <h3 id="doc1_269">ディレクティブ</h3>
1075    
1076    
1077  <ol>  <ol>
1078  <li> ChxjLoadDeviceData<br></br>デバイス定義ファイルを指定します。  <li> ChxjLoadDeviceData<br></br>デバイス定義ファイルを指定します。
1079  <div id="doc1_280" class="caption">ex)</div>  <div id="doc1_277" class="caption">ex)</div>
1080  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1081      ChxjLoadDeviceData /etc/apache2/device.xml      ChxjLoadDeviceData /etc/apache2/device.xml
1082        
1083  </pre>  </pre>
1084  <li> ChxjLoadEmojiData<br></br>絵文字変換定義ファイルを指定します。  <li> ChxjLoadEmojiData<br></br>絵文字変換定義ファイルを指定します。
1085  <div id="doc1_288" class="caption">ex)</div>  <div id="doc1_285" class="caption">ex)</div>
1086  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1087      ChxjLoadEmojiData   /etc/apache2/chxj/emoji.xml      ChxjLoadEmojiData   /etc/apache2/chxj/emoji.xml
1088        
1089  </pre>  </pre>
1090  <li> ChxjImageEngine<br></br>画像変換エンジンを有効にします。パラメータとしてOnとOffを指定できます。DefaultはOffです。  <li> ChxjImageEngine<br></br>画像変換エンジンを有効にします。パラメータとしてOnとOffを指定できます。DefaultはOffです。
1091  <div id="doc1_296" class="caption">ex)</div>  <div id="doc1_293" class="caption">ex)</div>
1092  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1093      ChxjImageEngine On      ChxjImageEngine On
1094        
1095  </pre>  </pre>
1096  <li> ChxjImageCacheDir<br></br>イメージの一時ファイル保存場所を指定します。  <li> ChxjImageCacheDir<br></br>イメージの一時ファイル保存場所を指定します。
1097  <div id="doc1_304" class="caption">ex)</div>  <div id="doc1_301" class="caption">ex)</div>
1098  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1099      ChxjImageCacheDir   /tmp      ChxjImageCacheDir   /tmp
1100        
1101  </pre>  </pre>
1102  <li> ChxjImageCacheLimit<br></br>イメージの一時ファイル保存許容量を指定します。下記は1MByteの例。  <li> ChxjImageCacheLimit<br></br>イメージの一時ファイル保存許容量を指定します。下記は1MByteの例。
1103  <div id="doc1_312" class="caption">ex)</div>  <div id="doc1_309" class="caption">ex)</div>
1104  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1105      ChxjImageCacheLimit   1048576      ChxjImageCacheLimit   1048576
1106        
1107  </pre>  </pre>
1108  <li> ChxjImageCopyright<br></br>イメージに著作権情報を付与します。  <li> ChxjImageCopyright<br></br>イメージに著作権情報を付与します。
1109  <div id="doc1_320" class="caption">ex)</div>  <div id="doc1_317" class="caption">ex)</div>
1110  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1111      ChxjImageCopyright   &quot;chosakuken jyoho&quot;      ChxjImageCopyright   &quot;chosakuken jyoho&quot;
1112        
1113  </pre>  </pre>
1114  <li> ChxjConvertRule<br></br> HTML変換エンジンの適用ルールを記述します。本ディレクティブを使用し、変換エンジンのOn|Offを指定します。DefaultはOFFです。また、ルールは記述された順番に評価し、マッチするものがあれば、その時点で対象ルールを適用します。パラメータは3つ必要です。下記にパラメータを記します。  <li> ChxjConvertRule<br></br> HTML変換エンジンの適用ルールを記述します。本ディレクティブを使用し、変換エンジンのOn|Offを指定します。DefaultはOFFです。また、ルールは記述された順番に評価し、マッチするものがあれば、その時点で対象ルールを適用します。パラメータは3つ必要です。下記にパラメータを記します。
1115  <div class="table">  <div class="table">
1116  <table id="doc1_328" class="data" rules="groups">  <table id="doc1_325" class="data" rules="groups">
1117  <caption>パラメータ</caption>  <caption>パラメータ</caption>
1118  <colgroup span="2">  <colgroup span="2">
1119  <col>  <col>
# Line 1146  ChxjConvRule &quot;^/chxj.+$&quot; &quot Line 1145  ChxjConvRule &quot;^/chxj.+$&quot; &quot
1145  </div>  </div>
1146    
1147    
1148  <div id="doc1_374" class="caption">ex)</div>  <div id="doc1_371" class="caption">ex)</div>
1149  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1150      ChxjConvertRule &quot;^/chxj.+$/&quot; EngineOn EUC-JP      ChxjConvertRule &quot;^/chxj.+$/&quot; EngineOn EUC-JP
1151        
1152  </pre>  </pre>
1153  <li> <p>ChxjCookieDir<br></br>クッキーを使用する場合に指定します。クッキーの内容を保存するディレクトリを指定します。指定しない場合は/tmpに保存されます。</p>  <li> <p>ChxjCookieDir<br></br>クッキーを使用する場合に指定します。クッキーの内容を保存するディレクトリを指定します。指定しない場合は/tmpに保存されます。</p>
1154    
1155  <div id="doc1_382" class="caption">ex)</div>  <div id="doc1_379" class="caption">ex)</div>
1156  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1157      &lt;Location /&gt;      &lt;Location /&gt;
1158        ChxjCookieDir   /tmp        ChxjCookieDir   /tmp
# Line 1164  ChxjConvRule &quot;^/chxj.+$&quot; &quot Line 1163  ChxjConvRule &quot;^/chxj.+$&quot; &quot
1163  <p>詳細は「Cookieシミュレート機能」の項を参照ください。</p>  <p>詳細は「Cookieシミュレート機能」の項を参照ください。</p>
1164  <li> <p>ChxjCookieTimeout<br></br>クッキーを使用する場合に指定します。クッキーの保持期間を秒単位で指定します。指定しない場合は、1800秒でクッキーデータを破棄します。</p>  <li> <p>ChxjCookieTimeout<br></br>クッキーを使用する場合に指定します。クッキーの保持期間を秒単位で指定します。指定しない場合は、1800秒でクッキーデータを破棄します。</p>
1165    
1166  <div id="doc1_390" class="caption">ex)</div>  <div id="doc1_387" class="caption">ex)</div>
1167  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1168      &lt;Location /&gt;      &lt;Location /&gt;
1169        ChxjCookieTimeout 10        ChxjCookieTimeout 10
# Line 1175  ChxjConvRule &quot;^/chxj.+$&quot; &quot Line 1174  ChxjConvRule &quot;^/chxj.+$&quot; &quot
1174  <p>詳細は「Cookieシミュレート機能」の項を参照ください。</p></ol>  <p>詳細は「Cookieシミュレート機能」の項を参照ください。</p></ol>
1175    
1176    
1177  <h2 id="doc1_397">対応するCHTMLタグ</h2>  <h2 id="doc1_394">対応するCHTMLタグ</h2>
1178    
1179  <p class="first_ja">変換可能なCHTMLタグは以下のとおりです。</p>  <p class="first_ja">変換可能なCHTMLタグは以下のとおりです。</p>
1180    
1181  <div class="table">  <div class="table">
1182  <table id="doc1_399" class="data" rules="groups">  <table id="doc1_396" class="data" rules="groups">
1183  <caption>対応タグ一覧</caption>  <caption>対応タグ一覧</caption>
1184  <colgroup span="7">  <colgroup span="7">
1185  <col>  <col>
# Line 1399  ChxjConvRule &quot;^/chxj.+$&quot; &quot Line 1398  ChxjConvRule &quot;^/chxj.+$&quot; &quot
1398  <td align="center">○</td>  <td align="center">○</td>
1399  <td align="center">○</td>  <td align="center">○</td>
1400  <td align="center">○</td>  <td align="center">○</td>
1401  <td align="left"><span class="note"><a href="#doc1_954" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="必ず閉じてください。そのうち対応します。"><sup>(7)</sup></a></span></td>  <td align="left"><span class="note"><a href="#doc1_951" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="必ず閉じてください。そのうち対応します。"><sup>(7)</sup></a></span></td>
1402  </tr>  </tr>
1403  <tr class="even">  <tr class="even">
1404  <td></td>  <td></td>
# Line 1462  ChxjConvRule &quot;^/chxj.+$&quot; &quot Line 1461  ChxjConvRule &quot;^/chxj.+$&quot; &quot
1461    
1462  <div class="footnote">  <div class="footnote">
1463  <ol>  <ol>
1464  <li id="doc1_954" value="7"> 必ず閉じてください。そのうち対応します。</ol>  <li id="doc1_951" value="7"> 必ず閉じてください。そのうち対応します。</ol>
1465  </div>  </div>
1466    
1467    
1468  <h2 id="doc1_1105">独自拡張タグ</h2>  <h2 id="doc1_1102">独自拡張タグ</h2>
1469    
1470    
1471  <ol>  <ol>
1472  <li> <p>&lt;CHXJ:IF&gt;<br></br></p>  <li> <p>&lt;CHXJ:IF&gt;<br></br></p>
1473  <p>&lt;CHXJ:IF&gt;タグと&lt;/CHXJ:IF&gt;タグではさまれたタグやテキストは、変換せずに<b>そのまま</b><span class="note"><a href="#doc1_1115" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="変換しませんので注意が必要です"><sup>(8)</sup></a></span>出力します。必須の属性としてlangがあります。lang属性を指定することによって、例えば、<b>「HDML機の場合のみ出力させる」</b>といったことを可能にします。<br></br><br></br>ex)</p>  <p>&lt;CHXJ:IF&gt;タグと&lt;/CHXJ:IF&gt;タグではさまれたタグやテキストは、変換せずに<b>そのまま</b><span class="note"><a href="#doc1_1112" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="変換しませんので注意が必要です"><sup>(8)</sup></a></span>出力します。必須の属性としてlangがあります。lang属性を指定することによって、例えば、<b>「HDML機の場合のみ出力させる」</b>といったことを可能にします。<br></br><br></br>ex)</p>
1474    
1475  <div id="doc1_1125" class="caption">HTML文書中にHDML機の場合のみ有効にしたいタグ、または文書がある場合</div>  <div id="doc1_1122" class="caption">HTML文書中にHDML機の場合のみ有効にしたいタグ、または文書がある場合</div>
1476  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1477         &lt;CHXJ:IF lang=&quot;HDML&quot; &gt;         &lt;CHXJ:IF lang=&quot;HDML&quot; &gt;
1478           &lt;NODISPLAY&gt;           &lt;NODISPLAY&gt;
# Line 1487  ChxjConvRule &quot;^/chxj.+$&quot; &quot Line 1486  ChxjConvRule &quot;^/chxj.+$&quot; &quot
1486  <p><br></br></p>  <p><br></br></p>
1487  <p>ex)</p>  <p>ex)</p>
1488    
1489  <div id="doc1_1129" class="caption">i-Modeのみ出力したい文書がある場合</div>  <div id="doc1_1126" class="caption">i-Modeのみ出力したい文書がある場合</div>
1490  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1491         &lt;CHXJ:IF lang=&quot;chtml&quot; &gt;         &lt;CHXJ:IF lang=&quot;chtml&quot; &gt;
1492           シークレットコードがどーのこーの。           シークレットコードがどーのこーの。
# Line 1498  ChxjConvRule &quot;^/chxj.+$&quot; &quot Line 1497  ChxjConvRule &quot;^/chxj.+$&quot; &quot
1497  <p><br></br></p>  <p><br></br></p>
1498  <p>また、lang属性は、複数指定することも可能です。<br></br></p>  <p>また、lang属性は、複数指定することも可能です。<br></br></p>
1499    
1500  <div id="doc1_1135" class="caption">HDML機,J-PHONE機は以下を出力します</div>  <div id="doc1_1132" class="caption">HDML機,J-PHONE機は以下を出力します</div>
1501  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1502         &lt;CHXJ:IF lang=&quot;chtml&quot; lang=&quot;jhtml&quot;&gt;         &lt;CHXJ:IF lang=&quot;chtml&quot; lang=&quot;jhtml&quot;&gt;
1503         あなたの携帯は、HDML機かJ-HTML機です。         あなたの携帯は、HDML機かJ-HTML機です。
# Line 1511  ChxjConvRule &quot;^/chxj.+$&quot; &quot Line 1510  ChxjConvRule &quot;^/chxj.+$&quot; &quot
1510    
1511  <div class="footnote">  <div class="footnote">
1512  <ol>  <ol>
1513  <li id="doc1_1115" value="8"> 変換しませんので注意が必要です</ol>  <li id="doc1_1112" value="8"> 変換しませんので注意が必要です</ol>
1514  </div>  </div>
1515    
1516    
1517  <h2 id="doc1_1142">絵文字について</h2>  <h2 id="doc1_1139">絵文字について</h2>
1518    
1519  <p class="first_ja">i-Mode用の絵文字を書いておけば、アクセスしたキャリアによって、mod_chxjが対応の絵文字に自動変換します。ソースに2byteのバイナリコードを直接書いても、10進参照文字列<span class="note"><a href="#doc1_1144" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="16進参照文字列には対応していません"><sup>(9)</sup></a></span>(&amp;#XXX;の形)で書いても、どちらでも変換対象になります。10進参照文字列で書いた場合は、mod_chxjにより、自動で2バイトコードに変換します。</p>  <p class="first_ja">i-Mode用の絵文字を書いておけば、アクセスしたキャリアによって、mod_chxjが対応の絵文字に自動変換します。ソースに2byteのバイナリコードを直接書いても、10進参照文字列<span class="note"><a href="#doc1_1141" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="16進参照文字列には対応していません"><sup>(9)</sup></a></span>(&amp;#XXX;の形)で書いても、どちらでも変換対象になります。10進参照文字列で書いた場合は、mod_chxjにより、自動で2バイトコードに変換します。</p>
1520    
1521  <div class="footnote">  <div class="footnote">
1522  <ol>  <ol>
1523  <li id="doc1_1144" value="9"> 16進参照文字列には対応していません</ol>  <li id="doc1_1141" value="9"> 16進参照文字列には対応していません</ol>
1524  </div>  </div>
1525    
1526    
1527  <h3 id="doc1_1147">絵文字変換定義</h3>  <h3 id="doc1_1144">絵文字変換定義</h3>
1528    
1529  <p class="first_ja">絵文字の変換に関する動作を変えたい場合(例えば「ハートがあったら、AUの場合はスペードに」とか、「変換定義がおかしい」といった場合)は、emoji.xmlファイルを直接編集することによって定義を変更することが可能です。emoji.xmlはXMLファイルとなっていますので、vi等で簡単に定義を変更することができます<span class="note"><a href="#doc1_1149" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="厳密にはXMLになっていないので、日本語の記述はSJISでお願いします。"><sup>(10)</sup></a></span>。</p>  <p class="first_ja">絵文字の変換に関する動作を変えたい場合(例えば「ハートがあったら、AUの場合はスペードに」とか、「変換定義がおかしい」といった場合)は、emoji.xmlファイルを直接編集することによって定義を変更することが可能です。emoji.xmlはXMLファイルとなっていますので、vi等で簡単に定義を変更することができます<span class="note"><a href="#doc1_1146" onmouseover="hilightSelflink(this)" onmouseout="normal(this)" title="厳密にはXMLになっていないので、日本語の記述はSJISでお願いします。"><sup>(10)</sup></a></span>。</p>
1530  <p><br></br>以下に、emoji.xmlファイルの一部を記します。</p>  <p><br></br>以下に、emoji.xmlファイルの一部を記します。</p>
1531    
1532  <div id="doc1_1154" class="caption">emoji.xml</div>  <div id="doc1_1151" class="caption">emoji.xml</div>
1533  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1534  &lt;?xml encoding=&quot;Shift_JIS&quot; &gt;  &lt;?xml encoding=&quot;Shift_JIS&quot; &gt;
1535    
# Line 1566  ChxjConvRule &quot;^/chxj.+$&quot; &quot Line 1565  ChxjConvRule &quot;^/chxj.+$&quot; &quot
1565    
1566  <div class="footnote">  <div class="footnote">
1567  <ol>  <ol>
1568  <li id="doc1_1149" value="10"> 厳密にはXMLになっていないので、日本語の記述はSJISでお願いします。</ol>  <li id="doc1_1146" value="10"> 厳密にはXMLになっていないので、日本語の記述はSJISでお願いします。</ol>
1569  </div>  </div>
1570    
1571    
1572  <h2 id="doc1_1192">デバイス定義 device_data.xml</h2>  <h2 id="doc1_1189">デバイス定義 device_data.xml</h2>
1573    
1574  <p class="first_ja">mod_chxjの動作を決定付ける重要な定義です。変換対象の端末は全て、device_data.xmlファイルに定義される必要があります。定義されていない端末は、mod_chxjとしては、認識することができません。認識できない場合には、変換せずにそのまま出力します。ただし、Perl互換の正規表現によって定義できるため、正規表現の書き方によっては全ての機種に対応させることも可能です。</p>  <p class="first_ja">mod_chxjの動作を決定付ける重要な定義です。変換対象の端末は全て、device_data.xmlファイルに定義される必要があります。定義されていない端末は、mod_chxjとしては、認識することができません。認識できない場合には、変換せずにそのまま出力します。ただし、Perl互換の正規表現によって定義できるため、正規表現の書き方によっては全ての機種に対応させることも可能です。</p>
1575    
1576  <h2 id="doc1_1195">イメージ画像変換機能</h2>  <h2 id="doc1_1192">イメージ画像変換機能</h2>
1577    
1578  <p class="first_ja">mod_chxjには、JPEG、GIF、PNG、BMPファイルを置いておくだけで、デバイス定義に従って、それぞれのキャリア対応のフォーマットに変換する機能があります。画像のサイズ(縦X横)も、端末の画面サイズに合わせて変換します。画像のサイズ(バイト数)については、デバイス定義中のキャッシュサイズを見て、その値よりも小さくなるように<b>努力</b>しますが、元の画像が大きすぎる場合や、複雑な画像の場合には、キャッシュサイズよりも小さくできずに表示できない場合があります。<br></br>それぞれのタグで指定する場合には、ファイル名の拡張子(.jpgや.gif等)をはずした形で指定します。<br></br>本機能には3つのモードが存在します。そのモードを以下に記します。</p>  <p class="first_ja">mod_chxjには、JPEG、GIF、PNG、BMPファイルを置いておくだけで、デバイス定義に従って、それぞれのキャリア対応のフォーマットに変換する機能があります。画像のサイズ(縦X横)も、端末の画面サイズに合わせて変換します。画像のサイズ(バイト数)については、デバイス定義中のキャッシュサイズを見て、その値よりも小さくなるように<b>努力</b>しますが、元の画像が大きすぎる場合や、複雑な画像の場合には、キャッシュサイズよりも小さくできずに表示できない場合があります。<br></br>それぞれのタグで指定する場合には、ファイル名の拡張子(.jpgや.gif等)をはずした形で指定します。<br></br>本機能には3つのモードが存在します。そのモードを以下に記します。</p>
1579    
1580  <h3 id="doc1_1204">サムネイルモード</h3>  <h3 id="doc1_1201">サムネイルモード</h3>
1581    
1582  <p class="first_ja">端末側画面サイズの約3分の1程度のサイズ(縦X横)に画像を縮小表示します。</p>  <p class="first_ja">端末側画面サイズの約3分の1程度のサイズ(縦X横)に画像を縮小表示します。</p>
1583    
1584  <div id="doc1_1206" class="caption">サムネイルモード 使用例</div>  <div id="doc1_1203" class="caption">サムネイルモード 使用例</div>
1585  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1586    &lt;IMG SRC=&quot;/img/logo?Mode=Thumbnail&quot;&gt;    &lt;IMG SRC=&quot;/img/logo?Mode=Thumbnail&quot;&gt;
1587        
1588  </pre>  </pre>
1589    
1590    
1591  <h3 id="doc1_1210">壁紙モード</h3>  <h3 id="doc1_1207">壁紙モード</h3>
1592    
1593  <p class="first_ja">端末側画面のサイズにマッチするサイズに拡大・縮小します。横長の画像の場合には、縦幅を合わせた後に左右をトリミングします。</p>  <p class="first_ja">端末側画面のサイズにマッチするサイズに拡大・縮小します。横長の画像の場合には、縦幅を合わせた後に左右をトリミングします。</p>
1594    
1595  <div id="doc1_1212" class="caption">壁紙モード 使用例</div>  <div id="doc1_1209" class="caption">壁紙モード 使用例</div>
1596  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1597    &lt;IMG SRC=&quot;/img/logo?Mode=WP&quot;&gt;    &lt;IMG SRC=&quot;/img/logo?Mode=WP&quot;&gt;
1598        
1599  </pre>  </pre>
1600    
1601    
1602  <h3 id="doc1_1216">EzGetモード</h3>  <h3 id="doc1_1213">EzGetモード</h3>
1603    
1604  <p class="first_ja">壁紙ダウンロードを行いたい場合に使用します。EzGETモードは、壁紙モードで出力される画像サイズと同一サイズの画像が使用されます。</p>  <p class="first_ja">壁紙ダウンロードを行いたい場合に使用します。EzGETモードは、壁紙モードで出力される画像サイズと同一サイズの画像が使用されます。</p>
1605    
1606  <div id="doc1_1218" class="caption">EzGetモード 使用例</div>  <div id="doc1_1215" class="caption">EzGetモード 使用例</div>
1607  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1608    &lt;A HREF=&quot;/img/logo?Mode=EzGet&quot;&gt;    &lt;A HREF=&quot;/img/logo?Mode=EzGet&quot;&gt;
1609        
1610  </pre>  </pre>
1611    
1612    
1613  <h3 id="doc1_1222">その他の機能</h3>  <h3 id="doc1_1219">その他の機能</h3>
1614    
1615  <p class="first_ja">モードの他に、画像サイズ(縦X横)を直接指定することも可能です。<b>w</b>パラメータ、<b>h</b>パラメータを使用して指定します。</p>  <p class="first_ja">モードの他に、画像サイズ(縦X横)を直接指定することも可能です。<b>w</b>パラメータ、<b>h</b>パラメータを使用して指定します。</p>
1616    
# Line 1619  ChxjConvRule &quot;^/chxj.+$&quot; &quot Line 1618  ChxjConvRule &quot;^/chxj.+$&quot; &quot
1618  <li> wパラメータ<br></br>横幅を指定します。  <li> wパラメータ<br></br>横幅を指定します。
1619  <li> hパラメータ<br></br>縦幅を指定します。  <li> hパラメータ<br></br>縦幅を指定します。
1620    
1621  <div id="doc1_1242" class="caption">w/hパラメータ 使用例</div>  <div id="doc1_1239" class="caption">w/hパラメータ 使用例</div>
1622  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1623    &lt;IMG SRC=&quot;/img/logo?w=100&amp;h=200&quot;&gt;    &lt;IMG SRC=&quot;/img/logo?w=100&amp;h=200&quot;&gt;
1624        
# Line 1629  ChxjConvRule &quot;^/chxj.+$&quot; &quot Line 1628  ChxjConvRule &quot;^/chxj.+$&quot; &quot
1628    
1629  <p>上記全てのモード、パラメータはGETリクエストとしてのみ使用できます。</p>  <p>上記全てのモード、パラメータはGETリクエストとしてのみ使用できます。</p>
1630    
1631  <h2 id="doc1_1253">QRコード出力機能</h2>  <h2 id="doc1_1250">QRコード出力機能</h2>
1632    
1633    
1634  <h3 id="doc1_1255">QRコード出力ハンドラの登録</h3>  <h3 id="doc1_1252">QRコード出力ハンドラの登録</h3>
1635    
1636  <p class="first_ja">QRコード出力機能を使用するには、QRコードハンドラを登録します。httpd.confに以下の記述を追加します。</p>  <p class="first_ja">QRコード出力機能を使用するには、QRコードハンドラを登録します。httpd.confに以下の記述を追加します。</p>
1637    
1638  <div id="doc1_1257" class="caption">httpd.conf</div>  <div id="doc1_1254" class="caption">httpd.conf</div>
1639  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1640    AddHandler chxj-qrcode .qrc    AddHandler chxj-qrcode .qrc
1641  </pre>  </pre>
1642    
1643  <p>なお、ハンドラを登録しないでも、出力フィルターを経由させることで、QRコードを出力させることも可能です。(※QRコードの動的出力を参照)</p>  <p>なお、ハンドラを登録しないでも、出力フィルターを経由させることで、QRコードを出力させることも可能です。(※QRコードの動的出力を参照)</p>
1644    
1645  <h3 id="doc1_1261">QRコードソースファイルの設置</h3>  <h3 id="doc1_1258">QRコードソースファイルの設置</h3>
1646    
1647  <p class="first_ja">ハンドラを登録したら、その登録した拡張子を持つファイルを用意します。</p>  <p class="first_ja">ハンドラを登録したら、その登録した拡張子を持つファイルを用意します。</p>
1648    
1649  <div id="doc1_1263" class="caption">例:a.qrc</div>  <div id="doc1_1260" class="caption">例:a.qrc</div>
1650  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1651    &lt;?xml version=1.0 ?&gt;    &lt;?xml version=1.0 ?&gt;
1652        
# Line 1670  ChxjConvRule &quot;^/chxj.+$&quot; &quot Line 1669  ChxjConvRule &quot;^/chxj.+$&quot; &quot
1669  <li> dataタグdataタグは、QRコードに出力するデータを指定します。改行した場合は、改行文字もQRコード内に符号化されます。</ol>  <li> dataタグdataタグは、QRコードに出力するデータを指定します。改行した場合は、改行文字もQRコード内に符号化されます。</ol>
1670    
1671    
1672  <h3 id="doc1_1285">QRコードの動的出力機能</h3>  <h3 id="doc1_1282">QRコードの動的出力機能</h3>
1673    
1674  <p class="first_ja">プログラム等を使用し、動的にQRコードを出力したい場合は、上記の.qrcファイルの内容をそのままOutputFilterに通してあげればOKです。つまり、ChxjConvertRuleディレクティブで&quot;EngineOn&quot;と指定したURIが指すディレクトリに設置すれば良いということです。mod_chxj内部で、Content-Typeがtext/xmlの場合、QRCode用のファイルであるかどうかを一度読み込んで判断するので、Content-Typeには、text/xmlを設定してください。</p>  <p class="first_ja">プログラム等を使用し、動的にQRコードを出力したい場合は、上記の.qrcファイルの内容をそのままOutputFilterに通してあげればOKです。つまり、ChxjConvertRuleディレクティブで&quot;EngineOn&quot;と指定したURIが指すディレクトリに設置すれば良いということです。mod_chxj内部で、Content-Typeがtext/xmlの場合、QRCode用のファイルであるかどうかを一度読み込んで判断するので、Content-Typeには、text/xmlを設定してください。</p>
1675    
1676  <div id="doc1_1287" class="caption">phpでQRコードを動的に出力する例</div>  <div id="doc1_1284" class="caption">phpでQRコードを動的に出力する例</div>
1677  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1678      &lt;php      &lt;php
1679        $version = $_POST[&quot;version&quot;];        $version = $_POST[&quot;version&quot;];
# Line 1698  ChxjConvRule &quot;^/chxj.+$&quot; &quot Line 1697  ChxjConvRule &quot;^/chxj.+$&quot; &quot
1697    
1698  <p>そして、上記のコードを、mod_chxj変換エンジンが処理するはずであるところに設置すれば完了です。</p>  <p>そして、上記のコードを、mod_chxj変換エンジンが処理するはずであるところに設置すれば完了です。</p>
1699    
1700  <h2 id="doc1_1292">Cookieシミュレート機能(EXPERIMENTAL)</h2>  <h2 id="doc1_1289">Cookieシミュレート機能(EXPERIMENTAL)</h2>
1701    
1702    
1703  <h3 id="doc1_1294">Cookieシミュレート機能(EXPERIMENTAL)</h3>  <h3 id="doc1_1291">Cookieシミュレート機能(EXPERIMENTAL)</h3>
1704    
1705  <p class="first_ja">Cookieを受け付けない(無視する)端末のためにCookieをシミュレートします。本機能を有効にするためにはChxjConvertRuleディレクティブを使用する必要があります。ChxjConvertRuleディレクティブの第2パラメータにCookieOnを指定します。</p>  <p class="first_ja">Cookieを受け付けない(無視する)端末のためにCookieをシミュレートします。本機能を有効にするためにはChxjConvertRuleディレクティブを使用する必要があります。ChxjConvertRuleディレクティブの第2パラメータにCookieOnを指定します。</p>
1706    
1707  <div id="doc1_1296" class="caption">Cookieシミュレート機能を有効にする例</div>  <div id="doc1_1293" class="caption">Cookieシミュレート機能を有効にする例</div>
1708  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1709      ChxjConvertRule &quot;^/chxj.+$&quot; &quot;EngineOn,CookieOn&quot; &quot;NONE&quot;      ChxjConvertRule &quot;^/chxj.+$&quot; &quot;EngineOn,CookieOn&quot; &quot;NONE&quot;
1710        
1711  </pre>  </pre>
1712    
1713    
1714  <h3 id="doc1_1300">One-Time ID</h3>  <h3 id="doc1_1297">One-Time ID</h3>
1715    
1716  <p class="first_ja">Cookieシミュレートでは、aタグ、imgタグ、formタグのURL部にOne-Time IDを埋め込むことで実現します。そのため、ユーザがブラウザの戻るボタン等で戻った場合はCookieを取得できなくなります。</p>  <p class="first_ja">Cookieシミュレートでは、aタグ、imgタグ、formタグのURL部にOne-Time IDを埋め込むことで実現します。そのため、ユーザがブラウザの戻るボタン等で戻った場合はCookieを取得できなくなります。</p>
1717    
1718  <h3 id="doc1_1303">Cookieの保存場所</h3>  <h3 id="doc1_1300">Cookieの保存場所</h3>
1719    
1720  <p class="first_ja">Cookieの内容は、サーバ側に保存されます。保存ディレクトリはChxjCookieDirディレクティブを使用することで指定することができます。指定しなかった場合は、/tmpに保存されます。</p>  <p class="first_ja">Cookieの内容は、サーバ側に保存されます。保存ディレクトリはChxjCookieDirディレクティブを使用することで指定することができます。指定しなかった場合は、/tmpに保存されます。</p>
1721    
1722  <div id="doc1_1305" class="caption">ChxjCookieDirの例</div>  <div id="doc1_1302" class="caption">ChxjCookieDirの例</div>
1723  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1724      ChxjCookieDir /var/abc      ChxjCookieDir /var/abc
1725        
1726  </pre>  </pre>
1727    
1728    
1729  <h3 id="doc1_1309">Cookieの保持期間</h3>  <h3 id="doc1_1306">Cookieの保持期間</h3>
1730    
1731  <p class="first_ja">ChxjCookieTimeoutディレクティブで保持期間を指定することができます。指定しなかった場合は1800秒でサーバに保存されているCookieは削除されます。</p>  <p class="first_ja">ChxjCookieTimeoutディレクティブで保持期間を指定することができます。指定しなかった場合は1800秒でサーバに保存されているCookieは削除されます。</p>
1732    
1733  <div id="doc1_1311" class="caption">ChxjCookieTimeoutの例</div>  <div id="doc1_1308" class="caption">ChxjCookieTimeoutの例</div>
1734  <pre class="program" style="margin-top:0">  <pre class="program" style="margin-top:0">
1735      &lt;Location /&gt;      &lt;Location /&gt;
1736        ChxjCookieTimeout 10        ChxjCookieTimeout 10
# Line 1741  ChxjConvRule &quot;^/chxj.+$&quot; &quot Line 1740  ChxjConvRule &quot;^/chxj.+$&quot; &quot
1740    
1741  <p>上記の例は、10秒でタイムアウト(サーバから削除)するように指定しています。</p>  <p>上記の例は、10秒でタイムアウト(サーバから削除)するように指定しています。</p>
1742    
1743  <h2 id="doc1_1316">Refererシミュレート機能(EXPERIMENTAL)</h2>  <h2 id="doc1_1313">Refererシミュレート機能(EXPERIMENTAL)</h2>
1744    
1745    
1746  <h3 id="doc1_1318">Refererシミュレート機能(EXPERIMENTAL)</h3>  <h3 id="doc1_1315">Refererシミュレート機能(EXPERIMENTAL)</h3>
1747    
1748  <p class="first_ja">DoCoMo端末などのRefererに対応していない機種のためにRefererシミュレート機能を提供します。本機能は、Cookieシミュレート機能を有効にすると、自動で有効になります(将来的には変更予定)。</p>  <p class="first_ja">DoCoMo端末などのRefererに対応していない機種のためにRefererシミュレート機能を提供します。本機能は、Cookieシミュレート機能を有効にすると、自動で有効になります(将来的には変更予定)。</p>
1749  </body>  </body>

Legend:
Removed from v.1.24  
changed lines
  Added in v.1.25

Back to OSDN">Back to OSDN
ViewVC Help
Powered by ViewVC 1.1.26