home *** CD-ROM | disk | FTP | other *** search
/ DOS/V Power Report 2002 April / VPR0204A.ISO / OLS / LF-SUPPLEMENT101 / lf-supplement101.lzh / LF-Supplement.txt < prev    next >
Text File  |  2001-12-09  |  12KB  |  280 lines
  1. //-----------------------------------------------------------------------------
  2. // LF-Supplement (プログラマのための文字列補完マクロ)
  3. // Version 1.01
  4. // 
  5. // Copyright: Original code by Yusuke Komori.
  6. //                      Copyright (c) 2001. Yusuke Komori, All rights reserved.
  7. //-----------------------------------------------------------------------------
  8.  
  9. 【１】概要
  10.  
  11.     　「LF-Supplement」は、プログラミングの際に面倒な長い単語の入力をサ
  12.     ポートする、文字列補完マクロです。
  13.     
  14.     　入力したい文字列の先頭何文字かを入力してから LF-Supplement を起動
  15.     すると、辞書ファイルの中から入力中の文字列で始まる文字列の一覧を表
  16.     示してくれます。あとは、候補の中から入力したい文字列を選択するだけ
  17.     で、残りの文字列を自動的に入力してくれるため、標準 API の多い Java
  18.     プログラミングなどで威力を発揮します。
  19.     
  20.     　辞書ファイルは単なるテキストファイルなので、簡単に用意することが
  21.     できます。(Java クラス用辞書と、Java 予約語用辞書、田楽 DLL 用コマ
  22.     ンド辞書がサンプルとして付属しています。)
  23.     
  24.     　また、他にも LF-Supplement には以下のような特徴があります。
  25.     
  26.         ・複数の辞書ファイルから候補の検索が可能
  27.         ・拡張子毎に辞書の切換が可能
  28.         ・前に選択した文字列を優先的に表示する学習機能
  29.         ・大文字小文字を区別せずに検索が可能
  30.         ・GUI画面で設定が簡単
  31.     
  32.     
  33. 【２】使ってみよう!
  34.     
  35.         　例えば、秀丸エディタで Java プログラムを作成する場合に 
  36.         LF-Supplement を使用してみましょう。【５】インストール＆アンインス
  37.         トール にしたがって田楽 DLL と LF-Supplement をインストールしたら、
  38.         まず、辞書ファイルの設定を行います。「マクロ (M)- マクロ実行 (X)」
  39.         で LF-SupplementConfig.mac を実行してください。
  40.         　ダイアログが現れたら、「拡張子の追加」ボタンを押して、java と入力
  41.         します。左上に「拡張子 .java の設定」と表示されましたね？
  42.         　次に、右側にある「追加」ボタンを押して、サンプルで付属してる
  43.         J2SE1.3.dic を選択してください。中央のリストにファイル名が追加され
  44.         ます。あとは、左下の「OK」ボタンを押して設定を保存すれば準備は完了
  45.         です。
  46.         
  47.         　それでは、LF-Supplement で StringBuffer という文字列を入力してみ
  48.         ましょう。まず、秀丸で拡張子が java のファイルを開いてください。拡
  49.         張子が java になっていないと、先ほどの設定が有効にならないので気を
  50.         つけてください。(LF-Supplement は拡張子で使用する辞書ファイルを切り
  51.         換えます。)
  52.         
  53.         　ファイルを開いたら、以下のように最初の Str だけ入力してください。(|
  54.         はカーソル位置)
  55.     
  56.         Str|
  57.             
  58.     　この状態で LF-Supplement.mac を起動します。Str で始まる文字列の一
  59.     覧がカーソル位置にリストで表示されましたか？ この中から、目的の 
  60.     StringBuffer を選択してリターンキーを押します。以下のように残りの部
  61.     分が自動的に入力されます。
  62.             
  63.         StringBuffer|
  64.     
  65.     　さらに、もう一度同じことを行ってみてください。今度はリストの先頭
  66.     に StringBuffer が表示されました。このように、LF-Supplement では一
  67.     度選択した文字列を最初に表示することができます。
  68.  
  69.  
  70. 【３】ファイル一覧
  71.  
  72.         LF-Supplement.txt        このファイル
  73.         LF-Supplement.mac        LF-Supplement のマクロ本体【必須】
  74.         LF-SupplementConfig.mac  LF-Supplement 設定用マクロ【必須】
  75.         LF-Supplement.ini        LF-Supplement の設定ファイル【必須】
  76.         J2SE1.3.dic              Java 1.3 API用辞書ファイル(サンプル)
  77.         JavaKeyword.dic          Java 言語予約語辞書ファイル(サンプル)
  78.         DengakuDLL.dic           田楽DLL用辞書ファイル(サンプル)
  79.  
  80.  
  81. 【４】動作環境
  82.  
  83.     「秀丸エディタ for Windows (Intel 版)」の Ver.3.09 以降。
  84.     「田楽(でんがく)ＤＬＬ」 Version 1.78以降
  85.     
  86.     ※「田楽(でんがく)ＤＬＬ」は杉浦まさき氏によるフリーウェアで、秀丸
  87.        エディタのマクロから使用可能な各種ユーティリティ関数を備えたDLLで
  88.        す。
  89.     ※「田楽 (でんがく) ＤＬＬ」は、LF-Supplement には付属しておりませ
  90.       んので、別途入手の上、インストールを行ってください。「田楽 (でん
  91.       がく) ＤＬＬ」は以下の場所で入手可能です。
  92.     ※どちらもできる限り最新のものを使用することをお薦めします。
  93.         
  94.         [一次配布先]「M. Sugiura Personal Web Page」
  95.         URL: http://www.ceres.dti.ne.jp/~sugiura/index.html
  96.         
  97.         「秀まるおのホームページ」
  98.         URL: http://hidemaru.xaxon.co.jp/
  99.  
  100.  
  101. 【５】インストール＆アンインストール
  102.  
  103.     　まず、「田楽 (でんがく)DLL」を前述の配布場所から入手し、付属のマ
  104.     ニュアルに従ってインストールを行ってください。
  105.     　次に、以下の 3 つのファイルを「秀丸エディタ」のマクロディレクトリ
  106.     (通常は「秀丸エディタ」をインストールしたディレクトリの下にある macro
  107.     ディレクトリ) に置いてください。
  108.  
  109.         LF-Supplement.mac
  110.         LF-SupplementConfig.mac
  111.         LF-Supplement.ini
  112.     
  113.     　また、サンプルで付属する辞書ファイルを使用する場合は、使用したい
  114.     辞書ファイルを適当な場所にコピーしてください。(わからなければ、
  115.     LF-Supplement と同じディレクトリで構いません。)
  116.     
  117.     　以上でインストールは完了です。
  118.     
  119.     
  120.     　アンインストールはインストール時にコピーしたファイルを削除するだ
  121.     けです。このとき、秀丸マクロディレクトリに、userdic_ という名前で始
  122.     まるファイルがある場合は、LF-Supplement の学習結果ファイルですので、
  123.     必要ない場合はあわせて削除してください。
  124.  
  125.  
  126. 【６】操作方法
  127.  
  128.     [起動]
  129.         　「秀丸エディタ」の「マクロ (M)- マクロ登録 (E)」で 
  130.         LF-Supplement.mac を登録してから、適当なキーにアサインするか、
  131.         「マクロ (M)- マクロ実行 (X)」で直接実行してください。
  132.         
  133.         　【2】使ってみよう ! で示したとおり、カーソル位置の文字列で始
  134.         まる単語を辞書から検索して表示しますので、入力したい候補を選択
  135.         してください。文字列の残りの部分が自動的に入力されます。
  136.         　複数の辞書を設定している場合は設定された順に辞書を検索し、候
  137.         補を表示します。また、学習機能が ON になっている場合は、学習結
  138.         果 (過去に選択した単語) から先に検索します。
  139.         
  140.         　まとめると、候補は以下の順番で表示され、各辞書の候補の間はセ
  141.         パレータで区切られて表示されます。
  142.             1. 学習結果から検索した候補
  143.             2. 辞書1から検索した候補
  144.             3. 辞書2から検索した候補
  145.                      ......
  146.             n. 辞書 n-1 から検索した候補
  147.         
  148.         　また、補完候補が 30 を超える場合は、「補完候補が多すぎるので
  149.         検索を中止しました」というメッセージが表示されて、30個までの候
  150.         補しか表示されません。
  151.         
  152.         　また、LF-Supplement の設定で「検索時に大文字小文字を区別しな
  153.         い」を ON にしておくと、辞書から検索を行う際に大文字小文字の区
  154.         別を行わないようになります。このオプションを使用することで、大
  155.         文字小文字を間違って入力しても LF-Supplement による修正を行うこ
  156.         とができます。
  157.         
  158.     [学習機能]
  159.         　 LF-Supplement では、一度補完した文字列を記録しておき、次回検
  160.         索時に優先して表示することができます。このため、同じ文字列をな
  161.         んども使用する場合、カーソル移動の手間を省くことができます。学
  162.         習結果は拡張子毎に userdic_.(拡張子) というファイル名で秀丸マク
  163.         ロディレクトリに保存されます。
  164.         　学習機能は設定によって有効 / 無効を切り換えることができ、また、
  165.         有効にした場合は最大いくつまで記憶するか指定することができます。
  166.         この場合、最大数を超えた文字列は学習結果から自動的に削除されま
  167.         す。
  168.         
  169.     [複数辞書設定機能]
  170.         　 LF-Supplement では、複数の辞書ファイルから補完候補を検索する
  171.         ことができます。辞書のメンテナンス上、複数ファイルに分けておい
  172.         た方が便利な場合に有効です。例えば、サンプルでは Java 言語の予
  173.         約語用辞書と、Java1.3 API 用辞書の 2 つに別れています。この 2 
  174.         つを使用することで、将来的に Java の API 用辞書だけ差し替えるこ
  175.         とができます。
  176.         
  177.     [拡張子毎の辞書ファイルセット変更機能]
  178.         　 LF-Supplement では、編集しているファイルの拡張子毎に辞書ファ
  179.         イルセットを切り換えることもできます。例えば、C 言語のプログラ
  180.         ムを書いている際に、Java の API が補完候補として出てくると困る
  181.         ので、拡張子毎に辞書ファイルを切り換えられるようになっています。
  182.         
  183.     [各種設定]
  184.       (1) 設定マクロの起動方法
  185.       
  186.         　学習機能の設定、拡張子毎に使用する辞書ファイルの設定は、設定
  187.         用マクロ、LF-SupplementConfig.mac を使用して設定することができ
  188.         ます。設定結果は、LF-Supplement.ini に保存されます。
  189.         　 LF-SupplementConfig.mac を実行するには、「秀丸エディタ」の
  190.         「マクロ (M)- マクロ登録 (E)」で LF-SupplementConfig.mac を登録
  191.         してから、適当なキーにアサインするか、「マクロ (M)- マクロ実行
  192.         (X)」で直接実行してください。
  193.         
  194.       (2) 拡張子毎の辞書設定
  195.         　設定ダイアログでは、まず最初に「拡張子の追加」ボタンを押して
  196.         拡張子 (ピリオドは除く) を入力し、右側の「追加」ボタンで、その
  197.         拡張子で使用する辞書を選択してください。検索は上にある辞書から
  198.         順番に行いますので「上へ」「下へ」ボタンで順番を変更してくださ
  199.         い。
  200.         　最後に「OK」ボタンを押すと設定が反映されます。別の拡張子の辞
  201.         書ファイルを変更したい場合は左上のコンボボックスから選択するこ
  202.         とができますが、「OK」ボタンを押す前に拡張子を変更すると、前の
  203.         拡張子の変更結果は反映されなくなってしまいますのでご注意下さい。
  204.         
  205.         　拡張子の設定や辞書ファイルを削除したい場合は、それぞれ「拡張
  206.         子の削除」、「削除」ボタンから行ってください。
  207.  
  208.       (3) 学習機能の設定
  209.         　設定ダイアログの「選択した単語を学習する」をチェックすると、
  210.         学習機能が有効になります、その場合、「学習する単語の数を制限す
  211.         る」をチェックして、数を入力することで学習する単語の数を制限す
  212.         ることができます。制限を行い場合は無限に学習していきます。(使い
  213.         にくくなりますので、適当な数で制限をかけておくことをお薦めしま
  214.         す。)
  215.         　学習辞書ファイル (userdic_.*) の保存先は「学習結果の保存先」
  216.         で指定することができます。何も指定しない場合は、LF-Supplement 
  217.         のマクロが置かれたディレクトリと同じディレクトリに保存されます。
  218.  
  219.       (4) 検索時に大文字小文字を区別しない
  220.         　この項目をチェックすることで、辞書を検索する際に大文字小文字
  221.         の区別を行わないようになります。詳細は、【６】操作方法 をご覧下
  222.         さい。
  223.  
  224.  
  225. 【７】変更履歴
  226.   2001.12.09(Sun) Version 1.01
  227.       ・検索時に大文字小文字を区別しないオプションを追加。
  228.       ・学習結果の保存先ディレクトリを指定できるようにした。
  229.  
  230.   2001.12.01(Sat) Version 1.00
  231.       初公開
  232.  
  233.  
  234. 【８】著作権・配布条件等
  235.  
  236.     [著作権について]
  237.         　この「LF-Supplement」の著作権は作者である 小森裕介
  238.         (y-komori@nifty.ne.jp) が所有しています。
  239.         
  240.         　また、「LF-Supplement」が使用する「田楽 (でんがく) ＤＬＬ」の
  241.         著作権は、杉浦まさき氏が所有しています。
  242.  
  243.     [ソフトウェアの種別]
  244.         　「LF-Supplement」は フリーソフトウェア です。このソフトウェア
  245.         を使用するにあたり、誰に対しても一切お金を払う必要も義務もあり
  246.         ません。
  247.  
  248.     [配布条件]
  249.         　基本的には自由です。ただし、雑誌の付録や Web/FTP サイト上での
  250.         公開の際は作者に一応ご連絡を頂けると嬉しいです (義務ではありま
  251.         せん)。
  252.  
  253.     [免責事項]
  254.         　このソフトウェアを使用したことによって如何なる不利益を被った
  255.         場合も、著作権者にはそれらに関する一切の責任が無いものとさせて
  256.         頂きます。また、著作権者はこのソフトウェアに不具合が生じた際に
  257.         修正する義務も一切ないものとさせていただきます。
  258.  
  259.     [サポート・連絡先]
  260.         このソフトウェアに関する質問やバグ報告等々は、
  261.             y-komori@nifty.ne.jp
  262.         までメールでお願いいたします。
  263.  
  264.     [最新版の入手方法]
  265.         以下の作者の Web ページにて配布中です。
  266.         
  267.         「Little Forest」
  268.         URL: http://www.win.ne.jp/~y-komori/
  269.  
  270.  
  271. 【９】謝辞
  272.     
  273.     　本ソフトウェアを作成するにあたり利用させていただいた、「田楽 (で
  274.     んがく) ＤＬＬ」作者の杉浦まさき氏に深く感謝いたします。　「田楽 
  275.     (でんがく)DLL」は秀丸マクロの持つ可能性を大きく広げてくれました。
  276.     
  277.  
  278.  
  279. 以上
  280.