Теми

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. Вижте Персонализирани езици и теми.