Temas

shikiphp inclui o conjunto completo de temas de Shiki: todos os 65 temas de VS Code de tm-themes 1.12.2, o conjunto fornecido por Shiki 3.23.0. 44 são escuros e 21 são claros. IDs populares incluem github-dark, github-light, nord, dracula, vitesse-dark, vitesse-light, one-dark-pro, monokai, solarized-dark, além das famílias catppuccin-* e material-theme-*.

Use um único tema com a opção theme, ou dois (ou mais) com themes para gerar saída com variáveis de tema claro/escuro CSS. Consulte Primeiros passos.

use Shikiphp\Shikiphp;

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

Um ID de tema desconhecido pelo pacote gera Shikiphp\Exceptions\Highlight com a mensagem Unknown theme "…".

O que um tema controla

Um tema define o primeiro plano e o plano de fundo do bloco (escritos no <pre>) e a cor e o estilo da fonte (itálico, negrito, sublinhado, tachado) de cada token, determinados pela especificidade do seletor de escopo. Para lang: 'ansi', as cores terminal.ansi* se tornam a paleta ANSI (consulte ANSI). Para ajustar cores específicas sem editar um tema, use colorReplacements.

Como listar os temas incluídos

De 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 pela linha de comando, um ID por linha em ordem alfabética:

vendor/bin/shikiphp themes

Catálogo

O tipo é o tipo light ou dark que o pacote registra para cada tema, útil na escolha de um par para a opção themes.

Adicionar seus próprios idiomas

Registre um tema personalizado VS Code JSON com loadTheme. Consulte Idiomas e temas personalizados.