Motivy

shikiphp obsahuje úplnou sadu motivů Shiki: všech 65 motivů VS Code z tm-themes 1.12.2, které jsou součástí sady Shiki 3.23.0. 44 motivů je tmavých a 21 světlých. Mezi oblíbená ID patří github-dark, github-light, nord, dracula, vitesse-dark, vitesse-light, one-dark-pro, monokai, solarized-dark a rodiny catppuccin-* a material-theme-*.

Použijte jeden motiv s volbou theme nebo dva či více motivů s volbou themes pro výstup s proměnnými CSS pro světlý a tmavý motiv. Viz Začínáme.

use Shikiphp\Shikiphp;

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

Neznámé ID motivu v balíčku vyvolá Shikiphp\Exceptions\Highlight se zprávou Unknown theme "…".

Co motiv ovládá

Motiv nastavuje barvu popředí a pozadí bloku (zapsanou do <pre>) a barvu a styl písma (kurzívu, tučné písmo, podtržení, přeškrtnutí) každého tokenu, které se určují podle specifičnosti selektoru rozsahu. U lang: 'ansi' se jeho barvy terminal.ansi* stanou paletou ANSI (viz ANSI). Chcete-li upravit jednotlivé barvy bez změny motivu, použijte colorReplacements.

Výpis přibalených motivů

Z 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

Nebo z příkazového řádku, vždy jedno ID na řádek v abecedním pořadí:

vendor/bin/shikiphp themes

Katalog

Typ je hodnota light nebo dark, kterou balíček zaznamenává pro každý motiv; hodí se při výběru dvojice pro možnost themes.

Přidání vlastních

Zaregistrujte vlastní motiv VS Code JSON pomocí loadTheme. Viz Vlastní jazyky a motivy.