# السمات

يجمع shikiphp **مجموعة سمات Shiki الكاملة**: جميع سمات VS Code الـ65 من [`tm-themes`](https://github.com/shikijs/textmate-grammars-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`](https://shikiphp.inline0.dev/ar/docs/options#theme)، أو سمتين (أو أكثر) مع [`themes`](https://shikiphp.inline0.dev/ar/docs/options#themes) لإخراج متغيرات CSS الفاتحة والداكنة. راجع [البدء](https://shikiphp.inline0.dev/ar/docs/getting-started#dual-themes-light-and-dark).

```php
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](https://shikiphp.inline0.dev/ar/docs/ansi)). لتعديل ألوان منفردة دون تحرير السمة، استخدم [`colorReplacements`](https://shikiphp.inline0.dev/ar/docs/options#colorreplacements).

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

من PHP:

```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
```

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

```bash
vendor/bin/shikiphp themes
```

## الفهرس

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

| السمة | المعرّف | النوع |
| --- | --- | --- |
| Andromeeda | `andromeeda` | داكن |
| Aurora X | `aurora-x` | داكن |
| Ayu Dark | `ayu-dark` | داكن |
| Ayu Light | `ayu-light` | فاتح |
| Ayu Mirage | `ayu-mirage` | داكن |
| Catppuccin Frappé | `catppuccin-frappe` | داكن |
| Catppuccin Latte | `catppuccin-latte` | فاتح |
| Catppuccin Macchiato | `catppuccin-macchiato` | داكن |
| Catppuccin Mocha | `catppuccin-mocha` | داكن |
| Dark Plus | `dark-plus` | داكن |
| Dracula Theme | `dracula` | داكن |
| Dracula Theme Soft | `dracula-soft` | داكن |
| Everforest Dark | `everforest-dark` | داكن |
| Everforest Light | `everforest-light` | فاتح |
| GitHub داكن | `github-dark` | داكن |
| GitHub داكن افتراضي | `github-dark-default` | داكن |
| GitHub داكن خافت | `github-dark-dimmed` | داكن |
| GitHub داكن عالي التباين | `github-dark-high-contrast` | داكن |
| GitHub فاتح | `github-light` | فاتح |
| GitHub فاتح افتراضي | `github-light-default` | فاتح |
| GitHub فاتح عالي التباين | `github-light-high-contrast` | فاتح |
| Gruvbox Dark Hard | `gruvbox-dark-hard` | داكن |
| Gruvbox Dark Medium | `gruvbox-dark-medium` | داكن |
| Gruvbox Dark Soft | `gruvbox-dark-soft` | داكن |
| Gruvbox Light Hard | `gruvbox-light-hard` | فاتح |
| Gruvbox Light Medium | `gruvbox-light-medium` | فاتح |
| Gruvbox Light Soft | `gruvbox-light-soft` | فاتح |
| Horizon | `horizon` | داكن |
| Horizon Bright | `horizon-bright` | فاتح |
| Houston | `houston` | داكن |
| Kanagawa Dragon | `kanagawa-dragon` | داكن |
| Kanagawa Lotus | `kanagawa-lotus` | فاتح |
| Kanagawa Wave | `kanagawa-wave` | داكن |
| LaserWave | `laserwave` | داكن |
| Light Plus | `light-plus` | فاتح |
| Material Theme | `material-theme` | داكن |
| Material Theme Darker | `material-theme-darker` | داكن |
| Material Theme Lighter | `material-theme-lighter` | فاتح |
| Material Theme Ocean | `material-theme-ocean` | داكن |
| Material Theme Palenight | `material-theme-palenight` | داكن |
| Min Dark | `min-dark` | داكن |
| Min Light | `min-light` | فاتح |
| Monokai | `monokai` | داكن |
| Night Owl | `night-owl` | داكن |
| Night Owl Light | `night-owl-light` | فاتح |
| Nord | `nord` | داكن |
| One Dark Pro | `one-dark-pro` | داكن |
| One Light | `one-light` | فاتح |
| Plastic | `plastic` | داكن |
| Poimandres | `poimandres` | داكن |
| Red | `red` | داكن |
| Rosé Pine | `rose-pine` | داكن |
| Rosé Pine Dawn | `rose-pine-dawn` | فاتح |
| Rosé Pine Moon | `rose-pine-moon` | داكن |
| Slack Dark | `slack-dark` | داكن |
| Slack Ochin | `slack-ochin` | فاتح |
| Snazzy Light | `snazzy-light` | فاتح |
| Solarized Dark | `solarized-dark` | داكن |
| Solarized Light | `solarized-light` | فاتح |
| Synthwave '84 | `synthwave-84` | داكن |
| Tokyo Night | `tokyo-night` | داكن |
| Vesper | `vesper` | داكن |
| Vitesse Black | `vitesse-black` | داكن |
| Vitesse Dark | `vitesse-dark` | داكن |
| Vitesse Light | `vitesse-light` | فاتح |

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

سجّل سمة VS Code مخصصة JSON باستخدام `loadTheme`. راجع
[اللغات والسمات المخصصة](https://shikiphp.inline0.dev/ar/docs/custom-languages-themes).