sumibi.el(testing)

このドキュメントについて

このドキュメントは、sumibi.el 0.7.2についての解説です。

sumibi.elの特徴

• 簡単インストール

  sumibi.elをロードするだけで即使えます。

  (変換サーバーはsumibi.orgで提供しています。自分で変換サーバーを用意しなくても使い始めることができます。)

• モードレス

  日本語入力モードという概念がありません。Emacsバッファに入力したローマ字文字列を直接、漢字変換できます。

  もう日本語/英単の切り替えでイライラするということがありません。

• シンプルなユーザーインターフェース

  なるべく少ないキーで操作できるように設計しています。短時間で覚えることができます。

インストール

1. sumibi.elをEmacsのロードパスにコピーします。

   Emacsのロードパスを調べるには、Emacs 起動後、 M-x describe-variable で変数説明コマンドを実行し、変数 load-path を指定して内容を調べてください。

2. curlをインストールします。

   ほとんどのディストリビューションで curl コマンドがサポートされています。

   以下のディストリビューションでは curlが標準でサポートされていることを確認しました。

   • Debian GNU/Linux 3.0及び3.1
   • Red Hat Enterprise 3.0及び4.0
   • Cygwin (最新版)

   httpsプロキシーサーバーを使用するには以下の例のように環境変数を設定する必要があります。

   export http_proxy=http://your.proxy.server:8080/
   export https_proxy=http://your.proxy.server:8080/
   

3. .emacsに次のコードを追加します。

   (load "sumibi")
   (global-sumibi-mode 1)
   

   ※変数 sumibi-server-use-cert を nil にするとSSL証明書を利用しなくても通信できます。但し、この設定ではSumibi Serverとの通信の安全性が低下しますので、sumibi.orgで提供しているSumibi Serverを利用する場合は、SSL証明書を利用する事をお勧めします。

4. Emacsを再起動し、Emacsのモードラインに"Sumibi"の文字が表示されれば成功です。

   

5. Meadowをお使いの場合は、次の環境変数の設定が必要です。

   パス名はそれぞれの環境に合わせて読みかえて下さい。

   cygwinではなく Windowsの環境変数に設定してください。そうしないとMeadowに環境変数が渡りません。

   [環境変数]	[設定値]	[設定値(二つ目のパターン)]
   SHELL	c:\cygwin\bin\bash
   PATH	$PATH;c:\cygwin\bin	c:\cygwin\bin;$PATH

   環境変数にcygwin\binを追加したくない場合 カスタマイズ変数 sumibi-curl を /usr/bin/curl などに変更してください。

キー操作

変換

1. 基本的な使いかた

   Emacsのモードラインに"Sumibi"の文字が出ていれば C-jキーでいきなり変換できます。

   • (入力例)

     sumibi de oishii yakiniku wo tabeyou. [C-j]
     

   • (結果)

     炭火でおいしい焼肉を食べよう。
     

2. '/'記号で変換範囲を限定する。
   • (入力例)

     sumibi de oishii /yakiniku wo tabeyou. [C-j]
     

   • (結果)

     sumibi de oishii 焼肉を食べよう。
     

3. .hと.kメソッドでひらがな・カタカナに固定する。
   • (入力例)

     sumibi.h de oishii.k yakiniku wo tabeyou. [C-j]
     

   • (結果)

     すみびでオイシイ焼肉を食べよう。
     

4. .lメソッドでアルファベットに固定する。
   • (入力例)

     sumibi.l de oishii yakiniku.l wo tabeyou. [C-j]
     

   • (結果)

     sumibiでおいしいyakinikuをたべよう。
     

5. スペースを2個以上入力すると1個のスペースになる

   emacs-w3m等からgoogle検索する場合などに使います。

   • (入力例)

     sumibi  yakiniku [C-j]
     

   • (結果)

     炭火 焼肉
     

候補選択

1. とにかく候補選択を開始するには
   • カーソルが文末にある状態で[C-j]を押す。

     

   • C-jを押すと、候補選択モードに移行します。

     

2. 文章の途中から候補選択を開始するには
   • 候補選択したい文節にカーソルを合わせて[C-j]を押す。

     

   • 候補選択モードに移行します。

     

3. 候補の順送り
   • [C-j]で次の変換候補が順番に出てきます。

     

4. 候補選択キー操作一覧

   第一のキー操作	第二のキー操作	第三のキー操作	アクション
   C-m			候補選択確定
   C-g	q		候補選択キャンセル
   C-b	b		前方の文節に移動
   C-f	f		後方の文節に移動
   C-a	a		最初の文節に移動
   C-e	e		最後の文節に移動
   C-j	space		次の候補に切りかえる
   C-n	n		次の候補に切りかえる
   C-p	p		前の候補に切りかえる
   	j		漢字の第一候補に切りかえる
   C-u	u	h	ひらがな候補に切りかえる
   C-i	i	k	カタカナ候補に切りかえる
   	l(エル)		アルファベット候補に切りかえる

