Teemat

shikiphp sisältää koko Shiki-teemakokoelman: kaikki 65 VS Code-teemaa paketista tm-themes 1.12.2, jonka kokoelma Shiki 3.23.0 toimittaa. 44 on tummia ja 21 vaaleita. Suosittuja tunnuksia ovat github-dark, github-light, nord, dracula, vitesse-dark, vitesse-light, one-dark-pro, monokai, solarized-dark sekä catppuccin-*- ja material-theme-*-perheet.

Käytä yhtä teemaa asetuksella theme tai kahta (tai useampaa) asetuksella themes vaalean ja tumman CSS-muuttujatulosteen luomiseen. Katso Aloittaminen.

use Shikiphp\Shikiphp;

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

Tunnus, jota paketti ei tunne, aiheuttaa Shikiphp\Exceptions\Highlight-virheen, jonka viesti on Unknown theme "…".

Mitä teema ohjaa

Teema määrittää lohkon etu- ja taustavärin (kirjoitetaan elementtiin <pre>) sekä kunkin tokenin värin ja fonttityylin (kursiivi, lihavointi, alleviivaus, yliviivaus) määritettynä kontekstinvalitsimien tarkkuuden mukaan. Kohteessa lang: 'ansi' sen terminal.ansi*-värit muodostavat ANSI-paletin (katso ANSI). Jos haluat säätää yksittäisiä värejä muokkaamatta teemaa, käytä asetusta colorReplacements.

Pakettiin sisältyvien teemojen luetteloiminen

Kohteesta 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

Tai komentoriviltä, yksi tunnus rivillä aakkosjärjestyksessä:

vendor/bin/shikiphp themes

Luettelo

Tyyppi on light- tai dark-tyyppi, jonka paketti tallentaa kullekin teemalle. Siitä on hyötyä, kun valitset paria asetukseen themes.

Oman lisääminen

Rekisteröi mukautettu VS Code-teema JSON komennolla loadTheme. Katso Custom languages and themes.