Temaer

shikiphp indeholder hele temasættet fra Shiki: alle 65 VS Code-temaer fra tm-themes 1.12.2, sættet Shiki 3.23.0 leverer. 44 er mørke og 21 er lyse. Populære id'er omfatter github-dark, github-light, nord, dracula, vitesse-dark, vitesse-light, one-dark-pro, monokai, solarized-dark samt familierne catppuccin-* og material-theme-*.

Brug ét tema med indstillingen theme eller to (eller flere) med themes for output med variabler i CSS til lys/mørk tilstand. Se Kom godt i gang.

use Shikiphp\Shikiphp;

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

Et tema-id, som pakken ikke kender, udløser Shikiphp\Exceptions\Highlight med meddelelsen Unknown theme "…".

Hvad et tema styrer

Et tema angiver blokkens forgrunds- og baggrundsfarve (skrevet på <pre>) og farven og skrifttypen (kursiv, fed, understreget, gennemstreget) for hvert token, bestemt ud fra specificiteten af scope-vælgeren. For lang: 'ansi' bliver dets terminal.ansi*-farver til ANSI-paletten (se ANSI). Hvis du vil justere enkelte farver uden at redigere et tema, kan du bruge colorReplacements.

Liste over de medfølgende temaer

Fra 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

Eller fra kommandolinjen, ét id pr. linje i alfabetisk rækkefølge:

vendor/bin/shikiphp themes

Katalog

Typen er den light- eller dark-type, som pakken registrerer for hvert tema. Det er nyttigt, når du skal vælge et par til indstillingen themes.

Tilføj dine egne

Registrer et brugerdefineret VS Code-tema JSON med loadTheme. Se Brugerdefinerede sprog og temaer.