vim/gvim用howmプラグイン「QFixHowm」のコマンド一覧表 QFixHowm | インストール | 基本的な使い方 | コマンド一覧 | 検索リンクとアクションロック | 予定とTODO | オプション | 快適な使用のために | 更新時間の管理 設定とオプション 設定やオプションについては以下を参照して下さい。「オプション」 「快適な使用のために」 Howmコマンドキーマップリーダーに 'g' を指定した場合、「新規ファイルを作成」は g,c になります。「キーマップのカスタマイズ」 Howmコマンド(全てのバッファで有効)
howmバッファローカルコマンド
一ファイル複数エントリで使用するhowmバッファローカルコマンド
「予定・TODO」のコマンド
「Grepとして使用する」コマンド(全てのバッファで有効)
Quickfixウィンドウの操作QuickfixウィンドウのON/OFFには一応copen,cclose等のQuickfixコマンドが使えます。ただ<C-w>, や ToggleQFixWinを使用すると前回のカーソル位置、ソート結果なども保存されるので、<C-w>, かToggleQFixWinを使用してください。 キー操作の表記<CR>はEnterキーの入力、<C-w>はCtrlキー + w というように読み替えて下さい。 Quickfixウィンドウのキー操作
QuickfixウィンドウのON/OFFQuickfixウィンドウのON/OFFには一応copen,cclose等のQuickfixコマンドが使えます。ただ<C-w>, や ToggleQFixWinを使用すると前回のカーソル位置、ソート結果なども保存されるので、<C-w>, かToggleQFixWinを使用してください。
ToggleQFixWinでQuickfixウィンドウのON/OFFが出来ます。 .vimrc設定例 "QuickfixウィンドウをON/OFF
ファイルを画面分割して開くことが出来ます。 "ファイルを画面分割して開く/開かない。<S-CR>を使うと<CR>とは逆の画面分割方法でファイルを開く事が出来ます。 ファイルを分割で開いたときの最小ウィンドウ高さを指定可能です。 0なら全てのウィンドウサイズを同じ高さにします(デフォルト) ウィンドウを水平分割するタイプのプラグインを使用するなら、高さを指定すると相性が改善される事があります。 "ファイルを分割して開いたときの最小ウィンドウ高さ指定 絞り込み検索Quickfixウィンドウでは絞り込みが出来ます。sを押すと入力モードになるので、何か適当な文字列(たとえばファイル名)を入れてみてください。 入力した文字列で絞り込まれます。 元に戻したい場合はuでアンドゥ出来ます。 最初の状態に戻すのはUです。 注意 Quickfixウィンドウに絞り込みを行っていて画面に表示されている時にvimを終了しようとすると、「変更を"無題"に保存しますか?」 というメッセージが出ることがあります。 これは絞り込み中のQuickfixバッファは編集中と見なされるためです。 'n'を選ぶか、Quickfixウィンドウを閉じてから終了するか、'U'コマンドで絞り込みを初期状態に戻してから終了するかのいずれかを選択します。 また基本的に画面がおかしいと思ったら、アンドゥ(特にU)してください。 例えば絞り込み中に拡張Quickfixに対応していないgrep等(helpgrep等)が実行されると、画面は絞り込み中の物が表示され続けることがあります。 ソートの種類Quickfixウィンドウで S を押すとソートの種類を聞いてきます。 m,n,t のいずれかを入力します。 Sort type? (r:reverse)+(m:mtime, n:name, t:text h:howmtime) :ソートの種類
逆順にしたい場合は rt のように、最初に r を付けて下さい。 連結表示@で現在Quickfixウィンドウに登録されているエントリの内容を全てまとめて別バッファに表示できます。絞り込みやソートを行って、ばらばらのファイルにある内容をまとめたいときに便利です。 また3@の様に現在行から個数指定したり、ビジュアルモードで選択した状態で @ を押すと選択したファイルだけ連結表示します。 連結表示のバッファはスクラッチバッファ(ファイルと関連がなく、書き込まれる予定のないバッファ)として作成されます。 この時バッファ名としては通常の新規howmファイルと同じ名前が使用されます。 連結表示バッファを保存したい場合は、 g,wで保存するか、以下を実行してから保存してください。 :setlocal buftype=連結表示して保存したファイルは、g,Wで個別のエントリに保存し直すことも可能です。 また<C-q>でQuickfixウィンドウの編集可/不可を切り替えることが出来ます。 Modifiableモードは連結表示の際、不要なエントリを削除したい時や順番を入れ替えたい時などに使用することを想定しています。 通常のバッファと同じようにQuickfixウィンドウが編集できるのでddで削除してpで貼り付けして、Quickfixウィンドウでの表示順を手動で入れ替え可能です。 (スクリーンショット) "レジスタ"を検索して、 @ で連結表示した所。  連結表示バッファを複数作成したくない場合は連結表示バッファ名を指定してください。 連結表示バッファ名指定をすると常に指定名の一つのみ使用されます。 let QFixHowm_MergeEntryName = "Merg-00-0000-00-00-000000.howm"連結バッファ名を指定しない場合は以下の生成規則が使われます。 「QFixHowmの自動生成ファイル」 連結表示は「アウトラインモード」を利用すると、エントリをタイトルで折りたたむことが出来て便利です。  一ファイル複数エントリや連結表示のエントリを分割保存する一ファイル複数エントリや連結表示されたファイル内のエントリを分割して保存出来ます。分割したいファイルを開いて ,W か、分割したいエントリが含まれる部分をビジュアルモードで選択してから ,W を実行すると、エントリ単位で新規ファイルが howm_dir へ作成されます。 「QFixHowmの自動生成ファイル」 Modifiableモード<C-q>でQuickfixウィンドウを書き換え可能にして、通常のバッファと同じ編集作業が出来ます。基本的に行単位の編集でないと意味がありませんが、自分で作成したソート、編集などが使用できます。 例えば、絞り込み検索とは逆に「指定した単語を含まない行を抽出したい」場合は、<C-q>を押してから次の様にします。 :g/fuga/dこの例では fuga を含む行が削除されます。 dd で削除、 p で貼り付けするなどして順番の入れ替えも可能です。 ファイル名部分を編集するとジャンプできなくなるので注意して下さい。 おかしくなったら U や u で全て元に戻せます。 これを利用して連結表示するファイルを柔軟に選択する事が出来ます。 howmファイルを文字列検索してから、Quickfixウィンドウで # を押すと、エントリフィルタが実行されます。 エントリフィルタを使用すると、検索単語を含むエントリの一覧が表示できます。
検索結果を「連結表示」も出来ます。 エントリフィルタはタイトル検索やカテゴリ検索の一種として扱うと便利です。 たとえば「QFixHowm」についてのエントリをたくさん書きためていたとして、「QFixHowm」について書いてあるエントリを一覧表示したいとします。 単純に「QFixHowm」を検索するとたくさんの行がヒットするはずです。 ここでエントリフィルタを実行すると、同じエントリにある検索結果は一つにまとめられて、エントリのタイトル行のみが残ります。 これにより「QFixHowm」というカテゴリ設定をしていなくても、「QFixHowm」というカテゴリを設定していたかのように扱う事が可能になります。 このままでもタイトル検索に近い結果になっていると思いますが、この状態で s コマンドを使用してタイトル行検索の絞り込みも出来ます。 よく使うエントリフィルタ検索はマクロアクションと組み合わせて、メニュー画面に登録しておくのもおすすめです。 % コマンドは検索結果のサマリーのみをエントリタイトルに変更します。 Quickfix画面の保存と読込Quickfix上のコマンド
QFixHowmの場合は g,kでも保存した結果を読み込めます。 何かgrepしてからQuickfixウィンドウ上で A を押すと現在のgrep結果が保存されます。 その後に別のgrepを行ってから O を押すと、保存した検索結果が表示されます。 保存するファイルはMyGrep_Resultfileで指定します。 "現在登録されているGrep結果を保存するファイルコマンドで読込、書込も出来ます。 ファイル名を指定しないと、MyGrep_Resultfileが使用されます。 必要なら適当なキーにマップするなどして使用してください。
,S でカーソル位置のhowmタイムスタンプを現在時刻に更新,S 実行するとカーソル位置のエントリの howmタイムスタンプを現在時刻へ更新します。= エントリのタイトル行１ エントリのランダム表示Howmコマンド(全てのバッファで有効)
Quickfixウィンドウ上の操作
g,rr を実行するか、 QFixGrep、QFixHowmの検索結果が表示されている Quickfixウィンドウ上で <F5> を押すと全てのエントリから、ランダムにエントリを表示します。 10g,rrの用にカウント指定すると、指定した数のエントリをランダム表示します。 表示される可能性のある全てのエントリのリストはQFixHowm_RandomWalkFileに保存され、一度に表示する数はQFixHowm_RandomWalkColumnsで指定できます。 "ランダム表示用のエントリリスト保存ファイルエントリリストファイルは作成時から10日以上経つと自動更新されますが、必要ならば g,rRを実行して、エントリリストファイルを再作成してください。 0に設定すると自動更新はしません。 "ランダム表示用エントリリストファイルを自動更新 またメニュー画面でエントリのランダム表示を行いたい場合は、 QFixHowm_ShowTodoOnMenu に 2 を設定します。 "メニュー画面でエントリのランダム表示を行う grepとして使用するQFixHowm は QFixGrep を利用しているためにプレビュー付のgrepとして扱う事も可能です。howmファイル以外の適当なファイルを開いてから、,f や ,b を実行してみて下さい。 実行後、検索文字列と、検索対象のファイルを聞いてきますので、適当に設定してから<CR>で確定して下さい。 <C-u>や<C-w>でデフォルトの文字列は削除可能です。 なにかファイルを開いてから、以下のいずれかで検索を実行してみて下さい。 カーソル下の単語が自動的に取り込まれて、検索文字列入力画面になります。 デフォルトではキーマップリーダーに g が設定されているので、 g,e でGrepが実行されます。 ビジュアルモードで範囲選択している場合は、選択範囲の文字をgrepします。 またコマンドモードから各種オプションを指定して実行する事も出来ます。 コマンド一覧
QuickfixウィンドウのON/OFFは<C-w>, かToggleQFixWinを使用してください。 「QuickfixウィンドウのON/OFF」 Quickfixウィンドウ上の操作は「拡張Quickfixウィンドウの操作」にまとめてあります。 検索するファイルの種類を指定する際は、*.vim *.txt のように 複数の種類を指定可能です。 grep後、自動的にQuickfixウィンドウが開き、検索レジスタにはgrepした文字列が登録されます。 検索するファイルを指定する際、**/*.vimのように **/を付けて指定すると再帰的にgrepを行います。 gvimではメニューのツール(T)から実行する事も出来ます。 コマンドモードから実行する コマンドモードからもGrepを実行できます。:Grepは grepprgで指定されているコマンドが実行されます。 したがって:grepの完全上位コマンドとして扱えるので、使用できるオプションも :grepと全く同じになります。 grepprg に外部grepを指定している場合、再帰検索には -r など外部grepのオプションを指定してください。 :Grep -r searchword *.vim:Vimgrepは grepprg にかかわらずvimgrepと同等のコマンドになります。また:Grep! のように'!'を指定すると、開いているファイルと同じディレクトリを基準にgrepします。 したがって autochdir やプラグインでカレントディレクトリをファイルと同じディレクトリに設定している場合に違いはありません。 ,f ,e で外部grepを使用している時のファイルの文字エンコード外部grepを使用する場合、検索対象ファイルの文字エンコードは、現在開いているファイルと同じと仮定して実行されます。よって異なる文字エンコードのファイルは検索されません。 vimgrepならファイルエンコードは自動判別されます。 検索リンクとアクションロック「howmの検索リンクとアクションロック」 にまとめました。検索リンクを使うと体系だったメモの作成や、特定の単語の抽出が簡単になります。 日付の入力補助などのアクションロックについても解説しています。 次のページ「howmの検索リンクとアクションロック」 へ移動 前のページ「QFixHowm - 基本的な使い方」 へ戻る |
