<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html lang="ja" dir="LTR">
 <head>
  <meta http-equiv="Content-Type" content="text/html; charset=ISO-2022-JP">
  <title>ローマ字ひらがな変換ライブラリ suikyo for Emacs Lisp</title>
<?php require_once("http://www.taiyaki.org/taiyaki.phpm"); ?>
 </head>

 <body>
<!-- Start Header -->
<?php $HTML->header(); ?>
<!-- End Header -->

<!-- Start Body -->
  <h1>ローマ字ひらがな変換ライブラリ suikyo for Emacs Lisp</h1>

  <h2>suikyo 「水鏡」とは</h2>
  <p>
   suikyo は決定性オートマトンに基づいて, 文字列の変換を行うライブラリです.
   主には「ローマ字ひらがな変換」に使用されます. 例えば "suikyou" という
   文字列から "すいきょう" と変換を行なったり, 逆に "すいきょう" から
   "suikyou" に変換することが可能です.
  </p>
  <p>
   このページ内容は Emacs Lisp 用ライブラリの説明です.
   <a href="../index.html">suikyo 全般のページ</a>も参照して下さい.
  </p>

  <h2>サンプルコード</h2>
<pre>
(require 'init-suikyo)

;; ローマ字ひらがな変換
(suikyo-convert-romaji-kana "suikyou ")
;; => "すいきょう"

;; " " 空白は入力の区切りと解釈されます.
(suikyo-convert-romaji-kana "shin")
;; => しn
(suikyo-convert-romaji-kana "shin ")
;; => しん
(suikyo-convert-romaji-kana "shin ai")
;; => しんあい
</pre>

<pre>
;;; suikyo-convert-romaji-kana を使わない汎用的な方法.
(require 'init-suikyo)

;; 変換テーブルの読み込み
(setq table (suikyo-table-loadfile (list nil) "romaji-kana"))

;; 変換テーブルを用いた文字列の変換
(suikyo-convert table "suikyou")
;; => "すいきょう"
</pre>

  <h2>API の説明</h2>
  <p>
   suikyo を使うには "(require 'init-suikyo)" を行う必要があります.
  </p>

  <dl class="list">
   <dt>(suikyo-convert-romaji-kana string)</dt>
   <dd>
    <p>
     与えられたローマ字をひらがなに変換して返します.
    </p>
    <p>
     変換ルールは, 変数 suikyo-table-romaji-kana の内容を使用します.
     suikyo-table-romaji-kana が nil の場合は自動的にデフォルトの
     ルールを読み込みます.
    </p>
   </dd>

   <dt>(suikyo-convert-kana-romaji string)</dt>
   <dd>
    <p>
     与えられたひらがなをローマ字に変換して返します.
    </p>
    <p>
     変換ルールは, 変数 suikyo-table-kana-romaji の内容を使用します.
     suikyo-table-kana-romaji が nil の場合は自動的にデフォルトの
     ルールを読み込みます.
    </p>
   </dd>
   
   <dt>(suikyo-convert table string)</dt>
   <dd>
    文字列 string を変換ルール table に基づいて変換します.
   </dd>

   <dt>(suikyo-table-loadfile table filename &amp;optional table-path)</dt>
   <dd>
    <p>
     <a href="../index.html#format">変換ルールのフォーマット</a>
     で記述されたファイル filename を読み込み, 変換ルール table に追加します.
     新規に変換ルールを作成する場合は, table の値は "(list nil)" にする
     必要があります.
    </p>
<pre>
;; "/tmp/english.kpdef" を読み込んで新しい変換ルールを作成する.
(setq english-table
      (suikyo-table-loadfile (list nil) "english.kpdef" "/tmp"))
</pre>
    <p>
     table-path が省略された場合は, 変数 suikyo-table-path がファイルのパスに
     なります.
    </p>
   </dd>

   <dt>(suikyo-table-set table conv-from conv-to &amp;optional pendency)</dt>
   <dd> 
    「入力データ」・「変換データ」・「保留データ」を指定して, 
    変換ルールを table に追加します. 各データについては
    <a href="../index.html#format">変換ルールのフォーマット</a>
    を参照して下さい. 
   </dd>
  </dl>

  <h2>インストール</h2>
  <p>
   <a href="../index.html#install">suikyo 全般のページ</a>を参照して下さい.
  </p>

  <h2>更新履歴</h2>
  <dl>
   <dt>2004-01-31</dt>
   <dd><ul>
     <li>1.3.0 からの仕様変更へのドキュメントの追随.
      白井秀行 &lt;shirai@rdmg.mgcs.mei.co.jp&gt;さん,
      やまだあきら &lt;akira@arika.org&gt;さん
      のご報告に感謝.
     </li>
    </ul>
   </dd>

   <dt>2003-04-25</dt>
   <dd><ul>
     <li>ドキュメントの間違い (関数名が suikyo-table-set ではなくて,
      suikyo-table-init だった) の修正. 
      Hideyuki ENDO &lt;endo-h@remus.dti.ne.jp&gt; さんのご報告に感謝.
     </li>
    </ul>
   </dd>

   <dt>2002-11-23</dt>
   <dd><ul>
     <li>リリース</li>
    </ul>
   </dd>
  </dl>

<!-- End Body -->

<!-- Start Footer -->
<?php $HTML->footer(); ?>

  <div class="id" align="right">
   小松 弘幸 &lt;komatsu@taiyaki.org&gt;<br>
   $Id: index.html,v 1.2 2004/01/31 07:23:25 komatsu Exp $
  </div>
<!-- End Footer -->

 </body>
</html>
<!--
Local variables:
sgml-omittag: nil
sgml-shorttag: nil
sgml-indent-step: 1
sgml-indent-data: t
End:
-->
