* feat(callout): revamp of the callouts * fix: doc * chore: refactor gh alert * feat: same colors on callouts and gh alerts * docs: more relevant examples * docs: i18n * docs: update existing callouts
150 lines
5.0 KiB
Markdown
150 lines
5.0 KiB
Markdown
---
|
||
title: کامپوننت Callout
|
||
linkTitle: Callout
|
||
aliases:
|
||
- callouts
|
||
prev: /docs/guide/shortcodes
|
||
---
|
||
|
||
یک کامپوننت داخلی برای نمایش اطلاعات مهم به خواننده.
|
||
|
||
<!--more-->
|
||
|
||
> [!NOTE]
|
||
> [هشدارهای سبک GitHub](../../markdown#alerts) از [نسخه 0.9.0](https://github.com/imfing/hextra/releases/tag/v0.9.0) پشتیبانی میشوند.
|
||
> این ویژگی از سینتکس Markdown برای رندر کردن callout استفاده میکند که باعث بهبود قابلیت حمل و خوانایی محتوا میشود.
|
||
|
||
## أمثلة
|
||
|
||
{{< callout >}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{< /callout >}}
|
||
|
||
{{< callout type="info" >}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{< /callout >}}
|
||
|
||
{{< callout type="warning" >}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{< /callout >}}
|
||
|
||
{{< callout type="error" >}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{< /callout >}}
|
||
|
||
{{< callout type="important" >}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{< /callout >}}
|
||
|
||
### تقصير
|
||
|
||
{{< callout >}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{< /callout >}}
|
||
|
||
```markdown
|
||
{{</* callout */>}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{</* /callout */>}}
|
||
```
|
||
|
||
### Info
|
||
|
||
{{< callout type="info" >}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{< /callout >}}
|
||
|
||
```markdown
|
||
{{</* callout type="info" */>}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{</* /callout */>}}
|
||
```
|
||
|
||
### Warning
|
||
|
||
{{< callout type="warning" >}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{< /callout >}}
|
||
|
||
```markdown
|
||
{{</* callout type="warning" */>}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{</* /callout */>}}
|
||
```
|
||
|
||
### Error
|
||
|
||
{{< callout type="error" >}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{< /callout >}}
|
||
|
||
```markdown
|
||
{{</* callout type="error" */>}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{</* /callout */>}}
|
||
```
|
||
|
||
### Important
|
||
|
||
{{< callout type="important" >}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{< /callout >}}
|
||
|
||
```markdown
|
||
{{</* callout type="important" */>}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{</* /callout */>}}
|
||
```
|
||
|
||
### أيقونة مخصصة
|
||
|
||
{{< callout icon="sparkles" >}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{< /callout >}}
|
||
|
||
```markdown
|
||
{{</* callout icon="sparkles" */>}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{</* /callout */>}}
|
||
```
|
||
|
||
{{< callout type="important" icon="sparkles" >}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{< /callout >}}
|
||
|
||
```markdown
|
||
{{</* callout type="important" icon="sparkles" */>}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{</* /callout */>}}
|
||
```
|
||
|
||
### الرموز التعبيرية
|
||
|
||
{{< callout emoji="🌐" >}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{< /callout >}}
|
||
|
||
```markdown
|
||
{{</* callout emoji="🌐" */>}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{</* /callout */>}}
|
||
```
|
||
|
||
{{< callout type="info" emoji="ℹ️" >}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{< /callout >}}
|
||
|
||
```markdown
|
||
{{</* callout type="info" emoji="ℹ️" */>}}
|
||
**الإشارة** عبارة عن جزء قصير من النص يهدف إلى جذب الانتباه.
|
||
{{</* /callout */>}}
|
||
```
|
||
|
||
## خيارات
|
||
|
||
| المعلمة | وصف |
|
||
|---------|---------------------------------------------------------------------|
|
||
| `type` | نوع الاستدعاء. (افتراضي، `info`، `warning`، `error`) |
|
||
| `emoji` | الرمز التعبيري الذي يظهر قبل المكالمة. |
|
||
| `icon` | رمز تعبيري للنداء (مرتبط بالنوع أو يمكن أن يكون رمز تعبيري مخصصًا). |
|