名無しのvim使い

「Vimテクニックバイブル〜作業効率をカイゼンする150の技」を執筆

2012-01-02T19:23:24+09:00

「Vimテクニックバイブル〜作業効率をカイゼンする150の技」の概要
想定読者
取り扱っている内容
執筆陣
本のデータ
主張したいこと
関連リンク

「Vimテクニックバイブル〜作業効率をカイゼンする150の技」の概要

Vimテクニックバイブルを執筆しました。
Vimテクニックバイブルは既にVimエディタを利用している人向けに、さらなる作業効率の改善を行うための手法や、プラグインなどの解説を150のTipsとして紹介する本です。
おおよそ本サイトを見に来て頂いている方ならば、ちょうど良い本になっています。

まだ全ての情報は出せません。このページの情報は新情報があるたびに更新します。

想定読者

Vimエディタを利用しているけど、さらに色々知りたい方
Vimエディタの基礎の先を知りたい方
Emacsテクニックバイブルを読んで、Vim版Emacsテクニックバイブルが欲しくなった方
ちょっとだけVim使える、ぐらいの人でも大丈夫

取り扱っている内容

Vimエディタでよく困りがちな問題の解決方法
Unite
neocomplecache
QFixHowm
quickrun
zencoding
vimshell
などなど
↓本のカバーを見ると、うっすら取り扱っているプラグインが見えます。

執筆陣

mattn（著）
- PerlとVimの人。
- http://mattn.kaoriya.net/
fuenor（著）
- QFixHowmの作者。
- http://d.hatena.ne.jp/fuenor/
- http://sites.google.com/site/fudist/
Shougo（著）
- Unite、neocomplecache、vimshellの作者。
- http://vinarian.blogspot.com/
thinca（著）
- quickrunの作者。
- http://d.hatena.ne.jp/thinca/
中村茂樹（著）
- GREEエンジニア。
小見拓（著）
- いろいろ。

本のデータ

タイトル：Vimテクニックバイブル〜作業効率をカイゼンする150の技
384ページ
発売時期：9月中旬
価格：2980円＋税
出版社：技術評論社
正誤表

主張したいこと

初心者向けでない、こういう本、日本では今まで無かったよね？
- たぶん、この先もあまり出ません。
- 基礎本と比べると、売り上げが予想できなくてリスキーらしい。
- だから、この本を買うべきだ。
かなり良いメンバー集めたよ。
- 本当にありがたい。
- プラグイン作者自身による、プラグインの詳しい説明とか載せることができた。
- でも、そのせいで更新の鈍くなったVim系まとめサイトとかあるそうな。
- 名無しのvim使いも更新滞ったけどね。
Emacsテクニックバイブルが200Tipsなのに対して、Vimテクニックバイブルは150Tips。
- しかし、ページ数は同じ。
- 1Tipsあたりが重くなっています。

Vim Advent Calendar 2011 17日目メモを取るためのプラグイン達

2011-12-17T19:30:34+09:00

Contents

Vimテクニックバイブル 7章「記録の取り方を改善する」に載らなかったプラグイン達の話
Vimwiki
Viki/Deplate
taskpaper.vim
ttoc
いろいろ並べた感想とか
リンク

Vimテクニックバイブル 7章「記録の取り方を改善する」に載らなかったプラグイン達の話

おはようございます、 Vim Advent Calendar 2011 17日目担当の小見です。

3月ほど前発売された、 Vimテクニックバイブルの7章「記録の取り方を改善する」では QFixHowm を紹介してしましたが、タスク管理・TODO管理や、メモを取るための機能をもったプラグインって、他にも、たくさんありますよね。

でも、それらのプラグインのほとんどは、多数の機能をもつ巨大なプラグインである上に、機能も重複していることが多いから、VimテクニックバイブルではQFixHowmのみを扱っています。

今回は、それらのVimテクニックバイブルに載らなかったプラグイン達をいくつか紹介しようと思います。

Vimwiki

Vimwiki はVimスクリプトで作られた個人用途向けのWikiシステムです。他のシステムや環境に依存せず、Vimエディタ上で動作させられます。作成し記録したWikiのページからHTML形式のドキュメントを生成したり、TODO項目を管理する機能をもっています。

Vimwikiを使い始めるには、プラグインインストール後、まず、 \ww とコマンドを実行して、最初のWikiページを作ってください。

より詳しい使い方については、次のURLで説明しています。
Vimwiki : Vimエディタ上で動作するWiki環境
http://nanasi.jp/vim/vimwiki.html

Vimwikiは次のURLから入手できます。
http://www.vim.org/scripts/script.php?script_id=2226

Viki/Deplate

Viki は Vimwiki と同じく、Vim上でWiki記法で書かれた文書を管理するプラグインです。

Vikiを利用開始するには、何らかのファイルを開いて、 :VikiMinorMode か、 :VikiMode とコマンドを実行してください。
:VikiMinorMode の方は、文書間のハイパーリンクのみ有効になるモードなので、テキストファイル間のリンクが欲しいだけなら、 :VikiMinorMode の方を利用します。

Vikiは次のURLから入手します。
https://github.com/tomtom/viki_vim

Vikiを動作させるには、プラグイン本体の他に、 tlib と呼ばれるライブラリが必要になるので、気をつけてください。
tlib : Some utility functions
https://github.com/tomtom/tlib_vim

taskpaper.vim

taskpaper.vim は、シンプルなTODO管理用のプラグインです。拡張子「.taskpaper」のファイルを開いた時か、ファイルタイプ「taskpaper」の時に動作します。

使い方は、テキストファイルを作成して、次のようなフォーマットでタスクを記述していき、

プロジェクト1:
- タスク1
- タスク2
- タスク3

プロジェクト2:
- タスク1
- タスク2

\td でタスクに完了マークを、 \tx でタスクにキャンセルのマークを付けて、終わったタスク、残っているタスクを管理していく、という方式です。シンプルですね。

プロジェクト1:
- タスク1
- タスク2 @done(2011-07-10)
- タスク3 @cancelled(2011-07-10)

taskpaper.vimプラグインは、次のURLで入手できます。
https://github.com/davidoc/taskpaper.vim

ttoc

ttoc プラグインを使うと、正規表現で文章中から見出しとなる行を拾ってきて、目次一覧を作成してくれます。
このプラグインは、走り書きのメモを、そのまま活用するのに向いているかもしれません。

デフォルト設定では、見出しの先頭が数字で始まるものを、 :TToC とコマンド実行された時に、目次として拾います。

1. 見出し1
    メモ1
    メモ2
    メモ3

2. 見出し2
    メモ1
    メモ2

もし、数字から始まる行ではなくて、文字列から始まる行を目次として収集したいのであれば、

見出し1
    メモ1
    メモ2
    メモ3

見出し2
    メモ1
    メモ2

こんな感じでコマンドを実行すると実現できます。

:let g:ttoc_rx_txt = '^k+>'
:setf txt
:TToC

より詳しい使い方については、次のURLを参考にしてください。
「ttoc : 見出しの一覧を検索して表示」
http://nanasi.jp/articles/vim/ttoc_vim.html

ttocプラグインは次のURLから入手します。
https://github.com/tomtom/ttoc_vim

ttocを動作させるには、Vikiと同じく、プラグイン本体の他に tlib と呼ばれるライブラリもインストールする必要があります。
tlib : Some utility functions
https://github.com/tomtom/tlib_vim

いろいろ並べた感想とか

この手のメモ系のプラグインは、どうしても、機能がたくさん追加されてきて、巨大なプラグインになってしまいますよね。
現在のVimスクリプト界では、誰もが使う標準的なライブラリみたいなものがまだ確定していなくて、巨大なプラグインを作ろうとすると、たくさん車輪が開発されていそうで、ちょっともったいない状況だなぁ、と思わないのでも無いのでした。
（あったら使うかどうかは別の話。）

リンク

Vim Advent Calendar 2011
- http://atnd.org/events/21925
Vimテクニックバイブル
- http://www.amazon.co.jp/gp/product/4774147958
QFixHowm
- http://sites.google.com/site/fudist/Home/qfixhowm
Vimwiki
- http://www.vim.org/scripts/script.php?script_id=2226
Viki
- https://github.com/tomtom/viki_vim
tlib
- https://github.com/tomtom/tlib_vim
taskpaper.vim
- https://github.com/davidoc/taskpaper.vim
ttoc
- https://github.com/tomtom/ttoc_vim

totd.vim : その日最初にvimエディタを起動した時にVimのTipsを表示

2011-09-20T22:57:07+09:00

Contents

概要
インストール方法
- プラグインのインストール
- Vip Tipsのインストール
使用方法
注意事項など

概要

vimtips.zip : Display a helpful tip the first time you start Vim each day.
http://www.vim.org/scripts/script.php?script_id=88

その日最初にvimエディタを起動した時に、
vimオフィシャルサイトに投稿されているVim Tipsを表示するスクリプトです。

インストール方法

プラグインのインストール

まず、配布ファイルをダウンロードしてください。

ダウンロードしたファイルは圧縮ファイルになっているので
何らかの解凍ツールを使用して解凍します。

このファイルを解凍すると、以下のように展開されます。

圧縮ファイルの構成
doc/
  +
  +---  totd.txt

plugin/
  +
  +---  totd.vim
  +
  +---  vimtips/
          +
          +---  vimtips.txt

docディレクトリ以下のファイルをローカルのdocディレクトリに、
pluginディレクトリ以下のファイルをそのままローカルのpluginディレクトリにコピーします。

ここまで作業したら、一度vimエディタを起動して、
エディタ起動時にウィンドウが分割された状態になるか確認してください。

Vip Tipsのインストール

次にVimのオフィシャルサイトで配布しているVip Tipsのデータを入手して、
スクリプトから読める位置にコピーします。

Vip Tipsのデータは、オフィシャルサイトのこのページからダウンロードできます。

ファイルサイズは2006年2月13日現在で1.2MBほどあります。

Note

環境によってはダウンロードしづらいかもしれません。 2006年2月13日時点のVim Tipsのデータファイルをこちらに置いておきます。解凍ツールで解凍してから利用してください。中身はテキストファイルです。 Vim Tipsデータ

ダウンロードしたテキストファイルで、
先ほどローカルのpluginディレクトリ内に作成した
vimtipsディレクトリ内のvimtips.txtファイルを上書きしてください。

ファイル	URL
vimtips.zip	http://www.vim.org/scripts/script.php?script_id=88
vimtips.txt	http://www.vim.org/tips/

使用方法

日付が変わって、最初にvimエディタを起動した時にVim Tipsが表示されるようになります。
表示されるVim Tipsは、前回表示したTipsの次のTipsです。

日付が変わるまで待つ以外に、下のコマンドをvimエディタで入力して、直接呼び出すこともできます。

:TipOfTheDay

注意事項など

このスクリプトは、Vim Tipsをどこまで表示したかの情報を
自身のスクリプト内で保持しているので、
Vim Tipsをまた最初から見る場合は、
totd.vimスクリプトを最新のファイルと入れ替えてください。

zshr.vim : 直前に実行したコマンドを少し変更して実行する。zshシェルのrコマンド。

2011-09-20T22:57:56+09:00

Contents

概要
インストール方法
使用方法
- コマンドのフォーマット
- スクリプトの使い方の例
注意事項など

概要

zshr.vim : 直前に実行したコマンドを少し変更して実行する。zshシェルのrコマンド。
https://github.com/taku-o/downloads/raw/master/zshr.vim

直前に実行したvimエディタのコマンドの一部を置き換えてから、
再度実行するコマンドを提供するスクリプト。

インストール方法

スクリプトをダウンロードして、
pluginディレクトリにコピーしてください。

ファイル	URL
zshr.vim	https://github.com/taku-o/downloads/raw/master/zshr.vim

使用方法

コマンドのフォーマット

このスクリプトで定義される「:R」コマンドのフォーマットは、次のとおりです。

:R {置き換え前1}={置き換え後1} [{置き換え前2}={置き換え後2} {置き換え前3}={置き換え後3} ...]

「:R」コマンドを実行すると、直前（1回前）に実行したコマンドに含まれる置き換え前文字列を、
置き換え後文字列で置き換えてから、再度、コマンドを実行します。

スクリプトの使い方の例

具体的な「:R」コマンドの使い方の例を挙げます。

まず、次の処理をvimエディタで実行します。

:w foo_abc.txt

続いて、次のように「:R」コマンドを実行します。

:R abc=xyz

すると、zshr.vimスクリプトはコマンド履歴から最後のコマンドを取り出し、
コマンドを置換してから、再度実行します。

:w foo_abc.txt

↓ 「abc」を「xyz」に置換してから実行

:w foo_xyz.txt

複数箇所の置換を一度に行うには、次のようにパラメータを連続で指定します。

:R xyz=def foo=var txt=log

:w foo_xyz.txt

↓ 「xyz」を「def」に置換
↓ 「foo」を「var」に置換
↓ 「txt」を「log」に置換
↓ 実行

:w var_def.log

注意事項など

コマンドの履歴を見るには、ノーマルモードで次のコマンドを実行してください。

q:

zoom.vim : 「+」、「-」キーで文字の大きさを変更

2011-09-20T22:57:39+09:00

Contents

概要
インストール方法
使用方法
- マッピングから実行
- コマンドから実行
注意事項など

概要

zoom.vim : 「+」、「-」キーで文字の大きさを変更
https://github.com/taku-o/downloads/raw/master/zoom.vim

vimエディタで使用しているフォントの大きさを、「+」キーで大きく、「-」キーで小さく変更するスクリプトです。
GUI版のvimエディタでのみ使用できます。

インストール方法

スクリプトをダウンロードして、
pluginディレクトリにコピーしてください。

ファイル	URL
zoom.vim	https://github.com/taku-o/downloads/raw/master/zoom.vim

使用方法

プラグインの使用方法として、マッピングから実行する方法、コマンドから実行する方法が用意されています。

マッピングから実行

用意されているマッピングは2種類です。ノーマルモード「+」キーでフォントのサイズを拡大、「-」キーでフォントのサイズを縮小します。
なお、フォントのサイズを変更すると、それに伴い、ウィンドウの大きさも変化します。

キー	モード	説明
+	ノーマルモード	フォントのサイズを1サイズ拡大する。
-	ノーマルモード	フォントのサイズを1サイズ縮小する。

コマンドから実行

コマンドからフォントのサイズを変更する方法も用意してあります。
「:ZoomReset」コマンドを使用すると、変更したフォントのサイズを初期状態にリセットできます。

コマンド	説明
:ZoomIn	フォントのサイズを1サイズ拡大する。
:ZoomOut	フォントのサイズを1サイズ縮小する。
:ZoomReset	変更したフォントのサイズを、元の状態に戻す。

注意事項など

このプラグインの機能はGUI版のvimエディタでのみ使用できます。

Visual Mark : 行をハイライト表示して、後でその行に移動できるスクリプト

2011-09-20T22:57:22+09:00

Contents

概要
インストール方法
使用方法
- 行のハイライト表示、ハイライト表示取消
- ハイライトした行への移動
設定
- ハイライトするキー、ハイライトを取り消すキーを変更する
- ハイライトした行へのカーソル移動キーを変更する
注意事項など
- スクリプトを使用するのに必要なコンパイルオプション
- :signコマンド

概要

Visual Mark : Visual mark, similar to UltraEdit's bookmark
http://www.vim.org/scripts/script.php?script_id=1026

visualmark.vimは指定した行をハイライト表示する機能と、
ハイライトした行に移動する機能を提供するマーカースクリプトです。
機能としてはマークした場所を目立つように表示する「 ShowMarks 」に似ています。

インストール方法

vim onlineで配布している visualmark.vimスクリプトの修正版を用意してあるので、
このスクリプトをダウンロードし、pluginディレクトリにコピーしてください。

ファイル	URL
オリジナル版	http://www.vim.org/scripts/script.php?script_id=1026
名無しのvim使い修正版	https://github.com/taku-o/downloads/raw/master/visualmark.vim

使用方法

visualmark.vimスクリプトには、大きく2種類の機能があります。
ひとつが行をハイライト表示する機能、行のハイライトを取り消す機能で、
もうひとつがハイライトした行への移動機能です。

行のハイライト表示、ハイライト表示取消

デフォルトでは、ノーマルモードで「Control-F2」を押下すると、カーソルのある行をハイライト表示します。
このハイライト表示を消すには、ハイライトされた行にカーソルを移動し、「Control-F2」を押します。

カーソル行をハイライト表示、ハイライト表示取消する
<C-F2>

つまり、「Control-F2」を押すたびに、行のハイライト表示、ハイライト表示取消で切り替えられます。

Note

名無しのvim使い修正版visualmark.vim は、MacOSX環境では、
「コマンドキー + F2」でハイライトの切り替えができるように修正してあります。
「Control-F2」がMac OSX環境ではメニューバー選択に割り当てられているためです。

ハイライトした行への移動

「Control-F2」でハイライト表示しておいた行へは「F2」キーでカーソルを移動できます。
また、「Shift-F2」で逆方向に移動できます。

コマンド	説明
<F2>	順方向にハイライトした行に移動。
<S-F2>	逆方向にハイライトした行に移動。

「F2」によるカーソル移動は、編集中のファイル内のみ移動できます。

設定

行をハイライトするキー、ハイライトした行に移動するキーといった、
スクリプトの機能を呼び出すキーをvimエディタの設定ファイルで変更できます。

ハイライトするキー、ハイライトを取り消すキーを変更する

行をハイライトするキーを「F2」から他のキーに変更する場合は、
次のようにvimエディタの設定ファイルで定義してください。

" 例。行をハイライトするキーを「Control-F3」に変更。
:map <unique> <C-F3> <Plug>Vm_toggle_sign
:map <silent> <unique> mm <Plug>Vm_toggle_sign

ハイライトした行へのカーソル移動キーを変更する

ハイライト行へのカーソルの移動キーも同じく変更できます。
変更するには、次の例のようにvimエディタの設定ファイルで設定します。

" 例。順方向にハイライトされた行に移動するキーを「F3」に変更。
:map <unique> <F3> <Plug>Vm_goto_next_sign

" 例。逆方向にハイライトされた行に移動するキーを「Control-F3」に変更。
:map <unique> <S-F3> <Plug>Vm_goto_prev_sign

