主题

shikiphp打包了完整的 Shiki 主题集：来自 tm-themes 1.12.2的全部 65 个 VS Code主题，也就是 3.23.0所提供的集合 Shiki。其中 44 个为深色主题，21 个为浅色主题。常用 ID 包括 github-dark、github-light、nord、dracula、vitesse-dark、vitesse-light、one-dark-pro、monokai、solarized-dark，以及 catppuccin-*和 material-theme-*系列。

使用 theme 选项指定单个主题，或使用 themes 指定两个或更多主题，以生成包含明暗 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，并按字母顺序排列：

vendor/bin/shikiphp themes

目录

类型是捆绑包为每个主题记录的 light 或 dark 类型，选择 themes 选项的主题组合时很有用。

添加自己的语言

使用 VS Code 和 loadTheme 注册自定义 JSON 主题。参见 自定义语言和主题。