AquaSKK

Fork

[aquaskk-changes 620] CVS update: htdocs

t-suw****@users***** t-suw****@users*****
2009年 11月 27日 (金) 00:03:25 JST

• 前の記事 [aquaskk-changes 619] CVS update: htdocs
• 次の記事 [aquaskk-changes 621] [147] r212 ＠ milonga-2: t_suwa | 2009-11-25 23:53:07 +0900
• 記事の並び順: [ 日付 ] [ スレッド ] [ 件名 ] [ 著者 ]

Index: htdocs/kana_rule.html
diff -u htdocs/kana_rule.html:1.1 htdocs/kana_rule.html:1.2
--- htdocs/kana_rule.html:1.1	Thu Nov 26 01:12:10 2009
+++ htdocs/kana_rule.html	Fri Nov 27 00:03:24 2009
@@ -18,56 +18,81 @@
     <div class="main">
 
       <p>
-        AquaSKK ではローマ字かな変換用に以下の設定ファイルを利用します。
+        AquaSKK ではローマ字かな変換用に kana-rule.conf という設定ファイルを利用します。
+        kana-rule.conf には、ローマ字に対応するかな変換を以下の形式で記述します。
       </p>
 
-      <table>
-        <tr>
-          <th nowrap>ファイル名</th>
-          <th nowrap>文字コード</th>
-          <th width="100%">説明</th>
-        </tr>
+      <pre>ローマ字,ひらかな,カタカナ,半角カナ,次状態</pre>
 
-        <tr>
-          <td nowrap>kana-rule.conf</td>
-          <td nowrap>EUC-JP</td>
-          <td>ローマ字かな変換ルール本体。個人フォルダに同名のファイルを置くと内容を完全に置換できる。</td>
-        </tr>
+      <p>
+        次状態は省略可能です。実際の kana-rule.conf から一部抜粋します。
+      </p>
+
+      <pre>###
+### kana-rule.conf
+###
+
+a,あ,ア,ｱ
+
+bb,っ,ッ,ｯ,b
+ba,ば,バ,ﾊﾞ
+bi,び,ビ,ﾋﾞ
+bu,ぶ,ブ,ﾌﾞ
+be,べ,ベ,ﾍﾞ
+bo,ぼ,ボ,ﾎﾞ</pre>
+
+      <p>
+        # で始まる行はコメントとみなされ、無視されます。ファイルの文字コードは EUC-JP です。
+        ここで <kbd>a</kbd> を入力すると、ひらかなモードのときには「あ」に変換されます。同様に
+        <kbd>b</kbd><kbd>b</kbd> と入力すると「っ」に変換され、さらに「b」が先行入力された状態になります。
+      </p>
 
+      <p>
+        独自に作成した kana-rule.conf を個人フォルダ(~/Library/Application Support/AquaSKK)
+        に配置することで、標準のかな変換ルールを完全に置換することが可能です。
+        なお、カンマやシャープ等の特殊文字を変換ルールとして指定する場合には、
+        以下のエスケープ文字を使う必要があります。
+      </p>
+
+      <table>
         <tr>
-          <td nowrap>azik.rule</td>
-          <td nowrap>EUC-JP</td>
-          <td>拡張ローマ字入力「AZIK」用の補助変換ルール。</td>
+          <th>特殊文字</th>
+          <th>エスケープ文字</th>
         </tr>
-
         <tr>
-          <td nowrap>comma.rule</td>
-          <td nowrap>EUC-JP</td>
-          <td>読点をカンマにする補助変換ルール。</td>
+          <td>,</td>
+          <td>&comma;</td>
         </tr>
-
         <tr>
-          <td nowrap>period.rule</td>
-          <td nowrap>EUC-JP</td>
-          <td>句点をピリオドにする補助変換ルール。</td>
+          <td>#</td>
+          <td>&sharp;</td>
         </tr>
-
         <tr>
-          <td nowrap>sub-rule.desc</td>
-          <td nowrap>UTF-8</td>
-          <td>補助変換ルールの説明。環境設定パネルで表示される内容を指定する。</td>
+          <td>スペース</td>
+          <td>&space;</td>
         </tr>
       </table>
 
       <h2>補助変換ルール</h2>
 
       <p>
