طرح سفارشی!
+ + +طرح سفارشی!
+ +طرح سفارشی!
+ +طرح سفارشی!
+ +{{ data }}
+```
+
+خروجی:
+
+```json
+{
+ "hello": "world"
+}
+```
+
+شما متوجه خواهید شد که بارگذار داده خودش داده را صادر نمی‌کند. ویت‌پرس پشت صحنه متد `load()` را فراخوانی می‌کند و به طور ضمنی نتیجه را از طریق صادرات نام‌گذاری شده `data` ارائه می‌دهد.
+
+این کار حتی اگر بارگذار async باشد انجام می‌شود:
+
+```js
+export default {
+ async load() {
+ // دریافت داده از راه دور
+ return (await fetch('...')).json()
+ }
+}
+```
+
+## داده از فایل‌های محلی {#data-from-local-files}
+
+وقتی نیاز به تولید داده بر اساس فایل‌های محلی دارید، باید از گزینه `watch` در بارگذار داده استفاده کنید تا تغییرات اعمال شده به این فایل‌ها بتواند به روزرسانی‌های سریع منجر شود.
+
+گزینه `watch` همچنین در آنجا مفید است که می‌توانید از [الگوهای glob](https://github.com/mrmlnc/fast-glob#pattern-syntax) برای تطابق با چندین فایل استفاده کنید. الگوها می‌توانند نسبت به فایل بارگذار خود نسبی باشند و تابع `load()` فایل‌های تطابق یافته را به عنوان مسیرهای مطلق دریافت می‌کند.
+
+مثال زیر نشان می‌دهد که چگونه فایل‌های CSV را بارگذاری کرده و آنها را با استفاده از [csv-parse](https://github.com/adaltas/node-csv/tree/master/packages/csv-parse/) به JSON تبدیل می‌کند. این فایل تنها در زمان ساخت اجرا می‌شود، بنابراین شما نیازی به ارسال پارسر CSV به مشتری ندارید!
+
+```js
+import fs from 'node:fs'
+import { parse } from 'csv-parse/sync'
+
+export default {
+ watch: ['./data/*.csv'],
+ load(watchedFiles) {
+ // watchedFiles یک آرایه از مسیرهای مطلق فایل‌های تطابق یافته خواهد بود.
+ // تولید یک آرایه از فراداده‌های پست وبلاگ که می‌تواند برای نمایش
+ // یک لیست در طرح استفاده شود
+ return watchedFiles.map((file) => {
+ return parse(fs.readFileSync(file, 'utf-8'), {
+ columns: true,
+ skip_empty_lines: true
+ })
+ })
+ }
+}
+```
+
+## `createContentLoader` {#createcontentloader}
+
+وقتی که در حال ساختن یک سایت متمرکز بر محتوا هستیم، اغلب نیاز به ایجاد یک "بایگانی" یا "فهرست" صفحه داریم: یک صفحه که ما همه ورودی‌های موجود در مجموعه محتوای خود را لیست می‌کنیم، به عنوان مثال پست‌های وبلاگ یا صفحات API. ما می‌توانیم این کار را مستقیماً با API بارگذار داده انجام دهیم، اما از آنجا که این یک حالت استفاده رایج است، ویت‌پرس همچنین یک کمک‌کننده به نام `createContentLoader` را فراهم می‌کند تا این فرآیند را ساده‌تر کند:
+
+```js [posts.data.js]
+import { createContentLoader } from 'vitepress'
+
+export default createContentLoader('posts/*.md', /* گزینه‌ها */)
+```
+
+کمک‌کننده یک الگوی glob را نسبت به [دایرکتوری منبع](./routing#source-directory) مشخص می‌کند و یک شی `{ watch، load }` را که می‌تواند به عنوان صادرات پیش‌فرض در یک فایل بارگذار داده استفاده شود، برمی‌گرداند. همچنین پیاده‌سازی حافظه پنهانی بر اساس برچسب‌های تغییر مدیریت
+
+می‌کند تا عملکرد توسعه را بهبود بخشد.
+
+لطفاً توجه داشته باشید که بارگذار فقط با فایل‌های Markdown کار می‌کند - فایل‌های غیر-Markdown تطابق یافته حذف می‌شوند.
+
+داده بارگذاری شده یک آرایه با نوع `ContentData[]` خواهد بود:
+
+```ts
+interface ContentData {
+ // آدرس URL برای صفحه. به عنوان مثال /posts/hello.html (شامل پایه نمی‌شود)
+ // تکرار دستی یا استفاده از `transform` سفارشی برای نرمال کردن مسیرها
+ url: string
+ // اطلاعات frontmatter صفحه
+ frontmatter: Recordهمه پست‌های وبلاگ
+-
+
- + {{ post.frontmatter.title }} + توسط {{ post.frontmatter.author }} + +
نمایش
+ + + +-
+
- + {{ todo.text }} + +
-
+
- + {{ todo.text }} + +
` تا `` است.
+ *
+ * @default 2
+ */
+ level?: number | [number، number] | 'deep'
+
+ /**
+ * عنوانی که باید در آوند نمایش داده شود.
+ *
+ * @default 'On this page'
+ */
+ label?: string
+}
+```
+
+## socialLinks
+
+- نوع: `SocialLink[]`
+
+می‌توانید این گزینه را تعریف کنید تا لینک‌های حساب اجتماعی خود را با آیکون‌ها در ناوبری نمایش دهید.
+
+```ts
+export default {
+ themeConfig: {
+ socialLinks: [
+ { icon: 'github', link: 'https://github.com/vuejs/vitepress' },
+ { icon: 'twitter', link: '...' },
+ // شما همچنین می‌توانید آیکون‌های سفارشی را با ارسال SVG به عنوان رشته اضافه کنید:
+ {
+ icon: {
+ svg: ''
+ },
+ link: '...',
+ // شما همچنین می‌توانید برچسب سفارشی را برای دسترسی (اختیاری اما توصیه می‌شود) شامل کنید:
+ ariaLabel: 'لینک جذاب'
+ }
+ ]
+ }
+}
+```
+
+```ts
+interface SocialLink {
+ icon: SocialLinkIcon
+ link: string
+ ariaLabel?: string
+}
+
+type SocialLinkIcon =
+ | 'discord'
+ | 'facebook'
+ | 'github'
+ | 'instagram'
+ | 'linkedin'
+ | 'mastodon'
+ | 'npm'
+ | 'slack'
+ | 'twitter'
+ | 'x'
+ | 'youtube'
+ | { svg: string }
+```
+
+## footer
+
+- نوع: `Footer`
+- می‌تواند به صورت خودکار برای هر صفحه از طریق [frontmatter](./frontmatter-config#footer) بازنویسی شود.
+
+پیکربندی پا. شما می‌توانید پیام یا متن حق کپی را در پا اضافه کنید، با این حال، فقط زمانی نمایش داده می‌شود که صفحه شامل نوار کناری نباشد. این به دلایل طراحی است.
+
+```ts
+export default {
+ themeConfig: {
+ footer: {
+ message: 'منتشر شده تحت مجوز MIT.',
+ copyright: 'حق نشر © 2019-present Evan You'
+ }
+ }
+}
+```
+
+```ts
+export interface Footer {
+ message?: string
+ copyright?: string
+}
+```
+
+## editLink
+
+- نوع: `EditLink`
+- می‌تواند به صورت خودکار برای هر صفحه از طریق [frontmatter](./frontmatter-config#editlink) بازنویسی شود.
+
+پیوند ویرایش به شما امکان می‌دهد که یک لینک به ویرایش صفحه را در خدمات مدیریت گیت مانند GitHub یا GitLab نمایش دهید. برای جزئیات بیشتر به [تم پیش‌فرض: لینک ویرایش](./default-theme-edit-link) مراجعه کنید.
+
+```ts
+export default {
+ themeConfig: {
+ editLink: {
+ pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path',
+ text: 'ویرایش این صفحه در GitHub'
+ }
+ }
+}
+```
+
+```ts
+export interface EditLink {
+ pattern: string
+ text?: string
+}
+```
+
+## lastUpdated
+
+- نوع: `LastUpdatedOptions`
+
+امکانات سفارشی‌سازی برای متن به‌روز شده و فرمت تاریخ.
+
+```ts
+export default {
+ themeConfig: {
+ lastUpdated: {
+ text: 'به‌روزرسانی شده در',
+ formatOptions: {
+ dateStyle: 'full',
+ timeStyle: 'medium'
+ }
+ }
+ }
+}
+```
+
+```ts
+export interface LastUpdatedOptions {
+ /**
+ * @default 'آخرین به‌روزرسانی'
+ */
+ text?: string
+
+ /**
+ * @default
+ * { dateStyle: 'short', timeStyle: 'short' }
+ */
+ formatOptions?: Intl.DateTimeFormatOptions & { forceLocale?: boolean }
+}
+```
+
+## algolia
+
+- نوع: `AlgoliaSearch`
+
+یک گزینه برای پشتیبانی از جستجو در سایت مستندات خود با استفاده از [Algolia DocSearch](https://docsearch.algolia.com/docs/what-is-docsearch). بیشتر در [تم پیش‌فرض: جستجو](./default-theme-search) بیاموزید.
+
+```ts
+export interface AlgoliaSearchOptions extends DocSearchProps {
+ locales?: Record>
+}
+```
+
+گزینه‌های کامل را [اینجا](https://github.com/vuejs/vitepress/blob/main/types/docsearch.d.ts) مشاهده کنید.
+
+## carbonAds {#carbon-ads}
+
+- نوع: `CarbonAdsOptions`
+
+یک گزینه برای نمایش [Carbon Ads](https://www.carbonads.net/).
+
+```ts
+export default {
+ themeConfig: {
+ carbonAds: {
+ code: 'your-carbon-code',
+ placement: 'your-carbon-placement'
+ }
+ }
+}
+```
+
+```ts
+export interface CarbonAdsOptions {
+ code: string
+ placement: string
+}
+```
+
+بیشتر در [تم پیش‌فرض: Carbon Ads](./default-theme-carbon-ads) بیاموزید.
+
+## docFooter
+
+- نوع: `DocFooter`
+
+می‌تواند برای سفارشی‌سازی متنی که در بالای لینک‌های قبلی و بعدی نمایش داده می‌شود استفاده شود. مفید است اگر مستندات خود را به زبانی غیر از انگلیسی نوشته باشید. همچنین می‌تواند برای غیرفعال کردن لینک‌های قبلی/بعدی به صورت جهانی استفاده شود. اگر می‌خواهید لینک‌های قبلی/بعدی را به صورت انتخابی فعال
+
+/غیرفعال کنید، می‌توانید از [frontmatter](./default-theme-prev-next-links) استفاده کنید.
+
+```ts
+export default {
+ themeConfig: {
+ docFooter: {
+ prev: 'صفحه قبلی',
+ next: 'صفحه بعدی'
+ }
+ }
+}
+```
+
+```ts
+export interface DocFooter {
+ prev?: string | false
+ next?: string | false
+}
+```
+
+## darkModeSwitchLabel
+
+- نوع: `string`
+- پیش‌فرض: `ظاهر`
+
+می‌تواند برای سفارشی‌سازی برچسب سوئیچ حالت تاریک استفاده شود. این برچسب تنها در نمای تلفن همراه نمایش داده می‌شود.
+
+## lightModeSwitchTitle
+
+- نوع: `string`
+- پیش‌فرض: `تغییر به تم روشن`
+
+می‌تواند برای سفارشی‌سازی عنوان سوئیچ حالت روشن که در بالا حاشیه دار می‌شود، استفاده شود.
+
+## darkModeSwitchTitle
+
+- نوع: `string`
+- پیش‌فرض: `تغییر به تم تاریک`
+
+می‌تواند برای سفارشی‌سازی عنوان سوئیچ حالت تاریک که در بالا حاشیه دار می‌شود، استفاده شود.
+
+## sidebarMenuLabel
+
+- نوع: `string`
+- پیش‌فرض: `منو`
+
+می‌تواند برای سفارشی‌سازی برچسب منوی نوار کناری استفاده شود. این برچسب تنها در نمای تلفن همراه نمایش داده می‌شود.
+
+## returnToTopLabel
+
+- نوع: `string`
+- پیش‌فرض: `بازگشت به بالا`
+
+می‌تواند برای سفارشی‌سازی برچسب دکمه بازگشت به بالا استفاده شود. این برچسب تنها در نمای تلفن همراه نمایش داده می‌شود.
+
+## langMenuLabel
+
+- نوع: `string`
+- پیش‌فرض: `تغییر زبان`
+
+می‌تواند برای سفارشی‌سازی برچسب aria- توگل زبان در ناوبری استفاده شود. این فقط در صورت استفاده از [i18n](../guide/i18n) استفاده می‌شود.
+
+## externalLinkIcon
+
+- نوع: `boolean`
+- پیش‌فرض: `false`
+
+آیا باید نمایش آیکون لینک خارجی کنار لینک‌های خارجی در مارک‌داون باشد.
\ No newline at end of file
diff --git a/docs/fa/reference/default-theme-edit-link.md b/docs/fa/reference/default-theme-edit-link.md
new file mode 100644
index 00000000..7acab905
--- /dev/null
+++ b/docs/fa/reference/default-theme-edit-link.md
@@ -0,0 +1,60 @@
+# پیوند ویرایش {#edit-link}
+
+## پیکربندی سطح سایت {#site-level-config}
+
+پیوند ویرایش به شما این امکان را می‌دهد که یک پیوند به صفحه ویرایش را در خدمات مدیریت گیت مانند GitHub یا GitLab نمایش دهید. برای فعال‌سازی آن، گزینه `themeConfig.editLink` را به پیکربندی خود اضافه کنید.
+
+```js
+export default {
+ themeConfig: {
+ editLink: {
+ pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path'
+ }
+ }
+}
+```
+
+گزینه `pattern` ساختار URL را برای پیوند تعیین می‌کند و `:path` با مسیر صفحه جایگزین خواهد شد.
+
+همچنین می‌توانید یک تابع خالص ارائه دهید که `PageData` را به عنوان آرگومان دریافت کرده و رشته URL را برمی‌گرداند.
+
+```js
+export default {
+ themeConfig: {
+ editLink: {
+ pattern: ({ filePath }) => {
+ if (filePath.startsWith('packages/')) {
+ return `https://github.com/acme/monorepo/edit/main/${filePath}`
+ } else {
+ return `https://github.com/acme/monorepo/edit/main/docs/${filePath}`
+ }
+ }
+ }
+ }
+}
+```
+
+این تابع نباید اثر جانبی داشته باشد و هیچ چیز خارج از دامنه خود را دسترسی ندهد، زیرا که در مرورگر سریالیزه و اجرا خواهد شد.
+
+به طور پیش‌فرض، این عبارت "ویرایش این صفحه" را در پایین صفحه مستندات اضافه می‌کند. می‌توانید این متن را با تعریف گزینه `text` سفارشی‌سازی کنید.
+
+```js
+export default {
+ themeConfig: {
+ editLink: {
+ pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path',
+ text: 'ویرایش این صفحه در GitHub'
+ }
+ }
+}
+```
+
+## پیکربندی Frontmatter {#frontmatter-config}
+
+می‌توانید این امکان را برای هر صفحه با استفاده از گزینه `editLink` در frontmatter غیرفعال کنید:
+
+```yaml
+---
+editLink: false
+---
+```
diff --git a/docs/fa/reference/default-theme-footer.md b/docs/fa/reference/default-theme-footer.md
new file mode 100644
index 00000000..6c9915cf
--- /dev/null
+++ b/docs/fa/reference/default-theme-footer.md
@@ -0,0 +1,53 @@
+# پاورقی {#footer}
+
+وقتی `themeConfig.footer` حاضر باشد، ویت‌پرس پاورقی جهانی را در پایین صفحه نمایش می‌دهد.
+
+```ts
+export default {
+ themeConfig: {
+ footer: {
+ message: 'Released under the MIT License.',
+ copyright: 'Copyright © 2019-present Evan You'
+ }
+ }
+}
+```
+
+```ts
+export interface Footer {
+ // پیام نمایش داده شده درست قبل از حق نسخه.
+ message?: string
+
+ // متن حق نسخه واقعی.
+ copyright?: string
+}
+```
+
+پیکربندی بالا همچنین از رشته‌های HTML پشتیبانی می‌کند. بنابراین، به عنوان مثال، اگر می‌خواهید متن پاورقی دارای برخی از لینک‌ها باشد، می‌توانید پیکربندی را به شکل زیر تنظیم کنید:
+
+```ts
+export default {
+ themeConfig: {
+ footer: {
+ message: 'Released under the MIT License.',
+ copyright: 'Copyright © 2019-present Evan You'
+ }
+ }
+}
+```
+
+::: warning هشدار
+تنها عناصر مستقیم می‌توانند در `message` و `copyright` استفاده شوند زیرا در داخل یک عنصر `` رندر می‌شوند. اگر می‌خواهید عناصر بلوکی را اضافه کنید، در نظر داشته باشید که به جای این، از [اسلات `layout-bottom`](../guide/extending-default-theme#layout-slots) استفاده کنید.
+:::
+
+توجه داشته باشید که پاورقی نمایش داده نمی‌شود زمانی که [نوار کناری](./default-theme-sidebar) قابل مشاهده باشد.
+
+## پیکربندی Frontmatter {#frontmatter-config}
+
+این می‌تواند برای هر صفحه با استفاده از گزینه `footer` در frontmatter غیرفعال شود:
+
+```yaml
+---
+footer: false
+---
+```
\ No newline at end of file
diff --git a/docs/fa/reference/default-theme-home-page.md b/docs/fa/reference/default-theme-home-page.md
new file mode 100644
index 00000000..10f04e41
--- /dev/null
+++ b/docs/fa/reference/default-theme-home-page.md
@@ -0,0 +1,193 @@
+# صفحه اصلی {#home-page}
+
+قالب پیش‌فرض ویت‌پرس یک طرح صفحه اصلی فراهم می‌کند که می‌توانید آن را همچنین در [صفحه اصلی این سایت](../) مشاهده کنید. شما می‌توانید آن را در هر یک از صفحات خود با تعیین `layout: home` در [frontmatter](./frontmatter-config) استفاده کنید.
+
+```yaml
+---
+layout: home
+---
+```
+
+اما این گزینه به تنهایی خیلی کاربردی نخواهد بود. شما می‌توانید با اضافه کردن بخش‌های "قالب‌های پیش‌فرض" مختلف، چندین بخش متفاوت را به صفحه اصلی اضافه کنید مانند `hero` و `features`.
+
+## بخش Hero {#hero-section}
+
+بخش Hero در بالای صفحه اصلی قرار دارد. در ادامه می‌توانید نحوه پیکربندی بخش Hero را ببینید.
+
+```yaml
+---
+layout: home
+
+hero:
+ name: ویت‌پرس
+ text: Vite & Vue powered static site generator.
+ tagline: Lorem ipsum...
+ image:
+ src: /logo.png
+ alt: ویت‌پرس
+ actions:
+ - theme: brand
+ text: Get Started
+ link: /guide/what-is-vitepress
+ - theme: alt
+ text: View on GitHub
+ link: https://github.com/vuejs/vitepress
+---
+```
+
+```ts
+interface Hero {
+ // رشته نمایش داده شده در بالای `text`. همراه با رنگ برند و انتظار می‌رود که کوتاه باشد، مانند نام محصول.
+ name?: string
+
+ // متن اصلی بخش Hero. این به عنوان تگ `h1` تعریف می‌شود.
+ text: string
+
+ // تگ‌لاین نمایش داده شده زیر `text`.
+ tagline?: string
+
+ // تصویر که در کنار ناحیه متن و تگ‌لاین نمایش داده می‌شود.
+ image?: ThemeableImage
+
+ // دکمه‌های اقدام برای نمایش در بخش Hero صفحه اصلی.
+ actions?: HeroAction[]
+}
+
+type ThemeableImage =
+ | string
+ | { src: string; alt?: string }
+ | { light: string; dark: string; alt?: string }
+
+interface HeroAction {
+ // رنگ تم دکمه. به طور پیش‌فرض `brand` است.
+ theme?: 'brand' | 'alt'
+
+ // برچسب دکمه.
+ text: string
+
+ // مقصد لینک دکمه.
+ link: string
+
+ // ویژگی هدف لینک.
+ target?: string
+
+ // ویژگی rel لینک.
+ rel?: string
+}
+```
+
+### سفارشی‌سازی رنگ نام {#customizing-the-name-color}
+
+ویت‌پرس از رنگ برند (`--vp-c-brand-1`) برای `name` استفاده می‌کند. با این حال، شما می‌توانید این رنگ را با جایگذاری متغیر `--vp-home-hero-name-color` سفارشی کنید.
+
+```css
+:root {
+ --vp-home-hero-name-color: blue;
+}
+```
+
+همچنین می‌توانید با ترکیب `--vp-home-hero-name-background`، رنگ گرادیانت `name` را تعیین کنید.
+
+```css
+:root {
+ --vp-home-hero-name-color: transparent;
+ --vp-home-hero-name-background: -webkit-linear-gradient(120deg, #bd34fe, #41d1ff);
+}
+```
+
+## {#features-section} بخش ویژگی‌ها
+
+در بخش ویژگی‌ها، می‌توانید هر تعدادی ویژگی که مایلید پس از بخش Hero نمایش دهید، لیست کنید. برای پیکربندی آن، گزینه `features` را به frontmatter ارسال کنید.
+
+می‌توانید برای هر ویژگی آیکونی ارائه دهید که می‌تواند یک ایموجی یا هر نوع تصویر دیگری باشد. زمانی که آیکون پیکربندی شده یک تصویر است (svg، png، jpeg...). باید آیکون را با عرض و ارتفاع مناسب ارائه دهید. شما همچنین می‌توانید توضیحات، اندازه داخلی آن و نسخه‌های آن برای تم تاریک و روشن را ارائه دهید هنگام لزوم.
+
+```yaml
+---
+layout: home
+
+features:
+ - icon: 🛠️
+ title: ساده و کم حجم، همیشه
+ details: Lorem ipsum...
+ - icon:
+ src: /cool-feature-icon.svg
+ title: ویژگی جالب دیگر
+ details: Lorem ipsum...
+ - icon:
+ dark: /dark-feature-icon.svg
+ light: /light-feature-icon.svg
+ title: ویژگی جالب دیگر
+ details: Lorem ipsum...
+---
+```
+
+```ts
+interface Feature {
+ // نمایش آیکون در هر جعبه ویژگی.
+ icon?: FeatureIcon
+
+ // عنوان ویژگی.
+ title: string
+
+ // جزئیات ویژگی.
+ details: string
+
+ // لینک زمانی که بر روی جزئیات کلیک می‌کنید. لینک می‌تواند داخلی یا خارجی باشد.
+ //
+ // به عنوان مثال: `guide/reference/default-theme-home-page` یا `https://example.com`
+ link?: string
+
+ // متن لینکی که داخل جزئیات کامپوننت نمایش داده می‌شود. بهتر است با گزینه `link` استفاده شود.
+ //
+ // به عنوان مثال: `بیشتر بدانید`، `صفحه بازدید` و غیره.
+ linkText?: string
+
+ // ویژگی rel لینک برای گزینه `link`.
+ //
+ // به عنوان مثال: `external`
+ rel?: string
+
+ // ویژگی target لینک برای گزینه `link`.
+ target?: string
+}
+
+type FeatureIcon =
+ | string
+ | { src: string; alt?: string; width?: string; height: string }
+ | {
+ light: string
+ dark: string
+ alt?: string
+ width?: string
+ height: string
+ }
+```
+
+## محتوای Markdown {#markdown-content}
+
+می‌توانید محتوای اضافی را به صفحه اصلی سایت خود اضافه کنید فقط با افزودن Markdown زیر تقسیم‌کننده `---` در پایین frontmatter.
+
+````md
+---
+layout: home
+
+hero:
+ name
+
+: ویت‌پرس
+ text: Vite & Vue powered static site generator.
+---
+
+## شروع کردن
+
+می‌توانید بلافاصله با استفاده از `npx` از ویت‌پرس شروع کنید!
+
+```sh
+npm init
+npx vitepress init
+```
+````
+
+::: info اطلاعات
+ویت‌پرس همیشه استایل اضافی محتوای صفحه `layout: home` را خودکار نمی‌کند. برای بازگشت به رفتار قدیمی، می‌توانید `markdownStyles: false` را به frontmatter اضافه کنید.
+:::
\ No newline at end of file
diff --git a/docs/fa/reference/default-theme-last-updated.md b/docs/fa/reference/default-theme-last-updated.md
new file mode 100644
index 00000000..08b8641c
--- /dev/null
+++ b/docs/fa/reference/default-theme-last-updated.md
@@ -0,0 +1,27 @@
+# آخرین بروزرسانی {#last-updated}
+
+زمان به روزرسانی آخرین محتوا در گوشه پایین سمت راست صفحه نمایش داده خواهد شد. برای فعال‌سازی آن، گزینه `lastUpdated` را به پیکربندی خود اضافه کنید.
+
+::: tip نکته
+برای دیدن زمان به‌روزرسانی، باید فایل Markdown را commit کنید.
+:::
+
+## پیکربندی سطح سایت {#site-level-config}
+
+```js
+export default {
+ lastUpdated: true
+}
+```
+
+## پیکربندی Frontmatter {#frontmatter-config}
+
+می‌توانید این امکان را برای هر صفحه با استفاده از گزینه `lastUpdated` در frontmatter غیرفعال کنید:
+
+```yaml
+---
+lastUpdated: false
+---
+```
+
+همچنین به [پیکربندی پیش‌فرض: آخرین بروزرسانی](./default-theme-config#lastupdated) مراجعه کنید تا اطلاعات بیشتری دریافت کنید. هر مقدار حقیقی در سطح تم از ویژگی را فعال خواهد کرد مگر آنکه به صورت صریح در سطح سایت یا صفحه غیرفعال شود.
\ No newline at end of file
diff --git a/docs/fa/reference/default-theme-layout.md b/docs/fa/reference/default-theme-layout.md
new file mode 100644
index 00000000..2d488072
--- /dev/null
+++ b/docs/fa/reference/default-theme-layout.md
@@ -0,0 +1,62 @@
+# طرح بندی {#layout}
+
+می‌توانید طرح صفحه را با تنظیم گزینه `layout` در [frontmatter](./frontmatter-config) صفحه انتخاب کنید. سه گزینه طرح وجود دارد، `doc`، `page` و `home`. اگر هیچ چیز مشخص نشده باشد، صفحه به عنوان صفحه `doc` در نظر گرفته می‌شود.
+
+```yaml
+---
+layout: doc
+---
+```
+
+## طرح Doc {#doc-layout}
+
+گزینه `doc` طرح پیش‌فرض است و تمام محتوای Markdown را به "نمایشگاه" درست می‌کند. این با پوشاندن کل محتوا در داخل کلاس css `vp-doc` کار می‌کند و استایل‌های لازم را بر روی عناصر زیرش اعمال می‌کند.
+
+تقریباً همه عناصر عمومی مانند `p` یا `h2` استایل‌های خاصی دارند. بنابراین، به یاد داشته باشید که اگر HTML سفارشی‌ای درون محتوای Markdown اضافه کنید، این استایل‌ها روی آنها هم اعمال خواهند شد.
+
+این طرح ویژگی‌های خاص مستندسازی زیر را فراهم می‌کند. این ویژگی‌ها فقط در این طرح فعال هستند.
+
+- پیوند ویرایش
+- پیوند قبلی و بعدی
+- ساختار
+- [تبلیغات Carbon](./default-theme-carbon-ads)
+
+## طرح Page {#page-layout}
+
+گزینه `page` به عنوان "صفحه خالی" در نظر گرفته می‌شود. Markdown همچنان تجزیه و تحلیل می‌شود و تمامی [توسعه‌های Markdown](../guide/markdown) به عنوان طرح `doc` کار می‌کنند، اما هیچ استایل پیش‌فرضی به آن اعمال نمی‌شود.
+
+طرح صفحه به شما این امکان را می‌دهد که همه چیز را به دلخواه خود شخصی‌سازی کنید بدون این که طرح ویت‌پرس بر روی مارک‌آپ تاثیر بگذارد. این کار بسیار مفید است زمانی که می‌خواهید صفحه سفارشی خود را ایجاد کنید.
+
+توجه داشته باشید که حتی در این طرح، نوار کناری نیز نمایش داده می‌شود اگر صفحه دارای پیکربندی نوار کناری مطابق باشد.
+
+## طرح Home {#home-layout}
+
+گزینه `home` صفحه "خانه" قالب‌بندی می‌کند. در این طرح، می‌توانید گزینه‌های اضافی مانند `hero` و `features` را برای دلخواه‌سازی محتوا تنظیم کنید. لطفاً [صفحه پیش‌فرض: صفحه خانه](./default-theme-home-page) را برای اطلاعات بیشتر مشاهده کنید.
+
+## بدون طرح {#no-layout}
+
+اگر نمی‌خواهید هیچ طرحی داشته باشید، می‌توانید با گذراندن `layout: false` از frontmatter، از این گزینه استفاده کنید. این گزینه مفید است اگر صفحهٔ نخستی کاملاً قابل تنظیم (بدون هیچ نوار کناری، نوار ناوبری یا پاورقی به صورت پیش‌فرض) را می‌خواهید.
+
+## طرح سفارشی {#custom-layout}
+
+همچنین می‌توانید از یک طرح سفارشی استفاده کنید:
+
+```md
+---
+layout: foo
+---
+```
+
+این دستور به دنبال یک کامپوننت به نام `foo` ثبت شده در محیط است. به عنوان مثال، می‌توانید کامپوننت خود را به صورت گلوبال در `.vitepress/theme/index.ts` ثبت کنید:
+
+```ts
+import DefaultTheme from 'vitepress/theme'
+import Foo from './Foo.vue'
+
+export default {
+ extends: DefaultTheme,
+ enhanceApp({ app }) {
+ app.component('foo', Foo)
+ }
+}
+```
\ No newline at end of file
diff --git a/docs/fa/reference/default-theme-nav.md b/docs/fa/reference/default-theme-nav.md
new file mode 100644
index 00000000..eafc5b53
--- /dev/null
+++ b/docs/fa/reference/default-theme-nav.md
@@ -0,0 +1,215 @@
+# ناوبری {#nav}
+
+ناوبری نوار ناوبری است که در بالای صفحه نمایش داده می‌شود و شامل عنوان سایت، لینک‌های منوی جهانی، و غیره می‌باشد.
+
+## عنوان سایت و لوگو {#site-title-and-logo}
+
+به طور پیش‌فرض، ناو نام سایت را با ارجاع به مقدار [`config.title`](./site-config#title) نمایش می‌دهد. اگر می‌خواهید تغییر دهید که چه چیزی در ناو نمایش داده شود، می‌توانید متن سفارشی را در گزینه `themeConfig.siteTitle` تعریف کنید.
+
+```js
+export default {
+ themeConfig: {
+ siteTitle: 'عنوان سفارشی من'
+ }
+}
+```
+
+اگر برای سایت خود لوگو دارید، می‌توانید آن را با ارسال مسیر تصویر نمایش دهید. شما باید لوگو را در دایرکتوری `public` قرار داده و مسیر مطلق آن را تعریف کنید.
+
+```js
+export default {
+ themeConfig: {
+ logo: '/my-logo.svg'
+ }
+}
+```
+
+هنگام افزودن یک لوگو، آن به همراه عنوان سایت نمایش داده می‌شود. اگر لوگوی شما همه چیزی است که نیاز دارید و اگر می‌خواهید متن عنوان سایت را پنهان کنید، گزینه `siteTitle` را برابر با `false` قرار دهید.
+
+```js
+export default {
+ themeConfig: {
+ logo: '/my-logo.svg',
+ siteTitle: false
+ }
+}
+```
+
+همچنین می‌توانید به عنوان لوگو یک شیء را نیز ارسال کنید اگر می‌خواهید ویژگی `alt` را اضافه کنید یا آن را بر اساس حالت تاریک / روشن سفارشی‌سازی کنید. برای جزئیات بیشتر به [`themeConfig.logo`](./default-theme-config#logo) مراجعه کنید.
+
+## لینک‌های ناوبری {#navigation-links}
+
+شما می‌توانید گزینه `themeConfig.nav` را تعریف کنید تا لینک‌ها را به ناوبری خود اضافه کنید.
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'راهنما', link: '/guide' },
+ { text: 'پیکربندی', link: '/config' },
+ { text: 'تغییرات', link: 'https://github.com/...' }
+ ]
+ }
+}
+```
+
+`text` متن واقعی است که در ناوبری نمایش داده می‌شود و `link` لینکی است که هنگام کلیک بر روی متن به آن ناوبری می‌شود. برای لینک، مسیر را به صورت واقعی بدون پیشوند `.md` تنظیم کنید و همیشه با `/` شروع کنید.
+
+لینک‌های ناوبری همچنین می‌توانند منوهای کشویی باشند. برای این کار، کلید `items` را در گزینه لینک تنظیم کنید.
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'راهنما', link: '/guide' },
+ {
+ text: 'منوی کشویی',
+ items: [
+ { text: 'مورد الف', link: '/item-1' },
+ { text: 'مورد ب', link: '/item-2' },
+ { text: 'مورد ج', link: '/item-3' }
+ ]
+ }
+ ]
+ }
+}
+```
+
+لطفا توجه داشته باشید که عنوان منوی کشویی (`منوی کشویی` در مثال بالا) نمی‌تواند خاصیت `link` داشته باشد زیرا این دکمه برای باز کردن صفحه گفتگوی کشویی می‌شود.
+
+همچنین می‌توانید بخش‌هایی را نیز به موارد منوی کشویی با ارسال موارد بیشتر تو در تو اضافه کنید.
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'راهنما', link: '/guide' },
+ {
+ text: 'منوی کشویی',
+ items: [
+ {
+ // عنوان بخش
+ text: 'عنوان بخش A',
+ items: [
+ { text: 'آیتم A بخش A', link: '...' },
+ { text: 'آیتم B بخش B', link: '...' }
+ ]
+ }
+ ]
+ },
+ {
+ text: 'منوی کشویی',
+ items: [
+ {
+ // شما همچنین می‌توانید عنوان را حذف کنید.
+ items: [
+ { text: 'آیتم A بخش A', link: '...' },
+ { text: 'آیتم B بخش B', link: '...' }
+ ]
+ }
+ ]
+ }
+ ]
+ }
+}
+```
+
+### سفارشی‌سازی وضعیت "فعال" لینک {#customize-link-s-active-state}
+
+موارد منوی ناوبری زمانی که صفحه فعلی زیر مسیر مطابقت دارد، مشخص می‌شوند. اگر می‌خواهید مسیر مطابقت را سفارشی کنید، ویژگی `activeMatch` و regex را به عنوان مقدار رشته تعریف کنید.
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ // این لینک وضعیت فعال را در زمانی که کاربر در مسیر `/config/` است، دریافت می‌کند.
+ {
+ text: 'راهنما',
+ link: '/guide',
+ activeMatch: '/config/'
+ }
+ ]
+ }
+}
+```
+
+::: warning هشدار
+`activeMatch` انتظار می‌رود که به عنوان یک رشته regex باشد، اما شما باید آن را به عنوان یک رشته تعریف کنید. ما نمی‌توانیم از شیء RegExp واقعی اینجا استفاده کنیم زیرا در زمان ساخت غیر قابل سریالیز کردن است.
+:::
+
+### سفارشی‌سازی ویژگی‌های "target" و "rel" لینک {#customize-link-s-target-and-rel-attributes}
+
+به طور پیش‌فرض، ویت‌پرس به طور خودکار ویژگی‌های
+
+`target` و `rel` را بر اساس اینکه لینک یک لینک خارجی است یا خیر، تعیین می‌کند. اما اگر می‌خواهید، شما همچنین می‌توانید آنها را سفارشی کنید.
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ {
+ text: 'کالای معاملاتی',
+ link: 'https://www.thegithubshop.com/',
+ target: '_self',
+ rel: 'sponsored'
+ }
+ ]
+ }
+}
+```
+
+## لینک‌های اجتماعی {#social-links}
+
+به [`socialLinks`](./default-theme-config#sociallinks) مراجعه کنید.
+
+## اجزای سفارشی
+
+می‌توانید اجزای سفارشی را در نوار ناوبری با استفاده از گزینه `component` اضافه کنید. کلید `component` باید نام مؤلفه Vue باشد و باید به صورت جهانی با استفاده از [Theme.enhanceApp](../guide/custom-theme#theme-interface) ثبت شود.
+
+```js [.vitepress/config.js]
+export default {
+ themeConfig: {
+ nav: [
+ {
+ text: 'منوی من',
+ items: [
+ {
+ component: 'MyCustomComponent',
+ // پارامترهای اختیاری برای ارسال به مؤلفه
+ props: {
+ title: 'مؤلفه سفارشی من'
+ }
+ }
+ ]
+ },
+ {
+ component: 'AnotherCustomComponent'
+ }
+ ]
+ }
+}
+```
+
+سپس، شما باید مؤلفه را به صورت جهانی ثبت کنید:
+
+```js [.vitepress/theme/index.js]
+import DefaultTheme from 'vitepress/theme'
+
+import MyCustomComponent from './components/MyCustomComponent.vue'
+import AnotherCustomComponent from './components/AnotherCustomComponent.vue'
+
+/** @type {import('vitepress').Theme} */
+export default {
+ extends: DefaultTheme,
+ enhanceApp({ app }) {
+ app.component('MyCustomComponent', MyCustomComponent)
+ app.component('AnotherCustomComponent', AnotherCustomComponent)
+ }
+}
+```
+
+اجزای شما در نوار ناوبری نمایش داده خواهد شد. ویت‌پرس ویژگی‌های اضافی زیر را به مؤلفه ارائه می‌دهد:
+
+- `screenMenu`: یک بولین اختیاری که نشان می‌دهد آیا مؤلفه در منوی ناوبری تلفن همراه است یا خیر
+
+می‌توانید یک نمونه را در آزمایش‌های e2e [اینجا](https://github.com/vuejs/vitepress/tree/main/__tests__/e2e/.vitepress) بررسی کنید.
diff --git a/docs/fa/reference/default-theme-prev-next-links.md b/docs/fa/reference/default-theme-prev-next-links.md
new file mode 100644
index 00000000..e17358cc
--- /dev/null
+++ b/docs/fa/reference/default-theme-prev-next-links.md
@@ -0,0 +1,43 @@
+# پیوندهای قبلی و بعدی {#prev-next-links}
+
+شما می‌توانید متن و پیوند برای صفحات قبلی و بعدی را سفارشی‌سازی کنید (نمایش داده شده در پایین صفحه مستندات). این مفید است اگر می‌خواهید متن دیگری را در این قسمت نمایش دهید که با آنچه در نوار کناری دارید، متفاوت باشد. همچنین، ممکن است مفید باشد که فوتر را غیرفعال کنید یا به یک صفحه لینک کنید که در نوار کناری شما وجود ندارد.
+
+## prev
+
+- نوع: `string | false | { text?: string; link?: string }`
+
+- جزئیات:
+
+ مشخص می‌کند متن/لینکی که برای لینک به صفحه قبلی نمایش داده خواهد شد. اگر این را در frontmatter تنظیم نکنید، متن/لینک از تنظیمات نوار کناری استخراج خواهد شد.
+
+- مثال‌ها:
+
+ - برای فقط سفارشی‌سازی متن:
+
+ ```yaml
+ ---
+ prev: 'شروع کنید | مارک‌داون'
+ ---
+ ```
+
+ - برای سفارشی‌سازی هم متن و هم لینک:
+
+ ```yaml
+ ---
+ prev:
+ text: 'مارک‌داون'
+ link: '/guide/markdown'
+ ---
+ ```
+
+ - برای مخفی کردن صفحه قبلی:
+
+ ```yaml
+ ---
+ prev: false
+ ---
+ ```
+
+## next
+
+مشابه `prev` اما برای صفحه بعدی.
diff --git a/docs/fa/reference/default-theme-search.md b/docs/fa/reference/default-theme-search.md
new file mode 100644
index 00000000..dd325c9f
--- /dev/null
+++ b/docs/fa/reference/default-theme-search.md
@@ -0,0 +1,386 @@
+---
+outline: deep
+---
+
+# جستجو {#search}
+
+## جستجوی محلی {#local-search}
+
+ویت‌پرس از جستجوی متن کامل نامتقارن با استفاده از یک فهرست در مرورگر با تشکر از [minisearch](https://github.com/lucaong/minisearch/) پشتیبانی می‌کند. برای فعال‌سازی این ویژگی، کافی است گزینه `themeConfig.search.provider` را به `'local'` در فایل `.vitepress/config.ts` خود تنظیم کنید:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local'
+ }
+ }
+})
+```
+
+نمونه نتیجه:
+
+
+
+همچنین، می‌توانید از [Algolia DocSearch](#algolia-search) یا برخی افزونه‌های جامعه‌ای مانند یا استفاده کنید.
+
+### بین‌المللی‌سازی {#local-search-i18n}
+
+می‌توانید با استفاده از تنظیماتی مانند این برای جستجوی چندزبانه استفاده کنید:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local',
+ options: {
+ locales: {
+ zh: { // اگر می‌خواهید زبان پیش‌فرض را ترجمه کنید، این را به `root` تغییر دهید
+ translations: {
+ button: {
+ buttonText: 'جستجو',
+ buttonAriaLabel: 'جستجو'
+ },
+ modal: {
+ displayDetails: 'نمایش جزئیات',
+ resetButtonTitle: 'بازنشانی جستجو',
+ backButtonTitle: 'بستن جستجو',
+ noResultsText: 'نتیجه‌ای یافت نشد',
+ footer: {
+ selectText: 'انتخاب',
+ selectKeyAriaLabel: 'ورود',
+ navigateText: 'پیمایش',
+ navigateUpKeyAriaLabel: 'کلید بالا',
+ navigateDownKeyAriaLabel: 'کلید پایین',
+ closeText: 'بستن',
+ closeKeyAriaLabel: 'esc'
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+})
+```
+
+### گزینه‌های miniSearch {#minisearch-options}
+
+می‌توانید MiniSearch را به این صورت پیکربندی کنید:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local',
+ options: {
+ miniSearch: {
+ /**
+ * @type {Pick}
+ */
+ options: {
+ /* ... */
+ },
+ /**
+ * @type {import('minisearch').SearchOptions}
+ * @default
+ * { fuzzy: 0.2, prefix: true, boost: { title: 4, text: 2, titles: 1 } }
+ */
+ searchOptions: {
+ /* ... */
+ }
+ }
+ }
+ }
+ }
+})
+```
+
+برای کسب اطلاعات بیشتر به [اسناد MiniSearch](https://lucaong.github.io/minisearch/classes/MiniSearch.MiniSearch.html) مراجعه کنید.
+
+### سفارشی‌سازی رندر محتوا {#custom-content-renderer}
+
+می‌توانید تابع استفاده شده برای رندر محتوای Markdown قبل از فهرست‌بندی آن را سفارشی‌سازی کنید:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local',
+ options: {
+ /**
+ * @param {string} src
+ * @param {import('vitepress').MarkdownEnv} env
+ * @param {import('markdown-it')} md
+ */
+ _render(src, env, md) {
+ // بازگشت رشته HTML
+ }
+ }
+ }
+ }
+})
+```
+
+این تابع از داده‌های سایت سمت کلاینت پاک خواهد شد، بنابراین شما می‌توانید از APIهای Node.js در آن استفاده کنید.
+
+#### مثال: استثنای صفحات از جستجو {#example-excluding-pages-from-search}
+
+می‌توانید با اضافه کردن `search: false` به frontmatter صفحه، صفحات را از جستجو استثنا دهید. به طور جایگزین:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local',
+ options: {
+ _render(src, env, md) {
+ const html = md.render(src, env)
+ if (env.frontmatter?.search === false) return ''
+ if (env.relativePath.startsWith('some/path')) return ''
+ return html
+ }
+ }
+ }
+ }
+})
+```
+
+::: warning توجه
+در صورت ارائه تابع `_render` سفارشی، باید خودتان بررسی کنید که آیا frontmatter `search: false` را مدیریت می‌کند یا خیر. همچنین، شی env قبل از فراخوانی `md.render` کاملاً پر نمی‌شود، بنابراین هر بررسی‌ای روی ویژگی‌های اختیاری env مانند `frontmatter` باید بعد از آن انجام شود.
+:::
+
+#### مثال: تبدیل محتوا - افزودن لینک‌های صفحه {#example-transforming-content-adding-anchors}
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local',
+ options: {
+ _render(src, env, md) {
+ const html = md.render(src, env)
+ if (env.frontmatter?.title)
+ return md.render(`# ${env.frontmatter.title}`) + html
+ return html
+ }
+ }
+ }
+ }
+})
+```
+
+## جستجوی Algolia {#algolia-search}
+
+ویت‌پرس از جستجو در سایت مستندات شما با استفاده از [Algolia DocSearch](https://docsearch.algolia.com/docs/what-is-docsearch) پشتیبانی می‌کند. به راهنمای شروع کار آنها مراجعه کنید. در فایل `.vitepress/config.ts` شما نیاز دارید که حداقل موارد زیر را فراهم کنید تا کار کند:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'algolia',
+ options: {
+ appId: '...',
+ apiKey: '...',
+ indexName: '...'
+ }
+ }
+ }
+})
+```
+
+### بین‌المللی‌سازی {#algolia-search-i18n}
+
+می‌توانید با استفاده از تنظیماتی مانند این برای جستجوی چندزبانه استفاده کنید:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig:
+
+ {
+ search: {
+ provider: 'algolia',
+ options: {
+ appId: '...',
+ apiKey: '...',
+ indexName: '...',
+ locales: {
+ zh: {
+ placeholder: 'جستجو در مستندات',
+ translations: {
+ button: {
+ buttonText: 'جستجو در مستندات',
+ buttonAriaLabel: 'جستجو در مستندات'
+ },
+ modal: {
+ searchBox: {
+ resetButtonTitle: 'پاک کردن شرایط جستجو',
+ resetButtonAriaLabel: 'پاک کردن شرایط جستجو',
+ cancelButtonText: 'لغو',
+ cancelButtonAriaLabel: 'لغو'
+ },
+ startScreen: {
+ recentSearchesTitle: 'تاریخچه جستجو',
+ noRecentSearchesText: 'هیچ تاریخچه جستجویی وجود ندارد',
+ saveRecentSearchButtonTitle: 'ذخیره در تاریخچه جستجو',
+ removeRecentSearchButtonTitle: 'حذف از تاریخچه جستجو'
+ },
+ errorScreen: {
+ titleText: 'نمایش نتایج امکان‌پذیر نیست',
+ helpText: 'شما ممکن است نیاز به بررسی اتصال اینترنت خود داشته باشید'
+ },
+ footer: {
+ selectText: 'انتخاب',
+ navigateText: 'جابجایی',
+ closeText: 'بستن',
+ searchByText: 'جستجو توسط'
+ },
+ noResultsScreen: {
+ noResultsText: 'نتیجه‌ای پیدا نشد',
+ suggestedQueryText: 'می‌توانید امتحان کنید',
+ reportMissingResultsText: 'فکر می‌کنید باید نتایجی وجود داشته باشد؟',
+ reportMissingResultsLinkText: 'برای بازخورد کلیک کنید'
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+})
+```
+
+این [گزینه‌ها](https://github.com/vuejs/vitepress/blob/main/types/docsearch.d.ts) می‌توانند بازنویسی شوند. برای یادگیری بیشتر درباره آنها به اسناد رسمی Algolia مراجعه کنید.
+
+### پیکربندی Crawler {#crawler-config}
+
+در اینجا یک پیکربندی نمونه بر اساس آنچه که این سایت استفاده می‌کند آمده است:
+
+```ts
+new Crawler({
+ appId: '...',
+ apiKey: '...',
+ rateLimit: 8,
+ startUrls: ['https://vitepress.dev/'],
+ renderJavaScript: false,
+ sitemaps: [],
+ exclusionPatterns: [],
+ ignoreCanonicalTo: false,
+ discoveryPatterns: ['https://vitepress.dev/**'],
+ schedule: 'at 05:10 on Saturday',
+ actions: [
+ {
+ indexName: 'vitepress',
+ pathsToMatch: ['https://vitepress.dev/**'],
+ recordExtractor: ({ $, helpers }) => {
+ return helpers.docsearch({
+ recordProps: {
+ lvl1: '.content h1',
+ content: '.content p, .content li',
+ lvl0: {
+ selectors: '',
+ defaultValue: 'Documentation'
+ },
+ lvl2: '.content h2',
+ lvl3: '.content h3',
+ lvl4: '.content h4',
+ lvl5: '.content h5'
+ },
+ indexHeadings: true
+ })
+ }
+ }
+ ],
+ initialIndexSettings: {
+ vitepress: {
+ attributesForFaceting: ['type', 'lang'],
+ attributesToRetrieve: ['hierarchy', 'content', 'anchor', 'url'],
+ attributesToHighlight: ['hierarchy', 'hierarchy_camel', 'content'],
+ attributesToSnippet: ['content:10'],
+ camelCaseAttributes: ['hierarchy', 'hierarchy_radio', 'content'],
+ searchableAttributes: [
+ 'unordered(hierarchy_radio_camel.lvl0)',
+ 'unordered(hierarchy_radio.lvl0)',
+ 'unordered(hierarchy_radio_camel.lvl1)',
+ 'unordered(hierarchy_radio.lvl1)',
+ 'unordered(hierarchy_radio_camel.lvl2)',
+ 'unordered(hierarchy_radio.lvl2)',
+ 'unordered(hierarchy_radio_camel.lvl3)',
+ 'unordered(hierarchy_radio.lvl3)',
+ 'unordered(hierarchy_radio_camel.lvl4)',
+ 'unordered(hierarchy_radio.lvl4)',
+ 'unordered(hierarchy_radio_camel.lvl5)',
+ 'unordered(hierarchy_radio.lvl5)',
+ 'unordered(hierarchy_radio_camel.lvl6)',
+ 'unordered(hierarchy_radio.lvl6)',
+ 'unordered(hierarchy_camel.lvl0)',
+ 'unordered(hierarchy.lvl0)',
+ 'unordered(hierarchy_camel.lvl1)',
+ 'unordered(hierarchy.lvl1)',
+ 'unordered(hierarchy_camel.lvl2)',
+ 'unordered(hierarchy.lvl2)',
+ 'unordered(hierarchy_camel.lvl3)',
+ 'unordered(hierarchy.lvl3)',
+ 'unordered(hierarchy_camel.lvl4)',
+ 'unordered(hierarchy.lvl4)',
+ 'unordered(hierarchy_camel.lvl5)',
+ 'unordered(hierarchy.lvl5)',
+ 'unordered(hierarchy_camel.lvl6)',
+ 'unordered(hierarchy.lvl6)',
+ 'content'
+ ],
+ distinct: true,
+ attributeForDistinct: 'url',
+ customRanking: [
+ 'desc(weight.pageRank)',
+ 'desc(weight.level)',
+ 'asc(weight.position)'
+ ],
+ ranking: [
+ 'words',
+ 'filters',
+ 'typo',
+ 'attribute',
+ 'proximity',
+ 'exact',
+ 'custom'
+ ],
+ highlightPreTag: '',
+ highlightPostTag: '',
+ minWordSizefor1Typo: 3,
+ minWordSizefor2Typos: 7,
+ allowTyposOnNumericTokens: false,
+ minProximity: 1,
+ ignorePlurals: true,
+ advancedSyntax: true,
+ attributeCriteriaComputedByMinProximity: true,
+ removeWordsIfNoResults: 'allOptional'
+ }
+ }
+})
+```
+
+
\ No newline at end of file
diff --git a/docs/fa/reference/default-theme-sidebar.md b/docs/fa/reference/default-theme-sidebar.md
new file mode 100644
index 00000000..cf5f5e55
--- /dev/null
+++ b/docs/fa/reference/default-theme-sidebar.md
@@ -0,0 +1,215 @@
+# نوار کناری {#sidebar}
+
+نوار کناری بلوک اصلی ناوبری برای مستندات شما است. شما می‌توانید منوی نوار کناری را در [`themeConfig.sidebar`](./default-theme-config#sidebar) پیکربندی کنید.
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'راهنما',
+ items: [
+ { text: 'مقدمه', link: '/introduction' },
+ { text: 'شروع کردن', link: '/getting-started' },
+ ...
+ ]
+ }
+ ]
+ }
+}
+```
+
+## مبانی {#the-basics}
+
+ساده‌ترین فرم منوی نوار کناری ارسال یک آرایه تکی از لینک‌هاست. آیتم سطح اول "بخش" نوار کناری را تعریف می‌کند. باید شامل `text` باشد که عنوان بخش است و `items` که لینک‌های واقعی ناوبری هستند.
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'عنوان بخش A',
+ items: [
+ { text: 'آیتم A', link: '/item-a' },
+ { text: 'آیتم B', link: '/item-b' },
+ ...
+ ]
+ },
+ {
+ text: 'عنوان بخش B',
+ items: [
+ { text: 'آیتم C', link: '/item-c' },
+ { text: 'آیتم D', link: '/item-d' },
+ ...
+ ]
+ }
+ ]
+ }
+}
+```
+
+هر `link` باید مسیر به فایل واقعی را با `/` آغاز کند. اگر شما `/` را به انتهای لینک اضافه کنید، صفحه `index.md` دایرکتوری متناظر را نمایش می‌دهد.
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'راهنما',
+ items: [
+ // این صفحه `/guide/index.md` را نمایش می‌دهد.
+ { text: 'مقدمه', link: '/guide/' }
+ ]
+ }
+ ]
+ }
+}
+```
+
+شما می‌توانید آیتم‌های نوار کناری را تا عمق ۶ سطح تعویض کنید که از سطح ریشه شمارش می‌شود. توجه داشته باشید که عمق بیشتر از ۶ سطح از آیتم‌های تو در تو نادیده گرفته می‌شود و در نوار کناری نمایش داده نمی‌شود.
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'سطح ۱',
+ items: [
+ {
+ text: 'سطح ۲',
+ items: [
+ {
+ text: 'سطح ۳',
+ items: [
+ ...
+ ]
+ }
+ ]
+ }
+ ]
+ }
+ ]
+ }
+}
+```
+
+## نوارهای کناری چندگانه {#multiple-sidebars}
+
+می‌توانید بسته به مسیر صفحه، نوار کناری مختلفی را نمایش دهید. به عنوان مثال، همانطور که در این سایت نشان داده شده است، ممکن است بخواهید برای مستندات خود بخش‌های جداگانه مانند صفحه "راهنما" و صفحه "پیکربندی" را ایجاد کنید.
+
+برای این کار، ابتدا صفحات خود را در دایرکتوری‌های مختلف برای هر بخش مورد نظر خود سازماندهی کنید:
+
+```
+.
+├─ guide/
+│ ├─ index.md
+│ ├─ one.md
+│ └─ two.md
+└─ config/
+ ├─ index.md
+ ├─ three.md
+ └─ four.md
+```
+
+سپس، پیکربندی خود را برای تعریف نوار کناری برای هر بخش تعیین کنید. در این موارد، شما باید به جای یک آرایه، یک شیء را ارسال کنید.
+
+```js
+export default {
+ themeConfig: {
+ sidebar: {
+ // این نوار کناری نمایش داده می‌شود زمانی که کاربر در دایرکتوری `guide` است.
+ '/guide/': [
+ {
+ text: 'راهنما',
+ items: [
+ { text: 'فهرست', link: '/guide/' },
+ { text: 'یک', link: '/guide/one' },
+ { text: 'دو', link: '/guide/two' }
+ ]
+ }
+ ],
+
+ // این نوار کناری نمایش داده می‌شود زمانی که کاربر در دایرکتوری `config` است.
+ '/config/': [
+ {
+ text: 'پیکربندی',
+ items: [
+ { text: 'فهرست', link: '/config/' },
+ { text: 'سه', link: '/config/three' },
+ { text: 'چهار', link: '/config/four' }
+ ]
+ }
+ ]
+ }
+ }
+}
+```
+
+## گروه‌های نوار کناری قابل جمع و جور {#collapsible-sidebar-groups}
+
+با اضافه کردن گزینه `collapsed` به گروه نوار کناری، دکمه جداگانه‌ای برای پنهان کردن/نمایش هر بخش نمایش داده می‌شود.
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'عنوان بخش A',
+ collapsed: false,
+ items: [...]
+ }
+ ]
+ }
+}
+```
+
+تمام بخش‌ها به طور پیش‌فرض "باز" هستند. اگر می‌خواهید آنها را در بارگذاری اولیه صفحه "بسته" کنید، گزینه `collapsed` را به `true` تنظیم کنید.
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'عنوان بخش A',
+ collapsed: true,
+ items: [...]
+ }
+ ]
+ }
+}
+```
+
+## `useSidebar`
+ sidebar: ComputedRef
+ sidebarGroups: ComputedRef
+ hasSidebar: ComputedRef
+ hasAside: ComputedRef
+ leftAside: ComputedRef
+ isSidebarEnabled: ComputedRef
+ open: () => void
+ close: () => void
+ toggle: () => void
+}
+```
+
+**مثال:**
+
+```vue
+
+
+
+ فقط ن
+
+مایش داده شود زمانی که نوار کناری وجود دارد
+
+```
\ No newline at end of file
diff --git a/docs/fa/reference/default-theme-team-page.md b/docs/fa/reference/default-theme-team-page.md
new file mode 100644
index 00000000..ccd9738d
--- /dev/null
+++ b/docs/fa/reference/default-theme-team-page.md
@@ -0,0 +1,255 @@
+
+
+# صفحه تیم {#team-page}
+
+اگر می‌خواهید تیم خود را معرفی کنید، می‌توانید از کامپوننت‌های تیم برای ساخت صفحه تیم استفاده کنید. دو راه برای استفاده از این کامپوننت‌ها وجود دارد. یکی اینکه آنها را در صفحه مستندات قرار دهید و دیگری اینکه یک صفحه کامل تیم ایجاد کنید.
+
+## نمایش اعضای تیم در یک صفحه {#show-team-members-in-a-page}
+
+می‌توانید از کامپوننت `` که از `vitepress/theme` قابل دسترسی است، برای نمایش لیست اعضای تیم در هر صفحه‌ای استفاده کنید.
+
+```html
+
+
+# تیم ما
+
+با سلام به تیم فوق‌العاده‌ی ما خوش آمدید.
+
+` دارای دو اندازه مختلف، `small` و `medium` است. معمولاً اندازه `small` برای استفاده در صفحات مستندات مناسب‌تر است. همچنین می‌توانید ویژگی‌های بیشتری برای هر عضو اضافه کنید مانند "توضیحات" یا "دکمه حامی". جهت کسب اطلاعات بیشتر به [``](#vpteammembers) مراجعه کنید.
+
+قرار دادن اعضای تیم در صفحه مستندات برای تیم‌های کوچک مناسب است که ایجاد یک صفحه کامل تیم ممکن است بیش از حد باشد یا معرفی اعضا به عنوان مرجع در زمینه مستندات.
+
+اگر تعداد اعضا بسیار زیاد است یا به سادگی می‌خواهید بیشتر فضا برای نمایش اعضای تیم داشته باشید، در نظر بگیرید [ایجاد یک صفحه کامل تیم](#create-a-full-team-page).
+
+## ایجاد یک صفحه کامل تیم {#create-a-full-team-page}
+
+بجای اضافه کردن اعضای تیم به صفحه مستندات، می‌توانید یک صفحه کامل تیم را ایجاد کنید، مشابه اینکه چگونه می‌توانید یک [صفحه خانگی سفارشی](./default-theme-home-page) ایجاد کنید.
+
+برای ایجاد یک صفحه تیم، ابتدا یک فایل md جدید بسازید. نام فایل مهم نیست، اما در اینجا آن را `team.md` می‌نامیم. در این فایل، گزینه `layout: page` را در فرانت‌ماتر تنظیم کنید، سپس می‌توانید ساختار صفحه خود را با استفاده از کامپوننت‌های `TeamPage` ایجاد کنید.
+
+```html
+---
+layout: page
+---
+
+
+
+
+
+ تیم ما
+
+
+ توسعه ویت‌پرس توسط تیمی بین‌المللی راهنمایی می‌شود، برخی از اعضا که انتخاب کرده‌اند تا در زیر نمایش داده شوند.
+
+
+
+```
+
+در ایجاد یک صفحه کامل تیم، به یاد داشته باشید که همهٔ کامپوننت‌ها را با کامپوننت `` بپوشانید. این کامپوننت تضمین می‌کند که همهٔ کامپوننت‌های مرتبط با تیم در ساختار طراحی مناسبی مانند فضاهای خالی قرار می‌گیرند.
+
+کامپوننت `` بخش عنوان صفحه را اضافه می‌کند. عنوان به عنوان `` نمایش داده می‌شود. از اسلات‌های `#title` و `#lead` برای مستندسازی در مورد تیم خود استفاده کنید.
+
+`` به عنوان زمانی که در یک صفحه مستند استفاده می‌شود، کار می‌کند. این لیست اعضا را نمایش می‌دهد.
+
+### اضافه کردن بخش‌ها برای تقسیم اعضای تیم {#add-sections-to-divide-team-members}
+
+می‌توانید بخش‌ها را به صفحه تیم اضافه کنید. به عنوان مثال، ممکن است اعضای مختلف تیمی مانند اعضای تیم اصلی و شرکای اجتماعی داشته باشید. شما می‌توانید این اعضا را به بخش‌ها تقسیم کنید تا نقش هر گروه بهتر توضیح داده شود.
+
+برای این کار، کامپوننت `` را به فایل `team.md` اضافه کنید که قبلاً ایجاد کردیم.
+
+```html
+---
+layout: page
+---
+
+
+
+
+ تیم ما
+ ...
+
+
+ شرکای تجاری
+ ...
+
+
+
+```
+
+کامپوننت `` می‌تواند همچون کامپوننت `VPTeamPageTitle` دارای اسلات‌های `#title` و `#lead` باشد و همچنین اسلات `#members` را برای نمایش اعضای تیم پذیرفته است.
+
+به یاد داشته باشید که کامپوننت `` را درون اسلات `#members` قرار دهید.
+
+## `` {#vpteammembers}
+
+کامپوننت `` لیست داده‌شده از اعضا را نمایش می‌دهد.
+
+```html
+` {#vpteampage}
+
+کامپوننت ریشه هنگام ایجاد یک صفحه کامل تیم. فقط یک اسلات را قبول می‌کند. این همه کامپوننت‌های مربوط به تیم را استایل می‌کند.
+
+## `` {#vpteampagetitle}
+
+بخش "عنوان" صفحه را اضافه می‌کند. بهترین استفاده را در ابتدایی‌ترین جای زیر `` داشته باشد. این اسلات‌های `#title` و `#lead` را قبول می‌کند.
+
+```html
+
+
+
+ تیم ما
+
+
+ توسعه ویت‌پرس توسط تیمی بین‌المللی راهنمایی می‌شود، برخی از اعضا که انتخاب کرده‌اند تا در زیر نمایش داده شوند.
+
+
+
+```
+
+## `` {#vpteampagesection}
+
+یک "بخش" را درون صفحه تیم ایجاد می‌کند. اسلات‌های `#title`، `#lead` و `#members` را قبول می‌کند. می‌توانید هر تعداد بخش را درون `` اضافه کنید.
+
+```html
+
+ ...
+
+ شرکای تجاری
+ Lorem ipsum...
+
+
+
+```
diff --git a/docs/fa/reference/frontmatter-config.md b/docs/fa/reference/frontmatter-config.md
new file mode 100644
index 00000000..01b0b169
--- /dev/null
+++ b/docs/fa/reference/frontmatter-config.md
@@ -0,0 +1,223 @@
+---
+outline: deep
+---
+
+# تنظیمات Frontmatter {#frontmatter-config}
+
+Frontmatter امکان پیکربندی بر اساس صفحه را فراهم می‌کند. در هر فایل markdown، شما می‌توانید از تنظیمات frontmatter برای بازنویسی تنظیمات سطح سایت یا تم استفاده کنید. همچنین، تنظیماتی وجود دارند که فقط می‌توانید آنها را در frontmatter تعریف کنید.
+
+نمونه استفاده:
+
+```md
+---
+title: مستندات با ویت‌پرس
+editLink: true
+---
+```
+
+شما می‌توانید به داده‌های frontmatter از طریق `$frontmatter` در بیانیه‌های Vue دسترسی داشته باشید:
+
+```md
+{{ $frontmatter.title }}
+```
+
+## title
+
+- نوع: `string`
+
+عنوان صفحه. همانطور که در [config.title](./site-config#title) است، این تنظیمات سطح سایت را بازنویسی می‌کند.
+
+```yaml
+---
+title: ویت‌پرس
+---
+```
+
+## titleTemplate
+
+- نوع: `string | boolean`
+
+پسوند برای عنوان. همانطور که در [config.titleTemplate](./site-config#titletemplate) است، این تنظیمات سطح سایت را بازنویسی می‌کند.
+
+```yaml
+---
+title: ویت‌پرس
+titleTemplate: Vite & Vue powered static site generator
+---
+```
+
+## description
+
+- نوع: `string`
+
+توضیحات صفحه. همانطور که در [config.description](./site-config#description) است، این تنظیمات سطح سایت را بازنویسی می‌کند.
+
+```yaml
+---
+description: ویت‌پرس
+---
+```
+
+## head
+
+- نوع: `HeadConfig[]`
+
+تگ‌های head اضافی برای درج در صفحه فعلی. پس از تگ‌های head تزریق شده توسط تنظیمات سطح سایت، این تنظیمات درج می‌شوند.
+
+```yaml
+---
+head:
+ - - meta
+ - name: description
+ content: hello
+ - - meta
+ - name: keywords
+ content: super duper SEO
+---
+```
+
+```ts
+type HeadConfig =
+ | [string, Record]
+ | [string, Record, string]
+```
+
+## فقط برای تم پیش‌فرض {#default-theme-only}
+
+گزینه‌های frontmatter زیر فقط زمانی قابل استفاده هستند که از تم پیش‌فرض استفاده می‌کنید.
+
+### layout
+
+- نوع: `doc | home | page`
+- پیش‌فرض: `doc`
+
+تعیین چیدمان صفحه.
+
+- `doc` - این چیدمان استایل‌های مستندات پیش‌فرض را به محتوای markdown اعمال می‌کند.
+- `home` - چیدمان ویژه برای "صفحه اصلی". شما می‌توانید گزینه‌های اضافی مانند `hero` و `features` را اضافه کنید تا به سرعت یک صفحه نخست زیبا ایجاد کنید.
+- `page` - مشابه `doc` عمل می‌کند اما هیچ استایلی به محتوا اعمال نمی‌شود. مفید است زمانی که می‌خواهید یک صفحه کاملاً سفارشی ایجاد کنید.
+
+```yaml
+---
+layout: doc
+---
+```
+
+### hero {{ theme.footer.copyright }}
+
+```
+
+## `useRoute`
+ /**
+ * قبل از تغییر مسیر فراخوانی می‌شود. برای لغو ناوبری `false` را برگردانید.
+ */
+ onBeforeRouteChange?: (to: string) => Awaitable
+ /**
+ * قبل از بارگذاری مؤلفه صفحه فراخوانی می‌شود (پس از به‌روزرسانی وضعیت تاریخچه). برای لغو ناوبری `false` را برگردانید.
+ */
+ onBeforePageLoad?: (to: string) => Awaitable
+ /**
+ * پس از تغییر مسیر فراخوانی می‌شود.
+ */
+ onAfterRouteChange?: (to: string) => Awaitable
+}
+```
+
+## `withBase` چیدمان شخصی!
+
+
+```
+
+- مرتبط: [سازگاری با SSR](../guide/ssr-compat)
+
+## `$frontmatter` /.vitepress/config.[ext]` رفع می‌شود، جایی که `` ریشه پروژه ویت‌پرس شما است و `[ext]` یکی از پسوندهای فایل پشتیبانی شده است. تایپ‌اسکریپت به طور پیش‌فرض پشتیبانی می‌شود. پسوندهای پشتیبانی شده شامل `.js`, `.ts`, `.mjs` و `.mts` هستند.
+
+توصیه می‌شود از سینتکس ماژول‌های ES در فایل‌های تنظیمات استفاده کنید. فایل تنظیمات باید به طور پیش‌فرض یک شیء صادر کند:
+
+```ts
+export default {
+ // گزینه‌های تنظیمات سطح برنامه
+ lang: 'en-US',
+ title: 'ویت‌پرس',
+ description: 'مولد سایت استاتیک توسط Vite & Vue.',
+ ...
+}
+```
+
+:::details تنظیمات پویا (غیرهمزمان)
+
+اگر نیاز دارید به طور پویا تنظیمات را تولید کنید، می‌توانید یک تابع صادر کنید. به عنوان مثال:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default async () => {
+ const posts = await (await fetch('https://my-cms.com/blog-posts')).json()
+
+ return defineConfig({
+ // گزینه‌های تنظیمات سطح برنامه
+ lang: 'en-US',
+ title: 'ویت‌پرس',
+ description: 'مولد سایت استاتیک توسط Vite & Vue.',
+
+ // گزینه‌های تنظیمات سطح تم
+ themeConfig: {
+ sidebar: [
+ ...posts.map((post) => ({
+ text: post.name,
+ link: `/posts/${post.name}`
+ }))
+ ]
+ }
+ })
+}
+```
+
+همچنین می‌توانید از `await` سطح بالا استفاده کنید. به عنوان مثال:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+const posts = await (await fetch('https://my-cms.com/blog-posts')).json()
+
+export default defineConfig({
+ // گزینه‌های تنظیمات سطح برنامه
+ lang: 'en-US',
+ title: 'ویت‌پرس',
+ description: 'مولد سایت استاتیک توسط Vite & Vue.',
+
+ // گزینه‌های تنظیمات سطح تم
+ themeConfig: {
+ sidebar: [
+ ...posts.map((post) => ({
+ text: post.name,
+ link: `/posts/${post.name}`
+ }))
+ ]
+ }
+})
+```
+
+:::
+
+### هوشمندی تنظیمات {#config-intellisense}
+
+استفاده از تابع `defineConfig` هوشمندی تایپ‌اسکریپت را برای گزینه‌های تنظیمات فراهم می‌کند. فرض کنید IDE شما از آن پشتیبانی می‌کند، این باید هم در جاوااسکریپت و هم تایپ‌اسکریپت کار کند.
+
+```js
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ // ...
+})
+```
+
+### تنظیمات تایپ‌شده تم {#typed-theme-config}
+
+به طور پیش‌فرض، تابع `defineConfig` انتظار دارد نوع تنظیمات تم از تم پیش‌فرض باشد:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ // نوع `DefaultTheme.Config`
+ }
+})
+```
+
+اگر از تم سفارشی استفاده می‌کنید و می‌خواهید بررسی نوع برای تنظیمات تم داشته باشید، باید به جای آن از `defineConfigWithTheme` استفاده کنید و نوع تنظیمات تم سفارشی خود را از طریق یک آرگومان جنریک منتقل کنید:
+
+```ts
+import { defineConfigWithTheme } from 'vitepress'
+import type { ThemeConfig } from 'your-theme'
+
+export default defineConfigWithTheme({
+ themeConfig: {
+ // نوع `ThemeConfig`
+ }
+})
+```
+
+### تنظیمات Vite, Vue و Markdown {#vite-vue-markdown-config}
+
+- **Vite**
+
+ شما می‌توانید نمونه پایه Vite را با استفاده از گزینه [vite](#vite) در تنظیمات ویت‌پرس خود پیکربندی کنید. نیازی به ایجاد فایل تنظیمات Vite جداگانه نیست.
+
+- **Vue**
+
+ ویت‌پرس از قبل پلاگین رسمی Vue برای Vite ([@vitejs/plugin-vue](https://github.com/vitejs/vite-plugin-vue)) را شامل می‌شود. شما می‌توانید گزینه‌های آن را با استفاده از گزینه [vue](#vue) در تنظیمات ویت‌پرس خود پیکربندی کنید.
+
+- **Markdown**
+
+ شما می‌توانید نمونه پایه [Markdown-It](https://github.com/markdown-it/markdown-it) را با استفاده از گزینه [markdown](#markdown) در تنظیمات ویت‌پرس خود پیکربندی کنید.
+
+## متاداده‌های سایت {#site-metadata}
+
+### عنوان {#title}
+
+- نوع: `string`
+- پیش‌فرض: `ویت‌پرس`
+- می‌تواند به ازای هر صفحه از طریق [frontmatter](./frontmatter-config#title) جایگزین شود.
+
+عنوان سایت. هنگامی که از تم پیش‌فرض استفاده می‌کنید، این در نوار ناوبری نمایش داده می‌شود.
+
+همچنین به عنوان پسوند پیش‌فرض برای تمام عناوین صفحات فردی استفاده می‌شود، مگر اینکه [`titleTemplate`](#titletemplate) تعریف شده باشد. عنوان نهایی صفحه‌ای به محتوای متنی اولین هدر `` آن صفحه ترکیب می‌شود با `title` جهانی به عنوان پسوند. به عنوان مثال با تنظیمات زیر و محتوای صفحه:
+
+```ts
+export default {
+ title: 'سایت فوق‌العاده من'
+}
+```
+
+```md
+# سلام
+```
+
+عنوان صفحه خواهد بود `سلام | سایت فوق‌العاده من`.
+
+### قالب عنوان {##titletemplate}
+
+- نوع: `string | boolean`
+- می‌تواند به ازای هر صفحه از طریق [frontmatter](./frontmatter-config#titletemplate) جایگزین شود.
+
+اجازه می‌دهد پسوند عنوان هر صفحه یا کل عنوان را سفارشی کنید. به عنوان مثال:
+
+```ts
+export default {
+ title: 'سایت فوق‌العاده من',
+ titleTemplate: 'پسوند سفارشی'
+}
+```
+
+```md
+# سلام
+```
+
+عنوان صفحه خواهد بود `سلام | پسوند سفارشی`.
+
+برای سفارشی کردن کامل نحوه نمایش عنوان، می‌توانید از نماد `:title` در `titleTemplate` استفاده کنید:
+
+```ts
+export default {
+ titleTemplate: ':title - پسوند سفارشی'
+}
+```
+
+اینجا `:title` با متن استنباط شده از اولین هدر `` صفحه جایگزین می‌شود. عنوان صفحه مثال قبلی خواهد بود `سلام - پسوند سفارشی`.
+
+این گزینه می‌تواند به `false` تنظیم شود تا پسوندهای عنوان غیرفعال شوند.
+
+### توضیحات {#description}
+
+- نوع: `string`
+- پیش‌فرض: `یک سایت ویت‌پرس`
+- می‌تواند به ازای هر صفحه از طریق [frontmatter](./frontmatter-config#description) جایگزین شود.
+
+توضیحات برای سایت. این به عنوان یک تگ `` در HTML صفحه رندر خواهد شد.
+
+```ts
+export default {
+ description: 'یک سایت ویت‌پرس'
+}
+```
+
+### head
+
+- نوع: `HeadConfig[]`
+- پیش‌فرض: `[]`
+- می‌تواند به ازای هر صفحه از طریق [frontmatter](./frontmatter-config#head) افزوده شود.
+
+عناصر اضافی برای رندر در تگ `` در HTML صفحه. تگ‌های افزوده شده توسط کاربر قبل از بسته شدن تگ `head`، پس از تگ‌های ویت‌پرس رندر می‌شوند.
+
+```ts
+type HeadConfig =
+ | [string, Record]
+ | [string, Record, string]
+```
+
+#### مثال: اضافه کردن یک favicon {#example-adding-a-favicon}
+
+```ts
+export default {
+ head: [['link', { rel: 'icon', href: '/favicon.ico' }]]
+} // favicon.ico را در دایرکتوری عمومی قرار دهید، اگر base تنظیم شده است، از /base/favicon.ico استفاده کنید.
+
+/* رندر خواهد شد:
+
+*/
+```
+
+#### مثال: اضافه کردن فونت‌های گوگل {#example-adding-google-fonts}
+
+```ts
+export default {
+ head: [
+ [
+ 'link',
+ { rel: 'preconnect', href: 'https://fonts.googleapis.com' }
+ ],
+ [
+ 'link',
+ { rel: 'preconnect', href: 'https://fonts.gstatic.com', crossorigin: '' }
+ ],
+ [
+ 'link',
+ { href: 'https://fonts.googleapis.com/css2?family=Roboto&display=swap', rel: 'stylesheet' }
+ ]
+ ]
+}
+
+/* رندر خواهد شد:
+
+
+
+*/
+```
+
+#### مثال: ثبت یک سرویس ورکر {#example-registering-a-service-worker}
+
+```ts
+export default {
+ head: [
+ [
+ 'script',
+ { id: 'register-sw' },
+ `;(() => {
+ if ('serviceWorker' in navigator) {
+ navigator.serviceWorker.register('/sw.js')
+ }
+ })()`
+ ]
+ ]
+}
+
+/* رندر خواهد شد
+
+:
+
+*/
+```
+
+#### مثال: استفاده از گوگل آنالیتیکس {#example-using-google-analytics}
+
+```ts
+export default {
+ head: [
+ [
+ 'script',
+ { async: '', src: 'https://www.googletagmanager.com/gtag/js?id=TAG_ID' }
+ ],
+ [
+ 'script',
+ {},
+ `window.dataLayer = window.dataLayer || [];
+ function gtag(){dataLayer.push(arguments);}
+ gtag('js', new Date());
+ gtag('config', 'TAG_ID');`
+ ]
+ ]
+}
+
+/* رندر خواهد شد:
+
+
+*/
+```
+
+### زبان {#lang}
+
+- نوع: `string`
+- پیش‌فرض: `en-US`
+
+ویژگی زبان برای سایت. این به عنوان یک تگ `` در HTML صفحه رندر خواهد شد.
+
+```ts
+export default {
+ lang: 'en-US'
+}
+```
+
+### پایه {#base}
+
+- نوع: `string`
+- پیش‌فرض: `/`
+
+آدرس پایه‌ای که سایت در آن مستقر خواهد شد. اگر قصد دارید سایت خود را در یک مسیر فرعی مستقر کنید، باید این تنظیم را انجام دهید، به عنوان مثال، صفحات GitHub. اگر قصد دارید سایت خود را در `https://foo.github.io/bar/` مستقر کنید، باید پایه را به `'/bar/'` تنظیم کنید. این باید همیشه با یک اسلش شروع و پایان یابد.
+
+پایه به طور خودکار به تمام آدرس‌های URL که با / شروع می‌شوند در سایر گزینه‌ها اضافه می‌شود، بنابراین فقط باید آن را یک بار مشخص کنید.
+
+```ts
+export default {
+ base: '/base/'
+}
+```
+
+## مسیریابی {#routing}
+
+### cleanUrls
+
+- نوع: `boolean`
+- پیش‌فرض: `false`
+
+وقتی تنظیم شود به `true`، ویت‌پرس `.html` انتهایی را از URL ها حذف می‌کند. همچنین ببینید [تولید URL تمیز](../guide/routing#generating-clean-url).
+
+::: هشدار نیاز به پشتیبانی سرور
+فعال کردن این ممکن است نیاز به پیکربندی اضافی در پلتفرم میزبان شما داشته باشد. برای اینکه کار کند، سرور شما باید بتواند `/foo.html` را زمانی که `/foo` بازدید می‌شود **بدون ریدایرکت** سرو کند.
+:::
+
+### rewrites
+
+- نوع: `Record`
+
+تعریف نقشه‌برداری‌های سفارشی دایرکتوری <-> URL. جزئیات بیشتر را در [مسیریابی: بازنویسی مسیرها](../guide/routing#route-rewrites) ببینید.
+
+```ts
+export default {
+ rewrites: {
+ 'source/:page': 'destination/:page'
+ }
+}
+```
+
+## ساخت {#build}
+
+### srcDir
+
+- نوع: `string`
+- پیش‌فرض: `.`
+
+دایرکتوری که صفحات مارک‌داون شما در آن ذخیره شده‌اند، نسبت به ریشه پروژه. همچنین ببینید [دایرکتوری ریشه و منبع](../guide/routing#root-and-source-directory).
+
+```ts
+export default {
+ srcDir: './src'
+}
+```
+
+### srcExclude
+
+- نوع: `string`
+- پیش‌فرض: `undefined`
+
+یک [الگوی glob](https://github.com/mrmlnc/fast-glob#pattern-syntax) برای تطبیق فایل‌های مارک‌داون که باید به عنوان محتوای منبع حذف شوند.
+
+```ts
+export default {
+ srcExclude: ['**/README.md', '**/TODO.md']
+}
+```
+
+### outDir
+
+- نوع: `string`
+- پیش‌فرض: `./.vitepress/dist`
+
+مکان خروجی ساخت برای سایت، نسبت به [ریشه پروژه](../guide/routing#root-and-source-directory).
+
+```ts
+export default {
+ outDir: '../public'
+}
+```
+
+### assetsDir
+
+- نوع: `string`
+- پیش‌فرض: `assets`
+
+دایرکتوری برای قرار دادن دارایی‌های تولید شده را مشخص کنید. مسیر باید داخل [`outDir`](#outdir) باشد و نسبت به آن حل شود.
+
+```ts
+export default {
+ assetsDir: 'static'
+}
+```
+
+### cacheDir
+
+- نوع: `string`
+- پیش‌فرض: `./.vitepress/cache`
+
+دایرکتوری برای فایل‌های کش، نسبت به [ریشه پروژه](../guide/routing#root-and-source-directory). همچنین ببینید: [cacheDir](https://vitejs.dev/config/shared-options.html#cachedir).
+
+```ts
+export default {
+ cacheDir: './.vitepress/.vite'
+}
+```
+
+### ignoreDeadLinks
+
+- نوع: `boolean | 'localhostLinks' | (string | RegExp | ((link: string) => boolean))[]`
+- پیش‌فرض: `false`
+
+زمانی که به `true` تنظیم شود، ویت‌پرس به دلیل لینک‌های مرده ساخت‌ها را شکست نخواهد داد.
+
+وقتی به `'localhostLinks'` تنظیم شود، ساخت بر روی لینک‌های مرده شکست خواهد خورد، اما لینک‌های `localhost` بررسی نخواهند شد.
+
+```ts
+export default {
+ ignoreDeadLinks: true
+}
+```
+
+همچنین می‌تواند یک آرایه از رشته‌های URL دقیق، الگوهای رگکس، یا توابع فیلتر سفارشی باشد.
+
+```ts
+export default {
+ ignoreDeadLinks: [
+ // نادیده گرفتن URL دقیق "/playground"
+ '/playground',
+ // نادیده گرفتن همه لینک‌های localhost
+ /^https?:\/\/localhost/,
+ // نادیده گرفتن همه لینک‌های شامل "/repl/""
+ /\/repl\//,
+ // تابع سفارشی، نادیده گرفتن همه لینک‌های شامل "ignore"
+ (url) => {
+ return url.toLowerCase().includes('ignore')
+ }
+ ]
+}
+```
+
+### metaChunk `
+
+`buildEnd` یک قلاب CLI ساخت است، که بعد از اتمام ساخت (SSG) اجرا می‌شود اما قبل از خروج از فرآیند CLI ویت‌پرس.
+
+```ts
+export default {
+ async buildEnd(siteConfig) {
+ // ...
+ }
+}
+```
+
+### postRender
+
+- نوع: `(context: SSGContext) => Awaitable`
+
+`postRender` یک قلاب ساخت است که زمانی که رندر SSG انجام شد، فراخوانی می‌شود. این امکان را به شما می‌دهد که محتوای teleports را در حین SSG مدیریت کنید.
+
+```ts
+export default {
+ async postRender(context) {
+ // ...
+ }
+}
+```
+
+```ts
+interface SSGContext {
+ content: string
+ teleports?: Record
+ [key: string]: any
+}
+```
+
+### transformHead
+
+- نوع: `(context: TransformContext) => Awaitable`
+
+`transformHead` یک قلاب ساخت است که برای تغییر head قبل از تولید هر صفحه استفاده می‌شود. این امکان را به شما می‌دهد که ورودی‌های head اضافه کنید که نمی‌توانند به صورت استاتیک به تنظیمات ویت‌پرس اضافه شوند. شما فقط باید ورودی‌های اضافی را برگردانید، آنها به صورت خودکار با موارد موجود ترکیب می‌شوند.
+
+::: warning هشدار
+هیچ‌چیزی را در داخل `context` تغییر ندهید.
+:::
+
+```ts
+export default {
+ async transform
+
+Head(context) {
+ // ...
+ }
+}
+```
+
+```ts
+interface TransformContext {
+ page: string // به عنوان مثال index.md (نسبت به srcDir)
+ assets: string[] // همه دارایی‌های غیر js/css به عنوان URL عمومی کاملاً حل شده
+ siteConfig: SiteConfig
+ siteData: SiteData
+ pageData: PageData
+ title: string
+ description: string
+ head: HeadConfig[]
+ content: string
+}
+```
+
+توجه داشته باشید که این قلاب فقط زمانی که سایت به صورت استاتیک تولید می‌شود فراخوانی می‌شود. در زمان توسعه فراخوانی نمی‌شود. اگر نیاز به اضافه کردن ورودی‌های head دینامیک در زمان توسعه دارید، می‌توانید به جای آن از قلاب [`transformPageData`](#transformpagedata) استفاده کنید:
+
+```ts
+export default {
+ transformPageData(pageData) {
+ pageData.frontmatter.head ??= []
+ pageData.frontmatter.head.push([
+ 'meta',
+ {
+ name: 'og:title',
+ content:
+ pageData.frontmatter.layout === 'home'
+ ? `ویت‌پرس`
+ : `${pageData.title} | ویت‌پرس`
+ }
+ ])
+ }
+}
+```
+
+#### مثال: اضافه کردن یک canonical URL `` {#example-adding-a-canonical-url-link}
+
+```ts
+export default {
+ transformPageData(pageData) {
+ const canonicalUrl = `https://example.com/${pageData.relativePath}`
+ .replace(/index\.md$/, '')
+ .replace(/\.md$/, '.html')
+
+ pageData.frontmatter.head ??= []
+ pageData.frontmatter.head.push([
+ 'link',
+ { rel: 'canonical', href: canonicalUrl }
+ ])
+ }
+}
+```
+
+### transformHtml
+
+- نوع: `(code: string, id: string, context: TransformContext) => Awaitable`
+
+`transformHtml` یک قلاب ساخت است که برای تغییر محتوای هر صفحه قبل از ذخیره به دیسک استفاده می‌شود.
+
+::: warning هشدار
+هیچ‌چیزی را در داخل `context` تغییر ندهید. همچنین، تغییر محتوای html ممکن است باعث مشکلات هیدراتاسیون در زمان اجرا شود.
+:::
+
+```ts
+export default {
+ async transformHtml(code, id, context) {
+ // ...
+ }
+}
+```
+
+### transformPageData
+
+- نوع: `(pageData: PageData, context: TransformPageContext) => Awaitable | { [key: string]: any } | void>`
+
+`transformPageData` یک قلاب است که برای تغییر `pageData` هر صفحه استفاده می‌شود. شما می‌توانید `pageData` را به صورت مستقیم تغییر دهید یا مقادیر تغییر یافته را برگردانید که به داده‌های صفحه ادغام خواهند شد.
+
+::: warning هشدار
+هیچ‌چیزی را در داخل `context` تغییر ندهید و دقت کنید که این ممکن است بر عملکرد سرور توسعه تاثیر بگذارد، به ویژه اگر در این قلاب درخواست‌های شبکه یا محاسبات سنگین (مانند تولید تصاویر) داشته باشید. می‌توانید برای منطق شرطی بررسی کنید `process.env.NODE_ENV === 'production'`.
+:::
+
+```ts
+export default {
+ async transformPageData(pageData, { siteConfig }) {
+ pageData.contributors = await getPageContributors(pageData.relativePath)
+ }
+
+ // یا داده‌ها را برای ادغام برگردانید
+ async transformPageData(pageData, { siteConfig }) {
+ return {
+ contributors: await getPageContributors(pageData.relativePath)
+ }
+ }
+}
+```
+
+```ts
+interface TransformPageContext {
+ siteConfig: SiteConfig
+}
+```
\ No newline at end of file
diff --git a/docs/ko/guide/custom-theme.md b/docs/ko/guide/custom-theme.md
index 6b319b4e..9c799f18 100644
--- a/docs/ko/guide/custom-theme.md
+++ b/docs/ko/guide/custom-theme.md
@@ -49,8 +49,7 @@ interface EnhanceAppContext {
테마 엔트리 파일은 테마(Theme 객체)를 "export default" 해야 합니다:
-```js
-// .vitepress/theme/index.js
+```js [.vitepress/theme/index.js]
// 테마 엔트리에서 Vue 파일을 직접 "import" 할 수 있습니다.
// VitePress는 @vitejs/plugin-vue가 사전 구성되어 있습니다.
@@ -72,8 +71,7 @@ export default {
가장 기본적인 레이아웃 컴포넌트는 [`Custom Layout!
@@ -172,8 +170,7 @@ const { page, frontmatter } = useData()
외부 테마를 사용하려면, 커스텀 테마 엔트리에서 테마를 "import" 후 다시 "export"합니다:
-```js
-// .vitepress/theme/index.js
+```js [.vitepress/theme/index.js]
import Theme from 'awesome-vitepress-theme'
export default Theme
@@ -181,8 +178,7 @@ export default Theme
테마를 확장해야 하는 경우:
-```js
-// .vitepress/theme/index.js
+```js [.vitepress/theme/index.js]
import Theme from 'awesome-vitepress-theme'
export default {
@@ -195,8 +191,7 @@ export default {
테마가 특별한 VitePress 구성을 요구하는 경우, 해당 구성을 (외부 커스텀 테마를 사용하는 자신의) 구성 파일에서도 확장해야 합니다:
-```ts
-// .vitepress/config.ts
+```ts [.vitepress/config.ts]
import baseConfig from 'awesome-vitepress-theme/config'
export default {
@@ -207,8 +202,7 @@ export default {
마지막으로 테마가 테마 구성에 대한 타입을 제공하는 경우:
-```ts
-// .vitepress/config.ts
+```ts [.vitepress/config.ts]
import baseConfig from 'awesome-vitepress-theme/config'
import { defineConfigWithTheme } from 'vitepress'
import type { ThemeConfig } from 'awesome-vitepress-theme'
diff --git a/docs/ko/guide/data-loading.md b/docs/ko/guide/data-loading.md
index c95b57be..9ac88f7a 100644
--- a/docs/ko/guide/data-loading.md
+++ b/docs/ko/guide/data-loading.md
@@ -8,8 +8,7 @@ VitePress는 페이지나 컴포넌트에서 임의의 데이터를 로드하고
데이터 로더 파일은 반드시 `.data.js` 또는 `.data.ts`로 끝나야 합니다. 이 파일은 `load()` 메서드를 가진 객체를 "export default" 해야 합니다:
-```js
-// example.data.js
+```js [example.data.js]
export default {
load() {
return {
@@ -84,8 +83,7 @@ export default {
콘텐츠가 많은 사이트를 구축할 때, 종종 "아카이브" 또는 "인덱스" 페이지를 만들어야 합니다. 이 페이지는 콘텐츠 모음에 있는 모든 항목(예: 블로그 게시물, API 페이지)을 나열하는 페이지입니다. 데이터 로더 API를 직접 사용하여 이를 구현할 수 있지만, VitePress는 이러한 일반적인 사용 사례를 간소화하기 위해 `createContentLoader` 헬퍼를 제공합니다:
-```js
-// posts.data.js
+```js [posts.data.js]
import { createContentLoader } from 'vitepress'
export default createContentLoader('posts/*.md', /* options */)
@@ -135,8 +133,7 @@ import { data as posts } from './posts.data.js'
기본 데이터가 모든 요구 사항에 충족하지 않을 수 있습니다. 옵션을 사용하여 데이터를 변환할 수 있습니다:
-```js
-// posts.data.js
+```js [posts.data.js]
import { createContentLoader } from 'vitepress'
export default createContentLoader('posts/*.md', {
@@ -162,8 +159,7 @@ export default createContentLoader('posts/*.md', {
`createContentLoader` API는 [빌드 훅](../reference/site-config#build-hooks) 내에서도 사용할 수 있습니다:
-```js
-// .vitepress/config.js
+```js [.vitepress/config.js]
export default {
async buildEnd() {
const posts = await createContentLoader('posts/*.md').load()
diff --git a/docs/ko/guide/deploy.md b/docs/ko/guide/deploy.md
index 145d7a78..797015da 100644
--- a/docs/ko/guide/deploy.md
+++ b/docs/ko/guide/deploy.md
@@ -10,7 +10,7 @@ outline: deep
- 기본 빌드 출력 디렉토리(`.vitepress/dist`)를 사용하고 있다.
- VitePress는 프로젝트의 로컬 종속성으로 설치되어 있으며, `package.json`에 다음 스크립트가 설정되어 있다:
- ```json
+ ```json [package.json]
{
"scripts": {
"docs:build": "vitepress build docs",
@@ -121,7 +121,7 @@ HTML 코드에 대해 _Auto Minify_ 옵션을 활성화하지 마세요. 이는
1. 프로젝트의 `.github/workflows` 디렉토리 안에 `deploy.yml`이라는 파일을 만들고 다음과 같은 내용을 추가하세요:
- ```yaml
+ ```yaml [.github/workflows/deploy.yml]
# VitePress 사이트를 GitHub Pages에 빌드하고 배포하는 샘플 워크플로우
#
name: VitePress 사이트를 Pages에 배포
@@ -203,7 +203,7 @@ HTML 코드에 대해 _Auto Minify_ 옵션을 활성화하지 마세요. 이는
2. 변경 사항을 적용할 때마다 사이트를 빌드하고 배포하도록 하기 위해 프로젝트의 루트에 다음 내용을 가진 `.gitlab-ci.yml` 파일을 생성하세요:
- ```yaml
+ ```yaml [.gitlab-ci.yml]
image: node:18
pages:
cache:
@@ -236,7 +236,7 @@ HTML 코드에 대해 _Auto Minify_ 옵션을 활성화하지 마세요. 이는
`firebase.json`:
- ```json
+ ```json [firebase.json]
{
"hosting": {
"public": "docs/.vitepress/dist",
@@ -247,7 +247,7 @@ HTML 코드에 대해 _Auto Minify_ 옵션을 활성화하지 마세요. 이는
`.firebaserc`:
- ```json
+ ```json [.firebaserc]
{
"projects": {
"default": ""
@@ -275,7 +275,7 @@ HTML 코드에 대해 _Auto Minify_ 옵션을 활성화하지 마세요. 이는
2. 프로젝트 루트에 아래 내용을 포함한 `static.json` 파일을 생성하세요:
- ```json
+ ```json [static.json]
{
"root": "docs/.vitepress/dist"
}
diff --git a/docs/ko/guide/extending-default-theme.md b/docs/ko/guide/extending-default-theme.md
index 30c97996..6e64646f 100644
--- a/docs/ko/guide/extending-default-theme.md
+++ b/docs/ko/guide/extending-default-theme.md
@@ -22,8 +22,7 @@ VitePress의 기본 테마는 문서화에 최적화되어 있으며, 커스텀
기본 테마의 CSS는 루트 레벨의 CSS 변수를 재정의하여 커스터마이징 할 수 있습니다:
-```js
-// .vitepress/theme/index.js
+```js [.vitepress/theme/index.js]
import DefaultTheme from 'vitepress/theme'
import './custom.css'
@@ -46,8 +45,7 @@ VitePress는 기본 폰트로 [Inter](https://rsms.me/inter/)를 사용하며,
빌드 결과물에 Inter를 포함시키지 않으려면, `vitepress/theme-without-fonts`에서 테마를 "import" 합니다:
-```js
-// .vitepress/theme/index.js
+```js [.vitepress/theme/index.js]
import DefaultTheme from 'vitepress/theme-without-fonts'
import './my-fonts.css'
@@ -68,8 +66,7 @@ export default DefaultTheme
폰트가 `@font-face`를 통해 참조된 로컬 파일인 경우, 에셋으로 처리되어 해시된 파일 이름으로 `.vitepress/dist/assets`에 포함됩니다. 이 파일을 미리 로드하려면 [transformHead](../reference/site-config#transformhead) 빌드 훅을 사용해야 합니다:
-```js
-// .vitepress/config.js
+```js [.vitepress/config.js]
export default {
transformHead({ assets }) {
// 폰트를 매칭하기 위해 정규식을 적절히 조정하세요
@@ -94,8 +91,7 @@ export default {
## 전역 컴포넌트 등록하기 {#registering-global-components}
-```js
-// .vitepress/theme/index.js
+```js [.vitepress/theme/index.js]
import DefaultTheme from 'vitepress/theme'
/** @type {import('vitepress').Theme} */
@@ -109,8 +105,7 @@ export default {
```
TypeScript를 사용하는 경우:
-```ts
-// .vitepress/theme/index.ts
+```ts [.vitepress/theme/index.ts]
import type { Theme } from 'vitepress'
import DefaultTheme from 'vitepress/theme'
@@ -129,8 +124,7 @@ Vite를 사용하므로, Vite의 [glob import 기능](https://vitejs.dev/guide/f
기본 테마의 `
` رندر می‌شوند. اگر می‌خواهید عناصر بلوکی را اضافه کنید، در نظر داشته باشید که به جای این، از [اسلات `layout-bottom`](../guide/extending-default-theme#layout-slots) استفاده کنید.
+:::
+
+توجه داشته باشید که پاورقی نمایش داده نمی‌شود زمانی که [نوار کناری](./default-theme-sidebar) قابل مشاهده باشد.
+
+## پیکربندی Frontmatter {#frontmatter-config}
+
+این می‌تواند برای هر صفحه با استفاده از گزینه `footer` در frontmatter غیرفعال شود:
+
+```yaml
+---
+footer: false
+---
+```
\ No newline at end of file
diff --git a/docs/fa/reference/default-theme-home-page.md b/docs/fa/reference/default-theme-home-page.md
new file mode 100644
index 00000000..10f04e41
--- /dev/null
+++ b/docs/fa/reference/default-theme-home-page.md
@@ -0,0 +1,193 @@
+# صفحه اصلی {#home-page}
+
+قالب پیش‌فرض ویت‌پرس یک طرح صفحه اصلی فراهم می‌کند که می‌توانید آن را همچنین در [صفحه اصلی این سایت](../) مشاهده کنید. شما می‌توانید آن را در هر یک از صفحات خود با تعیین `layout: home` در [frontmatter](./frontmatter-config) استفاده کنید.
+
+```yaml
+---
+layout: home
+---
+```
+
+اما این گزینه به تنهایی خیلی کاربردی نخواهد بود. شما می‌توانید با اضافه کردن بخش‌های "قالب‌های پیش‌فرض" مختلف، چندین بخش متفاوت را به صفحه اصلی اضافه کنید مانند `hero` و `features`.
+
+## بخش Hero {#hero-section}
+
+بخش Hero در بالای صفحه اصلی قرار دارد. در ادامه می‌توانید نحوه پیکربندی بخش Hero را ببینید.
+
+```yaml
+---
+layout: home
+
+hero:
+ name: ویت‌پرس
+ text: Vite & Vue powered static site generator.
+ tagline: Lorem ipsum...
+ image:
+ src: /logo.png
+ alt: ویت‌پرس
+ actions:
+ - theme: brand
+ text: Get Started
+ link: /guide/what-is-vitepress
+ - theme: alt
+ text: View on GitHub
+ link: https://github.com/vuejs/vitepress
+---
+```
+
+```ts
+interface Hero {
+ // رشته نمایش داده شده در بالای `text`. همراه با رنگ برند و انتظار می‌رود که کوتاه باشد، مانند نام محصول.
+ name?: string
+
+ // متن اصلی بخش Hero. این به عنوان تگ `h1` تعریف می‌شود.
+ text: string
+
+ // تگ‌لاین نمایش داده شده زیر `text`.
+ tagline?: string
+
+ // تصویر که در کنار ناحیه متن و تگ‌لاین نمایش داده می‌شود.
+ image?: ThemeableImage
+
+ // دکمه‌های اقدام برای نمایش در بخش Hero صفحه اصلی.
+ actions?: HeroAction[]
+}
+
+type ThemeableImage =
+ | string
+ | { src: string; alt?: string }
+ | { light: string; dark: string; alt?: string }
+
+interface HeroAction {
+ // رنگ تم دکمه. به طور پیش‌فرض `brand` است.
+ theme?: 'brand' | 'alt'
+
+ // برچسب دکمه.
+ text: string
+
+ // مقصد لینک دکمه.
+ link: string
+
+ // ویژگی هدف لینک.
+ target?: string
+
+ // ویژگی rel لینک.
+ rel?: string
+}
+```
+
+### سفارشی‌سازی رنگ نام {#customizing-the-name-color}
+
+ویت‌پرس از رنگ برند (`--vp-c-brand-1`) برای `name` استفاده می‌کند. با این حال، شما می‌توانید این رنگ را با جایگذاری متغیر `--vp-home-hero-name-color` سفارشی کنید.
+
+```css
+:root {
+ --vp-home-hero-name-color: blue;
+}
+```
+
+همچنین می‌توانید با ترکیب `--vp-home-hero-name-background`، رنگ گرادیانت `name` را تعیین کنید.
+
+```css
+:root {
+ --vp-home-hero-name-color: transparent;
+ --vp-home-hero-name-background: -webkit-linear-gradient(120deg, #bd34fe, #41d1ff);
+}
+```
+
+## {#features-section} بخش ویژگی‌ها
+
+در بخش ویژگی‌ها، می‌توانید هر تعدادی ویژگی که مایلید پس از بخش Hero نمایش دهید، لیست کنید. برای پیکربندی آن، گزینه `features` را به frontmatter ارسال کنید.
+
+می‌توانید برای هر ویژگی آیکونی ارائه دهید که می‌تواند یک ایموجی یا هر نوع تصویر دیگری باشد. زمانی که آیکون پیکربندی شده یک تصویر است (svg، png، jpeg...). باید آیکون را با عرض و ارتفاع مناسب ارائه دهید. شما همچنین می‌توانید توضیحات، اندازه داخلی آن و نسخه‌های آن برای تم تاریک و روشن را ارائه دهید هنگام لزوم.
+
+```yaml
+---
+layout: home
+
+features:
+ - icon: 🛠️
+ title: ساده و کم حجم، همیشه
+ details: Lorem ipsum...
+ - icon:
+ src: /cool-feature-icon.svg
+ title: ویژگی جالب دیگر
+ details: Lorem ipsum...
+ - icon:
+ dark: /dark-feature-icon.svg
+ light: /light-feature-icon.svg
+ title: ویژگی جالب دیگر
+ details: Lorem ipsum...
+---
+```
+
+```ts
+interface Feature {
+ // نمایش آیکون در هر جعبه ویژگی.
+ icon?: FeatureIcon
+
+ // عنوان ویژگی.
+ title: string
+
+ // جزئیات ویژگی.
+ details: string
+
+ // لینک زمانی که بر روی جزئیات کلیک می‌کنید. لینک می‌تواند داخلی یا خارجی باشد.
+ //
+ // به عنوان مثال: `guide/reference/default-theme-home-page` یا `https://example.com`
+ link?: string
+
+ // متن لینکی که داخل جزئیات کامپوننت نمایش داده می‌شود. بهتر است با گزینه `link` استفاده شود.
+ //
+ // به عنوان مثال: `بیشتر بدانید`، `صفحه بازدید` و غیره.
+ linkText?: string
+
+ // ویژگی rel لینک برای گزینه `link`.
+ //
+ // به عنوان مثال: `external`
+ rel?: string
+
+ // ویژگی target لینک برای گزینه `link`.
+ target?: string
+}
+
+type FeatureIcon =
+ | string
+ | { src: string; alt?: string; width?: string; height: string }
+ | {
+ light: string
+ dark: string
+ alt?: string
+ width?: string
+ height: string
+ }
+```
+
+## محتوای Markdown {#markdown-content}
+
+می‌توانید محتوای اضافی را به صفحه اصلی سایت خود اضافه کنید فقط با افزودن Markdown زیر تقسیم‌کننده `---` در پایین frontmatter.
+
+````md
+---
+layout: home
+
+hero:
+ name
+
+: ویت‌پرس
+ text: Vite & Vue powered static site generator.
+---
+
+## شروع کردن
+
+می‌توانید بلافاصله با استفاده از `npx` از ویت‌پرس شروع کنید!
+
+```sh
+npm init
+npx vitepress init
+```
+````
+
+::: info اطلاعات
+ویت‌پرس همیشه استایل اضافی محتوای صفحه `layout: home` را خودکار نمی‌کند. برای بازگشت به رفتار قدیمی، می‌توانید `markdownStyles: false` را به frontmatter اضافه کنید.
+:::
\ No newline at end of file
diff --git a/docs/fa/reference/default-theme-last-updated.md b/docs/fa/reference/default-theme-last-updated.md
new file mode 100644
index 00000000..08b8641c
--- /dev/null
+++ b/docs/fa/reference/default-theme-last-updated.md
@@ -0,0 +1,27 @@
+# آخرین بروزرسانی {#last-updated}
+
+زمان به روزرسانی آخرین محتوا در گوشه پایین سمت راست صفحه نمایش داده خواهد شد. برای فعال‌سازی آن، گزینه `lastUpdated` را به پیکربندی خود اضافه کنید.
+
+::: tip نکته
+برای دیدن زمان به‌روزرسانی، باید فایل Markdown را commit کنید.
+:::
+
+## پیکربندی سطح سایت {#site-level-config}
+
+```js
+export default {
+ lastUpdated: true
+}
+```
+
+## پیکربندی Frontmatter {#frontmatter-config}
+
+می‌توانید این امکان را برای هر صفحه با استفاده از گزینه `lastUpdated` در frontmatter غیرفعال کنید:
+
+```yaml
+---
+lastUpdated: false
+---
+```
+
+همچنین به [پیکربندی پیش‌فرض: آخرین بروزرسانی](./default-theme-config#lastupdated) مراجعه کنید تا اطلاعات بیشتری دریافت کنید. هر مقدار حقیقی در سطح تم از ویژگی را فعال خواهد کرد مگر آنکه به صورت صریح در سطح سایت یا صفحه غیرفعال شود.
\ No newline at end of file
diff --git a/docs/fa/reference/default-theme-layout.md b/docs/fa/reference/default-theme-layout.md
new file mode 100644
index 00000000..2d488072
--- /dev/null
+++ b/docs/fa/reference/default-theme-layout.md
@@ -0,0 +1,62 @@
+# طرح بندی {#layout}
+
+می‌توانید طرح صفحه را با تنظیم گزینه `layout` در [frontmatter](./frontmatter-config) صفحه انتخاب کنید. سه گزینه طرح وجود دارد، `doc`، `page` و `home`. اگر هیچ چیز مشخص نشده باشد، صفحه به عنوان صفحه `doc` در نظر گرفته می‌شود.
+
+```yaml
+---
+layout: doc
+---
+```
+
+## طرح Doc {#doc-layout}
+
+گزینه `doc` طرح پیش‌فرض است و تمام محتوای Markdown را به "نمایشگاه" درست می‌کند. این با پوشاندن کل محتوا در داخل کلاس css `vp-doc` کار می‌کند و استایل‌های لازم را بر روی عناصر زیرش اعمال می‌کند.
+
+تقریباً همه عناصر عمومی مانند `p` یا `h2` استایل‌های خاصی دارند. بنابراین، به یاد داشته باشید که اگر HTML سفارشی‌ای درون محتوای Markdown اضافه کنید، این استایل‌ها روی آنها هم اعمال خواهند شد.
+
+این طرح ویژگی‌های خاص مستندسازی زیر را فراهم می‌کند. این ویژگی‌ها فقط در این طرح فعال هستند.
+
+- پیوند ویرایش
+- پیوند قبلی و بعدی
+- ساختار
+- [تبلیغات Carbon](./default-theme-carbon-ads)
+
+## طرح Page {#page-layout}
+
+گزینه `page` به عنوان "صفحه خالی" در نظر گرفته می‌شود. Markdown همچنان تجزیه و تحلیل می‌شود و تمامی [توسعه‌های Markdown](../guide/markdown) به عنوان طرح `doc` کار می‌کنند، اما هیچ استایل پیش‌فرضی به آن اعمال نمی‌شود.
+
+طرح صفحه به شما این امکان را می‌دهد که همه چیز را به دلخواه خود شخصی‌سازی کنید بدون این که طرح ویت‌پرس بر روی مارک‌آپ تاثیر بگذارد. این کار بسیار مفید است زمانی که می‌خواهید صفحه سفارشی خود را ایجاد کنید.
+
+توجه داشته باشید که حتی در این طرح، نوار کناری نیز نمایش داده می‌شود اگر صفحه دارای پیکربندی نوار کناری مطابق باشد.
+
+## طرح Home {#home-layout}
+
+گزینه `home` صفحه "خانه" قالب‌بندی می‌کند. در این طرح، می‌توانید گزینه‌های اضافی مانند `hero` و `features` را برای دلخواه‌سازی محتوا تنظیم کنید. لطفاً [صفحه پیش‌فرض: صفحه خانه](./default-theme-home-page) را برای اطلاعات بیشتر مشاهده کنید.
+
+## بدون طرح {#no-layout}
+
+اگر نمی‌خواهید هیچ طرحی داشته باشید، می‌توانید با گذراندن `layout: false` از frontmatter، از این گزینه استفاده کنید. این گزینه مفید است اگر صفحهٔ نخستی کاملاً قابل تنظیم (بدون هیچ نوار کناری، نوار ناوبری یا پاورقی به صورت پیش‌فرض) را می‌خواهید.
+
+## طرح سفارشی {#custom-layout}
+
+همچنین می‌توانید از یک طرح سفارشی استفاده کنید:
+
+```md
+---
+layout: foo
+---
+```
+
+این دستور به دنبال یک کامپوننت به نام `foo` ثبت شده در محیط است. به عنوان مثال، می‌توانید کامپوننت خود را به صورت گلوبال در `.vitepress/theme/index.ts` ثبت کنید:
+
+```ts
+import DefaultTheme from 'vitepress/theme'
+import Foo from './Foo.vue'
+
+export default {
+ extends: DefaultTheme,
+ enhanceApp({ app }) {
+ app.component('foo', Foo)
+ }
+}
+```
\ No newline at end of file
diff --git a/docs/fa/reference/default-theme-nav.md b/docs/fa/reference/default-theme-nav.md
new file mode 100644
index 00000000..eafc5b53
--- /dev/null
+++ b/docs/fa/reference/default-theme-nav.md
@@ -0,0 +1,215 @@
+# ناوبری {#nav}
+
+ناوبری نوار ناوبری است که در بالای صفحه نمایش داده می‌شود و شامل عنوان سایت، لینک‌های منوی جهانی، و غیره می‌باشد.
+
+## عنوان سایت و لوگو {#site-title-and-logo}
+
+به طور پیش‌فرض، ناو نام سایت را با ارجاع به مقدار [`config.title`](./site-config#title) نمایش می‌دهد. اگر می‌خواهید تغییر دهید که چه چیزی در ناو نمایش داده شود، می‌توانید متن سفارشی را در گزینه `themeConfig.siteTitle` تعریف کنید.
+
+```js
+export default {
+ themeConfig: {
+ siteTitle: 'عنوان سفارشی من'
+ }
+}
+```
+
+اگر برای سایت خود لوگو دارید، می‌توانید آن را با ارسال مسیر تصویر نمایش دهید. شما باید لوگو را در دایرکتوری `public` قرار داده و مسیر مطلق آن را تعریف کنید.
+
+```js
+export default {
+ themeConfig: {
+ logo: '/my-logo.svg'
+ }
+}
+```
+
+هنگام افزودن یک لوگو، آن به همراه عنوان سایت نمایش داده می‌شود. اگر لوگوی شما همه چیزی است که نیاز دارید و اگر می‌خواهید متن عنوان سایت را پنهان کنید، گزینه `siteTitle` را برابر با `false` قرار دهید.
+
+```js
+export default {
+ themeConfig: {
+ logo: '/my-logo.svg',
+ siteTitle: false
+ }
+}
+```
+
+همچنین می‌توانید به عنوان لوگو یک شیء را نیز ارسال کنید اگر می‌خواهید ویژگی `alt` را اضافه کنید یا آن را بر اساس حالت تاریک / روشن سفارشی‌سازی کنید. برای جزئیات بیشتر به [`themeConfig.logo`](./default-theme-config#logo) مراجعه کنید.
+
+## لینک‌های ناوبری {#navigation-links}
+
+شما می‌توانید گزینه `themeConfig.nav` را تعریف کنید تا لینک‌ها را به ناوبری خود اضافه کنید.
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'راهنما', link: '/guide' },
+ { text: 'پیکربندی', link: '/config' },
+ { text: 'تغییرات', link: 'https://github.com/...' }
+ ]
+ }
+}
+```
+
+`text` متن واقعی است که در ناوبری نمایش داده می‌شود و `link` لینکی است که هنگام کلیک بر روی متن به آن ناوبری می‌شود. برای لینک، مسیر را به صورت واقعی بدون پیشوند `.md` تنظیم کنید و همیشه با `/` شروع کنید.
+
+لینک‌های ناوبری همچنین می‌توانند منوهای کشویی باشند. برای این کار، کلید `items` را در گزینه لینک تنظیم کنید.
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'راهنما', link: '/guide' },
+ {
+ text: 'منوی کشویی',
+ items: [
+ { text: 'مورد الف', link: '/item-1' },
+ { text: 'مورد ب', link: '/item-2' },
+ { text: 'مورد ج', link: '/item-3' }
+ ]
+ }
+ ]
+ }
+}
+```
+
+لطفا توجه داشته باشید که عنوان منوی کشویی (`منوی کشویی` در مثال بالا) نمی‌تواند خاصیت `link` داشته باشد زیرا این دکمه برای باز کردن صفحه گفتگوی کشویی می‌شود.
+
+همچنین می‌توانید بخش‌هایی را نیز به موارد منوی کشویی با ارسال موارد بیشتر تو در تو اضافه کنید.
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'راهنما', link: '/guide' },
+ {
+ text: 'منوی کشویی',
+ items: [
+ {
+ // عنوان بخش
+ text: 'عنوان بخش A',
+ items: [
+ { text: 'آیتم A بخش A', link: '...' },
+ { text: 'آیتم B بخش B', link: '...' }
+ ]
+ }
+ ]
+ },
+ {
+ text: 'منوی کشویی',
+ items: [
+ {
+ // شما همچنین می‌توانید عنوان را حذف کنید.
+ items: [
+ { text: 'آیتم A بخش A', link: '...' },
+ { text: 'آیتم B بخش B', link: '...' }
+ ]
+ }
+ ]
+ }
+ ]
+ }
+}
+```
+
+### سفارشی‌سازی وضعیت "فعال" لینک {#customize-link-s-active-state}
+
+موارد منوی ناوبری زمانی که صفحه فعلی زیر مسیر مطابقت دارد، مشخص می‌شوند. اگر می‌خواهید مسیر مطابقت را سفارشی کنید، ویژگی `activeMatch` و regex را به عنوان مقدار رشته تعریف کنید.
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ // این لینک وضعیت فعال را در زمانی که کاربر در مسیر `/config/` است، دریافت می‌کند.
+ {
+ text: 'راهنما',
+ link: '/guide',
+ activeMatch: '/config/'
+ }
+ ]
+ }
+}
+```
+
+::: warning هشدار
+`activeMatch` انتظار می‌رود که به عنوان یک رشته regex باشد، اما شما باید آن را به عنوان یک رشته تعریف کنید. ما نمی‌توانیم از شیء RegExp واقعی اینجا استفاده کنیم زیرا در زمان ساخت غیر قابل سریالیز کردن است.
+:::
+
+### سفارشی‌سازی ویژگی‌های "target" و "rel" لینک {#customize-link-s-target-and-rel-attributes}
+
+به طور پیش‌فرض، ویت‌پرس به طور خودکار ویژگی‌های
+
+`target` و `rel` را بر اساس اینکه لینک یک لینک خارجی است یا خیر، تعیین می‌کند. اما اگر می‌خواهید، شما همچنین می‌توانید آنها را سفارشی کنید.
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ {
+ text: 'کالای معاملاتی',
+ link: 'https://www.thegithubshop.com/',
+ target: '_self',
+ rel: 'sponsored'
+ }
+ ]
+ }
+}
+```
+
+## لینک‌های اجتماعی {#social-links}
+
+به [`socialLinks`](./default-theme-config#sociallinks) مراجعه کنید.
+
+## اجزای سفارشی
+
+می‌توانید اجزای سفارشی را در نوار ناوبری با استفاده از گزینه `component` اضافه کنید. کلید `component` باید نام مؤلفه Vue باشد و باید به صورت جهانی با استفاده از [Theme.enhanceApp](../guide/custom-theme#theme-interface) ثبت شود.
+
+```js [.vitepress/config.js]
+export default {
+ themeConfig: {
+ nav: [
+ {
+ text: 'منوی من',
+ items: [
+ {
+ component: 'MyCustomComponent',
+ // پارامترهای اختیاری برای ارسال به مؤلفه
+ props: {
+ title: 'مؤلفه سفارشی من'
+ }
+ }
+ ]
+ },
+ {
+ component: 'AnotherCustomComponent'
+ }
+ ]
+ }
+}
+```
+
+سپس، شما باید مؤلفه را به صورت جهانی ثبت کنید:
+
+```js [.vitepress/theme/index.js]
+import DefaultTheme from 'vitepress/theme'
+
+import MyCustomComponent from './components/MyCustomComponent.vue'
+import AnotherCustomComponent from './components/AnotherCustomComponent.vue'
+
+/** @type {import('vitepress').Theme} */
+export default {
+ extends: DefaultTheme,
+ enhanceApp({ app }) {
+ app.component('MyCustomComponent', MyCustomComponent)
+ app.component('AnotherCustomComponent', AnotherCustomComponent)
+ }
+}
+```
+
+اجزای شما در نوار ناوبری نمایش داده خواهد شد. ویت‌پرس ویژگی‌های اضافی زیر را به مؤلفه ارائه می‌دهد:
+
+- `screenMenu`: یک بولین اختیاری که نشان می‌دهد آیا مؤلفه در منوی ناوبری تلفن همراه است یا خیر
+
+می‌توانید یک نمونه را در آزمایش‌های e2e [اینجا](https://github.com/vuejs/vitepress/tree/main/__tests__/e2e/.vitepress) بررسی کنید.
diff --git a/docs/fa/reference/default-theme-prev-next-links.md b/docs/fa/reference/default-theme-prev-next-links.md
new file mode 100644
index 00000000..e17358cc
--- /dev/null
+++ b/docs/fa/reference/default-theme-prev-next-links.md
@@ -0,0 +1,43 @@
+# پیوندهای قبلی و بعدی {#prev-next-links}
+
+شما می‌توانید متن و پیوند برای صفحات قبلی و بعدی را سفارشی‌سازی کنید (نمایش داده شده در پایین صفحه مستندات). این مفید است اگر می‌خواهید متن دیگری را در این قسمت نمایش دهید که با آنچه در نوار کناری دارید، متفاوت باشد. همچنین، ممکن است مفید باشد که فوتر را غیرفعال کنید یا به یک صفحه لینک کنید که در نوار کناری شما وجود ندارد.
+
+## prev
+
+- نوع: `string | false | { text?: string; link?: string }`
+
+- جزئیات:
+
+ مشخص می‌کند متن/لینکی که برای لینک به صفحه قبلی نمایش داده خواهد شد. اگر این را در frontmatter تنظیم نکنید، متن/لینک از تنظیمات نوار کناری استخراج خواهد شد.
+
+- مثال‌ها:
+
+ - برای فقط سفارشی‌سازی متن:
+
+ ```yaml
+ ---
+ prev: 'شروع کنید | مارک‌داون'
+ ---
+ ```
+
+ - برای سفارشی‌سازی هم متن و هم لینک:
+
+ ```yaml
+ ---
+ prev:
+ text: 'مارک‌داون'
+ link: '/guide/markdown'
+ ---
+ ```
+
+ - برای مخفی کردن صفحه قبلی:
+
+ ```yaml
+ ---
+ prev: false
+ ---
+ ```
+
+## next
+
+مشابه `prev` اما برای صفحه بعدی.
diff --git a/docs/fa/reference/default-theme-search.md b/docs/fa/reference/default-theme-search.md
new file mode 100644
index 00000000..dd325c9f
--- /dev/null
+++ b/docs/fa/reference/default-theme-search.md
@@ -0,0 +1,386 @@
+---
+outline: deep
+---
+
+# جستجو {#search}
+
+## جستجوی محلی {#local-search}
+
+ویت‌پرس از جستجوی متن کامل نامتقارن با استفاده از یک فهرست در مرورگر با تشکر از [minisearch](https://github.com/lucaong/minisearch/) پشتیبانی می‌کند. برای فعال‌سازی این ویژگی، کافی است گزینه `themeConfig.search.provider` را به `'local'` در فایل `.vitepress/config.ts` خود تنظیم کنید:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local'
+ }
+ }
+})
+```
+
+نمونه نتیجه:
+
+
+
+همچنین، می‌توانید از [Algolia DocSearch](#algolia-search) یا برخی افزونه‌های جامعه‌ای مانند ` نمایش داده می‌شود. از اسلات‌های `#title` و `#lead` برای مستندسازی در مورد تیم خود استفاده کنید.
+
+`
{{ theme.footer.copyright }}
+
+```
+
+## `useRoute` چیدمان شخصی!
+ ` آن صفحه ترکیب می‌شود با `title` جهانی به عنوان پسوند. به عنوان مثال با تنظیمات زیر و محتوای صفحه:
+
+```ts
+export default {
+ title: 'سایت فوق‌العاده من'
+}
+```
+
+```md
+# سلام
+```
+
+عنوان صفحه خواهد بود `سلام | سایت فوق‌العاده من`.
+
+### قالب عنوان {##titletemplate}
+
+- نوع: `string | boolean`
+- می‌تواند به ازای هر صفحه از طریق [frontmatter](./frontmatter-config#titletemplate) جایگزین شود.
+
+اجازه می‌دهد پسوند عنوان هر صفحه یا کل عنوان را سفارشی کنید. به عنوان مثال:
+
+```ts
+export default {
+ title: 'سایت فوق‌العاده من',
+ titleTemplate: 'پسوند سفارشی'
+}
+```
+
+```md
+# سلام
+```
+
+عنوان صفحه خواهد بود `سلام | پسوند سفارشی`.
+
+برای سفارشی کردن کامل نحوه نمایش عنوان، می‌توانید از نماد `:title` در `titleTemplate` استفاده کنید:
+
+```ts
+export default {
+ titleTemplate: ':title - پسوند سفارشی'
+}
+```
+
+اینجا `:title` با متن استنباط شده از اولین هدر `
` صفحه جایگزین می‌شود. عنوان صفحه مثال قبلی خواهد بود `سلام - پسوند سفارشی`.
+
+این گزینه می‌تواند به `false` تنظیم شود تا پسوندهای عنوان غیرفعال شوند.
+
+### توضیحات {#description}
+
+- نوع: `string`
+- پیش‌فرض: `یک سایت ویت‌پرس`
+- می‌تواند به ازای هر صفحه از طریق [frontmatter](./frontmatter-config#description) جایگزین شود.
+
+توضیحات برای سایت. این به عنوان یک تگ `` در HTML صفحه رندر خواهد شد.
+
+```ts
+export default {
+ description: 'یک سایت ویت‌پرس'
+}
+```
+
+### head
+
+- نوع: `HeadConfig[]`
+- پیش‌فرض: `[]`
+- می‌تواند به ازای هر صفحه از طریق [frontmatter](./frontmatter-config#head) افزوده شود.
+
+عناصر اضافی برای رندر در تگ `` در HTML صفحه. تگ‌های افزوده شده توسط کاربر قبل از بسته شدن تگ `head`، پس از تگ‌های ویت‌پرس رندر می‌شوند.
+
+```ts
+type HeadConfig =
+ | [string, Record
Custom Layout!
@@ -172,8 +170,7 @@ const { page, frontmatter } = useData()
외부 테마를 사용하려면, 커스텀 테마 엔트리에서 테마를 "import" 후 다시 "export"합니다:
-```js
-// .vitepress/theme/index.js
+```js [.vitepress/theme/index.js]
import Theme from 'awesome-vitepress-theme'
export default Theme
@@ -181,8 +178,7 @@ export default Theme
테마를 확장해야 하는 경우:
-```js
-// .vitepress/theme/index.js
+```js [.vitepress/theme/index.js]
import Theme from 'awesome-vitepress-theme'
export default {
@@ -195,8 +191,7 @@ export default {
테마가 특별한 VitePress 구성을 요구하는 경우, 해당 구성을 (외부 커스텀 테마를 사용하는 자신의) 구성 파일에서도 확장해야 합니다:
-```ts
-// .vitepress/config.ts
+```ts [.vitepress/config.ts]
import baseConfig from 'awesome-vitepress-theme/config'
export default {
@@ -207,8 +202,7 @@ export default {
마지막으로 테마가 테마 구성에 대한 타입을 제공하는 경우:
-```ts
-// .vitepress/config.ts
+```ts [.vitepress/config.ts]
import baseConfig from 'awesome-vitepress-theme/config'
import { defineConfigWithTheme } from 'vitepress'
import type { ThemeConfig } from 'awesome-vitepress-theme'
diff --git a/docs/ko/guide/data-loading.md b/docs/ko/guide/data-loading.md
index c95b57be..9ac88f7a 100644
--- a/docs/ko/guide/data-loading.md
+++ b/docs/ko/guide/data-loading.md
@@ -8,8 +8,7 @@ VitePress는 페이지나 컴포넌트에서 임의의 데이터를 로드하고
데이터 로더 파일은 반드시 `.data.js` 또는 `.data.ts`로 끝나야 합니다. 이 파일은 `load()` 메서드를 가진 객체를 "export default" 해야 합니다:
-```js
-// example.data.js
+```js [example.data.js]
export default {
load() {
return {
@@ -84,8 +83,7 @@ export default {
콘텐츠가 많은 사이트를 구축할 때, 종종 "아카이브" 또는 "인덱스" 페이지를 만들어야 합니다. 이 페이지는 콘텐츠 모음에 있는 모든 항목(예: 블로그 게시물, API 페이지)을 나열하는 페이지입니다. 데이터 로더 API를 직접 사용하여 이를 구현할 수 있지만, VitePress는 이러한 일반적인 사용 사례를 간소화하기 위해 `createContentLoader` 헬퍼를 제공합니다:
-```js
-// posts.data.js
+```js [posts.data.js]
import { createContentLoader } from 'vitepress'
export default createContentLoader('posts/*.md', /* options */)
@@ -135,8 +133,7 @@ import { data as posts } from './posts.data.js'
기본 데이터가 모든 요구 사항에 충족하지 않을 수 있습니다. 옵션을 사용하여 데이터를 변환할 수 있습니다:
-```js
-// posts.data.js
+```js [posts.data.js]
import { createContentLoader } from 'vitepress'
export default createContentLoader('posts/*.md', {
@@ -162,8 +159,7 @@ export default createContentLoader('posts/*.md', {
`createContentLoader` API는 [빌드 훅](../reference/site-config#build-hooks) 내에서도 사용할 수 있습니다:
-```js
-// .vitepress/config.js
+```js [.vitepress/config.js]
export default {
async buildEnd() {
const posts = await createContentLoader('posts/*.md').load()
diff --git a/docs/ko/guide/deploy.md b/docs/ko/guide/deploy.md
index 145d7a78..797015da 100644
--- a/docs/ko/guide/deploy.md
+++ b/docs/ko/guide/deploy.md
@@ -10,7 +10,7 @@ outline: deep
- 기본 빌드 출력 디렉토리(`.vitepress/dist`)를 사용하고 있다.
- VitePress는 프로젝트의 로컬 종속성으로 설치되어 있으며, `package.json`에 다음 스크립트가 설정되어 있다:
- ```json
+ ```json [package.json]
{
"scripts": {
"docs:build": "vitepress build docs",
@@ -121,7 +121,7 @@ HTML 코드에 대해 _Auto Minify_ 옵션을 활성화하지 마세요. 이는
1. 프로젝트의 `.github/workflows` 디렉토리 안에 `deploy.yml`이라는 파일을 만들고 다음과 같은 내용을 추가하세요:
- ```yaml
+ ```yaml [.github/workflows/deploy.yml]
# VitePress 사이트를 GitHub Pages에 빌드하고 배포하는 샘플 워크플로우
#
name: VitePress 사이트를 Pages에 배포
@@ -203,7 +203,7 @@ HTML 코드에 대해 _Auto Minify_ 옵션을 활성화하지 마세요. 이는
2. 변경 사항을 적용할 때마다 사이트를 빌드하고 배포하도록 하기 위해 프로젝트의 루트에 다음 내용을 가진 `.gitlab-ci.yml` 파일을 생성하세요:
- ```yaml
+ ```yaml [.gitlab-ci.yml]
image: node:18
pages:
cache:
@@ -236,7 +236,7 @@ HTML 코드에 대해 _Auto Minify_ 옵션을 활성화하지 마세요. 이는
`firebase.json`:
- ```json
+ ```json [firebase.json]
{
"hosting": {
"public": "docs/.vitepress/dist",
@@ -247,7 +247,7 @@ HTML 코드에 대해 _Auto Minify_ 옵션을 활성화하지 마세요. 이는
`.firebaserc`:
- ```json
+ ```json [.firebaserc]
{
"projects": {
"default": "