注意事項など

スクリプトを使用するのに必要なコンパイルオプション

visualmark.vimスクリプトを使用するには「+signs」オプション付きで、 vimエディタがコンパイルされている必要があります。
使用しているvimエディタのコンパイルオプションを確認するには、次のコマンドを実行してください。

:version

:signコマンド

「F2」によるカーソル移動は編集ファイル内での移動限定ですが、
visualmark.vimスクリプトの機能は「:sign」コマンドの機能で実現されているため、
次のようにすれば、別ファイルのハイライト行へも移動できます。

" まず、サインの一覧を表示。
:sign place

" 次のコマンドを実行し、サインの位置に移動。
:sign jump {識別子} buffer={バッファ番号}

しかし、コマンドが非常に面倒なうえ、「m」コマンドで似たような機能を容易に実現できるので、
無理して覚える必要はありません。

:help mark

template file loader : ファイル新規作成時に用意されたテンプレートを読み込む

2011-09-20T22:56:53+09:00

Contents

概要
インストール方法
使用方法
テンプレートのカスタマイズ
テンプレートファイルのダウンロード
注意事項など

概要

template file loader : Loads a template file and does customizable processing when editing a new file.
http://www.vim.org/script.php?script_id=198

Note

最新のバージョンは1.6 です。 1.5のバグがフィックスされています。

Javaに限った話ではなく、プログラミングをしていれば、同じ作業を繰り返すことはとても多くなります。
このスクリプトは、新規ファイル作成時のテンプレート機能を提供するものです。

vimエディタでは、_vimrc設定ファイルに次のような1文を加えれば、Javaソースの新規作成時に $VIM/templates/skeleton.javaファイルを元にテンプレートを作成してくれますが、

:autocmd BufNewFile *.java 0r $VIM/templates/skeleton.java

このtemplatefile.vimスクリプトは、この方法では処理しきれないテンプレート用ディレクトリのテンプレート自動適用、キーワード展開、テンプレート使用未使用の選択手段の機能を提供します。

インストール方法

Note

1.5のバグはフィックスされています。最新のバージョンは1.6 です。

ファイル	URL
templatefile.vim	http://www.platon.sk/cvs/sk/cvs.php/vimconfig/vim/plugin/templatefile.vim

templatefile.vimファイルは、 $VIMRUNTIME/plugin/ ディレクトリに入れます。

テンプレートファイルを用意します。 Java言語用であれば、skel.javaという名前で $VIM/templates/ ディレクトリに入れてください。

// テンプレートファイル skel.javaの例
/**
 *
 *
 * @author author
 * @version $Revision: 1.8 $
 */
public class @FILE@ {
    /**
     * 本クラスのインスタンスを生成します。
     */
    public @FILE@(){}
}

最後に、_vimrc設定ファイルに次の一文を書き加えてください。

:let g:load_templates="ask"

使用方法

新規にJavaのファイルを作成してみましょう。コンソールからでも、既に立ち上げてあるvimエディタからでも構いません。
試しにViewTemplate.javaというファイルを作ってみます。

このようなダイアログが立ちあがり(Windows98の場合)、
ダイアログのYESボタンを押すと、次のソースが自動的に生成されます。
NOボタンと、右端のボタンを押した時はテンプレートは使用されません。

// ViewTemplate.java
/**
 *
 *
 * @author author
 * @version $Revision: 1.8 $
 */
public class ViewTemplate {
    /**
     * 本クラスのインスタンスを生成します。
     */
    public ViewTemplate(){}
}

このtemplatefile.vimスクリプトは、テンプレート用ディレクトリに、 skel.*という名前で、作成ファイルと拡張子の同じファイルがあった場合、そのファイルをテンプレートファイルとして認識し、キーワード展開して、新規ファイルに張りつけます。

テンプレートのカスタマイズ

テンプレートで使用できるキーワードは、デフォルトでは下の6つです。下記の表のキーワードがテンプレートで使用されていると、そのキーワードは変換されます。

キーワード	置き換えられるもの
@DATE@	× 変換されない。
@YEAR@	年の表示。(例 2002)
@LASTDIR@	× Windowsでは正しく機能しない。
@FILE@	拡張子抜きのファイル名 (例 ViewTemplate)
@FILE_EXT@	ファイル名 (例 ViewTemplate.java)
@INCLUDE_GAURD@	@FILE@の英大文字バージョン (例 VIEWTEMPLATE)

置換機能が足りない場合は、スクリプトの拡張(改造)を行ってしまいましょう。

templatefile.vimの54行目～67行目に、キーワードの変換を行っている個所があります。ここに自分の好きなキーワード変換処理を付け加えます。

" templatefile.vimの54行目～67行目 キーワード変換処理部
let date = strftime("%c")
let year = strftime("%Y")
let cwd = getcwd()
let lastdir = substitute(cwd, ".*/", "", "g")
let myfile = expand("%:t:r")
let myfile_ext = expand("%")
let inc_gaurd = substitute(myfile, "\\.", "_", "g")
let inc_gaurd = toupper(inc_gaurd)
silent! execute "%s/@DATE@/" .  date . "/g"
silent! execute "%s/@YEAR@/" .  year . "/g"
silent! execute "%s/@LASTDIR@/" .  lastdir . "/g"
silent! execute "%s/@FILE@/" .  myfile . "/g"
silent! execute "%s/@FILE_EXT@/" .  myfile_ext . "/g"
silent! execute "%s/@INCLUDE_GAURD@/" . inc_gaurd . "/g"

例えば、「@DATE@」キーワードを変えてしまいます。

" 変更例 templatefile.vimの54行目
let date = strftime("%c")

" 変更例 templatefile.vimの54行目 (変更後)
" let date = strftime("%c")
let date = strftime("%y %m %d %X")

また、変換キーワード「@KEYWORD@」を増やしたい時は、次の行を追加します。

" 変更例 キーワード@KEYWORD@の追加
let keyword = "変換メッセージ"
silent! execute "%s/@KEYWORD@/" . keyword . "/g"

この様にして、キーワードを増やしてしまいます。テンプレートに必要な分だけ追加しましょう。このキーワードは、新規作成時にテンプレートから置きかえられます。

