Temi

shikiphp include l'intero set di temi Shiki: tutti i 65 temi VS Code da tm-themes 1.12.2, il set distribuito da Shiki 3.23.0. 44 sono scuri e 21 chiari. Tra gli id più diffusi ci sono github-dark, github-light, nord, dracula, vitesse-dark, vitesse-light, one-dark-pro, monokai, solarized-dark, e le famiglie catppuccin-* e material-theme-*.

Usate un unico tema con l'opzione theme oppure due (o più) con themes per un output con variabili CSS per modalità chiara/scura. Consultate Guida introduttiva.

use Shikiphp\Shikiphp;

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

Un id di tema sconosciuto al bundle genera Shikiphp\Exceptions\Highlight con il messaggio Unknown theme "…".

Cosa controlla un tema

Un tema imposta il colore di primo piano e di sfondo del blocco (scritti su <pre>), oltre al colore e allo stile del carattere (corsivo, grassetto, sottolineato, barrato) di ogni token, determinati dalla specificità dei selettori di scope. Per lang: 'ansi' i suoi colori terminal.ansi* diventano la palette ANSI (vedere ANSI). Per modificare singoli colori senza intervenire sul tema, usate colorReplacements.

Elencare i temi inclusi

Da 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

Oppure dalla riga di comando, un id per riga in ordine alfabetico:

vendor/bin/shikiphp themes

Catalogo

Il tipo è quello light o dark registrato dal bundle per ogni tema, utile per scegliere una coppia per l'opzione themes.

Aggiungere le vostre

Registrate un tema VS Code personalizzato JSON con loadTheme. Consultate Linguaggi e temi personalizzati.