-        拡張子「rule」を持つファイルを補助変換ルールと呼びます。
-        補助変換ルールの文法は kana-rule.conf と同じですが、
-        カスタマイズが必要のある箇所だけを差分で記述されています。
-        例えば period.rule は、以下のような単純な内容です。
+        AquaSKK 4.1 以降では、補助変換ルールによる差分カスタマイズが可能になりました。
+        補助変換ルールは拡張子 .rule を持つファイルで、kana-rule.conf と同じ書式ですが、
+        カスタマイズが必要な箇所だけを記述します。
+      </p>
+
+      <p>
+        標準で提供される補助変換ルールには、以下のものがあります。
       </p>
 
+      <ul>
+        <li>azik.rule: 拡張ローマ字入力「AZIK」を有効にする</li>
+        <li>comma.rule: 読点をカンマにする</li>
+        <li>period.rule: 句点をピリオドにする</li>
+      </ul>
+
+      <p>例えば period.rule は以下のような単純な内容になっています。</p>
+
       <pre>
 ###
 ### period.rule -- 句点ルール
@@ -81,18 +106,25 @@
 
       <script>image("補助変換ルール一覧", "sub_rules.png");</script>
 
+      <p>
+        有効化された補助変換ルールは、kana-rule.conf を部分的に上書きします。
+        上書きと言っても、kana-rule.conf ファイルを物理的に変更するわけではありません。
+        メモリ中に構築されたかな変換ルールの一部分が上書きされるだけです。
+      </p>
+
       <h2>ユーザー定義の補助変換ルール</h2>
 
       <p>
-        作成した補助変換ルールを個人フォルダ (~/Library/Application Support/AquaSKK/)
-        に置くと自動的に環境設定パネルに表示され、利用可能になります。
+        独自に作成した補助変換ルールを個人フォルダ (~/Library/Application Support/AquaSKK/)
+        に置くと、自動的に環境設定パネルに表示され、利用可能になります。
       </p>
 
       <script>image("test.rule を個人フォルダに配置", "user_sub_rule1.png");</script>
 
       <p>
-        「かな変換規則」カラムには、デフォルトでファイル名が表示されます。
-        この内容は sub-rule.desc を用意することでカスタマイズすることが可能です。
+        このままでも動作に支障はありませんが、
+        補助変換ルールの説明カラムには「test.rule」というファイル名がそのまま表示されています。
+        これをわかりやすくするには、sub-rule.desc というファイルを用意します。
       </p>
 
       <pre>
@@ -103,17 +135,22 @@
 test.rule       「#」を全角にする</pre>
 
       <p>
-        各行ごとに、ファイル名とその説明を羅列していくだけです。説明には空白を含めることはできません。
-        # で始まる行はコメントです。このファイルを個人フォルダに置いた状態で環境設定パネルを開くと、
-        以下のように表示されます。
+        # で始まる行はコメントです。各行ごとに、ファイル名と一つ以上の空白に続けて説明を記述します。
+        説明には空白を含めることはできません。ファイルの文字コードは UTF-8 です。
+        このファイルを個人フォルダに置いた状態で環境設定パネルを開くと、
+        以下のように説明が表示されます。
       </p>
 
       <script>image("sub-rule.desc がある場合", "user_sub_rule2.png");</script>
 
+      <p>
+        ユーザー定義の補助変換ルールは、区分カラムに「ユーザー」が表示されます。
+      </p>
+      
     </div>
 
     <div class="sidebar">
-      <script>lastupdate("$Date: 2009/11/25 16:12:10 $");</script>
+      <script>lastupdate("$Date: 2009/11/26 15:03:24 $");</script>
       <script type="text/javascript" src="./sidebar.js"></script>
     </div>
 

• 前の記事 [aquaskk-changes 619] CVS update: htdocs
• 次の記事 [aquaskk-changes 621] [147] r212 ＠ milonga-2: t_suwa | 2009-11-25 23:53:07 +0900
• 記事の並び順: [ 日付 ] [ スレッド ] [ 件名 ] [ 著者 ]