format

docs/fa/guide/asset-handling.md

@@ -1,6 +1,6 @@
-# مدیریت منابع{#asset-handling}
+# مدیریت منابع {#asset-handling}
 
-## ارجاع به منابع ایستا{#referencing-static-assets}
+## ارجاع به منابع ایستا {#referencing-static-assets}
 
 تمام فایل‌های Markdown به کامپوننت‌های Vue تبدیل و توسط [Vite](https://vitejs.dev/guide/assets.html) پردازش می‌شوند. شما می‌توانید، **و باید**، هر نوع دارایی را با استفاده از URL‌های نسبی مرجع قرار دهید:
 
@@ -20,7 +20,7 @@ PDFها یا سند‌های دیگر که از طریق پیوندها در ف
 
 تمام ارجاع‌های مسیر **ایستا**، شامل مسیرهای مطلق، باید بر اساس ساختار دایرکتوری کاری شما تعیین شوند.
 
-## دایرکتوری عمومی{#the-public-directory}
+## دایرکتوری عمومی {#the-public-directory}
 
 گاهی اوقات ممکن است نیاز داشته باشید منابع ایستا را فراهم کنید که به صورت مستقیم در هیچ‌یک از Markdown یا کامپوننت‌های قالب شما ارجاع نشده‌اند، یا ممکن است بخواهید برخی فایل‌ها را با نام اصلی خود سرویس دهید. به عنوان مثال، فایل‌هایی مانند `robots.txt`، آیکون‌های fav، و آیکون‌های PWA.
 

docs/fa/guide/cms.md

@@ -2,9 +2,9 @@
 outline: deep
 ---
 
-# اتصال به یک سیستم مدیریت محتوا (CMS){#connecting-to-a-cms}
+# اتصال به یک سیستم مدیریت محتوا (CMS) {#connecting-to-a-cms}
 
-## گام‌های کلی{#general-workflow}
+## گام‌های کلی {#general-workflow}
 
 اتصال ویت‌پرس به یک سیستم مدیریت محتوا به طور عمده بر اساس [مسیریابی پویا](./routing#dynamic-routes) خواهد بود. حتماً قبل از شروع، با روش کار آن آشنا شوید.
 
@@ -51,6 +51,6 @@ outline: deep
     <!-- @content -->
     ```
 
-## راهنماهای ادغام{#integration-guides}
+## راهنماهای ادغام {#integration-guides}
 
 اگر راهنمایی درباره ادغام ویت‌پرس با یک سیستم مدیریت محتوا خاص نوشته‌اید، لطفاً از لینک "ویرایش این صفحه" زیر استفاده کنید تا آن را ارسال کنید!

docs/fa/guide/custom-theme.md

@@ -2,7 +2,7 @@
 outline: deep
 ---
 
-# استفاده از یک تم سفارشی{#using-a-custom-theme}
+# استفاده از یک تم سفارشی {#using-a-custom-theme}
 
 ## Resolve کردن تم {#theme-resolving}
 
@@ -21,7 +21,7 @@ outline: deep
 
 وقتی ویت‌پرس حضور یک فایل ورودی تم را شناسایی کند، همواره از تم سفارشی به جای تم پیش‌فرض استفاده می‌کند. با این حال، شما می‌توانید [تم پیش‌فرض را گسترش دهید](./extending-default-theme) تا سفارشی‌سازی‌های پیشرفته‌تری را روی آن اعمال کنید.
 
-## رابط تم{#theme-interface}
+## رابط تم {#theme-interface}
 
 یک تم سفارشی ویت‌پرس به عنوان یک شی تعریف می‌شود که شامل رابط زیر است:
 
@@ -172,7 +172,7 @@ const { page, frontmatter } = useData()
 
 5. دستورالعمل‌های روشنی برای مصرف تم خود ارائه دهید (مانند زیر).
 
-## مصرف یک تم سفارشی{#consuming-a-custom-theme}
+## مصرف یک تم سفارشی {#consuming-a-custom-theme}
 
 برای مصرف یک تم خارجی، آن را از ورودی تم سفارشی وارد و دوباره export کنید:
 

docs/fa/guide/data-loading.md

@@ -1,10 +1,10 @@
-# بارگذاری داده در زمان ساخت{#build-time-data-loading}
+# بارگذاری داده در زمان ساخت {#build-time-data-loading}
 
 ویت‌پرس یک ویژگی به نام **بارگذارهای داده** ارائه می‌دهد که به شما این امکان را می‌دهد که داده‌های دلخواه را بارگیری کنید و آن‌ها را از صفحات یا اجزا وارد کنید. بارگذاری داده فقط **در زمان ساخت** اجرا می‌شود: داده‌های حاصل به صورت JSON در بسته JavaScript نهایی سریالیزه می‌شوند.
 
 بارگذارهای داده می‌توانند برای بارگیری داده‌های از راه دور یا تولید فراداده‌ها بر اساس فایل‌های محلی استفاده شوند. به عنوان مثال، می‌توانید از بارگذارهای داده استفاده کنید تا تمام صفحات API محلی خود را تجزیه کنید و به طور خودکار یک فهرست از تمام ورودی‌های API تولید کنید.
 
-## استفاده ابتدایی{#basic-usage}
+## استفاده ابتدایی {#basic-usage}
 
 یک فایل بارگذار داده باید با `.data.js` یا `.data.ts` پایان یابد. فایل باید یک صادرات پیش‌فرض از یک شی با متد `load()` داشته باشد:
 
@@ -52,7 +52,7 @@ export default {
 }
 ```
 
-## داده از فایل‌های محلی{#data-from-local-files}
+## داده از فایل‌های محلی {#data-from-local-files}
 
 وقتی نیاز به تولید داده بر اساس فایل‌های محلی دارید، باید از گزینه `watch` در بارگذار داده استفاده کنید تا تغییرات اعمال شده به این فایل‌ها بتواند به روزرسانی‌های سریع منجر شود.
 
@@ -133,7 +133,7 @@ import { data as posts } from './posts.data.js'
 </template>
 ```
 
-### گزینه‌ها{#options}
+### گزینه‌ها {#options}
 
 احتمالاً داده پیش‌فرض به تمام نیازها پاسخ نمی‌دهد - شما می‌توانید با استفاده از گزینه‌ها به تبدیل داده‌ها مشترک شوید:
 

docs/fa/guide/deploy.md

@@ -2,7 +2,7 @@
 outline: deep
 ---
 
-# استقرار وب‌سایت ویت‌پرس شما{#deploy-your-vitepress-site}
+# استقرار وب‌سایت ویت‌پرس شما {#deploy-your-vitepress-site}
 
 راهنماهای زیر بر اساس برخی فرضیات مشترک است:
 
@@ -47,7 +47,7 @@ outline: deep
 
    حالا اسکریپت `docs:preview` سرور را در `http://localhost:8080` راه‌اندازی خواهد کرد.
 
-## تنظیم مسیر پایه عمومی{#setting-a-public-base-path}
+## تنظیم مسیر پایه عمومی {#setting-a-public-base-path}
 
 به‌طور پیش‌فرض، ما فرض می‌کنیم که وب‌سایت در مسیر ریشه دامنه (`/`) انتشار می‌یابد. اگر وب‌سایت شما باید در یک زیرمسیر ارائه شود، مانند `https://mywebsite.com/blog/`، در این صورت باید گزینه [`base`](../reference/site-config#base) را به `'/blog/'` در پیکربندی ویت‌پرس تنظیم کنید.
 
@@ -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-pages}
+### صفحات GitLab {#gitlab-pages}
 
 1. `outDir` را در پیکربندی ویت‌پرس به `../public` تنظیم کنید. گزینه `base` را به `'/<repository>/'` تنظیم کنید اگر می‌خواهید در `https://<username>.gitlab.io/<repository>/` انتشار دهید.
 

docs/fa/guide/extending-default-theme.md

@@ -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}
+## استفاده از فونت‌های مختلف {#using-different-fonts}
 
 ویت‌پرس از [Inter](https://rsms.me/inter/) به عنوان فونت پیش‌فرض استفاده می‌کند و فونت‌ها را در خروجی ساخته‌شده شامل می‌شود. این فونت همچنین در محصولات خودکار پیش‌بارگذاری می‌شود. با این حال، این ممکن است مطلوب نباشد اگر می‌خواهید از یک فونت اصلی مختلف استفاده کنید.
 
@@ -92,7 +92,7 @@ export default {
 }
 ```
 
-## ثبت مولفه‌های عمومی{#registering-global-components}
+## ثبت مولفه‌های عمومی {#registering-global-components}
 
 ```js
 // .vitepress/theme/index.js

docs/fa/guide/getting-started.md

@@ -1,12 +1,12 @@
-# شروع کار{#getting-started}
+# شروع کار {#getting-started}
 
 ## تست آنلاین {#try-it-online}
 
 می‌توانید ویت‌پرس را مستقیماً در مرورگر خود در [StackBlitz](https://vitepress.new) امتحان کنید.
 
-## نصب{#installation}
+## نصب {#installation}
 
-### پیش‌نیازها{#prerequisites}
+### پیش‌نیازها {#prerequisites}
 
 - [Node.js](https://nodejs.org/) نسخه 18 یا بالاتر.
 - ترمینال برای دسترسی به ویت‌پرس از طریق رابط خط فرمان (CLI).
@@ -96,7 +96,7 @@ $ bun vitepress init
 
 :::
 
-## ساختار فایل‌ها{#file-structure}
+## ساختار فایل‌ها {#file-structure}
 
 اگر در حال ساخت یک سایت مستقل ویت‌پرس هستید، می‌توانید سایت را در دایرکتوری فعلی خود (`./`) بسازید. اما، اگر ویت‌پرس را در یک پروژه موجود به همراه سایر کدهای منبع نصب می‌کنید، توصیه می‌شود سایت را در یک دایرکتوری تودرتو (مثلاً `./docs`) بسازید تا از بقیه پروژه جدا باشد.
 
@@ -121,7 +121,7 @@ $ bun vitepress init
 
 :::
 
-### فایل پیکربندی{#the-config-file}
+### فایل پیکربندی {#the-config-file}
 
 فایل پیکربندی (`.vitepress/config.js`) به شما اجازه می‌دهد جنبه‌های مختلف سایت ویت‌پرس خود را سفارشی کنید، با گزینه‌های پایه‌ای مانند عنوان و توضیحات سایت:
 
@@ -140,7 +140,7 @@ export default {
 
 همچنین می‌توانید رفتار تم را از طریق گزینه `themeConfig` پیکربندی کنید. برای جزئیات کامل درباره همه گزینه‌های پیکربندی، به [راهنمای پیکربندی](../reference/site-config) مراجعه کنید.
 
-### فایل‌های منبع{#source-files}
+### فایل‌های منبع {#source-files}
 
 فایل‌های Markdown خارج از دایرکتوری `.vitepress` به عنوان **فایل‌های منبع** در نظر گرفته می‌شوند.
 
@@ -212,7 +212,7 @@ $ bun vitepress dev docs
 
 سرور توسعه باید در `http://localhost:5173` اجرا شود. URL را در مرورگر خود بازدید کنید تا سایت جدید خود را در عمل ببینید!
 
-## مراحل بعدی{#what-s-next}
+## مراحل بعدی {#what-s-next}
 
 - برای درک بهتر چگونگی نگاشت فایل‌های markdown به HTML تولید شده، به [راهنمای مسیر یابی](./routing) مراجعه کنید.
 

docs/fa/guide/i18n.md

@@ -1,4 +1,4 @@
-# بین‌المللی‌سازی{#internationalization}
+# بین‌المللی‌سازی {#internationalization}
 
 برای استفاده از ویژگی‌های داخلی بین‌المللی‌سازی، نیاز است که یک ساختار دایرکتوری به شکل زیر ایجاد کنید:
 
@@ -53,7 +53,7 @@ interface LocaleSpecificConfig<ThemeConfig = any> {
 
 **نکته حرفه‌ای:** فایل پیکربندی را می‌توانید در `docs/.vitepress/config/index.ts` نیز ذخیره کنید. این کار به شما کمک می‌کند که با ایجاد یک فایل پیکربندی برای هر زبان و سپس ادغام و صدور آنها از `index.ts`، موارد را سازماندهی کنید.
 
-## دایرکتوری جداگانه برای هر زبان{#separate-directory-for-each-locale}
+## دایرکتوری جداگانه برای هر زبان {#separate-directory-for-each-locale}
 
 ساختار زیر به طور کاملاً صحیح است:
 
@@ -108,6 +108,6 @@ watchEffect(() => {
 </template>
 ```
 
-## پشتیبانی از RTL (آزمایشی){#rtl-support-experimental}
+## پشتیبانی از RTL (آزمایشی) {#rtl-support-experimental}
 
 برای پشتیبانی از RTL، `dir: 'rtl'` را در پیکربندی مشخص کنید و از پلاگین‌های PostCSS RTLCSS مانند <https://github.com/MohammadYounes/rtlcss>، <https://github.com/vkalinichev/postcss-rtl> یا <https://github.com/elchininet/postcss-rtlcss> استفاده کنید. باید پلاگین PostCSS خود را به کارگیری `:where([dir="ltr"])` و `:where([dir="rtl"])` به عنوان پیشوندها جلوگیری از مشکلات اولویت CSS استفاده کنید.

docs/fa/guide/markdown.md

@@ -1,4 +1,4 @@
-# افزونه‌های Markdown{#markdown-extensions}
+# افزونه‌های Markdown {#markdown-extensions}
 
 ویت‌پرس با افزونه‌های markdown داخلی ارائه شده است.
 
@@ -16,7 +16,7 @@
 
 این به شما امکان می‌دهد که به جای استفاده از به جای استفاده از `#using-custom-anchors`، به هدینگ به عنوان `#my-anchor` لینک دهید.
 
-## لینک‌ها{#links}
+## لینک‌ها {#links}
 
 هم لینک‌های داخلی و هم خارجی با دستورالعمل‌های خاصی ارائه می‌شوند.
 
@@ -54,7 +54,7 @@
 
 صفحات و لینک‌های داخلی به طور پیش‌فرض با پسوند `.html` تولید می‌شوند.
 
-### لینک‌های خارجی{#external-links}
+### لینک‌های خارجی {#external-links}
 
 لینک‌های خروجی به طور خودکار دارای `target="_blank" rel="noreferrer"` هستند:
 
@@ -124,7 +124,7 @@ lang: fa-IR
 
 نحوه پردازش فهرست مطالب با استفاده از گزینه `markdown.toc` قابل پیکربندی است.
 
-## کانتینرهای سفارشی{#custom-containers}
+## کانتینرهای سفارشی {#custom-containers}
 
 کانتینرهای سفارشی می‌توانند توسط انواع، عناوین و محتویات خود تعریف شوند.
 
@@ -397,7 +397,7 @@ const message = 'Hello, World!';
 console.log(message);
 ```
 
-## فکوس در بلاک‌های کد{#focus-in-code-blocks}
+## فکوس در بلاک‌های کد {#focus-in-code-blocks}
 
 افزودن کامنت `// [!code focus]` به یک خط، روی آن فکوس می‌کند و بخش‌های دیگر کد را مات می‌کند.
 
@@ -461,7 +461,7 @@ export default {
 }
 ```
 
-## خطاها و هشدارها در بلاک‌های کد{#errors-and-warnings-in-code-blocks}
+## خطاها و هشدارها در بلاک‌های کد {#errors-and-warnings-in-code-blocks}
 
 افزودن کامنت `// [!code warning]` یا `// [!code error]` به یک خط، آن را مطابق با نوع، رنگ می‌کند.
 
@@ -551,7 +551,7 @@ const line3 = 'این خط ۳ است'
 const line4 = 'این خط ۴ است'
 ```
 
-## وارد کردن Snippet کد{#import-code-snippets}
+## وارد کردن Snippet کد {#import-code-snippets}
 
 می‌توانید snippet های کد را از فایل‌های موجود با استفاده از دستور زیر وارد کنید:
 
@@ -875,7 +875,7 @@ $$ x = {-b \pm \sqrt{b^2-4ac} \over 2a} $$
 | $\nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t}  = \vec{\mathbf{0}}$                                                          | curl $\vec{\mathbf{E}}$ نسبت به نرخ تغییر $\vec{\mathbf{B}}$ نسبی است              |
 | $\nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} = \frac{4\pi}{c}\vec{\mathbf{j}}    \nabla \cdot \vec{\mathbf{E}} = 4 \pi \rho$ | _چیست؟_                                                                               |
 
-## بارگذاری lazy تصویر{#image-lazy-loading}
+## بارگذاری lazy تصویر {#image-lazy-loading}
 
 می‌توانید بارگذاری تنبلی را برای هر تصویر اضافه شده از طریق Markdown با تنظیم `lazyLoading` به `true` در فایل پیکربندی فعال کنید: