Усунення проблем і отримання допомоги в Prism

Prism — це спільний робочий простір LaTeX із вбудованим ШІ на основі передових моделей, який допомагає дослідникам швидше обмірковувати, писати й удосконалювати свої роботи. Вбудований інтелект підвищує швидкість і поглиблює наукову роботу.

У цьому посібнику описано, як усувати поширені проблеми та де шукати додаткову допомогу.

Як отримати доступ до Prism

Prism доступний на prism.openai.com для всіх користувачів облікових записів ChatGPT Free, Go, Plus або Pro, які не є й ніколи не були учасниками робочого простору Business або Enterprise. Найближчим часом ми розширимо доступ для Business, Enterprise та Edu.

1. Використання вбудованого інтелекту Prism

Prism має вбудованого в редактор помічника на основі передових моделей OpenAI. Він розуміє контекст документа й може створювати код LaTeX, діагностувати помилки та пропонувати виправлення, не змушуючи вас залишати редактор. Відкрити його можна на панелі в нижній частині робочого простору.

1. Створення фрагментів LaTeX: попросіть Prism створити поширені елементи LaTeX, наприклад: «Створи таблицю 4×4» або «Додай рисунок із підписом». Prism поверне готовий до використання код LaTeX і запропонує варіанти «Зберегти» та «Скасувати», щоб ви могли вставити його безпосередньо у свій проєкт.

2. Діагностика проблем із компіляцією: якщо документ не компілюється, опишіть проблему на панелі, наприклад: «Мій документ не компілюється». Prism поставить уточнювальні запитання та допоможе перевірити ймовірні причини, як-от відсутні команди або нерозв’язані посилання.

3. Виправлення помилок безпосередньо в тексті: помилки й попередження відображаються на полях редактора як червоні або жовті позначки. Ви можете попросити Prism виправити певну помилку. Він проаналізує відповідні рядки, пояснить проблему та запропонує цільові зміни. Ви можете відразу застосувати пропозицію та повторно скомпілювати документ, щоб перевірити виправлення.

4. Вичитування: попросіть Prism вичитати розділ, виділити помилки або прогалини в логіці та запропонувати, як зробити виклад зрозумілішим. Для редакторського відгуку та перевірки фактів можна скористатися Навичками, наприклад «Рецензування наукової роботи».

5. Пошук літератури: додай бібліографію до моєї роботи й запропонуй пов’язані праці, які я міг пропустити.

2. Діагностика помилок компіляції

Якщо документ LaTeX не компілюється, виконайте наведені нижче дії.

1. Перевірте позначку помилки: червоні й жовті позначки вказують, де Prism виявив проблему. Натисніть позначку, щоб переглянути подробиці, а потім скористайтеся вбудованим помічником для діагностики помилки.

2. Перегляньте журнал компіляції: якщо компіляція завершується невдало, на панелі попереднього перегляду PDF з’являється журнал компіляції. Зосередьтеся на першому повідомленні про помилку (наприклад, про відсутність \end{document}), оскільки наступні помилки часто є каскадними наслідками. Надішліть це повідомлення Prism, щоб отримати точніші рекомендації.

3. Скасуйте останні зміни: якщо помилка з’явилася після нещодавнього редагування, скасуйте цю зміну або тимчасово закоментуйте її та перевірте, чи завершиться компіляція успішно.

4. Скоротіть документ до мінімального прикладу: якщо проблеми не зникають, залиште в документі лише необхідний вміст. Видалення непов’язаних розділів допоможе визначити джерело помилки.

3. Рекомендації щодо запобігання проблемам

1. Не виходьте з облікового запису: завжди працюйте після входу, щоб зміни зберігалися й були доступні в наступних сеансах.

2. Використовуйте підтримувані пакети: Prism підтримує багато поширених пакетів LaTeX. Рідкісні, застарілі або непідтримувані пакети можуть спричиняти неочікувані помилки компіляції.

