Témák

Az shikiphp tartalmazza a teljes Shiki témakészletet: mind a 65 VS Code témát az tm-themes 1.12.2 kínálatából, amelyet az Shiki 3.23.0 szállít. 44 sötét, 21 világos. Népszerű azonosítók: github-dark, github-light, nord, dracula, vitesse-dark, vitesse-light, one-dark-pro, monokai, solarized-dark, valamint az catppuccin-* és material-theme-* család.

Egyetlen témához használja a theme beállítást, kettőhöz (vagy többhöz) pedig a themes beállítást a világos/sötét CSS-változók kimenetéhez. Lásd: Kezdő lépések.

use Shikiphp\Shikiphp;

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

Ha a csomag nem ismer egy témaazonosítót, Shikiphp\Exceptions\Highlight hibát dob a következő üzenettel: Unknown theme "…".

Mit szabályoz egy téma

A téma határozza meg a blokk előtér- és háttérszínét (a <pre> elemre írva), valamint az egyes tokenek színét és betűstílusát (dőlt, félkövér, aláhúzott, áthúzott), a hatókörválasztók specificitása alapján. A lang: 'ansi' esetében a terminal.ansi* színei alkotják az ANSI-palettát (lásd: ANSI). Ha egyéni színeket szeretne beállítani a téma szerkesztése nélkül, használja a colorReplacements lehetőséget.

A csomagban található témák listázása

Innen: 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

Vagy a parancssorból, ábécérendben, soronként egy azonosítóval:

vendor/bin/shikiphp themes

Katalógus

A típus az light vagy dark típus, amelyet a csomag az egyes témákhoz rögzít; ez hasznos, amikor az themes beállításhoz választ párt.

Saját hozzáadása

Regisztráljon egy egyéni VS Code témát az JSON segítségével, a loadTheme használatával. Lásd: Egyéni nyelvek és témák.