> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# الإعدادات المسبقة

> إدارة إعدادات العرض القابلة لإعادة الاستخدام

الإعداد المسبق هو إعداد عرض قابل لإعادة الاستخدام — الخلفية، ونمط الترجمة الفرعية، والتخطيط، وإعدادات مرئية أخرى — يمكنك تطبيقه على أي مشروع أو تصدير. تُعد الإعدادات المسبقة مثالية عندما تريد مظهراً متسقاً عبر العديد من المقاطع.

اطّلع على [Render settings reference](/en/render-settings-reference) للحصول على الشكل الكامل لـ
`preset` وكل خيار مدعوم بقيم تعداد (enum).

## `preset schema`

إرجاع مخطط JSON Schema لإعدادات الإعدادات المسبقة. استخدم هذا لاكتشاف الحقول الصالحة قبل إنشاء إعداد مسبق أو تحديثه.

```bash theme={null}
youka preset schema --json
```

<Tip>
  يجب على الوكلاء استدعاء `preset schema` قبل تعديل الإعدادات المسبقة لكي يعرفوا
  أسماء الحقول الدقيقة وأنواع القيم.
</Tip>

## `preset list`

سرد جميع الإعدادات المسبقة المملوكة للحساب المُصادَق عليه.

```bash theme={null}
youka preset list --json
```

## `preset show`

جلب إعداد مسبق واحد حسب المعرّف.

```bash theme={null}
youka preset show <presetId> --json
```

## `preset create`

إنشاء إعداد مسبق جديد.

```bash theme={null}
youka preset create [options]
```

### Options

| الخيار             | الوصف                                  |
| ------------------ | -------------------------------------- |
| `--name <name>`    | اسم الإعداد المسبق                     |
| `--default`        | تعيين الإعداد المسبق الجديد كافتراضي   |
| `--body <file\|->` | قراءة كامل نص الطلب من ملف أو من stdin |

<Note>
  يجب أن يحتوي نص الطلب على كائن `preset` بالكامل. للحمولات الكبيرة،
  يُفضَّل استخدام `--body` بدلاً من JSON مضمّن داخل السطر.
</Note>

### Examples

<CodeGroup>
  ```bash from-file theme={null}
  youka preset create \
    --name "Neon Night" \
    --body ./neon-preset.json \
    --json
  ```

  ```bash make-default theme={null}
  youka preset create \
    --name "Red Cinema" \
    --body ./red-cinema.json \
    --default \
    --json
  ```

  ```bash from-stdin theme={null}
  cat ./preset.json | youka preset create --name "From stdin" --body - --json
  ```
</CodeGroup>

تتغلب أعلام CLI على الحقول المطابقة القادمة من `--body`.

## `preset update`

تحديث إعداد مسبق موجود.

```bash theme={null}
youka preset update <presetId> [options]
```

| الخيار             | الوصف                            |
| ------------------ | -------------------------------- |
| `--name <name>`    | الاسم الجديد                     |
| `--body <file\|->` | كامل نص الطلب من ملف أو من stdin |

مثال:

```bash theme={null}
youka preset update $PRESET_ID \
  --name "Neon Night v2" \
  --body ./neon-v2.json \
  --json
```

## `preset delete`

حذف إعداد مسبق حسب المعرّف.

```bash theme={null}
youka preset delete <presetId> --json
```

<Warning>
  حذف إعداد مسبق لا يحذف المشاريع أو عمليات التصدير التي سبق
  عرضها باستخدامه. ستفشل عمليات التصدير المستقبلية التي تشير إلى الإعداد المسبق المحذوف.
</Warning>

## `preset default`

الحصول على الإعداد المسبق الافتراضي أو تعيينه.

```bash theme={null}
youka preset default --json
youka preset default <presetId> --json
```

من دون أي وسيط، يُرجع الأمر الإعداد المسبق الافتراضي الحالي أو `null`. ومع معرّف إعداد مسبق، يقوم بتعيين ذلك الإعداد المسبق كافتراضي.

## تطبيق إعداد مسبق

طبّق إعداداً مسبقاً على مشروع أو تصدير باستخدام `--preset`:

<CodeGroup>
  ```bash on-create theme={null}
  youka project create ./song.mp3 --preset $PRESET_ID --wait
  ```

  ```bash on-settings-update theme={null}
  youka project settings $PROJECT_ID --preset $PRESET_ID
  ```

  ```bash on-export theme={null}
  youka export create $PROJECT_ID --preset $PRESET_ID --wait
  ```
</CodeGroup>

## ما التالي

* [Render settings reference](/en/render-settings-reference) - جميع حقول الإعدادات المسبقة المشتركة
* [Projects](/ar/cli/projects) - تطبيق الإعدادات المسبقة على إعدادات المشروع
* [Exports](/ar/cli/exports) - تطبيق الإعدادات المسبقة وقت العرض
* [Media](/ar/cli/media) - وسائط قابلة لإعادة الاستخدام تشير إليها الإعدادات المسبقة