Thema's

shikiphp bundelt de volledige Shiki-themaset: alle 65 VS Code-thema's van tm-themes 1.12.2, de set die Shiki 3.23.0 levert. 44 zijn donker en 21 licht. Populaire id's zijn onder meer github-dark, github-light, nord, dracula, vitesse-dark, vitesse-light, one-dark-pro, monokai, solarized-dark en de families catppuccin-* en material-theme-*.

Gebruik één thema met de optie theme, of twee (of meer) met themes voor uitvoer met variabele CSS voor licht en donker. Zie Aan de slag.

use Shikiphp\Shikiphp;

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

Een thema-id die de bundel niet kent, veroorzaakt Shikiphp\Exceptions\Highlight met het bericht Unknown theme "…".

Wat een thema bepaalt

Een thema bepaalt de voor- en achtergrondkleur van het blok (vastgelegd op de <pre>) en de kleur en tekenstijl (cursief, vet, onderstreept, doorgehaald) van elk code-element, op basis van de specificiteit van de scope-selectors. Voor lang: 'ansi' worden de terminal.ansi*-kleuren het ANSI-palet (zie ANSI). Gebruik colorReplacements om afzonderlijke kleuren aan te passen zonder een thema te bewerken.

De meegeleverde thema's weergeven

Vanuit 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

Of via de opdrachtregel, één id per regel in alfabetische volgorde:

vendor/bin/shikiphp themes

Catalogus

Het type is het type light of dark dat de bundel voor elk thema vastlegt; handig bij het kiezen van een paar voor de optie themes.

Zelf talen toevoegen

Registreer met loadTheme een aangepast thema VS CodeJSON. Zie Aangepaste talen en thema's.