Fehlerbehebung und Hilfe in Prism

Prism ist eine kollaborative, KI-native LaTeX-Workspace auf Basis von Frontier-Modellen. Sie unterstützt Forschende dabei, schneller zu denken, zu schreiben und ihre Arbeit weiterzuentwickeln. Die integrierte Intelligenz beschleunigt die wissenschaftliche Arbeit und ermöglicht zugleich tiefere Analysen.

Dieser Leitfaden erklärt, wie du häufige Probleme behebst und wo du weitere Hilfe findest.

So greifst du auf Prism zu

Prism ist unter prism.openai.com für alle Nutzer:innen mit einem Free-, Go-, Plus- oder Pro-ChatGPT-Konto verfügbar, die nicht Mitglied eines Business- oder Enterprise-Workspace sind und es auch nie waren. Wir werden den Zugriff in naher Zukunft auf Business, Enterprise und Edu ausweiten.

1. Die integrierte Intelligenz von Prism verwenden

Prism enthält einen direkt in den Editor integrierten Assistenten, der auf Frontier-Modellen von OpenAI basiert. Er versteht den Kontext deines Dokuments und kann LaTeX erzeugen, Fehler diagnostizieren und Korrekturen vorschlagen, ohne dass du den Editor verlassen musst. Du kannst ihn über den Bereich am unteren Rand der Workspace aufrufen.

1. LaTeX-Ausschnitte erzeugen: Bitte Prism, häufig verwendete LaTeX-Elemente zu erstellen, etwa „Create a 4×4 table“ oder „Add a figure with a caption.“ Prism gibt einsatzbereiten LaTeX-Code zurück und bietet die Optionen „Übernehmen“ und „Rückgängig“, damit du ihn direkt in dein Projekt einfügen kannst.

2. Kompilierungsprobleme diagnostizieren: Wenn dein Dokument nicht kompiliert werden kann, beschreibe das Problem im Bereich, zum Beispiel „My document isn’t compiling“. Prism stellt Rückfragen und führt dich durch mögliche Ursachen, etwa fehlende Befehle oder nicht aufgelöste Verweise.

3. Fehler direkt im Editor beheben: Fehler und Warnungen werden am Rand des Editors durch rote oder gelbe Markierungen angezeigt. Du kannst Prism bitten, einen bestimmten Fehler zu beheben. Prism analysiert dann die relevanten Zeilen, erklärt das Problem und schlägt gezielte Änderungen vor. Du kannst den Vorschlag direkt übernehmen und das Dokument erneut kompilieren, um die Korrektur zu bestätigen.

4. Korrekturlesen: Bitte Prism, einen Abschnitt Korrektur zu lesen, Fehler oder logische Lücken hervorzuheben und Vorschläge zu machen, wie du den Abschnitt klarer formulieren kannst. Für redaktionelles und inhaltliches Feedback kannst du Skills wie Paper Review nutzen.

5. Literatursuche: Ergänze mein Paper um ein Literaturverzeichnis und schlage dabei auch relevante Arbeiten vor, die ich möglicherweise übersehen habe.

2. Kompilierungsfehler diagnostizieren

Wenn sich dein LaTeX-Dokument nicht kompilieren lässt, versuche Folgendes:

1. Fehlermarkierung prüfen: Rote und gelbe Markierungen zeigen, wo Prism ein Problem erkannt hat. Klicke auf die Markierung, um Details anzuzeigen. Verwende dann den integrierten Assistenten, um den Fehler zu diagnostizieren.

2. Kompilierungsprotokoll prüfen: Wenn die Kompilierung fehlschlägt, wird im Bereich der PDF-Vorschau ein Kompilierungsprotokoll angezeigt. Konzentriere dich auf die erste Fehlermeldung, beispielsweise ein fehlendes \end{document}, da spätere Fehler oft nur Folgefehler sind. Teile diese Meldung mit Prism, um genauere Hinweise zu erhalten.

