Теми

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. Див. Власні мови й теми.