From 8108938522990edf2ac0a0ca9e57b92e3a3d74e4 Mon Sep 17 00:00:00 2001 From: Amirhossein Alibakhshi Date: Fri, 13 Dec 2024 13:49:33 +0330 Subject: [PATCH] docs(persian): add fragments to headings --- docs/fa/guide/asset-handling.md | 8 +-- docs/fa/guide/cms.md | 6 +- docs/fa/guide/custom-theme.md | 12 ++-- docs/fa/guide/data-loading.md | 14 ++--- docs/fa/guide/deploy.md | 28 +++++----- docs/fa/guide/extending-default-theme.md | 18 +++--- docs/fa/guide/frontmatter.md | 6 +- docs/fa/guide/getting-started.md | 18 +++--- docs/fa/guide/i18n.md | 6 +- docs/fa/guide/markdown.md | 56 +++++++++---------- docs/fa/guide/mpa-mode.md | 2 +- docs/fa/guide/routing.md | 30 +++++----- docs/fa/guide/sitemap-generation.md | 6 +- docs/fa/guide/ssr-compat.md | 12 ++-- docs/fa/guide/using-vue.md | 28 +++++----- docs/fa/guide/what-is-vitepress.md | 10 ++-- docs/fa/reference/cli.md | 24 ++++---- docs/fa/reference/default-theme-badge.md | 21 ++++--- docs/fa/reference/default-theme-carbon-ads.md | 2 +- docs/fa/reference/default-theme-config.md | 6 +- docs/fa/reference/default-theme-edit-link.md | 6 +- docs/fa/reference/default-theme-footer.md | 4 +- docs/fa/reference/default-theme-home-page.md | 10 ++-- .../reference/default-theme-last-updated.md | 6 +- docs/fa/reference/default-theme-layout.md | 12 ++-- docs/fa/reference/default-theme-nav.md | 12 ++-- .../default-theme-prev-next-links.md | 2 +- docs/fa/reference/default-theme-search.md | 16 +++--- docs/fa/reference/default-theme-sidebar.md | 10 ++-- docs/fa/reference/default-theme-team-page.md | 20 +++---- docs/fa/reference/frontmatter-config.md | 9 +-- docs/fa/reference/runtime-api.md | 18 +++--- docs/fa/reference/site-config.md | 52 ++++++++--------- 33 files changed, 245 insertions(+), 245 deletions(-) diff --git a/docs/fa/guide/asset-handling.md b/docs/fa/guide/asset-handling.md index a990024f..df6aae9f 100644 --- a/docs/fa/guide/asset-handling.md +++ b/docs/fa/guide/asset-handling.md @@ -1,6 +1,6 @@ -# مدیریت منابع +# مدیریت منابع{#asset-handling} -## ارجاع به منابع ایستا +## ارجاع به منابع ایستا{#referencing-static-assets} تمام فایل‌های Markdown به کامپوننت‌های Vue تبدیل و توسط [Vite](https://vitejs.dev/guide/assets.html) پردازش می‌شوند. شما می‌توانید، **و باید**، هر نوع دارایی را با استفاده از URL‌های نسبی مرجع قرار دهید: @@ -20,7 +20,7 @@ PDFها یا سند‌های دیگر که از طریق پیوندها در ف تمام ارجاع‌های مسیر **ایستا**، شامل مسیرهای مطلق، باید بر اساس ساختار دایرکتوری کاری شما تعیین شوند. -## دایرکتوری عمومی +## دایرکتوری عمومی{#the-public-directory} گاهی اوقات ممکن است نیاز داشته باشید منابع ایستا را فراهم کنید که به صورت مستقیم در هیچ‌یک از Markdown یا کامپوننت‌های قالب شما ارجاع نشده‌اند، یا ممکن است بخواهید برخی فایل‌ها را با نام اصلی خود سرویس دهید. به عنوان مثال، فایل‌هایی مانند `robots.txt`، آیکون‌های fav، و آیکون‌های PWA. @@ -30,7 +30,7 @@ PDFها یا سند‌های دیگر که از طریق پیوندها در ف توجه داشته باشید که باید به فایل‌های قرار داده شده در `public` با استفاده از مسیر مطلق ریشه ارجاع دهید - به عنوان مثال، `public/icon.png` همیشه باید به عنوان `/icon.png` در کد منبع ارجاع داده شود. -## URL پایه +## URL پایه {#base-url} اگر وب‌سایت شما به URL غیر ریشه استقرار می‌یابد، باید گزینه `base` را در `.vitepress/config.js` تنظیم کنید. به عنوان مثال، اگر قصد دارید وب‌سایت خود را به `https://foo.github.io/bar/` استقرار دهید، آنگاه `base` باید به `'/bar/'` تنظیم شود (همیشه باید با یک خط شروع و پایان یابد). diff --git a/docs/fa/guide/cms.md b/docs/fa/guide/cms.md index 49ec8673..fb4955f9 100644 --- a/docs/fa/guide/cms.md +++ b/docs/fa/guide/cms.md @@ -2,9 +2,9 @@ outline: deep --- -# اتصال به یک سیستم مدیریت محتوا (CMS) +# اتصال به یک سیستم مدیریت محتوا (CMS){#connecting-to-a-cms} -## گام‌های کلی +## گام‌های کلی{#general-workflow} اتصال ویت‌پرس به یک سیستم مدیریت محتوا به طور عمده بر اساس [مسیریابی پویا](./routing#dynamic-routes) خواهد بود. حتماً قبل از شروع، با روش کار آن آشنا شوید. @@ -51,6 +51,6 @@ outline: deep ``` -## راهنماهای ادغام +## راهنماهای ادغام{#integration-guides} اگر راهنمایی درباره ادغام ویت‌پرس با یک سیستم مدیریت محتوا خاص نوشته‌اید، لطفاً از لینک "ویرایش این صفحه" زیر استفاده کنید تا آن را ارسال کنید! diff --git a/docs/fa/guide/custom-theme.md b/docs/fa/guide/custom-theme.md index 78f62fd2..df8b9019 100644 --- a/docs/fa/guide/custom-theme.md +++ b/docs/fa/guide/custom-theme.md @@ -2,9 +2,9 @@ outline: deep --- -# استفاده از یک تم سفارشی +# استفاده از یک تم سفارشی{#using-a-custom-theme} -## Resolve کردن تم +## Resolve کردن تم {#theme-resolving} می‌توانید با ایجاد یک فایل `.vitepress/theme/index.js` یا `.vitepress/theme/index.ts` (فایل ورودی تم) تم سفارشی را فعال کنید: @@ -21,7 +21,7 @@ outline: deep وقتی ویت‌پرس حضور یک فایل ورودی تم را شناسایی کند، همواره از تم سفارشی به جای تم پیش‌فرض استفاده می‌کند. با این حال، شما می‌توانید [تم پیش‌فرض را گسترش دهید](./extending-default-theme) تا سفارشی‌سازی‌های پیشرفته‌تری را روی آن اعمال کنید. -## رابط تم +## رابط تم{#theme-interface} یک تم سفارشی ویت‌پرس به عنوان یک شی تعریف می‌شود که شامل رابط زیر است: @@ -72,7 +72,7 @@ export پیش‌فرض تنها قراردادی برای یک تم سفارشی درون کامپوننت لایه‌ی خود، دقیقاً مانند یک برنامه Vite + Vue 3 عادی عمل می‌کند. با این وجود، توجه داشته باشید که تم همچنین باید [سازگار با SSR](./ssr-compat) باشد. -## ساخت یک لایه +## ساخت یک لایه {#building-a-layout} بیشترین لایه‌ی پایه‌ای نیازمند دارای یک کامپوننت `` است: @@ -156,7 +156,7 @@ const { page, frontmatter } = useData() برای همه چیزی که در کامپوننت‌های تم موجود است، به [مستندات API اجرایی](../reference/runtime-api) مراجعه کنید. به علاوه، شما می‌توانید از [بارگذاری داده در زمان ساخت](./data-loading) استفاده کنید تا لایه‌های مبتنی بر داده را تولید کنید - به عنوان مثال، یک صفحه که تمام پست‌های وبلاگ در پروژه فعلی را لیست می‌کند. -## توزیع یک تم سفارشی +## توزیع یک تم سفارشی {#distributing-a-custom-theme} آسان‌ترین روش برای توزیع یک تم سفارشی ارائه آن به عنوان [قالب مخزن در GitHub](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-template-repository) است. @@ -172,7 +172,7 @@ const { page, frontmatter } = useData() 5. دستورالعمل‌های روشنی برای مصرف تم خود ارائه دهید (مانند زیر). -## مصرف یک تم سفارشی +## مصرف یک تم سفارشی{#consuming-a-custom-theme} برای مصرف یک تم خارجی، آن را از ورودی تم سفارشی وارد و دوباره export کنید: diff --git a/docs/fa/guide/data-loading.md b/docs/fa/guide/data-loading.md index c351e9da..864efeb3 100644 --- a/docs/fa/guide/data-loading.md +++ b/docs/fa/guide/data-loading.md @@ -1,10 +1,10 @@ -# بارگذاری داده در زمان ساخت +# بارگذاری داده در زمان ساخت{#build-time-data-loading} ویت‌پرس یک ویژگی به نام **بارگذارهای داده** ارائه می‌دهد که به شما این امکان را می‌دهد که داده‌های دلخواه را بارگیری کنید و آن‌ها را از صفحات یا اجزا وارد کنید. بارگذاری داده فقط **در زمان ساخت** اجرا می‌شود: داده‌های حاصل به صورت JSON در بسته JavaScript نهایی سریالیزه می‌شوند. بارگذارهای داده می‌توانند برای بارگیری داده‌های از راه دور یا تولید فراداده‌ها بر اساس فایل‌های محلی استفاده شوند. به عنوان مثال، می‌توانید از بارگذارهای داده استفاده کنید تا تمام صفحات API محلی خود را تجزیه کنید و به طور خودکار یک فهرست از تمام ورودی‌های API تولید کنید. -## استفاده ابتدایی +## استفاده ابتدایی{#basic-usage} یک فایل بارگذار داده باید با `.data.js` یا `.data.ts` پایان یابد. فایل باید یک صادرات پیش‌فرض از یک شی با متد `load()` داشته باشد: @@ -52,7 +52,7 @@ export default { } ``` -## داده از فایل‌های محلی +## داده از فایل‌های محلی{#data-from-local-files} وقتی نیاز به تولید داده بر اساس فایل‌های محلی دارید، باید از گزینه `watch` در بارگذار داده استفاده کنید تا تغییرات اعمال شده به این فایل‌ها بتواند به روزرسانی‌های سریع منجر شود. @@ -80,7 +80,7 @@ export default { } ``` -## `createContentLoader` +## `createContentLoader` {#createcontentloader} وقتی که در حال ساختن یک سایت متمرکز بر محتوا هستیم، اغلب نیاز به ایجاد یک "بایگانی" یا "فهرست" صفحه داریم: یک صفحه که ما همه ورودی‌های موجود در مجموعه محتوای خود را لیست می‌کنیم، به عنوان مثال پست‌های وبلاگ یا صفحات API. ما می‌توانیم این کار را مستقیماً با API بارگذار داده انجام دهیم، اما از آنجا که این یک حالت استفاده رایج است، ویت‌پرس همچنین یک کمک‌کننده به نام `createContentLoader` را فراهم می‌کند تا این فرآیند را ساده‌تر کند: @@ -133,7 +133,7 @@ import { data as posts } from './posts.data.js' ``` -### گزینه‌ها +### گزینه‌ها{#options} احتمالاً داده پیش‌فرض به تمام نیازها پاسخ نمی‌دهد - شما می‌توانید با استفاده از گزینه‌ها به تبدیل داده‌ها مشترک شوید: @@ -216,7 +216,7 @@ interface ContentOptions { } ``` -## بارگذارهای داده تایپ شده +## بارگذارهای داده تایپ شده {#typed-data-loaders} زمان استفاده از TypeScript، می‌توانید بارگذار و صادرات `data` خود را به این شکل تایپ کنید: @@ -239,7 +239,7 @@ export default defineLoader({ }) ``` -## پیکربندی +## پیکربندی {#configuration} برای دریافت اطلاعات پیکربندی در داخل یک بارگذار، می‌توانید از کدی مانند زیر استفاده کنید: diff --git a/docs/fa/guide/deploy.md b/docs/fa/guide/deploy.md index 244f9044..90d523dc 100644 --- a/docs/fa/guide/deploy.md +++ b/docs/fa/guide/deploy.md @@ -2,7 +2,7 @@ outline: deep --- -# استقرار وب‌سایت ویت‌پرس شما +# استقرار وب‌سایت ویت‌پرس شما{#deploy-your-vitepress-site} راهنماهای زیر بر اساس برخی فرضیات مشترک است: @@ -19,7 +19,7 @@ outline: deep } ``` -## ساخت و تست محلی +## ساخت و تست محلی {#build-and-test-locally} 1. برای ساخت اسناد، این دستور را اجرا کنید: @@ -47,13 +47,13 @@ outline: deep حالا اسکریپت `docs:preview` سرور را در `http://localhost:8080` راه‌اندازی خواهد کرد. -## تنظیم مسیر پایه عمومی +## تنظیم مسیر پایه عمومی{#setting-a-public-base-path} به‌طور پیش‌فرض، ما فرض می‌کنیم که وب‌سایت در مسیر ریشه دامنه (`/`) انتشار می‌یابد. اگر وب‌سایت شما باید در یک زیرمسیر ارائه شود، مانند `https://mywebsite.com/blog/`، در این صورت باید گزینه [`base`](../reference/site-config#base) را به `'/blog/'` در پیکربندی ویت‌پرس تنظیم کنید. **مثال:** اگر از صفحات GitHub (یا GitLab) استفاده می‌کنید و به `user.github.io/repo/` انتشار می‌دهید، آنگاه `base` را به `/repo/` تنظیم کنید. -## سربرگ‌های حافظه نهان HTTP +## سربرگ‌های حافظه نهان HTTP {#http-cache-headers} اگر شما کنترلی بر روی سربرگ‌های HTTP در سرور تولیدی خود دارید، می‌توانید سربرگ‌های `cache-control` را پیکربندی کنید تا بهبود عملکرد در بازدیدهای تکراری داشته باشید. @@ -103,9 +103,9 @@ Cache-Control: max-age=31536000,immutable ::: -## راهنمای‌های پلتفرم +## راهنمای‌های پلتفرم {#platform-guides} -### Netlify / Vercel / Cloudflare Pages / AWS Amplify / Render +### Netlify / Vercel / Cloudflare Pages / AWS Amplify / Render {#netlify-vercel-cloudflare-pages-aws-amplify-render} یک پروژه جدید راه‌اندازی کرده و این تنظیمات را با استفاده از داشبورد خود تغییر دهید: @@ -117,7 +117,7 @@ Cache-Control: max-age=31536000,immutable گزینه‌هایی مانند _Auto Minify_ را برای کد HTML فعال نکنید. این گزینه‌ها ممکن است توضیحاتی را که به Vue معنا دارد، از خروجی حذف کنند. ممکن است خطاهای ناسازگاری را در اجرا ببینید اگر حذف شوند. ::: -### صفحات GitHub +### صفحات GitHub {#github-pages} 1. یک فایل به نام `deploy.yml` در دایرکتوری `.github/workflows` پروژه خود ایجاد کنید با محتوایی مانند زیر: @@ -196,7 +196,7 @@ Cache-Control: max-age=31536000,immutable 3. تغییرات خود را به شاخه `main` ارسال کنید و منتظر GitHub Actions workflow بمانید. شما باید وب‌سایت خود را در `https://.github.io/[repository]/` یا `https:///` بسته به تنظیمات خود دیده شده است. وب‌سایت شما به‌طور خودکار در هر بار فشرده‌سازی به شاخه `main` ارسال می‌شود. -### صفحات GitLab +### صفحات GitLab{#gitlab-pages} 1. `outDir` را در پیکربندی ویت‌پرس به `../public` تنظیم کنید. گزینه `base` را به `'//'` تنظیم کنید اگر می‌خواهید در `https://.gitlab.io//` انتشار دهید. @@ -219,7 +219,7 @@ Cache-Control: max-age=31536000,immutable - main ``` -### Azure Static Web Apps +### Azure Static Web Apps {#azure-static-web-apps} 1. دستورالعمل [رسمی](https://docs.microsoft.com/en-us/azure/static-web-apps/build-configuration) را دنبال کنید. @@ -229,7 +229,7 @@ Cache-Control: max-age=31536000,immutable - **`output_location`**: `docs/.vitepress/dist` - **`app_build_command`**: `npm run docs:build` -### Firebase +### Firebase {#firebase} 1. فایل‌های `firebase.json` و `.firebaserc` را در ریشه پروژه خود ایجاد کنید: @@ -260,7 +260,7 @@ Cache-Control: max-age=31536000,immutable firebase deploy ``` -### Surge +### Surge {#surge} 1. بعد از اجرای `npm run docs:build`، دستور زیر را برای انتشار اجرا کنید: @@ -268,7 +268,7 @@ Cache-Control: max-age=31536000,immutable npx surge docs/.vitepress/dist ``` -### Heroku +### Heroku {#heroku} 1. دستورالعمل و راهنماها را در [`heroku-buildpack-static`](https://elements.heroku.com/buildpacks/heroku/heroku-buildpack-static) دنبال کنید. @@ -280,11 +280,11 @@ Cache-Control: max-age=31536000,immutable } ``` -### Edgio +### Edgio {#edgio} به [ایجاد و انتشار یک برنامه ویت‌پرس در Edgio](https://docs.edg.io/guides/vitepress) مراجعه کنید. -### Kinsta Static Site Hosting +### Kinsta Static Site Hosting {#kinsta-static-site-hosting} شما می‌توانید وب‌سایت ویت‌پرس خود را بر روی [Kinsta](https://kinsta.com/static-site-hosting/) با دنبال کردن این [دستورالعمل‌ها](https://kinsta.com/docs/vitepress-static-site-example/) انتشار دهید. diff --git a/docs/fa/guide/extending-default-theme.md b/docs/fa/guide/extending-default-theme.md index 25df9c68..ceb8ed5e 100644 --- a/docs/fa/guide/extending-default-theme.md +++ b/docs/fa/guide/extending-default-theme.md @@ -2,7 +2,7 @@ outline: deep --- -# گسترش تم پیش‌فرض +# گسترش تم پیش‌فرض {#extending-the-default-theme} تم پیش‌فرض ویت‌پرس برای مستندات بهینه‌سازی شده است و قابلیت سفارشی‌سازی دارد. برای دریافت لیست جامع گزینه‌ها، به [نمای کلی از تنظیمات تم پیش‌فرض](../reference/default-theme-config) مراجعه کنید. @@ -18,7 +18,7 @@ outline: deep قبل از ادامه، ابتدا [استفاده از یک تم سفارشی](./custom-theme) را بخوانید تا نحوه کار تم‌های سفارشی را درک کنید. ::: -## سفارشی‌سازی CSS +## سفارشی‌سازی CSS {#customizing-css} CSS تم پیش‌فرض با نادیده گرفتن متغیرهای CSS سطح ریشه قابل سفارشی‌سازی است: @@ -40,7 +40,7 @@ export default DefaultTheme لیست متغیرهای CSS [تم پیش‌فرض](https://github.com/vuejs/vitepress/blob/main/src/client/theme-default/styles/vars.css) که می‌توانند سفارشی‌سازی شوند را ببینید. -## استفاده از فونت‌های مختلف +## استفاده از فونت‌های مختلف{#using-different-fonts} ویت‌پرس از [Inter](https://rsms.me/inter/) به عنوان فونت پیش‌فرض استفاده می‌کند و فونت‌ها را در خروجی ساخته‌شده شامل می‌شود. این فونت همچنین در محصولات خودکار پیش‌بارگذاری می‌شود. با این حال، این ممکن است مطلوب نباشد اگر می‌خواهید از یک فونت اصلی مختلف استفاده کنید. @@ -92,7 +92,7 @@ export default { } ``` -## ثبت مولفه‌های عمومی +## ثبت مولفه‌های عمومی{#registering-global-components} ```js // .vitepress/theme/index.js @@ -125,7 +125,7 @@ export default { از آنجا که از Vite استفاده می‌کنیم، می‌توانید از ویژگی [import glob](https://vitejs.dev/guide/features.html#glob-import) در Vite برای خودکار ثبت یک پوشه از مولفه‌ها استفاده کنید. -## slot ‌های طرح +## slot ‌های طرح {#layout-slots} کامپوننت `` تم پیش‌فرض چندین slot دارد که می‌توانید محتوا را در موقعیت‌های مختلف صفحه در آن‌ها درج کنید. در زیر مثالی از درج یک کامپوننت در قبل از طرح داده شده است: @@ -220,9 +220,9 @@ export default { - `nav-screen-content-after` -## استفاده از API انتقال نمایش +## استفاده از API انتقال نمایش {#using-view-transitions-api} -### در تغییر ظاهر +### در تغییر ظاهر {#on-appearance-toggle} شما می‌توانید تم پیش‌فرض را گسترش دهید تا هنگام تغییر حالت رنگ، یک انتقال سفارشی را فراهم کند. به عنوان مثال: @@ -312,11 +312,11 @@ provide('toggle-appearance', async ({ clientX: x, clientY: y }: MouseEvent) => { برای جزئیات بیشتر در مورد انتقال‌های نمایش به [اسناد کروم](https://developer.chrome.com/docs/web-platform/view-transitions/) مراجعه کنید. -### در تغییر مسیر +### در تغییر مسیر {#on-route-change} به زودی. -## جایگزینی کامپوننت‌های داخلی +## جایگزینی کامپوننت‌های داخلی {#overriding-internal-components} شما می‌توانید با استفاده از [alias های Vite](https://vitejs.dev/config/shared-options.html#resolve-alias)، کامپوننت‌های تم پیش‌فرض را با کامپوننت‌های سفارشی خود جایگزین کنید: diff --git a/docs/fa/guide/frontmatter.md b/docs/fa/guide/frontmatter.md index 3ecd6184..7f748b1e 100644 --- a/docs/fa/guide/frontmatter.md +++ b/docs/fa/guide/frontmatter.md @@ -1,6 +1,6 @@ # Frontmatter -## استفاده +## استفاده {#usage} ویت‌پرس پشتیبانی از frontmatter YAML در تمام فایل‌های Markdown را دارد و آن‌ها را با استفاده از [gray-matter](https://github.com/jonschlinkert/gray-matter) تجزیه می‌کند. Frontmatter باید در بالای فایل Markdown قرار داشته باشد (قبل از هر عنصر از جمله برچسب‌های ` ``` -### نمایش محتوای خام +### نمایش محتوای خام{#rendering-raw-content} پارامترهای ارسال شده به صفحه در بارگذاری JavaScript کلاینت سریال می‌شوند، بنابراین باید از ارسال داده‌های سنگین در پارامترها خودداری کنید، برای مثال محتوای خام Markdown یا HTML از یک CMS از راه دور. diff --git a/docs/fa/guide/sitemap-generation.md b/docs/fa/guide/sitemap-generation.md index 67131a62..5e9e2530 100644 --- a/docs/fa/guide/sitemap-generation.md +++ b/docs/fa/guide/sitemap-generation.md @@ -1,4 +1,4 @@ -# جنریت کردن Sitemap +# جنریت کردن Sitemap{#sitemap-generation} ویت‌پرس با پشتیبانی بیرونی برای تولید فایل `sitemap.xml` برای سایت شما ارائه می‌شود. برای فعال‌سازی آن، موارد زیر را به فایل `.vitepress/config.js` خود اضافه کنید: @@ -12,7 +12,7 @@ export default { برای داشتن تگ‌های `` در فایل `sitemap.xml` خود، می‌توانید گزینه [`lastUpdated`](../reference/default-theme-last-updated) را فعال کنید. -## گزینه‌ها +## گزینه‌ها{#options} پشتیبانی از sitemap توسط ماژول [`sitemap`](https://www.npmjs.com/package/sitemap) ارائه شده است. می‌توانید هر گزینه‌ای که توسط این ماژول پشتیبانی می‌شود را به گزینه `sitemap` در فایل پیکربندی خود منتقل کنید. این گزینه‌ها به طور مستقیم به سازنده `SitemapStream` منتقل می‌شوند. برای جزئیات بیشتر به [مستندات sitemap](https://www.npmjs.com/package/sitemap#options-you-can-pass) مراجعه کنید. مثال: @@ -36,7 +36,7 @@ export default { } ``` -## هوک `transformItems` +## هوک `transformItems`{#transformitems-hook} می‌توانید از هوک `sitemap.transformItems` برای اصلاح موارد sitemap قبل از نوشتن آن‌ها به فایل `sitemap.xml` استفاده کنید. این هوک با یک آرایه از موارد sitemap فراخوانی می‌شود و انتظار دارد که یک آرایه از موارد sitemap بازگردانده شود. مثال: diff --git a/docs/fa/guide/ssr-compat.md b/docs/fa/guide/ssr-compat.md index 3d006b98..990d1358 100644 --- a/docs/fa/guide/ssr-compat.md +++ b/docs/fa/guide/ssr-compat.md @@ -2,13 +2,13 @@ outline: deep --- -# تطابق SSR +# تطابق SSR{#ssr-compatibility} ویت‌پرس، با استفاده از قابلیت‌های رندرینگ سمت سرور (SSR) ارائه شده توسط Vue، اپلیکیشن را در Node.js در هنگام ساخت تولیدی پیش از رندر می‌کند. این بدان معناست که کلیه کدهای سفارشی در اجزای تم به تطابق SSR وابسته هستند. [بخش SSR در مستندات رسمی Vue](https://vuejs.org/guide/scaling-up/ssr.html) بیشتر در مورد SSR، ارتباط بین SSR / SSG و نکات متداول در نوشتن کد‌های سازگار با SSR توضیح می‌دهد. قانون عمده این است که فقط در `beforeMount` یا `mounted` هوک‌های اجزای Vue از API‌های مرورگر / DOM استفاده کنید. -## `` +## `` {#clientonly} اگر از اجزا یا دموهایی استفاده می‌کنید که سازگاری با SSR ندارند (برای مثال حاوی دستورالعمل‌های سفارشی هستند)، می‌توانید آن‌ها را درون کامپوننت داخلی `` قرار دهید: @@ -18,11 +18,11 @@ outline: deep ``` -## کتابخانه‌هایی که در هنگام وارد کردن به API مرورگر دسترسی دارند +## کتابخانه‌هایی که در هنگام وارد کردن به API مرورگر دسترسی دارند {#libraries-that-access-browser-api-on-import} بعضی از کتابخانه‌ها یا اجزا در هنگام وارد کردن به API‌های مرورگر **دسترسی دارند**. برای استفاده از کدی که فرض می‌کند محیطی مرورگر در هنگام وارد کردن وجود دارد، باید آن‌ها را به صورت پویا وارد کنید. -### وارد کردن در هوک Mounted +### وارد کردن در هوک Mounted {#importing-in-mounted-hook} ```vue ``` -### وارد کردن شرطی +### وارد کردن شرطی {#conditional-import} می‌توانید همچنین وابستگی را با استفاده از `import.meta.env.SSR` (قسمتی از [متغیرهای env Vite](https://vitejs.dev/guide/env-and-mode.html#env-variables)) به شرط وارد کنید: @@ -80,7 +80,7 @@ export default { } satisfies Theme ``` -### `defineClientComponent` +### `defineClientComponent` {#defineclientcomponent} ویت‌پرس یک کمک‌کننده راحتی برای وارد کردن کامپوننت‌های Vue که هنگام وارد کردن به API‌های مرورگر دسترسی دارند فراهم می‌کند. diff --git a/docs/fa/guide/using-vue.md b/docs/fa/guide/using-vue.md index 5f518956..9862de0b 100644 --- a/docs/fa/guide/using-vue.md +++ b/docs/fa/guide/using-vue.md @@ -1,4 +1,4 @@ -# استفاده از Vue در Markdown +# استفاده از Vue در Markdown {#using-vue-in-markdown} در ویت‌پرس، هر فایل Markdown به HTML تبدیل شده و سپس به عنوان یک [کامپوننت فایل تکی Vue](https://vuejs.org/guide/scaling-up/sfc.html) پردازش می‌شود. این بدان معنی است که شما می‌توانید از هر ویژگی Vue در داخل Markdown استفاده کنید، شامل قالب‌بندی پویا، استفاده از کامپوننت‌های Vue، یا منطق کامپوننت Vue دلخواه در داخل صفحه با افزودن تگ ` -# صفحه تیم +# صفحه تیم {#team-page} اگر می‌خواهید تیم خود را معرفی کنید، می‌توانید از کامپوننت‌های تیم برای ساخت صفحه تیم استفاده کنید. دو راه برای استفاده از این کامپوننت‌ها وجود دارد. یکی اینکه آنها را در صفحه مستندات قرار دهید و دیگری اینکه یک صفحه کامل تیم ایجاد کنید. -## نمایش اعضای تیم در یک صفحه +## نمایش اعضای تیم در یک صفحه {#show-team-members-in-a-page} می‌توانید از کامپوننت `` که از `vitepress/theme` قابل دسترسی است، برای نمایش لیست اعضای تیم در هر صفحه‌ای استفاده کنید. @@ -66,7 +66,7 @@ const members = [ اگر تعداد اعضا بسیار زیاد است یا به سادگی می‌خواهید بیشتر فضا برای نمایش اعضای تیم داشته باشید، در نظر بگیرید [ایجاد یک صفحه کامل تیم](#create-a-full-team-page). -## ایجاد یک صفحه کامل تیم +## ایجاد یک صفحه کامل تیم {#create-a-full-team-page} بجای اضافه کردن اعضای تیم به صفحه مستندات، می‌توانید یک صفحه کامل تیم را ایجاد کنید، مشابه اینکه چگونه می‌توانید یک [صفحه خانگی سفارشی](./default-theme-home-page) ایجاد کنید. @@ -118,11 +118,9 @@ const members = [ `` به عنوان زمانی که در یک صفحه مستند استفاده می‌شود، کار می‌کند. این لیست اعضا را نمایش می‌دهد. -### اضافه کردن بخش‌ها برای تقسیم اعضای تیم +### اضافه کردن بخش‌ها برای تقسیم اعضای تیم {#add-sections-to-divide-team-members} -می‌توانید "بخ - -ش‌ها" را به صفحه تیم اضافه کنید. به عنوان مثال، ممکن است اعضای مختلف تیمی مانند اعضای تیم اصلی و شرکای اجتماعی داشته باشید. شما می‌توانید این اعضا را به بخش‌ها تقسیم کنید تا نقش هر گروه بهتر توضیح داده شود. +می‌توانید بخش‌ها را به صفحه تیم اضافه کنید. به عنوان مثال، ممکن است اعضای مختلف تیمی مانند اعضای تیم اصلی و شرکای اجتماعی داشته باشید. شما می‌توانید این اعضا را به بخش‌ها تقسیم کنید تا نقش هر گروه بهتر توضیح داده شود. برای این کار، کامپوننت `` را به فایل `team.md` اضافه کنید که قبلاً ایجاد کردیم. @@ -162,7 +160,7 @@ const partners = [...] به یاد داشته باشید که کامپوننت `` را درون اسلات `#members` قرار دهید. -## `` +## `` {#vpteammembers} کامپوننت `` لیست داده‌شده از اعضا را نمایش می‌دهد. @@ -218,11 +216,11 @@ interface TeamMember { } ``` -## `` +## `` {#vpteampage} کامپوننت ریشه هنگام ایجاد یک صفحه کامل تیم. فقط یک اسلات را قبول می‌کند. این همه کامپوننت‌های مربوط به تیم را استایل می‌کند. -## `` +## `` {#vpteampagetitle} بخش "عنوان" صفحه را اضافه می‌کند. بهترین استفاده را در ابتدایی‌ترین جای زیر `` داشته باشد. این اسلات‌های `#title` و `#lead` را قبول می‌کند. @@ -239,7 +237,7 @@ interface TeamMember { ``` -## `` +## `` {#vpteampagesection} یک "بخش" را درون صفحه تیم ایجاد می‌کند. اسلات‌های `#title`، `#lead` و `#members` را قبول می‌کند. می‌توانید هر تعداد بخش را درون `` اضافه کنید. diff --git a/docs/fa/reference/frontmatter-config.md b/docs/fa/reference/frontmatter-config.md index a7f7988a..01b0b169 100644 --- a/docs/fa/reference/frontmatter-config.md +++ b/docs/fa/reference/frontmatter-config.md @@ -2,7 +2,7 @@ outline: deep --- -# تنظیمات Frontmatter +# تنظیمات Frontmatter {#frontmatter-config} Frontmatter امکان پیکربندی بر اساس صفحه را فراهم می‌کند. در هر فایل markdown، شما می‌توانید از تنظیمات frontmatter برای بازنویسی تنظیمات سطح سایت یا تم استفاده کنید. همچنین، تنظیماتی وجود دارند که فقط می‌توانید آن‌ها را در frontmatter تعریف کنید. @@ -82,7 +82,7 @@ type HeadConfig = | [string, Record, string] ``` -## فقط برای تم پیش‌فرض +## فقط برای تم پیش‌فرض {#default-theme-only} گزینه‌های frontmatter زیر فقط زمانی قابل استفاده هستند که از تم پیش‌فرض استفاده می‌کنید. @@ -103,11 +103,11 @@ layout: doc --- ``` -### hero +### hero {#hero} تعیین محتویات بخش hero صفحه اصلی هنگامی که `layout` به `home` تنظیم شده است. جزئیات بیشتر در [تم پیش‌فرض: صفحه اصلی](./default-theme-home-page). -### features +### features {#features} تعیین مواردی که در بخش ویژگی‌ها باید نمایش داده شوند هنگامی که `layout` به `home` تنظیم شده است. جزئیات بیشتر در [تم پیش‌فرض: صفحه اصلی](./default-theme-home-page). @@ -220,3 +220,4 @@ pageClass: custom-page-class .custom-page-class { /* استایل‌های مخصوص صفحه */ } +``` diff --git a/docs/fa/reference/runtime-api.md b/docs/fa/reference/runtime-api.md index 7a33adc7..74f1bcd6 100644 --- a/docs/fa/reference/runtime-api.md +++ b/docs/fa/reference/runtime-api.md @@ -1,4 +1,4 @@ -# API زمان اجرا +# API زمان اجرا {#runtime-api} ویت‌پرس چندین API داخلی را ارائه می‌دهد تا به شما امکان دسترسی به داده‌های برنامه را بدهد. همچنین، ویت‌پرس با چندین کامپوننت داخلی همراه است که می‌توانید به صورت جهانی از آن‌ها استفاده کنید. @@ -6,7 +6,7 @@ متدهایی که با `use*` آغاز می‌شوند نشان می‌دهند که این یک تابع [API ترکیبی Vue 3](https://vuejs.org/guide/introduction.html#composition-api) ("Composable") است که فقط می‌تواند در `setup()` یا `