usr_01.txt (Vim Reference Manual)

マニュアルについて

*usr_01.txt*  For Vim バージョン 8.1.  Last change: 2017 Jul 15

		     VIM USER MANUAL - by Bram Moolenaar

			      マニュアルについて

この章では、Vim のマニュアルを紹介します。著作權についてもお讀み下さい。

\|01.1\|	2 つのマニュアル
\|01.2\|	Vim の準備
\|01.3\|	チュートリアル
\|01.4\|	著作權 (Copyright)

2 つのマニュアル

Vim のマニュアルは 2 部構成になつてゐます。

ユーザーマニュアル
簡單なものから複雜なものまで、具體的な例を使つて說明してゐます。本のやうに最初から順を追つて讀んでください。
リファレンスマニュアル
Vim がどのやうに動作するかを詳しく說明してゐます。

マニュアルの表記方法については |notation| をご覽ください。

他のトピックへのジャンプ

2 つのマニュアルにはハイパーリンクが張つてあります。編輯手順の說明とコマンドやオプションの詳しい說明とを素早く行き來できます。次のコマンドを使つてください。

`CTRL-]` :	カーソル位置の項目にジャンプする。
`CTRL-O` :	ジャンプ先から戾る。

リンクは |bars| のやうに縱線 (vertical bar) で圍まれてゐます。縱線は隱れてゐるか非表示になつてゐるかもしれません (下記參照)。オプション名は ’number’ のやうにアポストロフィで、コマンドは ":write" のやうに引用符で圍まれてゐます。普通の單語もリンクとして使へます。試しに、カーソルを CTRL-] の上に動かして CTRL-] を押してみてください。

":help" コマンドでヘルプの目次を表示できます。|help.txt| をご覽ください。

縱線とスターは通常は |conceal| 機能によつて隱されてゐます。さらに、|hl-Ignore| が使用され、背景色と同じ色が設定されてゐます。次のコマンドでそれらを表示することができます:

:set conceallevel=0
:hi link HelpBar Normal
:hi link HelpStar Normal

Vim の準備

マニュアルの大部分は Vim が正しくインストールされてゐることを前提にしてゐます。まだインストールしてゐなかつたり、うまく動いてゐない (ファイルが見つからない、GUI でメニューが出ないなどの) 場合は、インストールの章 |usr_90.txt| を讀んでください。

このマニュアルでは「vi 互換スイッチ(’compatible’)」がオフになつてゐることを前提にしてゐます。ほとんどのコマンドは互換スイッチの影響を受けませんが、例へば、複數回アンドゥなどの機能を使ふときは設定が重要になります。正しく設定されてゐることを確實にするには、サンプル設定ファイルをコピーするのが簡單です。Vim の中からコピーを實行するなら、サンプル設定ファイルの場所を探す必要はありません。コピーの方法はシステムによつて違ひます:

Unix:

:!cp -i $VIMRUNTIME/vimrc_example.vim ~/.vimrc

MS-DOS, MS-Windows, OS/2:

:!copy $VIMRUNTIME/vimrc_example.vim $VIM/_vimrc

Amiga:

:!copy $VIMRUNTIME/vimrc_example.vim $VIM/.vimrc

vimrc ファイルが既にある場合はコピーする必要はないかもしれません。

Vim を起動すると、オプション ’compatible’ はオフになつてゐるはずです。次のコマンドで現在の設定を確認できます:

:set compatible?

"nocompatible" と表示されればオフになつてゐます。"compatible" と表示された場合は正しく設定されてゐません。オプションがオンになつてゐる理由を確認してください。もしかしたら、先程保存した設定ファイルが讀み込まれてゐないのかもしれません。次のコマンドで確認してください:

:scriptnames

ファイルが一覽に無い場合は、vimrc ファイルの名前と場所を確認してください。一覽に入つてゐる場合は、他のファイルによつて ’compatible’ がオンに設定されてゐるはずです。

