vim.treesitter

Treesitter integration                                 *treesitter*

Nvim integrates the `tree-sitter` library for incremental parsing of buffers:

Nvim は、バッファの増分解析のために`tree-sitter`ライブラリを統合しています：

https://tree-sitter.github.io/tree-sitter/

WARNING: Treesitter support is still experimental and subject to frequent
changes. This documentation may also not fully reflect the latest changes.

警告：Treesitter のサポートは依然として実験段階にあり、頻繁に変更される可能性があります。
また、このドキュメントには最新の変更が完全に反映されていない場合があります。

PARSER FILES                                              treesitter-parsers*

Parsers are searched for as `parser/{lang}.*` in any 'runtimepath' directory.
If multiple parsers for the same language are found, the first one is used.

パーサーは、任意の 'runtimepath' ディレクトリ内で `parser/{lang}.*` の形式で検索されます。
同じ言語のパーサーが複数見つかった場合、最初のものが使用されます。

(NOTE: This typically implies the priority "user config > plugins > bundled".)

(注：これは通常、「ユーザー設定 > プラグイン > バンドル」という優先順位を意味します。)

TREESITTER QUERIES                                          treesitter-query*

Treesitter queries are a way to extract information about a parsed |TSTree|,
e.g., for the purpose of highlighting. Briefly, a `query` consists of one or
more patterns. A `pattern` is defined over node types in the syntax tree. A
`match` corresponds to specific elements of the syntax tree which match a
pattern. Patterns may optionally define captures and predicates. A `capture`
allows you to associate names with a specific node in a pattern. A `predicate`
adds arbitrary metadata and conditional data to a match.

Treesitter のクエリは、解析済みの |TSTree| に関する情報を抽出するための手段であり、
例えばハイライト表示などの目的で使用されます。簡単に言えば、`query` は1つ以上の
パターンで構成されます。`pattern` は、構文木のノード型に対して定義されます。
`match` は、パターンに一致する構文木の特定の要素に対応します。
パターンには、オプションでキャプチャや述語を定義できます。
`capture` を使用すると、パターン内の特定のノードに名前を関連付けることができます。
`predicate` は、マッチに任意のメタデータや条件付きデータを追加します。

Queries are written in a lisp-like language documented in
https://tree-sitter.github.io/tree-sitter/using-parsers/queries/1-syntax.html
Note: The predicates listed there differ from those Nvim supports. See
|treesitter-predicates| for a complete list of predicates supported by Nvim.

クエリは、Lisp に似た言語で記述され、その詳細は
https://tree-sitter.github.io/tree-sitter/using-parsers/queries/1-syntax.html
注：そこに記載されている述語は、Nvim がサポートするものと異なります。Nvimがサポートする述語の完全なリストについては、
|treesitter-predicates| を参照してください。

Nvim looks for queries as `*.scm` files in a `queries` directory under
`runtimepath`, where each file contains queries for a specific language and
purpose, e.g., `queries/lua/highlights.scm` for highlighting Lua files.
By default, the first query on `runtimepath` is used (which usually implies
that user config takes precedence over plugins, which take precedence over
queries bundled with Nvim). If a query should extend other queries instead
of replacing them, use |treesitter-query-modeline-extends|.

Nvim は、`runtimepath` 配下の `queries` ディレクトリ内に `*.scm` ファイルとしてクエリを検索します。
各ファイルには特定の言語や目的に対応したクエリが含まれており、
例えば、Luaファイルのハイライト用には `queries/lua/highlights.scm` が使用されます。
デフォルトでは、`runtimepath` にある最初のクエリが使用されます
(これは通常、ユーザー設定がプラグインより優先され、プラグインが Nvim に同梱されているクエリより優先されることを意味します)。
クエリを置き換えるのではなく、他のクエリを拡張したい場合は、|treesitter-query-modeline-extends| を使用してください。

The Lua interface is described at |lua-treesitter-query|.

Lua インターフェースについては、|lua-treesitter-query| で説明されています。

 nvim
 ├── init.lua
 ├── lua
 │   ├── ...
 │   ...
+├── parser
+│   └── rust.dylib
+├── queries
+│   ├── rust
+│   │   ├── highlights.scm
+│   │   ├── injections.scm
+│   │   └── tags.scm
 ... ...