3. Редагуйте поступово: вносьте невеликі зміни й часто компілюйте документ. Так буде простіше визначити, яка саме зміна спричинила помилку, і швидко відновити роботу.

Перенесення проєктів LaTeX до Prism

У цьому посібнику пояснюється, як перенести до Prism наявні проєкти LaTeX з Overleaf або локального комп’ютера. Імпорт дає змогу зберігати всі проєкти в одному місці та продовжувати роботу без ручного відновлення файлів.

Імпорт проєктів з Overleaf

Щоб перенести проєкт з Overleaf до Prism, спочатку завантажте файли проєкту з Overleaf, а потім передайте їх до Prism.

Завантаження одного проєкту

1. Відкрийте панель проєктів Overleaf.

2. Знайдіть проєкт, який потрібно перенести.

3. Натисніть значок завантаження у тому самому рядку, що й назва проєкту.

4. Overleaf завантажить увесь проєкт на ваш комп’ютер як файл .zip.

Завантаження кількох проєктів

1. Відкрийте список проєктів Overleaf.

2. Виберіть проєкти за допомогою прапорця на початку кожного рядка.

1. Щоб вибрати всі проєкти, установіть перший прапорець у списку.

2. Вибравши проєкти, натисніть значок завантаження у верхньому правому куті списку проєктів.

Вибрані проєкти буде завантажено як файли .zip.

Імпорт проєктів до Prism

Prism дає змогу імпортувати проєкти трьома способами: завантажити папку, завантажити архів .zip або перетягнути файли до подання Усі проєкти.


Щоб імпортувати проєкт із меню «Імпорт»:

1. Відкрийте Prism і перейдіть до розділу Імпорт.

2. Натисніть шеврон поруч із пунктом Імпорт, щоб вибрати тип імпорту.

Виберіть один із наведених нижче варіантів.

1. Відкрийте Prism і перейдіть до пункту Імпорт.

2. Натисніть шеврон поруч із пунктом «Імпорт», щоб вибрати тип імпорту.

3. Виберіть один із наведених нижче варіантів.

Імпорт файлу .zip: виберіть на комп’ютері завантажений архів проєкту. Prism автоматично розпакує та завантажить проєкт.


Імпорт папки: виберіть папку проєкту на комп’ютері. Prism імпортує файли .tex, файли бібліографії, зображення та інші ресурси проєкту.


Щоб імпортувати перетягуванням: у поданні Усі проєкти перетягніть до Prism папку проєкту або файл .zip. Prism автоматично створить новий проєкт та імпортує файли.

Після завершення завантаження Prism відкриє весь проєкт, і ви зможете почати редагування та компіляцію.

Інші поширені запитання

Обліковий запис, безпека й оплата

Запитання: Де можна знайти вашу політику конфіденційності? Відповідь: Політику конфіденційності Prism можна знайти тут.

Запитання: Чи використовуєте ви мої дані для навчання моделей? Відповідь: Користувачі повністю контролюють, чи використовуються їхні дані для вдосконалення наших моделей відповідно до нашої Політики конфіденційності.

Запитання: Чи використовуєте ви «нульове збереження даних» (ZDR)? Які дані журналюються та зберігаються? Відповідь: Наразі Prism не використовує параметр API «нульове збереження даних» (ZDR) і протягом певного часу після запитів зберігає журнали для вдосконалення продукту.


Запитання: Чи пропонуєте ви режим конфіденційності, у якому текст не зберігається й не перевіряється людьми, та/або вимоги до локалізації даних лише в ЄС? Відповідь: Ці функції запитували користувачі. Вони внесені до плану розробки або списку завдань, але конкретних термінів упровадження поки немає.

Спільний доступ і співпраця

Запитання: Чому я не можу поділитися посиланням із дозволом «редагувати можуть усі»? (У розкривному списку доступний лише варіант «переглядати можуть усі».) Відповідь: Наразі це передбачена поведінка. Спільний доступ за посиланням із дозволом «редагувати можуть усі» поки не підтримується. Редакторів потрібно додавати як співавторів, які мають обліковий запис Prism.


