Fehlerbehebung und Hilfe in Prism

Prism ist ein kollaborativer, KI-nativer LaTeX-Workspace, der auf führenden Modellen basiert – entwickelt, um Forschende beim Denken, Schreiben und schnelleren Iterieren zu unterstützen. Seine eingebettete Intelligenz steigert sowohl die Geschwindigkeit als auch die Tiefe wissenschaftlicher Arbeit.

Dieser Leitfaden erklärt, wie Sie häufige Probleme beheben und wo Sie weitere Hilfe finden.

So greifen Sie auf Prism zu

Prism ist unter prism.openai.com für alle Nutzenden mit einem Free-, Go-, Plus- oder Pro-ChatGPT-Konto verfügbar, die keine Mitglieder eines Business- oder Enterprise-Workspace sind oder waren. Wir werden den Zugang in naher Zukunft auf Business, Enterprise und Edu ausweiten.

1. Nutzung der integrierten Intelligenz von Prism

Prism enthält einen editornativen Assistenten, der von OpenAIs führenden Modellen angetrieben wird. Er versteht den Kontext Ihres Dokuments und kann helfen, LaTeX zu generieren, Fehler zu diagnostizieren und Korrekturen vorzuschlagen, ohne den Editor zu verlassen. Sie können über das Panel unten im Workspace darauf zugreifen.

1. LaTeX-Snippets generieren: Bitten Sie Prism, gängige LaTeX-Elemente zu erstellen, zum Beispiel „Erstelle eine 4×4-Tabelle“ oder „Füge eine Abbildung mit Beschriftung hinzu.“ Prism gibt einsatzbereites LaTeX zurück und bietet die Optionen „Behalten“ und „Rückgängig“, damit Sie es direkt in Ihr Projekt einfügen können.

2. Kompilierungsprobleme diagnostizieren: Wenn sich Ihr Dokument nicht kompilieren lässt, beschreiben Sie das Problem im Panel (zum Beispiel „Mein Dokument kompiliert nicht“). Prism stellt Rückfragen und führt Sie durch wahrscheinliche Ursachen, etwa fehlende Befehle oder nicht aufgelöste Verweise.

3. Fehler inline beheben: Fehler und Warnungen erscheinen als rote oder gelbe Markierungen im Rand des Editors. Sie können Prism bitten, einen bestimmten Fehler zu beheben; dann analysiert es die relevanten Zeilen, erklärt, was nicht stimmt, und schlägt gezielte Änderungen vor. Sie können den Vorschlag direkt anwenden und erneut kompilieren, um die Korrektur zu bestätigen.

4. Korrekturlesen: Bitten Sie Prism, einen Abschnitt Korrektur zu lesen, auf Fehler oder Lücken in der Logik hinzuweisen und außerdem Vorschläge zu machen, wie ich die Klarheit des Abschnitts verbessern kann. Sie können Skills wie eine Paper Review für redaktionelles und faktisches Feedback nutzen.

5. Literaturrecherche: Füge meinem Paper eine Bibliografie hinzu, einschließlich Vorschlägen für verwandte Arbeiten, die ich möglicherweise übersehen habe.

2. Diagnose von Kompilierungsfehlern

Wenn sich Ihr LaTeX-Dokument nicht kompilieren lässt, versuchen Sie die folgenden Schritte:

1. Prüfen Sie die Fehlermarkierung: Rote und gelbe Markierungen heben hervor, wo Prism ein Problem erkannt hat. Klicken Sie auf die Markierung, um Details anzuzeigen, und verwenden Sie dann den integrierten Assistenten, um den Fehler zu diagnostizieren.

2. Prüfen Sie das Kompilierungsprotokoll: Wenn die Kompilierung fehlschlägt, zeigt der PDF-Vorschaubereich ein Kompilierungsprotokoll an. Konzentrieren Sie sich auf die erste Fehlermeldung (zum Beispiel ein fehlendes \end{document}), da spätere Fehler oft Folgefehler sind. Teilen Sie diese Meldung mit Prism, um präzisere Hinweise zu erhalten.

3. Machen Sie kürzliche Änderungen rückgängig: Wenn der Fehler nach einer kürzlichen Bearbeitung aufgetreten ist, machen Sie diese Änderung rückgängig oder kommentieren Sie sie vorübergehend aus, um zu sehen, ob die Kompilierung erfolgreich ist.

