Témy

shikiphp obsahuje úplnú sadu tém Shiki: všetkých 65 tém VS Code z tm-themes 1.12.2, teda sadu, ktorú dodáva Shiki 3.23.0. 44 tém je tmavých a 21 svetlých. Medzi obľúbené identifikátory patria github-dark, github-light, nord, dracula, vitesse-dark, vitesse-light, one-dark-pro, monokai, solarized-dark a rodiny catppuccin-* a material-theme-*.

Použite jednu tému s možnosťou theme alebo dve (či viac) s možnosťou themes na výstup s premennými CSS pre svetlý/tmavý režim. Pozrite si Začíname.

use Shikiphp\Shikiphp;

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

Ak balík nepozná identifikátor témy, vyvolá sa Shikiphp\Exceptions\Highlight so správou Unknown theme "…".

Čo určuje téma

Téma určuje farbu textu a pozadia bloku (nastavenú na <pre>) a farbu aj štýl písma (kurzíva, tučné, podčiarknuté, prečiarknuté) každého tokenu; rozhoduje špecifickosť selektora rozsahu. V prípade lang: 'ansi' sa farby terminal.ansi* zmenia na paletu ANSI (pozrite si ANSI). Ak chcete upraviť jednotlivé farby bez úprav témy, použite colorReplacements.

Zoznam pribalených tém

V 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

Alebo z príkazového riadka, jeden identifikátor na riadok v abecednom poradí:

vendor/bin/shikiphp themes

Katalóg

Typ je označenie light alebo dark, ktoré balík eviduje pre každú tému. Hodí sa pri výbere dvojice pre možnosť themes.

Pridanie vlastných

Zaregistrujte vlastnú tému VS Code JSON pomocou loadTheme. Pozrite si Vlastné jazyky a témy.