Thèmes

shikiphp intègre l'ensemble complet des thèmes Shiki : les 65 thèmes VS Code de tm-themes 1.12.2, l'ensemble fourni par Shiki 3.23.0. 44 sont sombres et 21 sont clairs. Parmi les identifiants les plus populaires figurent github-dark, github-light, nord, dracula, vitesse-dark, vitesse-light, one-dark-pro, monokai, solarized-dark, ainsi que les familles catppuccin-* et material-theme-*.

Utilisez un seul thème avec l’option theme, ou deux (ou plus) avec themes pour une sortie à variables CSS clair/sombre. Consultez Premiers pas.

use Shikiphp\Shikiphp;

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

Un identifiant de thème inconnu du bundle déclenche Shikiphp\Exceptions\Highlight avec le message Unknown theme "…".

Ce que contrôle un thème

Un thème définit le premier plan et l’arrière-plan du bloc (écrits sur le <pre>), ainsi que la couleur et le style de police (italique, gras, souligné, barré) de chaque jeton, déterminés par la spécificité des sélecteurs de portée. Pour lang: 'ansi', ses couleurs terminal.ansi* deviennent la palette ANSI (voir ANSI). Pour ajuster des couleurs individuelles sans modifier un thème, utilisez colorReplacements.

Liste des thèmes inclus

Depuis 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

Ou depuis la ligne de commande, avec un identifiant par ligne, par ordre alphabétique :

vendor/bin/shikiphp themes

Catalogue

Le type correspond au type light ou dark que le bundle associe à chaque thème. Il est utile pour choisir une paire pour l’option themes.

Ajouter les vôtres

Enregistrez un thème VS Code personnalisé JSON avec loadTheme. Consultez Custom languages and themes.