4. Reduzieren Sie auf ein Minimalbeispiel: Wenn die Probleme bestehen bleiben, vereinfachen Sie das Dokument auf nur die wesentlichen Inhalte. Das Entfernen nicht zusammenhängender Abschnitte hilft, die Fehlerquelle einzugrenzen.

3. Best Practices zur Vermeidung von Problemen

1. Angemeldet bleiben: Arbeiten Sie immer angemeldet, damit Ihre Änderungen gespeichert werden und sitzungsübergreifend verfügbar sind.

2. Unterstützte Pakete verwenden: Prism unterstützt viele häufig verwendete LaTeX-Pakete. Seltene, veraltete oder nicht mehr gepflegte Pakete können unerwartete Kompilierungsfehler verursachen.

3. Schrittweise bearbeiten: Nehmen Sie kleine Änderungen vor und kompilieren Sie häufig. So lässt sich leichter erkennen, welche Bearbeitung einen Fehler verursacht hat, und Probleme lassen sich schneller beheben.

LaTeX-Projekte nach Prism verschieben

Dieser Leitfaden erklärt, wie Sie bestehende LaTeX-Projekte – entweder aus Overleaf oder von Ihrem lokalen Computer – nach prism verschieben. Durch den Import Ihrer Projekte bleibt alles an einem Ort, und Sie können weiterarbeiten, ohne Ihre Dateien manuell neu aufbauen zu müssen.

Projekte aus Overleaf importieren

Um ein Projekt von Overleaf nach prism zu verschieben, laden Sie zuerst die Projektdateien aus Overleaf herunter und laden Sie sie dann in prism hoch.

Ein einzelnes Projekt herunterladen

1. Öffnen Sie Ihr Overleaf-Projekt-Dashboard.

2. Suchen Sie das Projekt, das Sie übertragen möchten.

3. Klicken Sie in derselben Zeile wie der Projektname auf das Download-Symbol.

4. Overleaf lädt das gesamte Projekt als .zip-Datei auf Ihren Computer herunter.

Mehrere Projekte herunterladen

1. Öffnen Sie Ihre Overleaf-Projektliste.

2. Wählen Sie die Projekte mit dem Kontrollkästchen am Anfang jeder Zeile aus.

   

3. Um alles auszuwählen, klicken Sie auf das erste Kontrollkästchen in der Liste.

4. Klicken Sie nach der Auswahl auf das Download-Symbol oben rechts in der Projektliste.

   

Die ausgewählten Projekte werden als .zip-Dateien heruntergeladen.

Projekte in Prism importieren

Prism kann Projekte auf drei Arten importieren: durch Hochladen eines Ordners, Hochladen eines .zip-Archivs oder durch Drag-and-Drop von Dateien in die Ansicht All Projects.


So importieren Sie ein Projekt über das Import-Menü:

1. Öffnen Sie Prism und gehen Sie zu Import.

2. Klicken Sie auf das Chevron neben Import, um den Importtyp auszuwählen.

Wählen Sie eine der folgenden Optionen:

1. Öffnen Sie prism und navigieren Sie zur Option Import.

2. Klicken Sie auf das Chevron neben Import, um den Importtyp auszuwählen.

3. Wählen Sie eine der folgenden Optionen:

Eine .zip-Datei importieren: Wählen Sie das heruntergeladene Projektarchiv von Ihrem Computer aus. Prism entpackt es automatisch und lädt das Projekt.

Einen Ordner importieren: Wählen Sie den Projektordner von Ihrem Computer aus. Prism importiert Ihre .tex-Dateien, Bibliografiedateien, Bilder und andere Projektressourcen.

Per Drag-and-Drop importieren: Ziehen Sie aus der Ansicht All Projects einen Projektordner oder eine .zip-Datei in Prism und legen Sie sie dort ab. Prism erstellt automatisch ein neues Projekt und importiert die Dateien für Sie.

Nachdem der Upload abgeschlossen ist, öffnet Prism das vollständige Projekt, sodass Sie mit dem Bearbeiten und Kompilieren beginnen können.

Weitere FAQs

Konto, Sicherheit und Abrechnung

F: Wo finde ich Ihre Datenschutzrichtlinie?
A: Sie finden die Prism-Datenschutzrichtlinie hier.