3. Letzte Änderungen rückgängig machen: Falls der Fehler nach einer kürzlich vorgenommenen Änderung aufgetreten ist, mache sie rückgängig oder kommentiere sie vorübergehend aus. Prüfe dann, ob die Kompilierung erfolgreich ist.

4. Auf ein Minimalbeispiel reduzieren: Falls das Problem weiterhin besteht, vereinfache das Dokument auf die wesentlichen Inhalte. Wenn du nicht relevante Abschnitte entfernst, kannst du die Fehlerquelle leichter eingrenzen.

3. Bewährte Vorgehensweisen zur Vermeidung von Problemen

1. Angemeldet bleiben: Arbeite immer im angemeldeten Zustand, damit deine Ä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: Nimm kleine Änderungen vor und kompiliere häufig. So kannst du leichter feststellen, welche Änderung einen Fehler verursacht hat, und den vorherigen Stand schnell wiederherstellen.

LaTeX-Projekte zu Prism übertragen

Dieser Leitfaden erklärt, wie du bestehende LaTeX-Projekte aus Overleaf oder von deinem lokalen Computer in Prism überträgst. Durch den Import bleiben alle Projekte an einem Ort und du kannst weiterarbeiten, ohne deine Dateien manuell neu erstellen zu müssen.

Projekte aus Overleaf importieren

Um ein Projekt von Overleaf zu Prism zu übertragen, lade zunächst die Projektdateien aus Overleaf herunter und anschließend in Prism hoch.

Ein einzelnes Projekt herunterladen

1. Öffne dein Overleaf-Projekt-Dashboard.

2. Suche das Projekt, das du übertragen möchtest.

3. Klicke in derselben Zeile wie der Projektname auf das Downloadsymbol.

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

Mehrere Projekte herunterladen

1. Öffne deine Overleaf-Projektliste.

2. Wähle die Projekte über das Kontrollkästchen am Anfang jeder Zeile aus.

1. Um alle Projekte auszuwählen, klicke auf das erste Kontrollkästchen in der Liste.

2. Klicke nach der Auswahl auf das Downloadsymbol 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, durch Hochladen eines .zip-Archivs oder durch Drag-and-drop von Dateien in die Ansicht Alle Projekte.


So importierst du ein Projekt über das Menü „Importieren“:

1. Öffne Prism und gehe zu Importieren.

2. Klicke auf den Pfeil neben Importieren, um die Importart auszuwählen.

Wähle eine der folgenden Optionen aus:

1. Öffne Prism und rufe die Option Importieren auf.

2. Klicke auf den Pfeil neben „Importieren“, um die Importart auszuwählen.

3. Wähle eine der folgenden Optionen aus:

Eine .zip-Datei importieren: Wähle das heruntergeladene Projektarchiv auf deinem Computer aus. Prism entpackt und lädt das Projekt automatisch.


Einen Ordner importieren: Wähle den Projektordner auf deinem Computer aus. Prism importiert deine .tex-Dateien, Literaturverzeichnisdateien, Bilder und weiteren Projektressourcen.


So importierst du per Drag-and-drop: Ziehe in der Ansicht Alle Projekte einen Projektordner oder eine .zip-Datei auf Prism und lege ihn beziehungsweise sie dort ab. Prism erstellt automatisch ein neues Projekt und importiert die Dateien für dich.

Nach Abschluss des Uploads öffnet Prism das vollständige Projekt, damit du mit der Bearbeitung und Kompilierung beginnen kannst.

Weitere FAQs

Konto, Sicherheit und Abrechnung

F: Wo finde ich eure Datenschutzrichtlinie? A: Die Datenschutzrichtlinie von Prism findest du hier.

F: Verwendet ihr meine Daten zum Trainieren? A: Du entscheidest selbst, ob deine Daten zur Verbesserung unserer Modelle verwendet werden dürfen. Dies entspricht unserer Datenschutzrichtlinie.

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


