Files
hextra_mirror/exampleSite/content/docs/guide/shortcodes/icon.fa.md

47 lines
1.4 KiB
Markdown
Raw Normal View History

---
title: آیکون
2025-08-14 22:07:15 +08:00
next: /docs/guide/shortcodes/steps
---
2025-08-14 22:07:15 +08:00
برای استفاده از این شورت‌کد به صورت درون‌خطی، باید قابلیت شورت‌کدهای درون‌خطی در تنظیمات فعال شود:
```yaml {filename="hugo.yaml"}
enableInlineShortcodes: true
```
2025-08-14 22:07:15 +08:00
لیست آیکون‌های موجود را می‌توانید در [`data/icons.yaml`](https://github.com/imfing/hextra/blob/main/data/icons.yaml) مشاهده کنید.
<!--more-->
## مثال
{{< icon "academic-cap" >}}
{{< icon "cake" >}}
{{< icon "gift" >}}
{{< icon "sparkles" >}}
2025-08-14 22:07:15 +08:00
## نحوه استفاده
```
{{</* icon "github" */>}}
```
2025-08-14 22:07:15 +08:00
آیکون‌های [Heroicons](https://v1.heroicons.com/) نسخه 1 به صورت پیش‌فرض در دسترس هستند.
2025-08-14 22:07:15 +08:00
### چگونه آیکون‌های خود را اضافه کنید
2025-08-14 22:07:15 +08:00
فایل `data/icons.yaml` را ایجاد کنید، سپس آیکون‌های SVG خود را با فرمت زیر اضافه کنید:
```yaml {filename="data/icons.yaml"}
2025-08-14 22:07:15 +08:00
your-icon: <svg>محتوای SVG آیکون شما</svg>
```
2025-08-14 22:07:15 +08:00
سپس می‌توانید از آن در شورت‌کد به این صورت استفاده کنید:
```
{{</* icon "your-icon" */>}}
{{</* card icon="your-icon" */>}}
```
2025-08-14 22:07:15 +08:00
نکته: [Iconify Design](https://iconify.design/) منبع خوبی برای یافتن آیکون‌های SVG برای سایت شماست.