پالت فرمان

دنبال فرمانی برای اجرا بگردید…

ZarynZaryn
شروع کار·۳ دقیقه مطالعه

واژه‌هایی که می‌بینید

توضیح ساده‌ی واژه‌هایی که در zev، Zaryn و این مستندات به کار می‌روند.

### شاخه (Branch) یک رشته از کامیت‌ها با یک نام. مخزن‌ها با `main` شروع می‌شوند. شاخه می‌سازید تا روی چیزی جداگانه کار کنید و بعداً آن را [ادغام](#ادغام-merge) کنید. [شاخه‌ها و ادغام](/docs/fa/branches) را ببینید. ### CI یکپارچه‌سازی پیوسته: سروری که هر بار push می‌کنید پروژه‌تان را خودکار می‌سازد و آزمایش می‌کند. با `zev ci enable` روشنش کنید. ### CID شناسهٔ محتوا: شناسه‌ای که از محتوای یک شیء (یعنی [هش](#هش-hash) آن) ساخته می‌شود، در قالبی که IPFS به کار می‌برد. محتوای یکسان همیشه CID یکسان دارد. ### کلون (Clone) یک نسخهٔ کامل از مخزن، همراه تاریخچه، روی رایانهٔ شما. با `zev clone` ساخته می‌شود. ### کامیت (Commit) یک نسخهٔ ذخیره‌شده از پروژه: تغییرات مرحله‌بندی‌شده، همراه نام شما، زمان و یک پیام. هر کامیت به کامیت پیش از خودش اشاره می‌کند و همین [تاریخچه](#تاریخچه-history) را می‌سازد. با `zev commit` ساخته می‌شود. ### تعارض (Conflict) وقتی دو شاخه همان خط‌های یک فایل را تغییر داده‌اند و zev نمی‌تواند خودش ترکیبشان کند. شما تصمیم می‌گیرید آن خط‌ها چه باشند. [وقتی هر دو طرف همان خط‌ها را تغییر داده‌اند](/docs/fa/branches#وقتی-هر-دو-طرف-همان-خطها-را-تغییر-دادهاند) را ببینید. ### دیف (Diff) تفاوت دو نسخه از یک فایل: خط‌های اضافه‌شده (`+`) و حذف‌شده (`-`). با `zev diff` نشان داده می‌شود. ### فورک (Fork) نسخهٔ خودتان از مخزن کس دیگری روی Zaryn. آزادانه تغییرش می‌دهید و می‌توانید تغییرات را با یک [درخواست ادغام](#درخواست-ادغام-pull-request) پس بفرستید. با `zev fork-repo` ساخته می‌شود. ### هش (Hash) اثر انگشتی کوتاه که از داده ساخته می‌شود. یک بایت را عوض کنید، هش کاملاً عوض می‌شود. zev هر فایل، پوشه و کامیت را با هشش (BLAKE3) می‌شناسد؛ برای همین شناسهٔ کامیت‌ها شبیه `5f7f5e22…` است. ### HEAD کامیتی که الان روی آن هستید: تازه‌ترین کامیت شاخهٔ فعلی. `HEAD~1` یکی پیش از آن است و `HEAD~2` یکی پیش‌تر. ### تاریخچه (History) همهٔ کامیت‌های یک شاخه، از تازه‌ترین تا قدیمی‌ترین. با `zev log` ببینیدش. ### نادیده گرفتن (Ignore) اینکه به zev بگویید بعضی فایل‌ها (خروجی ساخت، لاگ‌ها، رازها) را دنبال نکند، با فهرست کردنشان در فایل `.zevignore`. ### Issue گزارش باگ، ایده یا کاری که به یک مخزن روی Zaryn پیوست است. `zev issue` یکی باز می‌کند. ### ادغام (Merge) آوردن کامیت‌های یک شاخه به شاخه‌ای دیگر. `zev merge <branch>`. ### origin نام معمول ریموتی که پروژه از آن آمده یا در آن منتشر شده. `zev new` و `zev clone` آن را می‌سازند، و `zev push`/`zev pull` وقتی ریموت دیگری نام نبرید از آن استفاده می‌کنند. ### دریافت (Pull) گرفتن کامیت‌های تازه از یک ریموت و به‌روز کردن فایل‌هایتان. `zev pull`. ### درخواست ادغام (Pull request) درخواستی برای ادغام یک شاخه در شاخهٔ دیگر، معمولاً پس از بررسی. با `zev pr` یا در وب‌سایت Zaryn باز می‌شود. ### ارسال (Push) فرستادن کامیت‌هایتان به یک ریموت، مثل Zaryn. `zev push`. ### ریموت (Remote) نشانیِ نام‌گذاری‌شدهٔ یک نسخهٔ دیگر از مخزن، مثل `origin` روی Zaryn. `zev remote` فهرستشان را نشان می‌دهد. ### مخزن (Repository) پروژه‌ای که zev تاریخچه‌اش را نگه می‌دارد: فایل‌هایتان به‌علاوهٔ پوشهٔ `.zev`. به اختصار *repo* هم می‌گویند. ### بازگردانی (Restore) برگرداندن یک فایل به حالتش در آخرین کامیت (دور ریختن ویرایش‌ها)، یا با `--staged` بیرون آوردنش از مرحله‌بندی. `zev restore`. ### مرحله‌بندی (Stage) و ناحیهٔ مرحله‌بندی انتخاب تغییرات برای کامیت بعدی. ناحیهٔ مرحله‌بندی فهرست تغییراتی است که انتخاب کرده‌اید. `zev add` مرحله‌بندی می‌کند و `zev restore --staged` بیرون می‌آورد. ### Stash جایی برای کنار گذاشتن موقت تغییرات کامیت‌نشده، تا پوشه تمیز بماند. `zev stash`، و بعد `zev stash pop` برای برگرداندنشان. ### برچسب (Tag) نامی ثابت برای یک کامیت، معمولاً یک نسخهٔ انتشار مثل `v1.0`. `zev tag`. ### توکن (Token) رازی طولانی که به یک برنامه اجازه می‌دهد از طرف حساب Zaryn شما کار کند، مثل رمزی مخصوص همان برنامه. `zev login` یکی برایتان می‌سازد و ذخیره می‌کند. توکن‌ها را در «تنظیمات ← عامل‌های هوش مصنوعی و توکن‌ها» می‌بینید و باطل می‌کنید. ### فایل ردیابی‌شده (Tracked) فایلی که zev تاریخچه‌اش را نگه می‌دارد: در یک کامیت است یا مرحله‌بندی شده. فایل‌های تازه تا وقتی `zev add` نشوند *ردیابی‌نشده* (untracked) هستند. ### پوشهٔ کاری (Working folder) فایل‌های پروژه‌تان همان‌طور که الان روی دیسک هستند، با تغییراتی که هنوز مرحله‌بندی یا کامیت نکرده‌اید. ### Zaryn وب‌سایت [zaryn.xyz](https://zaryn.xyz)؛ جایی که مخزن‌ها آنلاین هستند، با issue، درخواست ادغام، CI و امکانات دیگر. zev ابزار روی رایانهٔ شماست و Zaryn جایی که در آن به اشتراک می‌گذارید. ### zev ابزار خط فرمان: کنترل نسخه برای کد، داده و مدل. ### .zevignore فایلی که می‌گوید zev چه چیزهایی را نادیده بگیرد. [نادیده گرفتن فایل‌ها](/docs/fa/how-do-i#نادیده-گرفتن-فایلها-خروجی-ساخت-لاگها-رازها) را ببینید.