|
|
import{_ as i,c as a,ag as e,o as t}from"./chunks/framework.C1C4sYC0.js";const o=JSON.parse('{"title":"شروع کار","description":"","frontmatter":{},"headers":[],"relativePath":"fa/guide/getting-started.md","filePath":"fa/guide/getting-started.md","lastUpdated":1736187882000}'),n={name:"fa/guide/getting-started.md"};function l(p,s,h,d,k,r){return t(),a("div",null,s[0]||(s[0]=[e(`<h1 id="getting-started" tabindex="-1">شروع کار <a class="header-anchor" href="#getting-started" aria-label="Permalink to "شروع کار {#getting-started}""></a></h1><h2 id="try-it-online" tabindex="-1">تست آنلاین <a class="header-anchor" href="#try-it-online" aria-label="Permalink to "تست آنلاین {#try-it-online}""></a></h2><p>میتوانید ویتپرس را مستقیماً در مرورگر خود در <a href="https://vitepress.new" target="_blank" rel="noreferrer">StackBlitz</a> امتحان کنید.</p><h2 id="installation" tabindex="-1">نصب <a class="header-anchor" href="#installation" aria-label="Permalink to "نصب {#installation}""></a></h2><h3 id="prerequisites" tabindex="-1">پیشنیازها <a class="header-anchor" href="#prerequisites" aria-label="Permalink to "پیشنیازها {#prerequisites}""></a></h3><ul><li><a href="https://nodejs.org/" target="_blank" rel="noreferrer">Node.js</a> نسخه 18 یا بالاتر.</li><li>ترمینال برای دسترسی به ویتپرس از طریق رابط خط فرمان (CLI).</li><li>ویرایشگر متنی با پشتیبانی از <a href="https://en.wikipedia.org/wiki/Markdown" target="_blank" rel="noreferrer">Markdown</a>. <ul><li><a href="https://code.visualstudio.com/" target="_blank" rel="noreferrer">VSCode</a> به همراه <a href="https://marketplace.visualstudio.com/items?itemName=Vue.volar" target="_blank" rel="noreferrer">افزونه رسمی Vue</a>.</li></ul></li></ul><p>ویتپرس میتواند به صورت مستقل استفاده شود یا در یک پروژه موجود نصب شود. در هر دو حالت، میتوانید آن را با دستور زیر نصب کنید:</p><div class="vp-code-group vp-adaptive-theme"><div class="tabs"><input type="radio" name="group-mP5De" id="tab-sXWm6B5" checked><label data-title="npm" for="tab-sXWm6B5">npm</label><input type="radio" name="group-mP5De" id="tab-Djiw8Xm"><label data-title="pnpm" for="tab-Djiw8Xm">pnpm</label><input type="radio" name="group-mP5De" id="tab-eZdOmuL"><label data-title="yarn" for="tab-eZdOmuL">yarn</label><input type="radio" name="group-mP5De" id="tab-4njZZKU"><label data-title="yarn (pnp)" for="tab-4njZZKU">yarn (pnp)</label><input type="radio" name="group-mP5De" id="tab-PqGfYH2"><label data-title="bun" for="tab-PqGfYH2">bun</label></div><div class="blocks"><div class="language-sh vp-adaptive-theme active"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> npm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -D</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> vitepress</span></span></code></pre></div><div class="language-sh vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> pnpm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -D</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> vitepress</span></span></code></pre></div><div class="language-sh vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> yarn</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -D</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> vitepress</span></span></code></pre></div><div class="language-sh vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> yarn</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -D</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> vitepress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> vue</span></span></code></pre></div><div class="language-sh vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bun</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -D</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> vitepress</span></span></code></pre></div></div></div><details class="details custom-block"><summary>درباره peer dependency های ناموجود هشدار دریافت میکنید؟</summary><p>اگر از PNPM استفاده میکنید، متوجه هشدار peer dependency برای <code>@docsearch/js</code> خواهید شد. این مسئله جلوی عملکرد ویتپرس را نمیگیرد. اگر میخواهید این هشدار را نادیده بگیرید، موارد زیر را به <code>package.json</code> خود اضافه کنید:</p><div class="language-json vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"pnpm"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: {</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "peerDependencyRules"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: {</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "ignoreMissing"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> "@algolia/client-search"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> "search-insights"</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ]</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div></details><div class="tip custom-block"><p class="custom-block-title">نکته</p><p>ویتپرس یک بسته فقط ESM است. از <code>require()</code> برای وارد کردن آن استفاده نکنید و اطمینان حاصل کنید که نزدیکترین <code>package.json</code> شما شامل <code>"type": "module"</code> است، یا پسوند فایلهای مربوطه خود مانند <code>.vitepress/config.js</code> را به <code>.mjs</code>/<code>.mts</code> تغییر دهید. برای جزئیات بیشتر به <a href="http://vitejs.dev/guide/troubleshooting.html#this-package-is-esm-only" target="_blank" rel="noreferrer">راهنمای عیبیابی Vite</a> مراجعه کنید. همچنین، در زمینههای async CJS میتوانید از <code>await import('vitepress')</code> استفاده کنید.</p></div><h3 id="wizard-راهاندازی" tabindex="-1">Wizard راهاندازی <a class="header-anchor" href="#wizard-راهاندازی" aria-label="Permalink to "Wizard راهاندازی""></a></h3><p>ویتپرس با یک جادوگر راهاندازی خط فرمان ارائه میشود که به شما کمک میکند یک پروژه پایه را بسازید. پس از نصب، با اجرای دستور زیر جادوگر را راهاندازی کنید:</p><div class="vp-code-group vp-adaptive-theme"><div class="tabs"><input type="radio" name="group-OQUFQ" id="tab-ZZ453W0" checked><label data-title="npm" for="tab-ZZ453W0">npm</label><input type="radio" name="group-OQUFQ" id="tab-QRxPJSc"><label data-title="pnpm" for="tab-QRxPJSc">pnpm</label><input type="radio" name="group-OQUFQ" id="tab-d1n6p86"><label data-title="yarn" for="tab-d1n6p86">yarn</label><input type="radio" name="group-OQUFQ" id="tab-ysLUhn_"><label data-title="bun" for="tab-ysLUhn_">bun</label></div><div class="blocks"><div class="language-sh vp-adaptive-theme active"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> npx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> vitepress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> init</span></span></code></pre></div><div class="language-sh vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> pnpm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> vitepress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> init</span></span></code></pre></div><div class="language-sh vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> yarn</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> vitepress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> init</span></span></code></pre></div><div class="language-sh vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bun</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> vitepress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> init</span></span></code></pre></div></div></div><p>چند سوال ساده از شما پرسیده خواهد شد:</p><div class="language- vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#959da5;--shiki-dark:#959da5;">┌</span><span style="--shiki-light:#1b7c83;--shiki-light-font-weight:bold;--shiki-dark:#39c5cf;--shiki-dark-font-weight:bold;"> Welcome to VitePress!</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#959da5;--shiki-dark:#959da5;">│</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#28a745;--shiki-dark:#34d058;">◇</span><span style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;"> Where should VitePress initialize the config?</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#959da5;--shiki-dark:#959da5;">│</span><span style="--shiki-light:#24292e80;--shiki-dark:#e1e4e880;"> ./docs</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#959da5;--shiki-dark:#959da5;">│</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#28a745;--shiki-dark:#34d058;">◇</span><span style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;"> Site title:</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#959da5;--shiki-dark:#959da5;">│</span><span style="--shiki-light:#24292e80;--shiki-dark:#e1e4e880;"> My Awesome Project</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#959da5;--shiki-dark:#959da5;">│</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#28a745;--shiki-dark:#34d058;">◇</span><span style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;"> Site description:</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#959da5;--shiki-dark:#959da5;">│</span><span style="--shiki-light:#24292e80;--shiki-dark:#e1e4e880;"> A VitePress Site</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#959da5;--shiki-dark:#959da5;">│</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#1b7c83;--shiki-dark:#39c5cf;">◆</span><span style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;"> Theme:</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#1b7c83;--shiki-dark:#39c5cf;">│</span><span style="--shiki-light:#28a745;--shiki-dark:#34d058;"> ●</span><span style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;"> Default Theme </span><span style="--shiki-light:#24292e80;--shiki-dark:#e1e4e880;">(Out of the box, good-looking docs)</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#1b7c83;--shiki-dark:#39c5cf;">│</span><span style="--shiki-light:#24292e80;--shiki-dark:#e1e4e880;"> ○</span><span style="--shiki-light:#24292e80;--shiki-dark:#e1e4e880;"> Default Theme + Customization</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#1b7c83;--shiki-dark:#39c5cf;">│</span><span style="--shiki-light:#24292e80;--shiki-dark:#e1e4e880;"> ○</span><span style="--shiki-light:#24292e80;--shiki-dark:#e1e4e880;"> Custom Theme</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#1b7c83;--shiki-dark:#39c5cf;">└</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">Vue به عنوان peer dependency</p><p>اگر قصد دارید سفارشیسازیهایی که از کامپوننتها یا APIهای Vue استفاده میکنند را انجام دهید، باید <code>vue</code> را به عنوان dependency نیز نصب کنید.</p></div><h2 id="file-structure" tabindex="-1">ساختار فایلها <a class="header-anchor" href="#file-structure" aria-label="Permalink to "ساختار فایلها {#file-structure}""></a></h2><p>اگر در حال ساخت یک سایت مستقل ویتپرس هستید، میتوانید سایت را در دایرکتوری فعلی خود (<code>./</code>) بسازید. اما، اگر ویتپرس را در یک پروژه موجود به همراه سایر کدهای منبع نصب میکنید، توصیه میشود سایت را در یک دایرکتوری تودرتو (مثلاً <code>./docs</code>) بسازید تا از بقیه پروژه جدا باشد.</p><p>فرض کنیم که پروژه ویتپرس را در <code>./docs</code> ساختهاید، ساختار فایلهای تولید شده باید به این شکل باشد:</p><div class="language- vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>.</span></span>
|
|
|
<span class="line"><span>├─ docs</span></span>
|
|
|
<span class="line"><span>│ ├─ .vitepress</span></span>
|
|
|
<span class="line"><span>│ │ └─ config.js</span></span>
|
|
|
<span class="line"><span>│ ├─ api-examples.md</span></span>
|
|
|
<span class="line"><span>│ ├─ markdown-examples.md</span></span>
|
|
|
<span class="line"><span>│ └─ index.md</span></span>
|
|
|
<span class="line"><span>└─ package.json</span></span></code></pre></div><p>دایرکتوری <code>docs</code> به عنوان <strong>ریشه پروژه</strong> سایت ویتپرس در نظر گرفته میشود. دایرکتوری <code>.vitepress</code> محل ذخیره فایلهای پیکربندی ویتپرس، حافظه نهان سرور توسعه، خروجی ساخت و کد سفارشیسازی تم اختیاری است.</p><div class="tip custom-block"><p class="custom-block-title">نکته</p><p>به طور پیشفرض، ویتپرس حافظه نهان سرور توسعه خود را در <code>.vitepress/cache</code> و خروجی ساخت تولیدی را در <code>.vitepress/dist</code> ذخیره میکند. اگر از Git استفاده میکنید، باید آنها را به فایل <code>.gitignore</code> خود اضافه کنید. این مکانها همچنین قابل <a href="./../reference/site-config#outdir">پیکربندی</a> هستند.</p></div><h3 id="the-config-file" tabindex="-1">فایل پیکربندی <a class="header-anchor" href="#the-config-file" aria-label="Permalink to "فایل پیکربندی {#the-config-file}""></a></h3><p>فایل پیکربندی (<code>.vitepress/config.js</code>) به شما اجازه میدهد جنبههای مختلف سایت ویتپرس خود را سفارشی کنید، با گزینههای پایهای مانند عنوان و توضیحات سایت:</p><div class="vp-code-block-title"><div class="vp-code-block-title-bar"><span class="vp-code-block-title-text" data-title=".vitepress/config.js">.vitepress/config.js</span></div><div class="language-js vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">js</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> // گزینههای سطح سایت</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> title: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'ویتپرس'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> description: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'فقط در حال بازی کردن.'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
|
<span class="line"></span>
|
|
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> themeConfig: {</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> // گزینههای سطح تم</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div></div><p>همچنین میتوانید رفتار تم را از طریق گزینه <code>themeConfig</code> پیکربندی کنید. برای جزئیات کامل درباره همه گزینههای پیکربندی، به <a href="./../reference/site-config">راهنمای پیکربندی</a> مراجعه کنید.</p><h3 id="source-files" tabindex="-1">فایلهای منبع <a class="header-anchor" href="#source-files" aria-label="Permalink to "فایلهای منبع {#source-files}""></a></h3><p>فایلهای Markdown خارج از دایرکتوری <code>.vitepress</code> به عنوان <strong>فایلهای منبع</strong> در نظر گرفته میشوند.</p><p>ویتپرس از <strong>مسیر یابی مبتنی بر فایل</strong> استفاده میکند: هر فایل <code>.md</code> به یک فایل <code>.html</code> متناظر با همان مسیر کامپایل میشود. برای مثال، <code>index.md</code> به <code>index.html</code> کامپایل میشود و میتواند در مسیر ریشه <code>/</code> سایت ویتپرس نتیجهگیری شده بازدید شود.</p><p>ویتپرس همچنین قابلیت تولید URLهای تمیز، بازنویسی مسیرها و تولید پویا صفحات را فراهم میکند. این موارد در <a href="./routing">راهنمای مسیر یابی</a> پوشش داده خواهند شد.</p><h2 id="up-and-running" tabindex="-1">راهاندازی و اجرا <a class="header-anchor" href="#up-and-running" aria-label="Permalink to "راهاندازی و اجرا {#up-and-running}""></a></h2><p>این ابزار باید اسکریپتهای npm زیر را به <code>package.json</code> شما اضافه کرده باشد اگر اجازه این کار را در طول فرآیند راهاندازی داده باشید:</p><div class="vp-code-block-title"><div class="vp-code-block-title-bar"><span class="vp-code-block-title-text" data-title="package.json">package.json</span></div><div class="language-json vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#B31D28;--shiki-light-font-style:italic;--shiki-dark:#FDAEB7;--shiki-dark-font-style:italic;"> ...</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "scripts"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: {</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "docs:dev"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"vitepress dev docs"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "docs:build"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"vitepress build docs"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "docs:preview"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"vitepress preview docs"</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#B31D28;--shiki-light-font-style:italic;--shiki-dark:#FDAEB7;--shiki-dark-font-style:italic;"> ...</span></span>
|
|
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div></div><p>اسکریپت <code>docs:dev</code> یک سرور توسعه محلی با بهروزرسانیهای فوری راهاندازی میکند. آن را با دستور زیر اجرا کنید:</p><div class="vp-code-group vp-adaptive-theme"><div class="tabs"><input type="radio" name="group-lC6MU" id="tab-oWowV79" checked><label data-title="npm" for="tab-oWowV79">npm</label><input type="radio" name="group-lC6MU" id="tab-bhaLuSn"><label data-title="pnpm" for="tab-bhaLuSn">pnpm</label><input type="radio" name="group-lC6MU" id="tab-uUFe4hR"><label data-title="yarn" for="tab-uUFe4hR">yarn</label><input type="radio" name="group-lC6MU" id="tab-d8W-OE0"><label data-title="bun" for="tab-d8W-OE0">bun</label></div><div class="blocks"><div class="language-sh vp-adaptive-theme active"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> npm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> docs:dev</span></span></code></pre></div><div class="language-sh vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> pnpm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> docs:dev</span></span></code></pre></div><div class="language-sh vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> yarn</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> docs:dev</span></span></code></pre></div><div class="language-sh vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bun</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> docs:dev</span></span></code></pre></div></div></div><p>به جای اسکریپتهای npm، میتوانید ویتپرس را مستقیماً با دستور زیر اجرا کنید:</p><div class="vp-code-group vp-adaptive-theme"><div class="tabs"><input type="radio" name="group-l937z" id="tab-YlqIqEq" checked><label data-title="npm" for="tab-YlqIqEq">npm</label><input type="radio" name="group-l937z" id="tab-5n3nLhc"><label data-title="pnpm" for="tab-5n3nLhc">pnpm</label><input type="radio" name="group-l937z" id="tab-zGQypLC"><label data-title="yarn" for="tab-zGQypLC">yarn</label><input type="radio" name="group-l937z" id="tab-VlY0YgL"><label data-title="bun" for="tab-VlY0YgL">bun</label></div><div class="blocks"><div class="language-sh vp-adaptive-theme active"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> npx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> vitepress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> dev</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> docs</span></span></code></pre></div><div class="language-sh vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> pnpm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> vitepress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> dev</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> docs</span></span></code></pre></div><div class="language-sh vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> yarn</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> vitepress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> dev</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> docs</span></span></code></pre></div><div class="language-sh vp-adaptive-theme"><button title="کپی کد" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">$</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bun</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> vitepress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> dev</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> docs</span></span></code></pre></div></div></div><p>استفاده بیشتر از خط فرمان در <a href="./../reference/cli">مرجع CLI</a> مستند شده است.</p><p>سرور توسعه باید در <code>http://localhost:5173</code> اجرا شود. URL را در مرورگر خود بازدید کنید تا سایت جدید خود را در عمل ببینید!</p><h2 id="what-s-next" tabindex="-1">مراحل بعدی <a class="header-anchor" href="#what-s-next" aria-label="Permalink to "مراحل بعدی {#what-s-next}""></a></h2><ul><li><p>برای درک بهتر چگونگی نگاشت فایلهای markdown به HTML تولید شده، به <a href="./routing">راهنمای مسیر یابی</a> مراجعه کنید.</p></li><li><p>برای کشف بیشتر درباره اینکه چه کارهایی میتوانید در صفحه انجام دهید، مانند نوشتن محتوای markdown یا استفاده از کامپوننتهای Vue، به بخش "نوشتن" راهنما مراجعه کنید. یک مکان عالی برای شروع یادگیری درباره <a href="./markdown">افزونههای Markdown</a> است.</p></li><li><p>برای کشف ویژگیهای ارائه شده توسط تم پیشفرض مستندات، به <a href="./../reference/default-theme-config">مرجع پیکربندی تم پیشفرض</a> مراجعه کنید.</p></li><li><p>اگر میخواهید ظاهر سایت خود را بیشتر سفارشی کنید، بررسی کنید که چگونه <a href="./extending-default-theme">تم پیشفرض را گسترش دهید</a> یا <a href="./custom-theme">یک تم سفارشی بسازید</a>.</p></li><li><p>هنگامی که سایت مستندات شما شکل گرفت، حتماً <a href="./deploy">راهنمای استقرار</a> را بخوانید.</p></li></ul>`,41)]))}const g=i(n,[["render",l]]);export{o as __pageData,g as default};
|
