Themes

shikiphp enthält den vollständigen Shiki-Theme-Satz: alle 65 VS Code-Themes aus tm-themes 1.12.2, dem Satz, den Shiki 3.23.0 mitliefert. 44 sind dunkel und 21 hell. Beliebte IDs sind github-dark, github-light, nord, dracula, vitesse-dark, vitesse-light, one-dark-pro, monokai, solarized-dark sowie die Familien catppuccin-* und material-theme-*.

Verwende ein Theme mit der Option theme oder zwei (oder mehr) mit themes für eine Ausgabe mit hellen und dunklen CSS-Variablen. Siehe Erste Schritte.

use Shikiphp\Shikiphp;

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

Ist dem Bundle eine Theme-ID unbekannt, wird Shikiphp\Exceptions\Highlight mit der Meldung Unknown theme "…" ausgelöst.

Was ein Theme steuert

Ein Theme legt Vorder- und Hintergrundfarbe des Blocks fest (sie werden auf <pre> geschrieben) sowie Farbe und Schriftstil (kursiv, fett, unterstrichen, durchgestrichen) jedes Tokens, aufgelöst anhand der Spezifität des Scope-Selectors. Für lang: 'ansi' werden die terminal.ansi*-Farben zur ANSI-Palette (siehe ANSI). Um einzelne Farben ohne Bearbeitung eines Themes anzupassen, verwende colorReplacements.

Enthaltene Themes auflisten

Über 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

Oder über die Kommandozeile, eine ID pro Zeile in alphabetischer Reihenfolge:

vendor/bin/shikiphp themes

Katalog

Der Typ ist der Typ light oder dark, den das Bundle für jedes Theme speichert. Er hilft dir bei der Auswahl eines Paares für die Option themes.

Eigene hinzufügen

Registriere mit loadTheme ein benutzerdefiniertes VS Code-Theme JSON. Siehe Benutzerdefinierte Sprachen und Themes.