السمات

يجمع shikiphp مجموعة سمات Shiki الكاملة: جميع سمات VS Code الـ65 من tm-themes 1.12.2، وهي المجموعة التي يأتي بها Shiki 3.23.0. منها 44 داكنة و21 فاتحة. تشمل المعرّفات الشائعة github-dark وgithub-light وnord وdracula وvitesse-dark وvitesse-light وone-dark-pro وmonokai وsolarized-dark، بالإضافة إلى مجموعتي catppuccin-* وmaterial-theme-*.

استخدم سمة واحدة مع الخيار theme، أو سمتين (أو أكثر) مع themes لإخراج متغيرات CSS الفاتحة والداكنة. راجع البدء.

use Shikiphp\Shikiphp;

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

يؤدي استخدام معرّف سمة غير معروف في الحزمة إلى طرح Shikiphp\Exceptions\Highlight مع الرسالة Unknown theme "…".

ما الذي تتحكم فيه السمة

تحدد السمة لونَي المقدمة والخلفية للكتلة (ويُكتبان على <pre>)، ولون كل رمز ونمط خطه (مائل أو عريض أو تحته خط أو مشطوب)، وفق خصوصية محددات النطاق. بالنسبة إلى lang: 'ansi'، تصبح ألوان terminal.ansi* لوحة ANSI (راجع ANSI). لتعديل ألوان منفردة دون تحرير السمة، استخدم colorReplacements.

عرض قائمة السمات المضمنة

من 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

أو من سطر الأوامر، معرّف واحد في كل سطر وبالترتيب الأبجدي:

vendor/bin/shikiphp themes

الفهرس

النوع هو نوع light أو dark الذي تسجله الحزمة لكل سمة، وهو مفيد عند اختيار زوج لخيار themes.

إضافة لغتك الخاصة

سجّل سمة VS Code مخصصة JSON باستخدام loadTheme. راجع اللغات والسمات المخصصة.