これらのキーワードを使用して、テンプレートの作成を行います。

テンプレートファイルのダウンロード

テンプレートの雛型をいくつか用意しました。ダウンロードして、適当に改変してご利用ください。

ファイル	テンプレート種類
skel.java	Java用テンプレート
skel.sdoc	SmartDoc用テンプレート
skel.rlx	Relaxer用テンプレート
skel.rxm	Relaxer用テンプレート

注意事項など

テンプレートがあると、新規ファイルを開くたびに確認を求められてしまいます(とても面倒なことに)。
また、このスクリプトは、Mac OSX 10.2版gvimでの挙動が怪しいようです。

monday.vim : Ctrl-a、Ctrl-xで曜日、月をループ（＋他の用途への応用）

2011-09-20T22:56:08+09:00

Contents

概要
インストール方法
使い方
拡張
- 曜日、月の省略形の変換パターンの追加
- このスクリプトのプログラマ的応用
ダウンロード

概要

monday : Lets you use ctrl-a and ctrl-x on names of months and weekdays
http://www.vim.org/scripts/script.php?script_id=1046

Ctrl-a、Ctrl-xで、曜日、月をインクリメント、デクリメントできる機能を提供するvimスクリプトです。

インストール方法

スクリプトをダウンロードして、
そのスクリプトをpluginディレクトリにコピーして下さい。

ファイル	URL
monday.vim	http://www.vim.org/scripts/script.php?script_id=1046

使い方

現在のバージョン(2004/09/13)で対応しているのは、

曜日
monday、tuesday、wednesday、thursday、friday、saturday、sunday

月
january、february、march、april、may、june、july、august、september、october、november、december
です。

これらの単語の上で、

Ctrl-aを押すと、1つ先の曜日、月に変更し、
Ctrl-xを押すと、1つ前の曜日、月に変更します。

なお、このスクリプトは、大文字小文字の構成もなるべく確保してくれます。

monday → tuesday (全部小文字の場合)
Monday → Tuesday (先頭の文字だけ大文字の場合)
MONDAY → TUESDAY (全部大文字の場合)

と変換します。

拡張

このスクリプトを拡張して、スクリプトが現在対応していない変換パターンを追加してみましょう。

変換パターンを追加するには、今の所、スクリプトを直接編集するしか方法はありません。スクリプトをエディタで開いて、スクリプト内の変換パターンを定義している箇所にコードを追加します。

下の行の後に、パターンを追加していきます。

:call <SID>AddPair("december", "january")

曜日、月の省略形の変換パターンの追加

下のコードをスクリプト内のパターン定義箇所に追加してください。

:call <SID>AddPair("mon", "tue")
:call <SID>AddPair("tue", "wed")
:call <SID>AddPair("wed", "thu")
:call <SID>AddPair("thu", "fri")
:call <SID>AddPair("fri", "sat")
:call <SID>AddPair("sat", "sun")
:call <SID>AddPair("sun", "mon")

:call <SID>AddPair("jan", "feb")
:call <SID>AddPair("feb", "mar")
:call <SID>AddPair("mar", "apr")
:call <SID>AddPair("apr", "may")
:call <SID>AddPair("may", "june")
:call <SID>AddPair("june", "july")
:call <SID>AddPair("july", "aug")
:call <SID>AddPair("aug", "sep")
:call <SID>AddPair("sep", "oct")
:call <SID>AddPair("oct", "nov")
:call <SID>AddPair("nov", "dec")
:call <SID>AddPair("dec", "jan")

may、june、julyは、省略前と省略後でスペルが同じなので、組み込むことはできませんでした。
この場合、例えば「july」の次の月が「august」になるか、「aug」になるか、スクリプトからでは区別できないからです。
つまり、こういう状況が発生するような場合、変換パターンを追加することはできません。

このスクリプトのプログラマ的応用

変換パターンは、別に曜日、月など、時間に関わるものである必要はありません。

例えば、Javaプログラマなら
public ←→ protected ←→ private ←→ public ......
という変換パターンとか。

:call <SID>AddPair("public", "protected")
:call <SID>AddPair("protected", "private")
:call <SID>AddPair("private", "public")

true ←→ false、yes ←→ no、on ←→ off という変換パターンとか。

:call <SID>AddPair("true", "false")
:call <SID>AddPair("false", "true")
:call <SID>AddPair("yes", "no")
:call <SID>AddPair("no", "yes")
:call <SID>AddPair("on", "off")
:call <SID>AddPair("off", "on")

いろいろ考えられそうです。

ダウンロード

今回、解説した変換パターンを加えたスクリプトです。いろいろ、手を加えて使ってみてください。

download

rargs.vim : 指定した複数のファイルを一度に読み込む

2011-09-20T22:56:22+09:00

Contents

概要
インストール方法
コマンドフォーマット
コマンドの実行例
読み込み位置
設定
- g:rargs_exit_when_error

概要

rargs.vim : read the contents of many files at one time.
https://github.com/taku-o/downloads/raw/master/rargs.vim

rargs.vimは指定した複数のファイルをカーソル行の位置に読み込む、 :read コマンドの拡張的な機能を提供するプラグインです。

Unixで良く行われるファイルをまとめる操作、

cat file1 file2 file3 > some.txt

を書き込まれる側のファイルから制御します。

インストール方法

インストールするにはプラグインをダウンロードして、 Vim設定ファイルディレクトリのpluginディレクトリにコピーしてください。

ファイル	URL
rargs.vim	https://github.com/taku-o/downloads/raw/master/rargs.vim

コマンドフォーマット

rargs.vimプラグインをインストールすると :RArgs コマンドが追加されます。 :RArgs コマンドのフォーマットは次の通りです。

:[N]RArgs [++opt] {filename1} [{filename2} {filename3}...]

コマンド説明
[N]
    テキストを流し込む位置。省略可能。

[++opt]
    ファイル読み込みの際に指定するオプション。
    詳しくは、 ':help ++opt' 参照。

{filename1} [{filename2} {filename3}...]
    読み込むファイル。複数指定可能。同じファイル指定可能。
    ワイルドカード使用可能。
    Vimのファイル系特殊キーワード（'#2', '%'）など使用可能。

コマンドの実行例