Запитання: Співавтори не отримують електронних листів із запрошенням. Як їм відкрити проєкт? Відповідь: Попросіть їх перевірити папку зі спамом або небажаною поштою та ввійти за допомогою адреси електронної пошти, на яку надіслано запрошення. Після першого входу спільний проєкт має з’явитися в їхньому списку.

Імпорт і експорт проєктів

Запитання: Завантаження або імпорт ZIP-файлу зупинилися на повідомленні «Імпортуємо ваш проєкт». Що робити? Відповідь: Спробуйте завантажити файл ще раз. Якщо після повторної спроби процес усе ще не рухається, надішліть ZIP-файл службі підтримки, щоб вона могла налагодити процес імпорту.


Запитання: Як експортувати або завантажити проєкт у форматі ZIP? Відповідь: Натисніть назву проєкту, а потім виберіть «Експортувати», щоб завантажити стиснену копію проєкту. Перш ніж експорт стане доступним, може знадобитися кілька секунд для встановлення з’єднання із серверною частиною.

Надійність, перебої та підключення

Запитання: Мої проєкти зникли після оновлення. Їх утрачено? Відповідь: Оновіть сторінку ще раз і повторно перевірте список проєктів. Ваші дані мають з’явитися знову.


Запитання: Мої проєкти зникли після оновлення сторінки. Їх утрачено? Відповідь: Таке може трапитися під час збою в постачальника послуг. Спробуйте ще раз — ваші проєкти мають з’явитися. Якщо цього не станеться, служба підтримки допоможе їх відновити.


Запитання: Схоже, сайт не працює, або застосунок повідомляє, що не може підключитися до серверної частини. Що робити? Відповідь: Спробуйте ще раз або перезавантажте сторінку. Якщо проблема не зникає, надішліть службі підтримки опис того, що ви бачите, і, якщо можливо, посилання на проєкт, щоб вона могла провести розслідування.

Цілісність і відновлення даних, резервні копії та історія версій

Запитання: Мій документ завис, після чого вміст зник, а прив’язки коментарів перемістилися. Чи можна його відновити? Відповідь: Спочатку завантажте резервну копію у форматі .zip. У Prism також є історія версій, за допомогою якої можна відновити попередню версію. Позиції прив’язок коментарів не завжди можна відновити, а самі коментарі наразі не експортуються до резервних копій. Якщо форматування змінилося, спробуйте виправити його за допомогою засобу форматування коду.


Запитання: Після повторного відкриття проєкту файли або вміст повернулися до попереднього стану чи зникли. Що сталося? Відповідь: Певний час збереження проєктів залежало від зовнішнього постачальника, система якого не впоралася зі стрімким зростанням навантаження. Збереження перенесли до внутрішньої системи, щоб зменшити кількість помилок підключення та запобігти повторенню проблеми, а також додали додаткові запобіжні заходи.


Запитання: Чи можна відновити позиції коментарів і чи входять коментарі до резервних копій проєкту? Відповідь: Після інциденту позиції коментарів може бути неможливо відновити. Тепер для відновлення після майбутніх інцидентів періодично створюються резервні копії (наприклад, приблизно кожні 10 хвилин), але коментарі наразі не експортуються до резервних копій 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»)? Відповідь: Використовуючи середовища для лістингів, позначте кадр Beamer атрибутом [fragile]. Це часто усуває такі помилки.


Запитання: Мої цитування \cite відображаються як «[?]», хоча файл .bib існує й команди бібліографії наявні. Яка конфігурація працює? Один зі способів, що успішно спрацьовував, — переконатися, що бібліографію правильно підключено з головного документа. Для робочих процесів у стилі BibTeX додайте \bibliographystyle{plain} і \bibliography{refs}, де refs.bib — ваш файл.

Інтерфейс продукту та запити на функції

Запитання: Чи є в Prism світлий режим? Відповідь: Так. Prism підтримує три налаштування вигляду: Системний, Світлий і Темний. Виберіть тему, яка вам найбільше підходить.