Tema

shikiphp menyertakan seluruh set tema Shiki: semua 65 tema VS Code dari tm-themes 1.12.2, set yang disertakan Shiki 3.23.0. 44 bertipe gelap dan 21 bertipe terang. Id populer mencakup github-dark, github-light, nord, dracula, vitesse-dark, vitesse-light, one-dark-pro, monokai, solarized-dark, serta keluarga catppuccin-* dan material-theme-*.

Gunakan satu tema dengan opsi theme, atau dua (atau lebih) tema dengan themes untuk keluaran variabel CSS terang/gelap. Lihat Memulai.

use Shikiphp\Shikiphp;

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

Id tema yang tidak dikenali oleh bundle akan memunculkan Shikiphp\Exceptions\Highlight dengan pesan Unknown theme "…".

Fungsi tema

Tema menetapkan warna latar depan dan latar belakang blok (ditulis pada <pre>) serta warna dan gaya font (miring, tebal, garis bawah, coret) setiap token, yang ditentukan berdasarkan spesifisitas pemilih cakupan. Untuk lang: 'ansi', warna terminal.ansi* menjadi palet ANSI (lihat ANSI). Untuk menyesuaikan warna tertentu tanpa mengedit tema, gunakan colorReplacements.

Menampilkan tema yang disertakan

Dari 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

Atau dari baris perintah, satu id per baris dalam urutan alfabet:

vendor/bin/shikiphp themes

Katalog

Jenisnya adalah jenis light atau dark yang dicatat bundle untuk setiap tema, berguna saat memilih pasangan untuk opsi themes.

Menambahkan bahasa sendiri

Daftarkan tema khusus VS Code JSON dengan loadTheme. Lihat Bahasa dan tema khusus.