کد و فایل‌ها

این راهنما فقط فایل‌های ذخیره‌شده در فضای کاری پروژه. فایل‌های بارگذاری‌شده در Chat, رسانه‌های تولیدشده، داده‌های ابری، نسخه‌های منتشرشده، و فایل‌های سرویس‌های متصل به‌صورت جداگانه مدیریت می‌شوند.

پیش از شروع

• از یک مرورگر دسکتاپ استفاده کنید. تجربه Editor در دستگاه‌های همراه محدود است.
• پیش از اعمال تغییرات دستی روی همان فایل‌ها، منتظر بمانید تا Agent کارش را تمام کند.
• آخرین نسخه پروژه را باز کنید. اگر در حال مشاهده نسخه‌ای قدیمی‌تر هستید، Restore را در کنترل‌های نسخه انتخاب کنید، Restore, را تأیید کنید و پیش از ویرایش منتظر بمانید تا بازیابی کامل شود.
• ویرایش یا دانلود یک پروژه ممکن است به یک طرح پولی واجد شرایط نیاز داشته باشد.

هرگز گذرواژه‌ها، کلیدهای API، توکن‌های دسترسی، یا سایر اطلاعات محرمانه را مستقیماً در فایل‌های منبع یا Chat قرار ندهید.

باز کردن Editor

1. یک پروژه موجود را باز کنید.
2. گزینه Editor را از نوار ابزار پروژه انتخاب کنید.
3. منتظر بمانید تا درخت فایل و نمایشگر فایل بارگذاری شوند.

درخت فایل در سمت چپ نمایش داده می‌شود. فایل انتخاب‌شده در سمت راست در یک ویرایشگر کد یا پیش‌نمایش باز می‌شود. ابزارهای نمایش‌داده‌شده برای یک فایل به قالب آن و وضعیت فعلی پروژه بستگی دارند.

یافتن و پیش‌نمایش فایل‌ها

جستجو بر اساس نام فایل یا پوشه

1. گزینه Search در بالای درخت فایل.
2. بخشی از نام فایل یا پوشه را وارد کنید.
3. برای باز کردن، یک نتیجه منطبق را انتخاب کنید.

جستجو با نام فایل‌ها و پوشه‌ها مطابقت می‌دهد. متن داخل فایل‌ها را جستجو نمی‌کند. اگر موردی را پیدا نمی‌کنید، عبارت جستجو را کوتاه‌تر کنید، جستجو را پاک کنید، و پوشه‌های مرتبط را به‌صورت دستی باز کنید.

درخت فایل Editor را بر اساس نام فایل یا پوشه جستجو کنید.

پیش‌نمایش یک فایل

یک فایل را در درخت انتخاب کنید. Atoms می‌تواند از فایل‌های رایج کد و متنی، HTML، Markdown، فایل‌های DOCX و XLSX، تصاویر، صوت و ویدیوی پشتیبانی‌شده، PDFها، فایل‌های CSV، و نوت‌بوک‌های Jupyter پیش‌نمایش ارائه دهد. پیش‌نمایش موجود به نوع فایل بستگی دارد.

اگر امکان پیش‌نمایش یک فایل یا پوشه وجود ندارد، آن را دانلود کنید و در یک برنامه سازگار باز کنید.

ویرایش کد پروژه

1. یک فایل کد یا متنی پشتیبانی‌شده را باز کنید.
2. تغییرات خود را در ویرایشگر اعمال کنید.
3. منتظر بمانید تا نشانگر ذخیره‌سازی کامل شود. ذخیره‌سازی نشست ویرایش فعلی شما را همگام‌سازی می‌کند، اما هنوز کل نشست را اعمال نمی‌کند.
4. گزینه Preview را برای بررسی نتیجه انتخاب کنید، هر زمان که پیش‌نمایش در دسترس باشد.
5. گزینه Submit all را برای اعمال نشست انتخاب کنید، یا Discard all را برای بازگرداندن ویرایش‌های آن نشست انتخاب کنید.

ویرایش‌های دستی و تغییرات تولیدشده توسط Agent می‌توانند روی همان فایل‌ها اثر بگذارند. پیش از اینکه از Agent بخواهید پروژه را تغییر دهد، ویرایش‌های فعلی خود را اعمال یا رد کنید، و پیش از ایجاد یک تغییر بزرگ از تاریخچه پروژه استفاده کنید.

یک نشست ویرایش در Editor را پیش‌نمایش کنید، رد کنید، یا اعمال کنید.