F: Trainieren Sie mit meinen Daten?
A: Nutzende haben die volle Kontrolle darüber, ob ihre Daten verwendet werden, um unsere Modelle zu verbessern, im Einklang mit unserer Datenschutzrichtlinie.

F: Nutzen Sie „keine Datenaufbewahrung“ (ZDR)? Welche Protokollierung/Aufbewahrung findet statt?
A: Prism verwendet derzeit nicht die API-Option „keine Datenaufbewahrung“ (ZDR) und speichert Protokolle nach Anfragen für einen bestimmten Zeitraum, um das Produkt zu verbessern.


F: Bieten Sie einen Datenschutzmodus an, in dem kein Text gespeichert oder von Menschen geprüft wird, und/oder eine auf die EU beschränkte Datenresidenz?
A: Das sind angefragte Funktionen; sie stehen auf der Roadmap/im Backlog, aber es gibt noch keinen verbindlichen Zeitplan.

Teilen und Zusammenarbeit

F: Warum kann ich keinen Link zum „Bearbeiten für alle“ freigeben? (Im Dropdown ist nur „Ansehen für alle“ verfügbar.)
A: Das ist derzeit so vorgesehen. Linkbasierte Freigabe nach dem Prinzip „von allen bearbeitbar“ wird noch nicht unterstützt; Bearbeitende müssen als Mitwirkende hinzugefügt werden (mit einem Prism-Konto).

F: Mitwirkende erhalten keine Einladungs-E-Mails – wie können sie auf das Projekt zugreifen?
A: Bitten Sie sie, ihren Spam-/Junk-Ordner zu prüfen, und lassen Sie sie sich mit der eingeladenen E-Mail-Adresse anmelden; das freigegebene Projekt sollte nach der ersten Anmeldung für sie erscheinen.

Projektimport und -export

F: Mein ZIP-Upload/-Import hängt bei „Importing your project“. Was soll ich tun?
A: Versuchen Sie den Upload erneut. Wenn er auch nach einem erneuten Versuch weiterhin hängt, teilen Sie die ZIP-Datei mit dem Support, damit der Importpfad debuggt werden kann.

F: Wie exportiere/lade ich mein Projekt als ZIP herunter?
A: Klicken Sie auf den Projektnamen und wählen Sie dann „Export“, um eine komprimierte Kopie des Projekts herunterzuladen. Es kann einige Sekunden dauern, bis die Backend-Verbindung hergestellt ist und der Export verfügbar wird.

Zuverlässigkeit, Ausfälle und Konnektivität

F: Meine Projekte sind nach dem Aktualisieren verschwunden. Sind sie verloren?
A: Aktualisieren Sie erneut und prüfen Sie die Projektliste noch einmal; Ihre Daten sollten wieder erscheinen.

F: Meine Projekte sind nach dem Aktualisieren der Seite verschwunden. Sind sie verloren?
A: Das kann während eines Ausfalls bei einem Anbieter passieren. Versuchen Sie es erneut; Ihre Projekte sollten wieder erscheinen. Wenn nicht, kann der Support bei der Wiederherstellung helfen.

F: Die Website scheint offline zu sein / die App sagt, dass keine Verbindung zum Backend hergestellt werden kann. Was soll ich tun?
A: Versuchen Sie es erneut/laden Sie neu. Wenn das Problem weiterhin besteht, senden Sie dem Support Details dazu, was Sie sehen (und wenn möglich einen Projektlink), damit es untersucht werden kann.

Datenintegrität, Wiederherstellung, Backups und Versionsverlauf

F: Mein Dokument ist eingefroren, dann ist Inhalt verschwunden und Kommentaranker haben sich verschoben. Kann ich es wiederherstellen?
A: Laden Sie zunächst ein .zip-Backup herunter. Prism enthält auch einen Versionsverlauf, mit dem Sie möglicherweise eine frühere Version wiederherstellen können. Positionen von Kommentarankern lassen sich nicht immer wiederherstellen, und Kommentare werden derzeit nicht in Backups exportiert. Wenn sich die Formatierung geändert hat, versuchen Sie, sie mit dem Code-Formatierer zu reparieren.

F: Ich habe ein Projekt erneut geöffnet und Dateien/Inhalte wurden zurückgesetzt oder sind verschwunden – was ist passiert?
A: Es gab einen Zeitraum, in dem das Speichern von Projekten von einem externen Anbieter abhing, der während eines Nutzungsspitzenwerts nicht mithalten konnte. Das Speichern wurde auf ein internes System migriert, um Verbindungsfehler zu reduzieren und Wiederholungen zu verhindern; außerdem wurden zusätzliche Schutzmaßnahmen hinzugefügt.