変換のコツ

• なるべく長い文章で変換する。

  Sumibiエンジンはなるべく長い文章を一括変換したほうが変換精度が上がります。

  理由は、Sumibiエンジンの仕組みにあります。

  Sumibiエンジンは文脈から統計的にどの単語が相応しいかを判断します。

• SKKの辞書に含まれていそうな単語を指定する。

  SKKに慣れている人でないと感覚がつかめないかもしれませんが、"変換精度"のような多くの複合語は最初から辞書に登録されているので、"henkanseido"という風に指定すると、確実に変換できます。

変換履歴によるパーソナライズ

• 変換履歴を利用して、自分の癖を覚えてくれる機能があります。

  sumibi.el 0.7.1から、変換履歴を利用してユーザーの癖を覚える機能が追加されました。

  sumibi.elで文章を沢山確定すればするほど、自分にピッタリの候補を最初に出してくれる様になります。

  自動的に変換履歴を保存してくれるので特別な操作は必要ありません。

対応環境

多くの環境で動くはずです。以下の環境で動作確認済みです。

• Emacs環境
  • Emacs 21.x以上
  • XEmacs 21.x以上
  • Meadow 2.00 + Cygwin最新版
  • apel 10.3以上
  • curl 7.9.5以上
• ディストリビューション
  • Debian GNU/Linux 3.0/3.1
  • RedHat Enterprise 3.0/4.0
  • Cygwin最新版

カスタマイズ

• M-x customize-groupを実行してグループに'sumibi'を指定すればカスタマイズ画面が表示されます。
• sumibi.elには以下のカスタマイズ項目があります。
  1. sumibi-server-url

     変換サーバーのURLを指定します。デフォルトでは sumibi.org の変換サーバーを使うようになっていますので変更しなくても使えます。

     自前の変換サーバーを利用する場合はこの設定を自前サーバーのURLに変更してください。

  2. sumibi-server-cert-data

     sumibi.org 用のSSL証明書データです。

  3. sumibi-server-use-cert

     SSL証明書を[利用する/しない]を指定します。( t か nil で指定します。)

  4. sumibi-server-timeout

     変換サーバーとの通信タイムアウト秒数を指定します。

  5. sumibi-stop-chars

     C-j キーでローマ字を変換する時、変換文章の停止文字を指定します。 sumibi.elは C-j キーを押されるとカーソル位置から前方方向に sumibi-stop-chars で定義された停止文字にマッチするまでを捜査し、変換対象とします。

  6. sumibi-curl

     curlコマンドの絶対パスを指定します。通常は変更する必要はありません。

  7. sumibi-use-viper

     Non-nil であれば、VIPER モード対応になります。VIPERモードとSumibiを併用したとき C-j が効かなくなる問題が出る場合に有効にしてください。

  8. sumibi-realtime-guide-running-seconds

     リアルタイムガイド表示の継続時間(秒数)・ゼロでガイド表示機能が無効になります。

  9. sumibi-realtime-guide-interval

     リアルタイムガイド表示を更新する時間間隔を設定します。

  10. sumibi-history-filename

      ユーザー固有の変換履歴を保存するファイル名(デフォルトは ~/.sumibi_historyです)

  11. sumibi-history-feature

      ユーザー固有の変換履歴を有効にします(デフォルトはt:有効です)

  12. sumibi-history-max

      ユーザー固有の変換履歴の最大保存件数を指定します(デフォルトは100件です)

  13. sumibi-guide-face

      リアルタイムガイドのフェイスを設定します。(装飾、色などの指定)

フック

• sumibi.elには以下のフックがサポートされています。
  1. sumibi-mode-hook

     sumibi.elを有効にするタイミングで実行する関数を定義できます。

  2. sumibi-select-mode-hook

     変換候補選択モードに以降するタイミングで実行する関数を定義できます。

  3. sumibi-select-mode-end-hook

     変換候補選択モードから脱出するタイミングで実行する関数を定義できます。

sumibi-modeのON/OFF

sumibi.elは他のinput methodの様にON/OFFできます。

1. .emacsで以下のように記述した場合、sumibi-mode OFFでEmacsが起動します。

   (load "sumibi")
   

2. M-x sumibi-modeでsumibi-modeのON/OFFをトグルします。

   この場合、影響範囲はカレントバッファだけです。

3. M-x global-sumibi-modeでsumibi-modeのON/OFFをトグルします。

   この場合、影響範囲はEmacs全体に及びます。