اگر Editor فقط خواندنی است

ممکن است Editor به‌طور موقت هنگام کار Agent، در حال انجام بودن ذخیره‌سازی، یا زمانی که در حال مشاهده نسخه‌ای قدیمی‌تر از پروژه هستید، از اعمال تغییرات جلوگیری کند. همچنین ممکن است برای یک پروژه پشتیبانی‌نشده یا حسابی بدون دسترسی لازم فقط خواندنی باشد.

منتظر بمانید تا عملیات فعلی کامل شود، آخرین نسخه را باز کنید، و صفحه را تازه‌سازی کنید. اگر در حال مشاهده نسخه‌ای قدیمی‌تر هستید، Restore را در کنترل‌های نسخه انتخاب کنید، Restore, را انتخاب کنید، منتظر بمانید تا بازیابی کامل شود، و آخرین نسخه را دوباره باز کنید. تأیید کنید که نشانگر Read only پیش از ویرایش دیگر نمایش داده نمی‌شود.

استفاده از کد در Chat و مقایسه تغییرات

افزودن یک فایل کامل به Chat

فایل را باز کنید، روی ... عمودی کلیک کنید و Select file را زمانی که این عمل در دسترس است انتخاب کنید. همچنین می‌توانید # را در Chat تایپ کنید و یک فایل پروژه را انتخاب کنید. فایل به‌عنوان زمینه برای درخواست بعدی شما اضافه می‌شود.

اقدام‌های فایل فعلی را باز کنید و Select file را انتخاب کنید.

مقایسه یک تغییر

گزینه Diff را هر زمان که در دسترس است انتخاب کنید تا پیش از اعمال تغییر، نسخه‌های اصلی و تغییر‌یافته یک فایل را مقایسه کنید.

مدیریت فایل‌ها و پوشه‌ها

از ... در کنار یک مورد در درخت فایل استفاده کنید تا اقدام‌های موجود برای آن فایل یا پوشه را ببینید. بسته به مورد و وضعیت پروژه، می‌توانید فایل‌ها و پوشه‌ها را ایجاد، بارگذاری، تغییر نام، دانلود، یا حذف کنید.

1. فایل یا پوشه را در درخت پیدا کنید.
2. گزینه ....
3. اقدام موردنیاز را انتخاب کنید و دستور روی صفحه را دنبال کنید.

حذف یک فایل یا پوشه قابل بازگشت نیست. پیش از حذف فایل‌های مهم پروژه، یک نسخه امن از پروژه ایجاد کنید یا یک کپی دانلود کنید.

برخی اقدام‌های فایل زمانی که Agent در حال تغییر پروژه است یا یک نشست ویرایش در حال ذخیره شدن است، در دسترس نیستند. منتظر بمانید تا عملیات فعلی کامل شود و دوباره تلاش کنید.

دانلود کد و فایل‌ها

دانلود فایل فعلی

1. فایل را در Editor باز کنید.
2. گزینه Download را از اقدام‌های فایل فعلی انتخاب کنید.
3. محل دانلود مرورگر خود را باز کنید و فایل را بررسی کنید.

دانلود یک پوشه

1. گزینه ... در کنار پوشه.
2. گزینه Download. Atoms پوشه را به‌صورت یک بایگانی ZIP بسته‌بندی می‌کند.
3. بایگانی را باز کنید و محتوای آن را بررسی کنید.

دانلود پروژه فعلی

1. در Editor، گزینه Download Project را زیر درخت فایل انتخاب کنید.
2. هنگام آماده‌سازی بایگانی توسط Atoms، صفحه را باز نگه دارید.
3. فایل ZIP دانلودشده را باز کنید و فایل‌های موردنیاز خود را بررسی کنید.

باید وارد حساب خود شده باشید. دانلود کد منبع پروژه فعلی ممکن است به یک طرح پولی واجد شرایط نیاز داشته باشد. دانلود از Editor همچنین ممکن است در نمای اشتراکی و فقط‌خواندنی پروژه در دسترس نباشد.

خروجی گرفتن از Share

همچنین می‌توانید Share را باز کنید و Export. را انتخاب کنید. این روش دیگری برای خروجی گرفتن از پروژه به‌صورت ZIP فراهم می‌کند. پیش از اینکه به بایگانی دانلودشده به‌عنوان تحویل نهایی یا نسخه پشتیبان تکیه کنید، آن را بررسی کنید.

Share را باز کنید و Export را برای دانلود پروژه انتخاب کنید.