言語

shikiphpにはShikiの言語セット全体が含まれます。tm-grammars 1.31.15が提供するShiki 3.23.0のすべての文法です。つまり、235言語と、それらに組み込まれた18の補助文法を合わせて、全253文法です。これらはTextMateとVS Code、Shikiがトークン化に使う文法と同じなので、対応言語、別名、スコープ名も一致します。

言語はIDまたはエイリアスで指定します。たとえばts、typescript、js、javascript、php、rust、python、html、yaml、jsonなどです。IDは完全一致で照合されるため、以下の一覧にある小文字表記を使ってください。バンドルにないIDを指定すると、Shikiphp\Exceptions\HighlightがUnknown language "…"というメッセージとともにスローされます。

特殊IDの'ansi'は文法ではなく、ターミナル出力をハイライトします。ANSIを参照してください。

Shikiのプレーンテキスト用ID、text、txt、plain、plaintextはまだサポートされておらず、Unknown languageをスローします（#2）。

同梱言語の一覧表示

PHPからハイライターに問い合わせます。

use Shikiphp\Shikiphp;

$highlighter = Shikiphp::highlighter();

$highlighter->bundledLanguages(); // list<string> — ids shipped in the box
$highlighter->loadedLanguages();  // list<string> — bundled plus any you registered

どちらの一覧にも解決可能なIDがすべて含まれます。253個の文法IDに97個のエイリアスが続き、バンドル全体で350件です。

またはコマンドラインから、1行に1つのIDを表示できます。

vendor/bin/shikiphp langs

カタログ

名前順に並べた同梱言語235件です。行にあるIDまたはエイリアスのどれを使っても、同じ文法が選択されます。

補助文法

これら18の文法は、他の文法に埋め込んだり、挿入したりするために用意されています（Angular、Vue、C++マクロ、Jinja、Nix、ts-tagsのタグ付きテンプレートリテラルなど）。必要な言語と一緒に自動で読み込まれ、IDはbundledLanguages()とshikiphp langsにも表示されます：

angular-expression, angular-let-declaration, angular-template, angular-template-blocks, angular-inline-style, angular-inline-template, cpp-macro, jinja-html, markdown-nix, es-tag-css, es-tag-glsl, es-tag-html, es-tag-sql, es-tag-xml, markdown-vue, vue-directives, vue-interpolations, vue-sfc-style-variable-injection.

独自の文法を追加する

同梱されていない言語やプライベートな文法が必要な場合は、loadGrammarに登録してください。カスタム言語とテーマを参照してください。