Огляд

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

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

Доступ до Prism

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

Використання вбудованого ШІ Prism

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

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

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

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

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

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

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

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

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

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

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

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

Як уникнути поширених проблем

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

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

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

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

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

Імпорт проєктів з 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 підтримує три налаштування теми: Системна, Світла й Темна. Виберіть тему, яка вам найбільше підходить.