F: Bietet ihr einen Datenschutzmodus, in dem kein Text gespeichert oder von Menschen geprüft wird, und/oder eine Datenresidenz ausschließlich in der EU? A: Diese Funktionen wurden angefragt und stehen auf der Roadmap beziehungsweise im Backlog. Einen verbindlichen Zeitplan gibt es jedoch noch nicht.

Freigabe und Zusammenarbeit

F: Warum kann ich keinen Link freigeben, über den „alle bearbeiten können“? Im Auswahlmenü ist nur „alle können ansehen“ verfügbar. A: Das ist derzeit so vorgesehen. Die linkbasierte Freigabe zur Bearbeitung durch alle wird noch nicht unterstützt. Personen mit Bearbeitungsrechten müssen als Mitwirkende hinzugefügt werden und benötigen ein Prism-Konto.


F: Mitwirkende erhalten keine Einladungs-E-Mails. Wie können sie auf das Projekt zugreifen? A: Bitte sie, ihren Spam- oder Junk-Ordner zu prüfen und sich mit der eingeladenen E-Mail-Adresse anzumelden. Nach der ersten Anmeldung sollte das freigegebene Projekt für sie angezeigt werden.

Projekte importieren und exportieren

F: Mein ZIP-Upload beziehungsweise -Import bleibt bei „Dein Projekt wird importiert“ hängen. Was soll ich tun? A: Versuche den Upload erneut. Falls er danach weiterhin hängt, sende die ZIP-Datei an den Support, damit der Importvorgang untersucht werden kann.


F: Wie kann ich mein Projekt als ZIP-Datei exportieren oder herunterladen? A: Klicke auf den Projektnamen und wähle dann „Exportieren“, um eine komprimierte Kopie des Projekts herunterzuladen. Es kann einige Sekunden dauern, bis die Verbindung zum Backend hergestellt ist und du exportieren kannst.

Zuverlässigkeit, Ausfälle und Verbindungen

F: Meine Projekte sind nach dem Aktualisieren verschwunden. Sind sie verloren? A: Aktualisiere die Seite erneut und prüfe die Projektliste noch einmal. Deine Daten sollten wieder angezeigt werden.


F: Meine Projekte sind nach dem Aktualisieren der Seite verschwunden. Sind sie verloren? A: Das kann während eines Ausfalls bei einem Anbieter vorkommen. Versuche es erneut. Deine Projekte sollten wieder angezeigt werden. Falls nicht, kann der Support bei der Wiederherstellung helfen.


F: Die Website scheint offline zu sein oder die App meldet, dass sie keine Verbindung zum Backend herstellen kann. Was soll ich tun? A: Versuche es erneut oder lade die Seite neu. Falls das Problem weiterhin besteht, sende dem Support eine genaue Beschreibung der Anzeige und nach Möglichkeit einen Projektlink, damit der Vorfall untersucht werden kann.

Datenintegrität, Wiederherstellung, Sicherungen und Versionsverlauf

F: Mein Dokument ist eingefroren. Danach sind Inhalte verschwunden und Kommentaranker wurden verschoben. Kann ich es wiederherstellen? A: Lade zunächst eine .zip-Sicherung herunter. Prism bietet außerdem einen Versionsverlauf, über den du möglicherweise eine frühere Version wiederherstellen kannst. Die Positionen von Kommentarankern lassen sich eventuell nicht wiederherstellen. Kommentare werden derzeit nicht in Sicherungen exportiert. Falls sich die Formatierung geändert hat, kannst du versuchen, sie mit dem Codeformatierer zu reparieren.


F: Nach dem erneuten Öffnen eines Projekts wurden Dateien oder Inhalte auf einen früheren Stand zurückgesetzt oder waren verschwunden. Was ist passiert? A: Eine Zeit lang war das Speichern von Projekten von einem externen Anbieter abhängig, der eine starke Nutzungsspitze nicht bewältigen konnte. Das Speichern wurde auf ein internes System umgestellt, um Verbindungsfehler zu reduzieren und eine Wiederholung zu verhindern. Außerdem wurden zusätzliche Schutzmaßnahmen eingeführt.


F: Lassen sich Kommentarpositionen wiederherstellen und sind Kommentare in Projektsicherungen enthalten? A: Kommentarpositionen lassen sich nachträglich möglicherweise nicht wiederherstellen. Für künftige Vorfälle werden inzwischen regelmäßig Sicherungen erstellt, beispielsweise etwa alle zehn Minuten. Kommentare werden derzeit jedoch nicht in ZIP-Sicherungen exportiert.

Integrationen

Zotero

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


F: Meine Zotero-Integration hängt, beispielsweise nach einem Wechsel des Kontos oder der API-Schlüssel. Wie lässt sich das beheben? A: Der Support benötigt deine numerische Zotero-ID, nicht deinen Benutzernamen, um die Integration vom vorherigen beziehungsweise anonymen Nutzerkonto zu trennen. Anschließend kannst du sie erneut mit deinem Konto verknüpfen. Eine Anleitung findest du hier: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

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

LaTeX-Kompilierung und Fehlerbehebung

F: Wie erzwinge ich eine vollständige Neukompilierung, bei der Aux-, toc- und bbl-Artefakte gelöscht werden? A: Lade die Seite neu. Dadurch wird eine vollständige Neukompilierung mit einem bereinigten Stand erzwungen.


F: Abbildungen oder Bilder werden in Prism nicht geladen, obwohl derselbe LaTeX-Code anderswo funktioniert. A: Verwende Pfade relativ zu der .tex-Datei, die den Import ausführt. Wenn sich die .tex-Datei in einem Unterordner und das Bild im Stammverzeichnis des Projekts befindet, stelle dem Pfad ../ voran.


F: Die Kompilierung ist extrem langsam oder wird nie abgeschlossen. Wie finde ich die Ursache? A: Kommentiere zunächst ganze Abschnitte und anschließend kleinere Teile darin aus, bis die Kompilierung erfolgreich ist. Grenze dann die genaue Zeile ein, die das Problem verursacht. Prüfe außerdem die Warnungen und Fehler in den Protokollen, beginnend mit dem ersten Eintrag.


F: In der erzeugten .bbl-Datei werden Warnungen vom Typ „Underfull/Overfull \hbox“ angezeigt. Ist das ein Kompilierungsfehler? A: Nein. Das sind Warnungen zum Schriftsatz und keine schwerwiegenden Kompilierungsfehler. Wenn die PDF-Ausgabe in Ordnung aussieht, kannst du die Warnung in der Regel ignorieren.


F: Warum verursachen lstlisting-/listings-Umgebungen in Beamer innerhalb eines Frames Fehler, etwa „Extra }, or forgotten \endgroup“? A: Kennzeichne den Beamer-Frame bei der Verwendung von listings-Umgebungen mit [fragile]. Dadurch lassen sich diese Fehler häufig beheben.


F: Meine \cite-Zitate werden als „[?]“ angezeigt, obwohl meine .bib-Datei vorhanden ist und die Literaturverzeichnis-Befehle enthalten sind. Welche Konfiguration funktioniert? Eine mögliche Lösung besteht darin, sicherzustellen, dass das Literaturverzeichnis korrekt aus dem Hauptdokument eingebunden wird. Füge bei BibTeX-basierten Abläufen \bibliographystyle{plain} und \bibliography{refs} ein, wobei refs.bib deine Datei ist.

Produktoberfläche und Funktionswünsche

F: Bietet Prism einen hellen Modus? A: Ja. Prism bietet drei Darstellungseinstellungen: System, Hell und Dunkel. Du kannst das Design auswählen, das für dich am besten geeignet ist.