عیبیابی و دریافت راهنمایی در Prism
Prism یک فضای کاری مشارکتی و مبتنی بر LaTeX است که با محوریت هوش مصنوعی و بر پایه مدلهای پیشرو ساخته شده تا پژوهشگران بتوانند سریعتر بیندیشند، بنویسند و کارشان را بهبود دهند. هوشمندی تعبیهشده در آن، هم سرعت و هم عمق کار علمی را افزایش میدهد.
این راهنما روش عیبیابی مشکلات رایج و محل دریافت راهنمایی بیشتر را توضیح میدهد.
نحوه دسترسی به Prism
Prism در prism.openai.com برای همه کاربرانی در دسترس است که حساب Free، Go، Plus یا Pro در ChatGPT دارند و عضو فضای کاری Business یا Enterprise نیستند و قبلاً هم نبودهاند. در آینده نزدیک، دسترسی را به Business، Enterprise و Edu گسترش خواهیم داد.
۱. استفاده از هوشمندی داخلی Prism
Prism دستیاری یکپارچه با ویرایشگر دارد که از مدلهای پیشرو OpenAI قدرت میگیرد. این دستیار بافت سندتان را درک میکند و بدون نیاز به ترک ویرایشگر، در تولید LaTeX، تشخیص خطاها و پیشنهاد اصلاحات به شما کمک میکند. میتوانید از پنل پایین فضای کاری به آن دسترسی پیدا کنید.
تولید قطعهکدهای LaTeX: از Prism بخواهید عناصر رایج LaTeX را ایجاد کند؛ برای مثال، «یک جدول ۴×۴ بساز» یا «یک شکل با زیرنویس اضافه کن». Prism کد LaTeX آماده استفاده را ارائه میدهد و گزینههای «نگهداشتن» و «واگردانی» را در اختیارتان میگذارد تا بتوانید آن را مستقیماً در پروژه درج کنید.
تشخیص مشکلات کامپایل: اگر سندتان کامپایل نمیشود، مشکل را در پنل شرح دهید (برای مثال، «سند من کامپایل نمیشود»). Prism پرسشهایی برای روشنتر شدن موضوع مطرح میکند و شما را برای یافتن علتهای محتمل، مانند فرمانهای ناقص یا ارجاعهای حلنشده، راهنمایی میکند.
رفع خطا در همان محل: خطاها و هشدارها بهصورت نشانگرهای قرمز یا زرد در حاشیه ویرایشگر ظاهر میشوند. میتوانید از Prism بخواهید خطای مشخصی را برطرف کند؛ در این صورت، خطوط مرتبط را تحلیل میکند، مشکل را توضیح میدهد و ویرایشهای هدفمندی پیشنهاد میکند. میتوانید پیشنهاد را مستقیماً اعمال و دوباره کامپایل کنید تا از رفع مشکل مطمئن شوید.
نمونهخوانی: از Prism بخواهید بخشی را نمونهخوانی کند، خطاها یا خلأهای منطقی را مشخص کند و برای افزایش وضوح آن بخش پیشنهادهایی ارائه دهد. میتوانید از مهارتهایی مانند «بررسی مقاله» برای دریافت بازخورد ویرایشی و محتوایی استفاده کنید.
جستوجوی منابع: یک کتابنامه به مقالهام اضافه کن و پژوهشهای مرتبطی را که ممکن است از قلم انداخته باشم پیشنهاد بده.
۲. تشخیص خطاهای کامپایل
اگر سند LaTeX شما کامپایل نمیشود، مراحل زیر را امتحان کنید:
نشانگر خطا را بررسی کنید: نشانگرهای قرمز و زرد محل تشخیص مشکل توسط Prism را مشخص میکنند. برای مشاهده جزئیات روی نشانگر کلیک کنید، سپس از دستیار داخلی برای تشخیص خطا کمک بگیرید.
گزارش کامپایل را بررسی کنید: وقتی کامپایل ناموفق باشد، بخش پیشنمایش PDF گزارش کامپایل را نمایش میدهد. بر اولین پیام خطا تمرکز کنید (برای مثال، نبودن \end{document})، زیرا خطاهای بعدی اغلب پیامد زنجیرهای همان خطا هستند. برای دریافت راهنمایی دقیقتر، این پیام را با Prism به اشتراک بگذارید.
تغییرات اخیر را برگردانید: اگر خطا پس از ویرایشی جدید ظاهر شده است، آن تغییر را واگردانی یا موقتاً به دیدگاه تبدیل کنید تا ببینید کامپایل موفق میشود یا نه.
یک نمونه حداقلی بسازید: اگر مشکل ادامه داشت، سند را به محتوای ضروری محدود کنید. حذف بخشهای نامرتبط، شناسایی منشأ خطا را آسانتر میکند.
۳. روشهای پیشنهادی برای جلوگیری از مشکلات
وارد حساب بمانید: همیشه پس از ورود به حساب کار کنید تا تغییراتتان ذخیره شود و در نشستهای بعدی نیز در دسترس باشد.
از بستههای پشتیبانیشده استفاده کنید: Prism از بسیاری از بستههای پرکاربرد LaTeX پشتیبانی میکند. بستههای نادر، قدیمی یا بدون نگهدارنده ممکن است باعث خطاهای غیرمنتظره در کامپایل شوند.
گامبهگام ویرایش کنید: تغییرات کوچک انجام دهید و مرتباً کامپایل کنید. به این ترتیب، میتوانید آسانتر تشخیص دهید کدام ویرایش باعث خطا شده و سریعتر مشکل را برطرف کنید.
انتقال پروژههای LaTeX به Prism
این راهنما توضیح میدهد که چگونه پروژههای فعلی LaTeX را از Overleaf یا رایانه محلی خود به Prism منتقل کنید. درونریزی پروژهها همهچیز را در یک محل نگه میدارد و به شما امکان میدهد بدون بازسازی دستی فایلها به کار ادامه دهید.
درونریزی پروژهها از Overleaf
برای انتقال پروژهای از Overleaf به Prism، ابتدا فایلهای پروژه را از Overleaf دانلود و سپس در Prism بارگذاری کنید.
دانلود یک پروژه
پیشخوان پروژههای Overleaf خود را باز کنید.
پروژهای را که میخواهید منتقل کنید پیدا کنید.
در ردیف نام پروژه، روی نماد دانلود کلیک کنید.
Overleaf کل پروژه را بهصورت یک فایل .zip در رایانه شما دانلود میکند.
دانلود چند پروژه
فهرست پروژههای Overleaf خود را باز کنید.
پروژهها را با استفاده از کادر انتخاب ابتدای هر ردیف انتخاب کنید.
برای انتخاب همه موارد، روی اولین کادر انتخاب در فهرست کلیک کنید.
پس از انتخاب، روی نماد دانلود در گوشه بالا سمت راست فهرست پروژهها کلیک کنید.
پروژههای انتخابشده بهصورت فایلهای .zip دانلود میشوند.
درونریزی پروژهها به Prism
Prism میتواند پروژهها را به سه روش درونریزی کند: بارگذاری یک پوشه، بارگذاری یک بایگانی .zip یا کشیدن و رها کردن فایلها در نمای همه پروژهها.
برای درونریزی پروژه از منوی «درونریزی»:
Prism را باز کنید و به بخش درونریزی بروید.
برای انتخاب نوع درونریزی، روی فلش کنار درونریزی کلیک کنید.
یکی از گزینههای زیر را انتخاب کنید:
Prism را باز کنید و به گزینه درونریزی بروید.
برای انتخاب نوع درونریزی، روی فلش کنار درونریزی کلیک کنید.
یکی از گزینههای زیر را انتخاب کنید:
درونریزی فایل .zip: بایگانی دانلودشده پروژه را از رایانه خود انتخاب کنید. Prism بهطور خودکار پروژه را از حالت فشرده خارج و بارگذاری میکند.
درونریزی پوشه: پوشه پروژه را از رایانه خود انتخاب کنید. Prism فایلهای .tex، فایلهای کتابنامه، تصاویر و دیگر منابع پروژه را درونریزی میکند.
برای درونریزی با کشیدن و رها کردن: در نمای همه پروژهها، پوشه پروژه یا فایل .zip را بکشید و در Prism رها کنید. Prism بهطور خودکار پروژهای جدید ایجاد و فایلها را برایتان درونریزی میکند.
پس از پایان بارگذاری، Prism کل پروژه را باز میکند تا بتوانید ویرایش و کامپایل را آغاز کنید.
سایر پرسشهای متداول
حساب، امنیت و صورتحساب
س: سیاست حفظ حریم خصوصی شما را کجا میتوانم پیدا کنم؟ پ: سیاست حفظ حریم خصوصی Prism را میتوانید از اینجا مشاهده کنید.
س: آیا با دادههای من مدلها را آموزش میدهید؟ پ: مطابق سیاست حفظ حریم خصوصی ما، کاربران کاملاً کنترل میکنند که آیا دادههایشان برای کمک به بهبود مدلهای ما استفاده شود یا نه.
س: آیا از «عدم ذخیره داده» (ZDR) استفاده میکنید؟ چه نوع ثبت و نگهداری دادهای انجام میشود؟ پ: Prism در حال حاضر از گزینه API مربوط به «عدم ذخیره داده» (ZDR) استفاده نمیکند و برای بهبود محصول، گزارشها را تا مدتی پس از درخواستها نگه میدارد.
س: آیا حالتی برای حفظ حریم خصوصی ارائه میدهید که در آن هیچ متنی ذخیره یا توسط انسان بررسی نشود و/یا محل اقامت داده فقط در اتحادیه اروپا باشد؟ پ: این قابلیتها درخواست شده و در نقشه راه یا فهرست کارهای آتی قرار دارند، اما هنوز زمانبندی قطعی برای آنها تعیین نشده است.
اشتراکگذاری و همکاری
س: چرا نمیتوانم پیوندی با گزینه «همه میتوانند ویرایش کنند» به اشتراک بگذارم؟ (در فهرست کشویی فقط «همه میتوانند مشاهده کنند» وجود دارد.) پ: این رفتار در حال حاضر عمدی است. اشتراکگذاری از طریق پیوند با امکان «ویرایش توسط همه» هنوز پشتیبانی نمیشود؛ ویرایشگران باید بهعنوان همکار افزوده شوند و حساب Prism داشته باشند.
س: همکاران ایمیل دعوت را دریافت نمیکنند؛ چگونه میتوانند به پروژه دسترسی پیدا کنند؟ پ: از آنها بخواهید پوشه هرزنامه را بررسی و با همان نشانی ایمیلی که دعوت شده است وارد شوند. پروژه مشترک باید پس از نخستین ورود برایشان نمایش داده شود.
درونریزی و برونبری پروژه
س: بارگذاری یا درونریزی فایل ZIP من روی پیام «در حال درونریزی پروژه شما» متوقف شده است. چهکار کنم؟ پ: بارگذاری را دوباره امتحان کنید. اگر پس از تلاش دوباره همچنان متوقف بود، فایل ZIP را با پشتیبانی به اشتراک بگذارید تا مسیر درونریزی عیبیابی شود.
س: چگونه پروژهام را بهصورت ZIP برونبری یا دانلود کنم؟ پ: روی نام پروژه کلیک کنید و سپس «برونبری» را انتخاب کنید تا یک نسخه فشرده از پروژه دانلود شود. ممکن است پیش از فعال شدن امکان برونبری، برقراری اتصال با بخش پشتیبان چند ثانیه طول بکشد.
پایداری، قطعیها و اتصال
س: پروژههایم پس از تازهسازی ناپدید شدند. آیا از دست رفتهاند؟ پ: دوباره صفحه را تازه و فهرست پروژهها را بررسی کنید؛ دادههایتان باید دوباره ظاهر شوند.
س: پروژههایم پس از تازهسازی صفحه ناپدید شدند. آیا از دست رفتهاند؟ پ: این اتفاق ممکن است هنگام قطعی سرویس یکی از ارائهدهندگان رخ دهد. دوباره امتحان کنید؛ پروژههایتان باید ظاهر شوند. اگر ظاهر نشدند، پشتیبانی میتواند در بازیابی آنها کمک کند.
س: به نظر میرسد سایت آفلاین است یا برنامه میگوید نمیتواند به بخش پشتیبان متصل شود. چهکار کنم؟ پ: دوباره امتحان کنید یا صفحه را از نو بارگذاری کنید. اگر مشکل ادامه داشت، جزئیات آنچه میبینید و در صورت امکان پیوند پروژه را برای پشتیبانی بفرستید تا بررسی شود.
یکپارچگی داده، بازیابی، نسخههای پشتیبان و تاریخچه نسخهها
س: سندم متوقف شد، سپس بخشی از محتوا ناپدید شد و محل اتصال دیدگاهها جابهجا شد. میتوانم آن را بازیابی کنم؟ پ: ابتدا یک نسخه پشتیبان .zip دانلود کنید. Prism تاریخچه نسخهها را نیز در اختیارتان میگذارد که ممکن است امکان بازیابی نسخهای قدیمیتر را فراهم کند. موقعیت محل اتصال دیدگاهها ممکن است همیشه بازیابیپذیر نباشد و در حال حاضر دیدگاهها در نسخههای پشتیبان صادر نمیشوند. اگر قالببندی تغییر کرده است، برای اصلاح آن از قالببند کد استفاده کنید.
س: پروژهای را دوباره باز کردم، اما فایلها یا محتوا به نسخه قبلی برگشته یا ناپدید شدهاند؛ چه اتفاقی افتاده است؟ پ: در مقطعی، ذخیرهسازی پروژهها به ارائهدهندهای خارجی متکی بود که هنگام افزایش ناگهانی استفاده نتوانست پاسخگو باشد. برای کاهش خطاهای اتصال و جلوگیری از تکرار مشکل، ذخیرهسازی به سامانهای داخلی منتقل شد و تدابیر حفاظتی بیشتری نیز افزوده شد.
س: آیا موقعیت دیدگاهها قابل بازیابی است و آیا دیدگاهها در نسخههای پشتیبان پروژه قرار میگیرند؟ پ: ممکن است پس از وقوع مشکل، موقعیت دیدگاهها قابل بازیابی نباشد. اکنون برای بازیابی در رخدادهای آینده، بهصورت دورهای نسخه پشتیبان تهیه میشود (برای مثال، تقریباً هر ۱۰ دقیقه)، اما دیدگاهها در حال حاضر در نسخههای پشتیبان ZIP صادر نمیشوند.
یکپارچهسازیها
Zotero
س: چرا نمیتوانم کتابخانههای گروهی Zotero را به Prism درونریزی کنم؟ پ: کتابخانههای گروهی Zotero هنوز پشتیبانی نمیشوند؛ کتابخانههای فردی کار میکنند، اما کتابخانههای گروهی فعلاً پشتیبانی نمیشوند.
س: یکپارچهسازی Zotero من متوقف شده است (برای مثال، پس از تغییر حساب یا کلیدهای API). چگونه میتوان آن را برطرف کرد؟ پ: پشتیبانی به شناسه عددی Zotero شما، نه نام کاربری، نیاز دارد تا اتصال یکپارچهسازی را از کاربر قبلی یا ناشناس قطع کند. سپس میتوانید دوباره آن را به حسابتان متصل کنید. نمونه روش انجام این کار: https://www.youtube.com/watch?v=7vDiZ8o_eHk
Git
س: آیا میتوانم پروژهای در Prism را از طریق Git (GitHub/GitLab) شبیهسازی کنم یا آن را با پلتفرم Git مؤسسهام همگام نگه دارم؟ پ: یکپارچهسازی Git هنوز در دسترس نیست، اما یکی از پروژههای توسعهای آتی با اولویت بالا است.
ساخت و عیبیابی LaTeX
س: چگونه بازسازی کامل و پاک را اجباری کنم (پاک کردن فایلهای جانبی Aux/toc/bbl)؟ پ: صفحه را دوباره بارگذاری کنید. تازهسازی صفحه باعث اجرای یک ساخت پاک و تازه میشود.
س: شکلها یا تصاویر در Prism بارگذاری نمیشوند، اما همان کد LaTeX در جای دیگری کار میکند. پ: از مسیرهایی استفاده کنید که نسبت به فایل .tex واردکننده تعریف شدهاند. اگر فایل .tex در زیرپوشه و تصویر در ریشه پروژه است، ابتدای مسیر ../ را اضافه کنید.
س: کامپایل بسیار کند است یا هرگز تمام نمیشود. چگونه علت را پیدا کنم؟ پ: بخشها و سپس قسمتهای کوچکتر هر بخش را به دیدگاه تبدیل کنید تا کامپایل موفق شود؛ سپس محدوده را آنقدر کوچک کنید تا خط دقیق عامل مشکل مشخص شود. هشدارها و خطاهای گزارشها را نیز از اولین مورد به بعد بررسی کنید.
س: در فایل .bbl تولیدشده هشدارهای «Underfull/Overfull \hbox» دریافت میکنم. آیا این خطای کامپایل است؟ پ: خیر، اینها هشدارهای حروفچینی هستند، نه خطاهای مرگبار کامپایل. اگر خروجی PDF قابل قبول است، معمولاً میتوان هشدار را نادیده گرفت.
س: چرا در Beamer، محیطهای lstlisting/listings درون یک frame خطا میدهند (برای مثال، «Extra }, or forgotten \endgroup»)؟ پ: هنگام استفاده از محیطهای listing، فریم Beamer را با [fragile] علامتگذاری کنید؛ این کار اغلب خطاها را برطرف میکند.
س: با وجود فایل .bib و فرمانهای کتابنامه، ارجاعهای \cite بهشکل «[?]» نمایش داده میشوند. چه پیکربندیای کار میکند؟ یکی از راهکارهای موفق این است که مطمئن شوید کتابنامه بهدرستی از سند اصلی گنجانده شده است؛ در گردشکارهای مبتنی بر BibTeX، \bibliographystyle{plain} و \bibliography{refs} را اضافه کنید (با فرض اینکه فایل شما refs.bib است).
رابط کاربری محصول و درخواست قابلیتها
س: آیا Prism حالت روشن دارد؟ پ: بله. Prism از سه تنظیم ظاهری پشتیبانی میکند: سیستم، روشن و تیره. میتوانید پوستهای را انتخاب کنید که برایتان مناسبتر است.