docs(persian): add fragments to headings

vuejs · Dec 13, 2024 · 8108938 · 8108938
1 parent 394d084
commit 8108938
Show file tree

Hide file tree

Showing 33 changed files with 245 additions and 245 deletions.
diff --git a/docs/fa/guide/asset-handling.md b/docs/fa/guide/asset-handling.md
@@ -1,6 +1,6 @@
-# مدیریت منابع
+# مدیریت منابع{#asset-handling}
 
-## ارجاع به منابع ایستا
+## ارجاع به منابع ایستا{#referencing-static-assets}
 
 تمام فایل‌های Markdown به کامپوننت‌های Vue تبدیل و توسط [Vite](https://vitejs.dev/guide/assets.html) پردازش می‌شوند. شما می‌توانید، **و باید**، هر نوع دارایی را با استفاده از URL‌های نسبی مرجع قرار دهید:
 
@@ -20,7 +20,7 @@ PDFها یا سند‌های دیگر که از طریق پیوندها در ف
 
 تمام ارجاع‌های مسیر **ایستا**، شامل مسیرهای مطلق، باید بر اساس ساختار دایرکتوری کاری شما تعیین شوند.
 
-## دایرکتوری عمومی
+## دایرکتوری عمومی{#the-public-directory}
 
 گاهی اوقات ممکن است نیاز داشته باشید منابع ایستا را فراهم کنید که به صورت مستقیم در هیچ‌یک از Markdown یا کامپوننت‌های قالب شما ارجاع نشده‌اند، یا ممکن است بخواهید برخی فایل‌ها را با نام اصلی خود سرویس دهید. به عنوان مثال، فایل‌هایی مانند `robots.txt`، آیکون‌های fav، و آیکون‌های PWA.
 
@@ -30,7 +30,7 @@ PDFها یا سند‌های دیگر که از طریق پیوندها در ف
 
 توجه داشته باشید که باید به فایل‌های قرار داده شده در `public` با استفاده از مسیر مطلق ریشه ارجاع دهید - به عنوان مثال، `public/icon.png` همیشه باید به عنوان `/icon.png` در کد منبع ارجاع داده شود.
 
-## URL پایه
+## URL پایه {#base-url}
 
 اگر وب‌سایت شما به URL غیر ریشه استقرار می‌یابد، باید گزینه `base` را در `.vitepress/config.js` تنظیم کنید. به عنوان مثال، اگر قصد دارید وب‌سایت خود را به `https://foo.github.io/bar/` استقرار دهید، آنگاه `base` باید به `'/bar/'` تنظیم شود (همیشه باید با یک خط شروع و پایان یابد).
 

diff --git a/docs/fa/guide/cms.md b/docs/fa/guide/cms.md
@@ -2,9 +2,9 @@
 outline: deep
 ---
 
-# اتصال به یک سیستم مدیریت محتوا (CMS)
+# اتصال به یک سیستم مدیریت محتوا (CMS){#connecting-to-a-cms}
 
-## گام‌های کلی
+## گام‌های کلی{#general-workflow}
 
 اتصال ویت‌پرس به یک سیستم مدیریت محتوا به طور عمده بر اساس [مسیریابی پویا](./routing#dynamic-routes) خواهد بود. حتماً قبل از شروع، با روش کار آن آشنا شوید.
 
@@ -51,6 +51,6 @@ outline: deep
     <!-- @content -->
     ```
 
-## راهنماهای ادغام
+## راهنماهای ادغام{#integration-guides}
 
 اگر راهنمایی درباره ادغام ویت‌پرس با یک سیستم مدیریت محتوا خاص نوشته‌اید، لطفاً از لینک "ویرایش این صفحه" زیر استفاده کنید تا آن را ارسال کنید!
diff --git a/docs/fa/guide/custom-theme.md b/docs/fa/guide/custom-theme.md
@@ -2,9 +2,9 @@
 outline: deep
 ---
 
-# استفاده از یک تم سفارشی
+# استفاده از یک تم سفارشی{#using-a-custom-theme}
 
-## Resolve کردن تم
+## Resolve کردن تم {#theme-resolving}
 
 می‌توانید با ایجاد یک فایل `.vitepress/theme/index.js` یا `.vitepress/theme/index.ts` (فایل ورودی تم) تم سفارشی را فعال کنید:
 
@@ -21,7 +21,7 @@ outline: deep
 
 وقتی ویت‌پرس حضور یک فایل ورودی تم را شناسایی کند، همواره از تم سفارشی به جای تم پیش‌فرض استفاده می‌کند. با این حال، شما می‌توانید [تم پیش‌فرض را گسترش دهید](./extending-default-theme) تا سفارشی‌سازی‌های پیشرفته‌تری را روی آن اعمال کنید.
 
-## رابط تم
+## رابط تم{#theme-interface}
 
 یک تم سفارشی ویت‌پرس به عنوان یک شی تعریف می‌شود که شامل رابط زیر است:
 
@@ -72,7 +72,7 @@ export پیش‌فرض تنها قراردادی برای یک تم سفارشی
 
 درون کامپوننت لایه‌ی خود، دقیقاً مانند یک برنامه Vite + Vue 3 عادی عمل می‌کند. با این وجود، توجه داشته باشید که تم همچنین باید [سازگار با SSR](./ssr-compat) باشد.
 
-## ساخت یک لایه
+## ساخت یک لایه {#building-a-layout}
 
 بیشترین لایه‌ی پایه‌ای نیازمند دارای یک کامپوننت `<Content />` است:
 
@@ -156,7 +156,7 @@ const { page, frontmatter } = useData()
 
 برای همه چیزی که در کامپوننت‌های تم موجود است، به [مستندات API اجرایی](../reference/runtime-api) مراجعه کنید. به علاوه، شما می‌توانید از [بارگذاری داده در زمان ساخت](./data-loading) استفاده کنید تا لایه‌های مبتنی بر داده را تولید کنید - به عنوان مثال، یک صفحه که تمام پست‌های وبلاگ در پروژه فعلی را لیست می‌کند.
 
-## توزیع یک تم سفارشی
+## توزیع یک تم سفارشی {#distributing-a-custom-theme}
 
 آسان‌ترین روش برای توزیع یک تم سفارشی ارائه آن به عنوان [قالب مخزن در GitHub](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-template-repository) است.
 
@@ -172,7 +172,7 @@ const { page, frontmatter } = useData()
 
 5. دستورالعمل‌های روشنی برای مصرف تم خود ارائه دهید (مانند زیر).
 
-## مصرف یک تم سفارشی
+## مصرف یک تم سفارشی{#consuming-a-custom-theme}
 
 برای مصرف یک تم خارجی، آن را از ورودی تم سفارشی وارد و دوباره export کنید:
 

diff --git a/docs/fa/guide/data-loading.md b/docs/fa/guide/data-loading.md
@@ -1,10 +1,10 @@
-# بارگذاری داده در زمان ساخت
+# بارگذاری داده در زمان ساخت{#build-time-data-loading}
 
 ویت‌پرس یک ویژگی به نام **بارگذارهای داده** ارائه می‌دهد که به شما این امکان را می‌دهد که داده‌های دلخواه را بارگیری کنید و آن‌ها را از صفحات یا اجزا وارد کنید. بارگذاری داده فقط **در زمان ساخت** اجرا می‌شود: داده‌های حاصل به صورت JSON در بسته JavaScript نهایی سریالیزه می‌شوند.
 
 بارگذارهای داده می‌توانند برای بارگیری داده‌های از راه دور یا تولید فراداده‌ها بر اساس فایل‌های محلی استفاده شوند. به عنوان مثال، می‌توانید از بارگذارهای داده استفاده کنید تا تمام صفحات API محلی خود را تجزیه کنید و به طور خودکار یک فهرست از تمام ورودی‌های API تولید کنید.
 
-## استفاده ابتدایی
+## استفاده ابتدایی{#basic-usage}
 
 یک فایل بارگذار داده باید با `.data.js` یا `.data.ts` پایان یابد. فایل باید یک صادرات پیش‌فرض از یک شی با متد `load()` داشته باشد:
 
@@ -52,7 +52,7 @@ export default {
 }
 ```
 
-## داده از فایل‌های محلی
+## داده از فایل‌های محلی{#data-from-local-files}
 
 وقتی نیاز به تولید داده بر اساس فایل‌های محلی دارید، باید از گزینه `watch` در بارگذار داده استفاده کنید تا تغییرات اعمال شده به این فایل‌ها بتواند به روزرسانی‌های سریع منجر شود.
 
@@ -80,7 +80,7 @@ export default {
 }
 ```
 
-## `createContentLoader`
+## `createContentLoader` {#createcontentloader}
 
 وقتی که در حال ساختن یک سایت متمرکز بر محتوا هستیم، اغلب نیاز به ایجاد یک "بایگانی" یا "فهرست" صفحه داریم: یک صفحه که ما همه ورودی‌های موجود در مجموعه محتوای خود را لیست می‌کنیم، به عنوان مثال پست‌های وبلاگ یا صفحات API. ما می‌توانیم این کار را مستقیماً با API بارگذار داده انجام دهیم، اما از آنجا که این یک حالت استفاده رایج است، ویت‌پرس همچنین یک کمک‌کننده به نام `createContentLoader` را فراهم می‌کند تا این فرآیند را ساده‌تر کند:
 
@@ -133,7 +133,7 @@ import { data as posts } from './posts.data.js'
 </template>
 ```
 
-### گزینه‌ها
+### گزینه‌ها{#options}
 
 احتمالاً داده پیش‌فرض به تمام نیازها پاسخ نمی‌دهد - شما می‌توانید با استفاده از گزینه‌ها به تبدیل داده‌ها مشترک شوید:
 
@@ -216,7 +216,7 @@ interface ContentOptions<T = ContentData[]> {
 }
 ```
 
-## بارگذارهای داده تایپ شده
+## بارگذارهای داده تایپ شده  {#typed-data-loaders}
 
 زمان استفاده از TypeScript، می‌توانید بارگذار و صادرات `data` خود را به این شکل تایپ کنید:
 
@@ -239,7 +239,7 @@ export default defineLoader({
 })
 ```
 
-## پیکربندی
+## پیکربندی {#configuration}
 
 برای دریافت اطلاعات پیکربندی در داخل یک بارگذار، می‌توانید از کدی مانند زیر استفاده کنید:
 

diff --git a/docs/fa/guide/deploy.md b/docs/fa/guide/deploy.md
@@ -2,7 +2,7 @@
 outline: deep
 ---
 
-# استقرار وب‌سایت ویت‌پرس شما
+# استقرار وب‌سایت ویت‌پرس شما{#deploy-your-vitepress-site}
 
 راهنماهای زیر بر اساس برخی فرضیات مشترک است:
 
@@ -19,7 +19,7 @@ outline: deep
   }
   ```
 
-## ساخت و تست محلی
+## ساخت و تست محلی  {#build-and-test-locally}
 
 1. برای ساخت اسناد، این دستور را اجرا کنید:
 
@@ -47,13 +47,13 @@ outline: deep
 
    حالا اسکریپت `docs:preview` سرور را در `http://localhost:8080` راه‌اندازی خواهد کرد.
 
-## تنظیم مسیر پایه عمومی
+## تنظیم مسیر پایه عمومی{#setting-a-public-base-path}
 
 به‌طور پیش‌فرض، ما فرض می‌کنیم که وب‌سایت در مسیر ریشه دامنه (`/`) انتشار می‌یابد. اگر وب‌سایت شما باید در یک زیرمسیر ارائه شود، مانند `https://mywebsite.com/blog/`، در این صورت باید گزینه [`base`](../reference/site-config#base) را به `'/blog/'` در پیکربندی ویت‌پرس تنظیم کنید.
 
 **مثال:** اگر از صفحات GitHub (یا GitLab) استفاده می‌کنید و به `user.github.io/repo/` انتشار می‌دهید، آنگاه `base` را به `/repo/` تنظیم کنید.
 
-## سربرگ‌های حافظه نهان HTTP
+## سربرگ‌های حافظه نهان HTTP {#http-cache-headers}
 
 اگر شما کنترلی بر روی سربرگ‌های HTTP در سرور تولیدی خود دارید، می‌توانید سربرگ‌های `cache-control` را پیکربندی کنید تا بهبود عملکرد در بازدیدهای تکراری داشته باشید.
 
@@ -103,9 +103,9 @@ Cache-Control: max-age=31536000,immutable
 
 :::
 
-## راهنمای‌های پلتفرم
+## راهنمای‌های پلتفرم {#platform-guides}
 
-### Netlify / Vercel / Cloudflare Pages / AWS Amplify / Render
+### Netlify / Vercel / Cloudflare Pages / AWS Amplify / Render {#netlify-vercel-cloudflare-pages-aws-amplify-render}
 
 یک پروژه جدید راه‌اندازی کرده و این تنظیمات را با استفاده از داشبورد خود تغییر دهید:
 
@@ -117,7 +117,7 @@ Cache-Control: max-age=31536000,immutable
 گزینه‌هایی مانند _Auto Minify_ را برای کد HTML فعال نکنید. این گزینه‌ها ممکن است توضیحاتی را که به Vue معنا دارد، از خروجی حذف کنند. ممکن است خطاهای ناسازگاری را در اجرا ببینید اگر حذف شوند.
 :::
 
-### صفحات GitHub
+### صفحات GitHub {#github-pages}
 
 1. یک فایل به نام `deploy.yml` در دایرکتوری `.github/workflows` پروژه خود ایجاد کنید با محتوایی مانند زیر:
 
@@ -196,7 +196,7 @@ Cache-Control: max-age=31536000,immutable
 
 3. تغییرات خود را به شاخه `main` ارسال کنید و منتظر GitHub Actions workflow بمانید. شما باید وب‌سایت خود را در `https://<username>.github.io/[repository]/` یا `https://<custom-domain>/` بسته به تنظیمات خود دیده شده است. وب‌سایت شما به‌طور خودکار در هر بار فشرده‌سازی به شاخه `main` ارسال می‌شود.
 
-### صفحات GitLab
+### صفحات GitLab{#gitlab-pages}
 
 1. `outDir` را در پیکربندی ویت‌پرس به `../public` تنظیم کنید. گزینه `base` را به `'/<repository>/'` تنظیم کنید اگر می‌خواهید در `https://<username>.gitlab.io/<repository>/` انتشار دهید.
 
@@ -219,7 +219,7 @@ Cache-Control: max-age=31536000,immutable
        - main
    ```
 
-### Azure Static Web Apps
+### Azure Static Web Apps {#azure-static-web-apps}
 
 1. دستورالعمل [رسمی](https://docs.microsoft.com/en-us/azure/static-web-apps/build-configuration) را دنبال کنید.
 
@@ -229,7 +229,7 @@ Cache-Control: max-age=31536000,immutable
    - **`output_location`**: `docs/.vitepress/dist`
    - **`app_build_command`**: `npm run docs:build`
 
-### Firebase
+### Firebase {#firebase}
 
 1. فایل‌های `firebase.json` و `.firebaserc` را در ریشه پروژه خود ایجاد کنید:
 
@@ -260,15 +260,15 @@ Cache-Control: max-age=31536000,immutable
    firebase deploy
    ```
 
-### Surge
+### Surge {#surge}
 
 1. بعد از اجرای `npm run docs:build`، دستور زیر را برای انتشار اجرا کنید:
 
    ```sh
    npx surge docs/.vitepress/dist
    ```
 
-### Heroku
+### Heroku {#heroku}
 
 1. دستورالعمل و راهنماها را در [`heroku-buildpack-static`](https://elements.heroku.com/buildpacks/heroku/heroku-buildpack-static) دنبال کنید.
 
@@ -280,11 +280,11 @@ Cache-Control: max-age=31536000,immutable
    }
    ```
 
-### Edgio
+### Edgio {#edgio}
 
 به [ایجاد و انتشار یک برنامه ویت‌پرس در Edgio](https://docs.edg.io/guides/vitepress) مراجعه کنید.
 
-### Kinsta Static Site Hosting
+### Kinsta Static Site Hosting {#kinsta-static-site-hosting}
 
 شما می‌توانید وب‌سایت ویت‌پرس خود را بر روی [Kinsta](https://kinsta.com/static-site-hosting/) با دنبال کردن این [دستورالعمل‌ها](https://kinsta.com/docs/vitepress-static-site-example/) انتشار دهید.
 

diff --git a/docs/fa/guide/extending-default-theme.md b/docs/fa/guide/extending-default-theme.md
@@ -2,7 +2,7 @@
 outline: deep
 ---
 
-# گسترش تم پیش‌فرض
+# گسترش تم پیش‌فرض {#extending-the-default-theme}
 
 تم پیش‌فرض ویت‌پرس برای مستندات بهینه‌سازی شده است و قابلیت سفارشی‌سازی دارد. برای دریافت لیست جامع گزینه‌ها، به [نمای کلی از تنظیمات تم پیش‌فرض](../reference/default-theme-config) مراجعه کنید.
 
@@ -18,7 +18,7 @@ outline: deep
 قبل از ادامه، ابتدا [استفاده از یک تم سفارشی](./custom-theme) را بخوانید تا نحوه کار تم‌های سفارشی را درک کنید.
 :::
 
-## سفارشی‌سازی CSS
+## سفارشی‌سازی CSS {#customizing-css}
 
 CSS تم پیش‌فرض با نادیده گرفتن متغیرهای CSS سطح ریشه قابل سفارشی‌سازی است:
 
@@ -40,7 +40,7 @@ export default DefaultTheme
 
 لیست متغیرهای CSS [تم پیش‌فرض](https://github.com/vuejs/vitepress/blob/main/src/client/theme-default/styles/vars.css) که می‌توانند سفارشی‌سازی شوند را ببینید.
 
-## استفاده از فونت‌های مختلف
+## استفاده از فونت‌های مختلف{#using-different-fonts}
 
 ویت‌پرس از [Inter](https://rsms.me/inter/) به عنوان فونت پیش‌فرض استفاده می‌کند و فونت‌ها را در خروجی ساخته‌شده شامل می‌شود. این فونت همچنین در محصولات خودکار پیش‌بارگذاری می‌شود. با این حال، این ممکن است مطلوب نباشد اگر می‌خواهید از یک فونت اصلی مختلف استفاده کنید.
 
@@ -92,7 +92,7 @@ export default {
 }
 ```
 
-## ثبت مولفه‌های عمومی
+## ثبت مولفه‌های عمومی{#registering-global-components}
 
 ```js
 // .vitepress/theme/index.js
@@ -125,7 +125,7 @@ export default {
 
 از آنجا که از Vite استفاده می‌کنیم، می‌توانید از ویژگی [import glob](https://vitejs.dev/guide/features.html#glob-import) در Vite برای خودکار ثبت یک پوشه از مولفه‌ها استفاده کنید.
 
-## slot ‌های طرح
+## slot ‌های طرح {#layout-slots}
 
 کامپوننت `<Layout/>` تم پیش‌فرض چندین slot دارد که می‌توانید محتوا را در موقعیت‌های مختلف صفحه در آن‌ها درج کنید. در زیر مثالی از درج یک کامپوننت در قبل از طرح داده شده است:
 
@@ -220,9 +220,9 @@ export default {
   - `nav-screen-content-after`
 
 
-## استفاده از API انتقال نمایش
+## استفاده از API انتقال نمایش {#using-view-transitions-api}
 
-### در تغییر ظاهر
+### در تغییر ظاهر {#on-appearance-toggle}
 
 شما می‌توانید تم پیش‌فرض را گسترش دهید تا هنگام تغییر حالت رنگ، یک انتقال سفارشی را فراهم کند. به عنوان مثال:
 
@@ -312,11 +312,11 @@ provide('toggle-appearance', async ({ clientX: x, clientY: y }: MouseEvent) => {
 
 برای جزئیات بیشتر در مورد انتقال‌های نمایش به [اسناد کروم](https://developer.chrome.com/docs/web-platform/view-transitions/) مراجعه کنید.
 
-### در تغییر مسیر
+### در تغییر مسیر {#on-route-change}
 
 به زودی.
 
-## جایگزینی کامپوننت‌های داخلی
+## جایگزینی کامپوننت‌های داخلی {#overriding-internal-components}
 
 شما می‌توانید با استفاده از [alias های Vite](https://vitejs.dev/config/shared-options.html#resolve-alias)، کامپوننت‌های تم پیش‌فرض را با کامپوننت‌های سفارشی خود جایگزین کنید: