شروع سریع

این صفحه شما را از صفر به پروژه‌ای می‌رساند که روی رایانه‌تان ذخیره شده و روی Zaryn به اشتراک گذاشته شده است. لازم نیست git یا ابزار کنترل نسخهٔ دیگری بلد باشید. هر گام می‌گوید آن دستور چه می‌کند و چرا. > **کنترل نسخه چیست؟** ابزاری است که هر نسخهٔ ذخیره‌شده از پروژه‌تان را به خاطر می‌سپارد. می‌توانید ببینید چه چیزی تغییر کرده، به نسخهٔ قدیمی‌تر برگردید، ایده‌ها را جدا از کار اصلی امتحان کنید بی‌آنکه چیزی خراب شود، و با دیگران روی همان فایل‌ها کار کنید. zev ابزار کنترل نسخه است و Zaryn وب‌سایتی است که پروژه‌هایتان آنلاین در آن نگه داشته می‌شوند. ## ۱. نصب zev در **لینوکس یا macOS** یک ترمینال باز کنید و اجرا کنید: ```bash curl -fsSL https://zaryn.xyz/install.sh | sh ``` در **ویندوز** PowerShell را باز کنید و اجرا کنید: ```powershell irm https://zaryn.xyz/install.ps1 | iex ``` بررسی کنید که نصب شده است: ```bash zev --version ``` باید چیزی شبیه `zev 0.3.0 (x86_64-linux)` ببینید. روش‌های دیگر، مثل apt و dnf و pacman، در صفحهٔ [نصب](/docs/fa/installation) آمده‌اند. ## ۲. ساختن یک پروژه به پوشهٔ پروژه‌تان بروید (یا یک پوشهٔ تازه بسازید) و آن را به مخزن zev تبدیل کنید: ```bash mkdir my-project cd my-project zev init ``` `zev init` یک پوشهٔ پنهان به نام `.zev` می‌سازد. zev تاریخچه را آنجا نگه می‌دارد و فایل‌های خودتان دست‌نخورده می‌مانند. به zev بگویید چه کسی هستید. نام شما روی هر کامیتی که می‌سازید می‌نشیند: ```bash zev config set user.name "نام شما" zev config set user.email "you@example.com" ``` ## ۳. ذخیرهٔ اولین نسخه یک فایل بسازید، یا از فایل‌هایی که دارید استفاده کنید: ```bash echo "# پروژهٔ من" > README.md ``` ذخیرهٔ یک نسخه دو گام دارد: ```bash zev add . zev commit -m "نسخهٔ اول" ``` - `zev add .` انتخاب می‌کند **چه چیزی** در ذخیرهٔ بعدی برود. نقطه یعنی «همه‌چیز در این پوشه». به این کار *مرحله‌بندی* (staging) می‌گویند. - `zev commit -m "..."` آنچه را مرحله‌بندی کرده‌اید، با پیامی کوتاه دربارهٔ کاری که کرده‌اید، **ذخیره می‌کند**. هر ذخیره را یک *کامیت* می‌نامند. چرا دو گام؟ چون معمولاً فایل‌های زیادی را تغییر می‌دهید اما می‌خواهید فقط بعضی از آن‌ها را با هم ذخیره کنید. `zev add` امکان انتخاب را به شما می‌دهد. ## ۴. تغییر دادن و دیدن تفاوت `README.md` را ویرایش کنید و از zev بپرسید چه چیزی تغییر کرده: ```bash zev status ``` `zev status` فایل‌هایی را که تغییر داده‌اید، فایل‌های مرحله‌بندی‌شده، و فایل‌های تازه‌ای را که zev هنوز دنبال نمی‌کند فهرست می‌کند. هر بخش از خروجی‌اش هم می‌گوید دستور بعدی چیست. برای دیدن دقیق خط‌هایی که تغییر کرده‌اند: ```bash zev diff ``` خط‌هایی که با `+` شروع می‌شوند اضافه شده‌اند و خط‌هایی که با `-` شروع می‌شوند حذف شده‌اند. وقتی راضی بودید، دوباره ذخیره کنید: ```bash zev add README.md zev commit -m "توضیح پروژه" ``` همهٔ ذخیره‌هایتان تا اینجا: ```bash zev log --oneline ``` ## ۵. اشتراک‌گذاری روی Zaryn حساب کاربری‌تان را از همین ترمینال بسازید. zev برای تأیید نشانی ایمیل‌تان یک کد ۶ رقمی می‌فرستد: ```bash zev login zaryn.xyz --register your-username --email you@example.com ``` وقتی zev کد را خواست، آن را وارد کنید. ورود برای هر رایانه یک بار کافی است و همهٔ پروژه‌های آن رایانه از همان استفاده می‌کنند. قبلاً در وب‌سایت [zaryn.xyz](https://zaryn.xyz) حساب ساخته‌اید؟ پس با مرورگرتان وارد شوید: ```bash zev login zaryn.xyz --device ``` zev یک پیوند و یک کد کوتاه نشان می‌دهد. پیوند را باز کنید، ببینید کد یکی است، و تأیید کنید. حالا پروژه را روی Zaryn بسازید و کامیت‌هایتان را بفرستید: ```bash zev new zev push ``` `zev new` نام، نوع پروژه، عمومی یا خصوصی بودن و مجوز را می‌پرسد. مخزن را روی Zaryn می‌سازد و آن را با نام `origin` به خاطر می‌سپارد؛ یعنی جای پیش‌فرض ارسال. `zev push` کامیت‌هایتان را می‌فرستد. نشانی `https://zaryn.xyz/your-username/the-name` را باز کنید تا آن‌ها را ببینید. ## چرخهٔ روزمره بیشتر روزها فقط به همین پنج دستور نیاز دارید: ```bash zev status # چه چیزی تغییر کرده؟ zev diff # دقیقاً چطور؟ zev add . # انتخاب چیزی که ذخیره می‌شود zev commit -m "کاری که کردید" # ذخیره zev push # اشتراک‌گذاری ``` وقتی با دیگران کار می‌کنید، اول `zev pull` را اجرا کنید تا آخرین تغییرات آن‌ها را بگیرید. ## قدم بعدی - [اولین مخزن شما، قدم به قدم](/docs/fa/first-repository): همین ایده‌ها با جزئیات بیشتر، از جمله برگرداندن اشتباه‌ها. - [چطور…؟](/docs/fa/how-do-i): پاسخ کوتاه برای کارهای رایج («برگرداندن یک تغییر»، «حذف یک فایل»، «کار روی یک شاخه»). - [همهٔ دستورات](/docs/fa/commands): همهٔ دستورات zev، با دستورات روزمره در ابتدا. - گیر کرده‌اید؟ [وقتی چیزی درست کار نمی‌کند](/docs/fa/troubleshooting) را ببینید، یا در هر صفحهٔ مستندات کلید `/` را بزنید و جست‌وجو کنید.