:RArgs コマンドはファイル名のリストを受け取りますが、
単純なファイル名だけでなく、ワイルドカードによるファイル指定や、 Vimのファイル系の特殊キーワードを使用したファイル指定、同じファイルの複数回の読み込みなども利用できます。

" 複数ファイルの読み込み
:RArgs sample1.txt sample2.txt sample3.txt

" ワイルドカード
:RArgs sample*

" Vimのファイル系特殊キーワード
:RArgs #2 #4 #6<.bak

" 同じファイルの複数回読み込み
:RArgs sample1.txt sample1.txt sample1.txt

" エンコード、ファイルフォーマット指定
:RArgs ++enc=utf-8 ++ff=unix sample1.txt sample2.txt sample3.txt

読み込み位置

:RArgs コマンドでファイルが読み込まれる位置は、行未指定ならカーソル行、
行を指定したなら、その指定行になります。

" カーソル行に読み込み
:RArgs sample1.txt sample2.txt sample3.txt

" 200行に読み込み
:200RArgs sample1.txt sample2.txt sample3.txt

ファイルの先頭に、読み込みファイルを流し込むには、
:read コマンドの場合と同じく、行の指定に0を使用してください。

" ファイルの先頭に読み込んだファイルを流し込む
:0RArgs sample1.txt sample2.txt sample3.txt

設定

g:rargs_exit_when_error

ファイル読み込みの際、エラーが発生した、もしくは、指定したファイルが読み込めない場合に、プラグインの処理を中止するかしないかを 'g:rargs_exit_when_error' で指定できます。「デフォルトの挙動は、エラーがあっても残りのファイルを継続して処理する」です。

エラー発見時に、プラグインの処理を中止するには、Vimの設定ファイルで次のように設定してください。

let g:rargs_exit_when_error = '1'

ScreenShot.vim : Vimエディタでの表示内容をHTML化するプラグイン

2011-09-20T22:56:38+09:00

Contents

概要
インストール方法
使用方法
設定

概要

ScreenShot : ScreenShot.vim enables you make screenshot of your VIM session as HTML code.
http://www.vim.org/scripts/script.php?script_id=1552

Vimエディタで表示している内容をHTML化して、Webブラウザで表示、印刷できるようにするプラグインです。
同様の機能をもったプラグインである 2html.vim との違いとして、 VimエディタのタイトルバーごとHTML化したり、差分diff結果をHTML化する機能を持ちます。

インストール方法

日本語環境用に少し修正を入れたプラグインを作成してあります。
プラグインをセットアップするにはプラグインファイルをダウンロード後、 vim設定ファイルディレクトリのpluginディレクトリにコピーしてください。

説明	ファイル	URL
オリジナル	ScreenShot.vim	http://www.vim.org/scripts/script.php?script_id=1552
修正版	ScreenShot_mb.vim	https://github.com/taku-o/downloads/raw/master/ScreenShot_mb.vim

使用方法

ScreenShot.vimプラグインには、3つのコマンドが用意されています。

コマンド	説明
:ScreenShot	ウィンドウも含めて、スクリーンショットをHTML化します。
:Text2Html	選択したテキストをHTML化します。
:Diff2Html	差分diff実行時に、そのdiffの状態をHTML化します。

:ScreenShot

「:ScreenShot」コマンドを実行すると、ウィンドウも含めて、Vimエディタに表示している内容をHTML化します。

:ScreenShot

下画像は、左上がVimエディタ上での表示で、右下がHTML化したテキストをWebブラウザで表示した様子です。

:Text2Html

「:Text2Html」コマンドは、選択した範囲のテキストをHTML化します。テキスト未選択時はファイル全体が対象となります。
「 2html.vim 」プラグインの挙動に最も近いのが、この「:Text2Html」コマンドだと思います。

:'<,'>Text2Html

左上がVimエディタ上での表示で、右下がHTML化したテキストをWebブラウザで表示したものです。選択した範囲のみ、HTML化されます。

Note

2html.vimプラグインのドキュメントも参考にしてください。
2html.vim : ファイルをシンタックスハイライトつきのHTMLに変換

:Diff2Html

diffモードでのみ、動作します。差分diff実行後に「Diff2Html」コマンドを実行すると、差分diffの状態をHTML化します。

:Diff2Html

下画像は、左上がVimエディタでの差分diffの状態、右下が「Diff2Html」コマンドで、HTML化した様子です。
上下ウィンドウで分割して比較しても、左右比較した状態でHTML化されます。

Note

差分diffの使い方が分らない場合は、いくつかドキュメントを用意してあるので、そちらのペースを参照してください。
2つのテキストファイルのdiff

設定

ScreenShot.vimプラグインには、次の設定が用意されています。これらの設定を有効にするには、Vimエディタの設定ファイルに記述してください。
いくつかの設定は「:ScreenShot」コマンドの結果のみで有効です。

オプション	説明
Title	タイトルバーを表示するか。1で表示、0で非表示。
Icon	アイコンをタイトルバーに表示するか。1で表示、0で非表示。
Credits	クレジットを表示するか。1で表示、0で非表示。
force_background	背景色を特定の色にする。

各設定は「g:ScreenShot」ディクショナリのキーとして、次のように指定します。

" 設定例
:let g:ScreenShot = {'Title':1, 'Icon':1, 'Credits':1, 'force_background':'#000000', 'fill_screen':1}

lsf.vim : カレントディレクトリ以下のファイル、ディレクトリ一覧を読み込む

2011-09-20T22:55:53+09:00

Contents

概要
インストール方法
使用方法
スクリプトの使い方の例

概要

lsf.vim : カレントディレクトリ以下、ファイルの一覧を取得するスクリプト
https://github.com/taku-o/downloads/raw/master/lsf.vim

カレントディレクトリ以下にある全ファイル、全ディレクトリを検索し、
パスの一覧をカレント行に書き込むスクリプトです。

インストール方法

プラグインをダウンロードして、
pluginディレクトリにコピーしてください。

ファイル	URL
lsf.vim	https://github.com/taku-o/downloads/raw/master/lsf.vim

使用方法

