Temas

shikiphp incluye el conjunto completo de temas de Shiki: los 65 temas VS Code de tm-themes 1.12.2, el conjunto que incluye Shiki 3.23.0. 44 son oscuros y 21 claros. Entre los identificadores más populares están github-dark, github-light, nord, dracula, vitesse-dark, vitesse-light, one-dark-pro, monokai, solarized-dark y las familias catppuccin-* y material-theme-*.

Use un solo tema con la opción theme, o dos (o más) con themes para generar variables CSS claras y oscuras. Consulte Primeros pasos.

use Shikiphp\Shikiphp;

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

Un ID de tema que el paquete no reconoce genera Shikiphp\Exceptions\Highlight con el mensaje Unknown theme "…".

Qué controla un tema

Un tema define el primer plano y el fondo del bloque (que se escriben en <pre>), así como el color y el estilo de fuente (cursiva, negrita, subrayado y tachado) de cada token, según la especificidad del selector de ámbito. Para lang: 'ansi', sus colores terminal.ansi* pasan a ser la paleta ANSI (consulte ANSI). Para ajustar colores individuales sin editar un tema, use colorReplacements.

Lista de temas incluidos

Desde 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

O desde la línea de comandos, un ID por línea y en orden alfabético:

vendor/bin/shikiphp themes

Catálogo

El tipo es el tipo light o dark que el paquete registra para cada tema; resulta útil al elegir un par para la opción themes.

Añadir idiomas propios

Registre un VS Code tema JSON personalizado con loadTheme. Consulte Idiomas y temas personalizados.