F: Lassen sich Kommentarpositionen wiederherstellen, und sind Kommentare in Projektsicherungen enthalten?
A: Kommentarpositionen lassen sich nachträglich möglicherweise nicht wiederherstellen. Es gibt jetzt regelmäßige Backups (z. B. etwa alle 10 Minuten) für die Wiederherstellung bei künftigen Vorfällen, aber Kommentare werden derzeit nicht in ZIP-Backups exportiert.

Integrationen

Zotero

F: Warum kann ich Zotero-Gruppenbibliotheken nicht in Prism importieren?
A: Zotero-Gruppenbibliotheken werden noch nicht unterstützt; individuelle Bibliotheken funktionieren, Gruppenbibliotheken werden derzeit jedoch nicht unterstützt.

F: Meine Zotero-Integration hängt fest (z. B. nach dem Wechsel von Konten oder API-Schlüsseln). Wie kann das behoben werden?
A: Der Support benötigt Ihre numerische Zotero-ID (nicht Ihren Benutzernamen), um die Integration vom vorherigen/anonymen Nutzenden zu entkoppeln; danach können Sie sie erneut mit Ihrem Konto verknüpfen. Ein Beispiel dafür finden Sie hier: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

F: Kann ich ein Prism-Projekt per Git (GitHub/GitLab) klonen oder es mit der Git-Plattform meines Instituts synchron halten?
A: Eine Git-Integration ist noch nicht verfügbar, hat aber als kommendes Entwicklungsprojekt hohe Priorität.

LaTeX-Build und Fehlerbehebung

F: Wie erzwinge ich einen sauberen Neuaufbau (Aux-/toc-/bbl-Artefakte löschen)?
A: Laden Sie die Seite neu. Ein Neuladen der Seite erzwingt einen frischen, sauberen Build.

F: Abbildungen/Bilder werden in Prism nicht geladen, aber dasselbe LaTeX funktioniert anderswo.
A: Verwenden Sie Pfade relativ zu der .tex-Datei, die den Import ausführt. Wenn sich die .tex-Datei in einem Unterordner befindet und das Bild im Projektstamm liegt, setzen Sie ../ vor den Pfad.

F: Die Kompilierung ist extrem langsam oder wird nie abgeschlossen. Wie finde ich die Ursache?
A: Kommentieren Sie Abschnitte aus (und dann kleinere Teile innerhalb dieser Abschnitte), bis die Kompilierung erfolgreich ist, und grenzen Sie dann die genaue Zeile ein, die das Problem verursacht. Prüfen Sie außerdem Warnungen und Fehler in den Protokollen, beginnend mit dem ersten.

F: Ich erhalte Warnungen wie „Underfull/Overfull \hbox“ in der generierten .bbl. Ist das ein Kompilierungsfehler?
A: Nein, das sind Satzwarnungen, keine schwerwiegenden Kompilierungsfehler. Wenn die PDF-Ausgabe akzeptabel aussieht, kann die Warnung in der Regel ignoriert werden.

F: Warum verursachen in Beamer lstlisting-/listings-Umgebungen innerhalb eines Frames Fehler (z. B. „Extra }, or forgotten \endgroup“)?
A: Kennzeichnen Sie den Beamer-Frame bei der Verwendung von Listing-Umgebungen als [fragile]; das behebt diese Fehler oft.

F: Meine \cite-Zitate werden als „[?]“ angezeigt, obwohl meine .bib vorhanden ist und Bibliografie-Befehle enthalten sind. Welche Konfiguration funktioniert?
Eine erfolgreiche Umgehungslösung besteht darin, sicherzustellen, dass die Bibliografie korrekt aus dem Hauptdokument eingebunden wird; für BibTeX-ähnliche Workflows fügen Sie \bibliographystyle{plain} und \bibliography{refs} ein (wobei refs.bib Ihre Datei ist).

Produkt-UI und Funktionsanfragen

F: Bietet Prism einen hellen Modus?
A: Ja. Prism unterstützt drei Darstellungseinstellungen: System, Hell und Dunkel. Sie können das Design wählen, das für Sie am besten funktioniert.