نمای کلی
Prism فضای کاری مشارکتی LaTeX است که از پایه با هوش مصنوعی و بر مبنای مدل‌های پیشرو ساخته شده تا به پژوهشگران کمک کند سریع‌تر فکر کنند، بنویسند و کارشان را بهبود دهند. هوش مصنوعی تعبیه‌شده در آن، هم سرعت و هم عمق کار علمی را افزایش می‌دهد.
این راهنما روش عیب‌یابی مشکلات رایج و راه‌های دریافت کمک بیشتر را توضیح می‌دهد.
دسترسی به Prism
Prism در نشانی prism.openai.com برای همه کاربران دارای حساب ChatGPT با طرح Free، Go، Plus یا Pro در دسترس است، به‌شرط آنکه اکنون یا در گذشته عضو فضای کاری 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 در حال حاضر از گزینه «عدم ذخیره داده» (ZDR) در API استفاده نمی‌کند و پس از درخواست‌ها، گزارش‌ها را برای مدتی به‌منظور بهبود محصول نگه می‌دارد.
پرسش: آیا حالتی برای حفظ حریم خصوصی دارید که در آن هیچ متنی ذخیره یا توسط انسان بررسی نشود، و/یا محل اقامت داده فقط در اتحادیه اروپا باشد؟ پاسخ: این قابلیت‌ها درخواست شده‌اند و در نقشه راه یا فهرست کارهای آتی قرار دارند، اما هنوز زمان‌بندی قطعی برای آن‌ها تعیین نشده است.
اشتراک‌گذاری و همکاری
س: چرا نمی‌توانم پیوندی با گزینه «همه می‌توانند ویرایش کنند» به اشتراک بگذارم؟ (در فهرست کشویی فقط «همه می‌توانند مشاهده کنند» وجود دارد.) پ: این رفتار در حال حاضر عمدی است. اشتراک‌گذاری از طریق پیوند با امکان «ویرایش توسط همه» هنوز پشتیبانی نمی‌شود؛ ویرایشگران باید به‌عنوان همکار افزوده شوند و حساب 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 داخل یک فریم خطا می‌دهند (مثلاً «Extra }, or forgotten \endgroup»)؟ پاسخ: هنگام استفاده از محیط‌های listing، گزینه [fragile] را برای فریم Beamer تعیین کنید؛ این کار اغلب این خطاها را برطرف می‌کند.
پرسش: ارجاع‌های \cite من به‌صورت «[?]» نمایش داده می‌شوند، با اینکه فایل .bib موجود است و دستورهای کتاب‌نامه هم وجود دارند. چه پیکربندی‌ای جواب می‌دهد؟ یکی از راه‌حل‌های مؤثر این است که مطمئن شوید کتاب‌نامه به‌درستی از سند اصلی فراخوانی می‌شود؛ اگر از روش BibTeX استفاده می‌کنید، دستورهای \bibliographystyle{plain} و \bibliography{refs} را اضافه کنید (با فرض اینکه نام فایل شما refs.bib است).
رابط کاربری محصول و درخواست قابلیت‌ها
پرسش: آیا Prism حالت روشن دارد؟ پاسخ: بله. Prism از سه تنظیم ظاهری پشتیبانی می‌کند: سیستم، روشن و تیره. می‌توانید پوسته‌ای را انتخاب کنید که برایتان مناسب‌تر است.