詳しくは |vimrc| と |compatible-default| をご覽ください。

Note:
このマニュアルは Vim を普通に使ふための說明書です。實は evim(=easy vim) といふ別の Vim があります。これも Vim なのですが、メモ帳のやうに「クリック & 入力」方式であつたり、常に插入モードであつたり、普通の Vim とはかなり雰圍氣が違ひます。このユーザーマニュアルでは evim について說明してゐません。操作方法は使へばわかるはずです。詳しいことは |evim-keys| をご覽ください。

チュートリアル

テキストを讀むだけではなく (退屈だし！) チュートリアルを使つて Vim の初步を學ぶことができます。vimtutor は 30 分の演習コースです。實際に操作しながら Vim の最低限の操作方法を習得できます。

Unix では、Vim が適切にインストールしてあれば、シェルから起動できます:

vimtutor

MS-Windows では、スタートメニューの Program/Vim から起動できます。あるいは、$VIMRUNTIME ディレクトリにある vimtutor.bat を實行してください。

演習ファイルのコピーが作られるので、テキストを編輯してもオリジナルの演習ファイルを壞してしまふ心配はありません。チュートリアルはいくつかの言語に飜譯されてゐます。飜譯されたチュートリアルを使ふには、二文字の言語コードを指定します。日本語の場合は次のやうにします:

vimtutor ja

Unix で GUI 版の Vim を使ひたい場合は、"gvimtutor" か "vimtutor -g" を實行してください。

OpenVMS では、VMS プロンプトから次のやうにして起動できます。

@VIM:vimtutor

上の例と同じやうにオプションで 2 文字の言語コードを指定できます。

Unix 以外のシステムでは、多少の作業が必要です。

演習用ファイルをコピーします。これは Vim を使つてコピーできます (Vim はファイルの場所を知つてゐる):
```
vim --clean -c 'e $VIMRUNTIME/tutor/tutor' -c 'w! TUTORCOPY' -c 'q'
```
"TUTORCOPY" といふファイルがカレントディレクトリに作成されます。飜譯された演習ファイルを使ふには、2 文字の言語コードを指定します。日本語の場合は次のやうにします:
```
vim --clean -c 'e $VIMRUNTIME/tutor/tutor.ja' -c 'w! TUTORCOPY' -c 'q'
```
コピーしたファイルを Vim で開きます:
```
vim --clean TUTORCOPY
```
引數 --clean を使ふと、Vim は快適な初期狀態で起動されます。
練習が終はつたら、コピーしたファイルを削除します:
```
del TUTORCOPY
```

著作權 (Copyright)

Vim のユーザーマニュアルとリファレンスマニュアルの著作權は以下の通りです。

Open Publication License, v1.0 以降の條件に從つて配布することができます。ライセンスの最新バージョンは次の場所から入手できます: http://www.opencontent.org/openpub/

マニュアルに貢獻する人は上記の著作權通達に同意しなければなりません。ユーザーマニュアルの一部は "Vi IMproved - VIM" から取られたものです。

"Vi IMproved - Vim" Steve Oualline著
(出版:New Riders Publishing, ISBN: 0735710015)

この本には Open Publication License が適用されてゐます。必要な部分のみコピーし、變更を加へてゐます (圖を削除したり、Vim 6.0 以降のために更新したり、閒違ひを訂正したり)。|frombook| タグが省略されてゐたとしても、この本からコピーしたことを否定するものではありません。

この本を OPL で出版してくださつた Steve Oualline 氏と New Riders に深く感謝します。ユーザーマニュアルの執筆においてとても助けられました。文章を提供してもらつただけでなく、スタイルや文體も參考にさせていただきました。

このマニュアルの販賣で收益を上げた方は、利益の一部を寄附してくださるやうお願ひします。ウガンダのエイズ患者を助けてあげてください。詳しくは |iccf| をご覽ください。