Usr_06
Nvim の:helpページ。生成されたもので、ソースはtree-sitter-vimdocパーサーを使用しています。
VIM ユーザーマニュアル - Bram Moolenaar 著
構文ハイライトの使用
白黒テキストは退屈です。色を使用すると、ファイルが生き生きとして見えます。見た目が良いだけでなく、作業速度も向上します。さまざまな種類のテキストに使用される色を変更します。画面に表示されている色でテキストを印刷します。
有効化
構文ハイライトはデフォルトで有効になっています。Nvim はファイルの種類を自動的に検出し、適切な構文ハイライトを読み込みます。
色が表示されない理由はいくつか考えられます。
ターミナルが色をサポートしていません。Vim は太字、斜体、下線付きのテキストを使用しますが、見栄えはあまり良くありません。色のサポートのあるターミナルを試してみることをお勧めします。
ターミナルは色をサポートしていますが、Vim がそれを認識していません。$TERM 設定が正しいことを確認してください。たとえば、色をサポートする xterm を使用している場合
setenv TERM xterm-color
または（シェルによって異なります）
TERM=xterm-color; export TERM
ターミナル名は、使用しているターミナルと一致する必要があります。
ファイルの種類が認識されません。Vim はすべてのファイルの種類を認識しているわけではなく、ファイルがどの言語を使用しているかを判断するのは不可能な場合があります。次のコマンドを試してください。
:set filetype
結果が「filetype=」の場合、問題は実際にはVim がファイルの種類を認識していないことです。種類を手動で設定できます。
:set filetype=fortran
使用可能な種類を確認するには、$VIMRUNTIME/syntax ディレクトリを参照してください。GUI の場合は、[構文] メニューを使用できます。ファイルの種類の設定は、
モードラインを使用して行うこともでき、ファイル編集のたびにハイライトされます。たとえば、Makefile では次の行を使用できます（ファイルの先頭または末尾に配置します）。
# vim: syntax=make
ファイルの種類を自分で検出する方法を知っているかもしれません。多くの場合、ファイル名の拡張子（ドットの後）を使用できます。Vim にそのファイルの種類を検出させる方法については、
new-filetypeを参照してください。
ファイルの種類のハイライトがありません。上記のように手動で設定することで、類似のファイルの種類を使用してみてください。それでも十分でない場合は、独自の構文ファイルを作成できます。
mysyntaxfileを参照してください。
または、色が間違っている可能性があります。
色の付いたテキストが非常に読みづらいです。Vim は使用している背景色を推測します。黒（または他の暗い色）の場合、テキストには明るい色を使用します。白（または他の明るい色）の場合、テキストには暗い色を使用します。Vim の推測が間違っていると、テキストが読みづらくなります。これを解決するには、
'background' オプションを設定します。暗い背景の場合は
:set background=dark
明るい背景の場合は
:set background=light
このコマンドを「:syntax enable」コマンドの_前に_配置してください。そうしないと、色が既に設定されている可能性があります。
'background'を設定した後に「:syntax reset」を実行して、Vim にデフォルトの色を再度設定させることができます。
下から上へスクロールすると色が間違っています。Vim はテキストを解析するためにファイル全体を読み込みません。ファイルを表示している場所から解析を開始します。これにより多くの時間が節約されますが、場合によっては色が間違っていることがあります。簡単な解決策は、
CTRL-Lを押すことです。または、少し戻ってから再び前にスクロールします。本当の解決策については、
:syn-syncを参照してください。一部の構文ファイルには、さらに遡って表示する方法があります。特定の構文ファイルのヘルプを参照してください。たとえば、TeX 構文の場合は
tex.vimです。
デフォルトの色が気に入らない場合は、別の配色を選択できます。GUI では、[編集]/[配色] メニューを使用します。次のコマンドを入力することもできます。
:colorscheme evening
"evening" は配色の名前です。他にも試してみる価値のあるものがいくつかあります。$VIMRUNTIME/colors ディレクトリを参照してください。
気に入った配色が見つかったら、
init.vimファイルに「:colorscheme」コマンドを追加します。
独自の配色を作成することもできます。方法は次のとおりです。
1. 近い配色を選択します。このファイルを独自の Vim ディレクトリにコピーします。Unix の場合は、次の操作で機能します。
!mkdir -p ~/.config/nvim/colors
!cp $VIMRUNTIME/colors/morning.vim ~/.config/nvim/colors/mine.vim
これは、$VIMRUNTIME の値を知っている Vim から実行されます。
2. 配色ファイルを編集します。これらのエントリは役立ちます。
カラーターミナルでの cterm 属性 ctermfg カラーターミナルでの前景の色 ctermbg カラーターミナルでの背景の色 GUI 属性 GUI guifg GUI での前景色 guibg GUI での背景色
たとえば、コメントを緑色にするには
:highlight Comment ctermfg=green guifg=green
"cterm" と "gui" に使用できる属性は "bold" と "underline" です。両方必要な場合は "bold,underline" を使用します。詳細については、
:highlight コマンドを参照してください。
3. Vim に常に独自の配色を使用するように指示します。
vimrcに次の行を追加します。
colorscheme mine
最も頻繁に使用される色の組み合わせがどのように見えるかを確認するには、次のコマンドを使用します。
:runtime syntax/colortest.vim
さまざまな色の組み合わせでテキストが表示されます。読みやすく、見栄えの良いものを確認できます。
テキストをカラーで表示するには、多くの労力が必要です。表示が遅すぎる場合は、構文ハイライトを一時的に無効にすることができます。
:syntax clear
別のファイル（または同じファイル）を編集すると、色が戻ります。
ハイライトを完全に停止する場合は、次のコマンドを使用します。
:syntax off
これにより、構文ハイライトが完全に無効になり、すべてのバッファーからすぐに削除されます。詳細については、
:syntax-offを参照してください。
:syn-manual 特定のファイルのみで構文ハイライトを使用する場合は、次のコマンドを使用します。
:syntax manual
これにより構文ハイライトが有効になりますが、バッファーの編集を開始したときに自動的にオンになるわけではありません。現在のバッファーでハイライトをオンにするには、
'syntax' オプションを設定します。
:set syntax=ON