Темы

shikiphp включает полный набор тем Shiki: все 65 тем VS Code из tm-themes 1.12.2, набора тем, который поставляет Shiki 3.23.0. 44 темы тёмные, 21 — светлая. Среди популярных идентификаторов: 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'],
]);

Если пакет не знает идентификатор темы, он выдаёт 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

Или из командной строки: по одному идентификатору в строке, в алфавитном порядке:

vendor/bin/shikiphp themes

Каталог

Тип — это light или dark тип, который пакет указывает для каждой темы. Он пригодится при выборе пары для параметра themes.

Добавление собственных языков

Зарегистрируйте пользовательскую тему VS Code JSON с помощью loadTheme. См. раздел Пользовательские языки и темы.