スクリプトをインストールすると、コマンドが2つ追加されます。
「:LSF」コマンドを実行すると、カレントディレクトリ以下の全ファイルのパス一覧を、
「:LSD」コマンドを実行すると、カレントディレクトリ以下の全ディレクトリのパス一覧を、
カレント行に書き込みます。

コマンド	コマンドの説明
:LSF	カレント行以下の全ファイルのパスを読み込む
:LSD	カレント行以下の全ディレクトリのパスを読み込む

スクリプトの使い方の例

まず、このスクリプトでカレント行以下のファイルの一覧を読み込み、

:LSF

foo/var/testA00.txt
foo/var/testA01.txt
foo/var/testA02.txt
foo/var/testA03.txt
foo/var/testA04.txt

読み取った結果を、たとえば、下記のように加工してから、

rm foo/var/testA00.txt
rm foo/var/testA03.txt
mv foo/var/testA04.txt foo/var/t219.txt

シェルスクリプト、もしくは、バッチファイルとして実行する

:!sh %

と、いったような使い方があります。

kwbd.vim : ウィンドウレイアウトを崩さないでバッファを閉じる

2011-09-20T22:55:37+09:00

Contents

概要
インストール方法
使用方法
注意事項など

概要

vim online Tip #622: Deleting a buffer without changing your window layout
http://www.vim.org/tips/tip.php?tip_id=622

複数のウィンドウで複数のバッファを開いている時に、あるウィンドウのバッファを閉じると、ウィンドウのレイアウトが崩れてしまいますが、
このスクリプトを使用すると、指定ウィンドウのバッファを、ウィンドウのレイアウトを崩す事無く閉じることができます。

↑上の状況で、レイアウトを崩さずバッファを消す事ができる。

インストール方法

スクリプトを用意してあります。
このスクリプトをダウンロードして、 pluginディレクトリにコピーしてください。
とても短いスクリプトです。

ファイル	URL
kwbd.vim	ダウンロード

使用方法

下のコマンドで、カレントのウィンドウのバッファを閉じることができます。

:Kwbd

注意事項など

閉じようとするウィンドウのバッファと同じバッファが
他のウィンドウで開かれていると、
そのウィンドウも一緒に閉じてしまいます。

java_getset.vim : Javaのゲットメソッド、セットメソッドを生成

2011-09-20T22:55:19+09:00

Contents

概要
インストール方法
使用方法
設定方法
- 方法1(簡単)
- 方法2
注意事項など

概要

java_getset.vim : Automatically add getter／setters for Java properties (including array-based)
http://www.vim.org/scripts/script.php?script_id=490

Java言語用のスクリプトで変数のアクセサメソッドを作成します。

// 変数
private String name;

// アクセサメソッド生成(デフォルト)
/**
 * Get name.
 *
 * @return name as String.
 */
public String getName()
{
    return name;
}

/**
 * Set name.
 *
 * @param name the value to set.
 */
public void setName(String name)
{
    this.name = name;
}

インストール方法

vim online から、スクリプトをダウンロードしてきます。

ファイル	URL
java_getset.vim	http://www.vim.org/scripts/script.php?script_id=490

ダウンロードしたスクリプトは、
$VIMRUNTIME/ftplugin
にコピーしてください。

使用方法

ノーマルモードで現在カーソルのある行、
もしくはビジュアルモードで選択している行の変数に対して、
働きます。

<LocalLeader>g

このコマンドでgetterメソッドを追加します。
変数上で「 ¥ g 」を入力してみてください。

<LocalLeader>s

このコマンドでsetterメソッドを追加します。
変数上で「 ¥ s 」を入力してみてください。

<LocalLeader>b

このコマンドでgetterメソッド、setterメソッドを共に追加します。
変数上で「 ¥ b 」を入力してみてください。

<LocalLeader>p

このコマンドはプロンプトを立ち上げ、どのアクセサを追加するか、尋ねてくるコマンドです。

変数上で「 ¥ p 」を入力してみてください。

Note

プロンプトの機能は、香り屋Mac OS X用 gvim 6.1.392で、使用するとフリーズしました。
原因は不明です。
もし、貴方の環境でもフリーズするようなら、スクリプトをコメントアウトするなり、キーマップを外すなりしてください。

コマンド	説明
\s	setterメソッドの追加を行う。
\g	getterメソッドの追加を行う。
\b	setter、getter両方のメソッドの追加を行う。
\p	プロンプトでどちらのメソッドを追加するか尋ねてくる。MacOSXで使うとフリーズする。

設定方法

生成されたアクセサメソッド、コメントの部分を見てください。
生成されるメソッドのコード、コメントは設定により変更することができます。

// アクセサメソッド生成(デフォルト)
/**
 * Get name.
 *
 * @return name as String.
 */
public String getName()
{
    return name;
}

/**
 * Set name.
 *
 * @param name the value to set.
 */
public void setName(String name)
{
    this.name = name;
}

適当なテンプレートを用意しました。

このテンプレートを変更して、生成されるコード、コメントを変更しましょう。
テンプレートは、下の方法のいずれかで導入します。

方法1(簡単)

テンプレートをダウンロードしたら、テキストエディタで開いて、その中身を_vimrc設定ファイルにコピーしましょう。

その後、テンプレートの該当部分を自分に合うように変更します。

方法2

このファイルを、「java.vim」にファイル名を変更して、
$HOME/vimfiles/ftplugin (Windows)
$HOME/.vim/ftplugin (Mac)
にコピーします。
既に同名のファイルが存在する場合は、ファイルの中身を追加してください。

その後、テンプレートの該当部分を自分に合うように変更します。

テンプレートについて
b:javagetset_getterTemplate	getterメソッドのテンプレートです。
b:javagetset_setterTemplate	setterメソッドのテンプレートです。
b:javagetset_getterArrayTemplate	配列のgetterメソッドのテンプレートです。
b:javagetset_setterArrayTemplate	配列のsetterメソッドのテンプレートです。
%varname%	実行時に変数名と置きかえられます。
%type%	実行時に型情報と置きかえられます。
%modifiers%	実行時に置きかえられます。通常、publicが入ります。
%funcname%	getメソッド時はget + 変数の頭大文字に、setメソッド時はset + 変数の頭大文字と置きかえられます。

