テーマ

shikiphpにはShikiの全テーマが含まれます。VS Codeの全65テーマは、tm-themes 1.12.2のテーマセットで、Shiki 3.23.0に収録されています。内訳はダーク44、ライト21です。人気のIDにはgithub-dark、github-light、nord、dracula、vitesse-dark、vitesse-light、one-dark-pro、monokai、solarized-dark、さらにcatppuccin-*とmaterial-theme-*の各ファミリーがあります。

themeオプションでテーマを1つ、またはthemesを使って2つ以上指定し、ライト／ダークのCSS変数出力を行います。はじめにを参照してください。

use Shikiphp\Shikiphp;

echo Shikiphp::codeToHtml('const answer = 42', [
    'lang'   => 'js',
    'themes' => ['light' => 'github-light', 'dark' => 'github-dark'],
]);

バンドルにないテーマIDを指定すると、Shikiphp\Exceptions\Highlightが発生し、メッセージUnknown theme "…"が表示されます。

テーマで設定できる項目

テーマはブロックの前景色と背景色（<pre>に設定）に加え、各トークンの色とフォントスタイル（斜体、太字、下線、取り消し線）を設定します。スタイルはスコープセレクターの具体性に基づいて決まります。lang: 'ansi'の場合は、テーマのterminal.ansi*色がANSIパレットになります（ANSIを参照）。テーマを編集せずに個別の色を調整するには、colorReplacementsを使います。

同梱テーマの一覧表示

PHPから：

use Shikiphp\Shikiphp;

$highlighter = Shikiphp::highlighter();

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

またはコマンドラインから、IDをアルファベット順に1行ずつ表示します：

vendor/bin/shikiphp themes

カタログ

種類はバンドルが各テーマに記録しているlightまたはdarkです。themesオプションに指定するテーマの組み合わせを選ぶ際に役立ちます。

独自の文法を追加する

カスタム VS Code テーマ JSON を loadTheme に登録します。カスタム言語とテーマを参照してください。