テンプレートを作成するのに必要な知識
\n	改行を示します。
.	文字列を連結します。これは、"(ダブルクォート)の囲みの外にある時です。
"	囲まれた範囲を文字列として扱います。ただし、行の先頭にある場合は、その行をコメントとして扱ってしまいます。

アクセサメソッドの挿入位置(どれか1つ)
let b:javagetset_insertPosition=0	アクセサメソッドを、Javaソースの最後に追加する。(デフォルト)
let b:javagetset_insertPosition=1	アクセサメソッドを、変数の直前に挿入する。
let b:javagetset_insertPosition=2	アクセサメソッドを、変数の直下に挿入する。

注意事項など

上にも書いてありますが、
一部の機能は、香り屋Mac OS X用 gvim 6.1.392で、フリーズを引き起こします。プロンプトにより、選択する機能がそうです。

もし、貴方の環境でもフリーズするようなら、
スクリプトをコメントアウトするなり、キーマップを外すなりしてください。

head.vim : ファイルの上か下、限定された行数のみを読み込む

2011-09-20T22:55:03+09:00

Contents

概要
インストール方法
スクリプトの使い方
- Windows環境
- Windows以外の環境
読み込む行数を変更する
設定

概要

head.vim : ファイルの上か下、限定された行数のみを読み込む
https://github.com/taku-o/downloads/raw/master/head.vim

「head.vim」は、ファイルの上か、下から特定範囲の行のみを読み書きするスクリプトです。
デフォルトでは10行のみ読み込みます。

インストール方法

スクリプトをダウンロードして、
pluginディレクトリにコピーしてください。

ファイル	URL
head.vim	https://github.com/taku-o/downloads/raw/master/head.vim

スクリプトの使い方

ファイル処理の関係で、Windows環境と、それ以外の環境ではスクリプトの使い方が異なります。

Windows環境

ファイルの上から10行を読み込む場合はファイル名に「head;」、ファイルの上から10行を読み込む場合はファイル名に「tail;」を頭につけて、呼び出してください。

" sample.txtの上から10行を読み込む
:e head;sample.txt

" sample.txtの下から10行を読み込む
:e tail;sample.txt

Windows以外の環境

ファイルの上から10行を読み込む場合はファイル名に「head:」、ファイルの上から10行を読み込む場合はファイル名に「tail:」を頭につけて、呼び出してください。

" sample.txtの上から10行を読み込む
:e head:sample.txt

" sample.txtの下から10行を読み込む
:e tail:sample.txt

読み込む行数を変更する

「:Head」コマンドで読み込む行数を変更できます。コマンドのフォーマットは次の通りです。

:Head {行数}

" コマンドの実行例
:Head 30

このコマンドを実行すると、ファイルの上から読む行数、下から読む行数、ともに変更されます。

設定

スクリプトがファイルから読み込む行数の初期値をオプションで変更できます。オプション名は「g:head_display_lines」です。
変更するには、vimエディタの設定ファイルで「g:head_display_lines」を設定してください。

" 読み込む行数に50を指定
:let g:head_display_lines = 50

grepu.vim ／ grepw.vim : ファイルのグレップ検索

2011-09-20T22:54:46+09:00

Contents

概要
インストール方法
使用方法
注意事項など

概要

grepu.vim

現在いるディレクトリのファイルに対して検索をかけ、その検索語が見つかったファイルおよび、見つけた行を表示します。
更には、そのリスト上から、検索語がヒットした個所へ移動できます。

検索でヒットしたリストを表示します。行数付き。

検索のヒットした行に移動します。

インストール方法

本来、 Jano's Vim Macro Page から、スクリプトをダウンロードすべきなのですが、リンクが切れているので、当サイトにファイルを逃がしてあります。
grepu.vim と、 array.vim をダウンロードしてください。

ファイル	URL
grepu.vim、array.vim（待避）	https://github.com/taku-o/downloads/blob/master/jano_vim_macros

ダウンロードしたgrepu.vim、array.vimは $VIMRUNTIME/macrosディレクトリにコピーしてください。

最後に_vimrcファイルに、次の1文を書き足します。

source $VIMRUNTIME/grepu.vim

これでインストール完了です。

使用方法

まず、検索から入ります。

,gr

このコマンドをノーマルモードで入力すると、
その時カーソルの下に単語があれば検索をかけ、もし、単語が無ければ、検索ワードを尋ねてきます。

検索ワードを入力した場合は、入力後、Enterキーで検索を実行できます。

検索結果のリストが表示されたら、

開きたいファイルの開きたい行の上にカーソルを持って行き、

で、そのファイルを開きます。

で、別のウィンドウにファイルを開くことができます。

注意事項など

このスクリプトは、Unix用です。
Windowsユーザー用には、 grepw.vim というマクロが用意されています。

Windowsで、grepwマクロを使用するには、grepw.vimの他に、
grep.exeがインストールされている必要があります。

名無しのvim使い

「Vimテクニックバイブル〜作業効率をカイゼンする150の技」を執筆

Vim Advent Calendar 2011 17日目 メモを取るためのプラグイン達

totd.vim : その日最初にvimエディタを起動した時にVimのTipsを表示

zshr.vim : 直前に実行したコマンドを少し変更して実行する。zshシェルのrコマンド。

zoom.vim : 「+」、「-」キーで文字の大きさを変更

Visual Mark : 行をハイライト表示して、後でその行に移動できるスクリプト

template file loader : ファイル新規作成時に用意されたテンプレートを読み込む

monday.vim : Ctrl-a、Ctrl-xで曜日、月をループ （＋他の用途への応用）

rargs.vim : 指定した複数のファイルを一度に読み込む

ScreenShot.vim : Vimエディタでの表示内容をHTML化するプラグイン

lsf.vim : カレントディレクトリ以下のファイル、ディレクトリ一覧を読み込む

kwbd.vim : ウィンドウレイアウトを崩さないでバッファを閉じる

java_getset.vim : Javaのゲットメソッド、セットメソッドを生成

head.vim : ファイルの上か下、限定された行数のみを読み込む

grepu.vim ／ grepw.vim : ファイルのグレップ検索

Vim Advent Calendar 2011 17日目メモを取るためのプラグイン達

monday.vim : Ctrl-a、Ctrl-xで曜日、月をループ（＋他の用途への応用）