Problemen oplossen en hulp krijgen in Prism

Prism is een collaboratieve, AI-native LaTeX-werkruimte gebouwd op frontier-modellen—ontworpen om onderzoekers te helpen sneller te denken, schrijven en itereren. De ingebouwde intelligentie vergroot zowel de snelheid als de diepgang van wetenschappelijk werk.

Deze gids beschrijft hoe je veelvoorkomende problemen oplost en waar je extra hulp kunt vinden.

Toegang krijgen tot Prism

Prism is beschikbaar op prism.openai.com voor alle gebruikers met een Free-, Go-, Plus- of Pro-ChatGPT-account die geen lid zijn en niet zijn geweest van een Business- of Enterprise-werkruimte. We zullen de toegang in de nabije toekomst uitbreiden naar Business, Enterprise en Edu.

1. De ingebouwde intelligentie van Prism gebruiken

Prism bevat een assistent die native in de editor werkt en wordt aangedreven door de frontier-modellen van OpenAI. Die begrijpt de context van je document en kan helpen LaTeX te genereren, fouten te diagnosticeren en oplossingen voor te stellen zonder de editor te verlaten. Je hebt er toegang toe via het paneel onderaan de werkruimte.

1. LaTeX-snippets genereren: Vraag Prism om veelgebruikte LaTeX-elementen te maken, zoals “Maak een 4×4-tabel” of “Voeg een figuur met een bijschrift toe.” Prism geeft dan kant-en-klare LaTeX terug en biedt de opties Keep en Undo zodat je die rechtstreeks in je project kunt invoegen.

2. Compilatieproblemen diagnosticeren: Als je document niet compileert, beschrijf het probleem dan in het paneel (bijvoorbeeld “Mijn document compileert niet”). Prism stelt verhelderende vragen en leidt je door waarschijnlijke oorzaken, zoals ontbrekende commando's of onopgeloste verwijzingen.

3. Fouten inline oplossen: Fouten en waarschuwingen verschijnen als rode of gele markeringen in de editor-marge. Je kunt Prism vragen een specifieke fout op te lossen, waarna het de relevante regels analyseert, uitlegt wat er mis is en gerichte bewerkingen voorstelt. Je kunt de suggestie direct toepassen en opnieuw compileren om de oplossing te bevestigen.

4. Proeflezen: Vraag Prism om een sectie na te lezen en eventuele fouten of hiaten in de logica te markeren, en ook suggesties te doen voor hoe ik de helderheid van de sectie kan verbeteren. Je kunt Skills gebruiken, zoals een Paper Review, voor redactionele en feitelijke feedback.

5. Literatuuronderzoek: Voeg een bibliografie toe aan mijn paper, inclusief suggesties voor gerelateerd werk dat ik mogelijk heb gemist.

2. Compileerfouten diagnosticeren

Als je LaTeX-document niet compileert, probeer dan de volgende stappen:

1. Controleer de foutmarkering: Rode en gele markeringen geven aan waar Prism een probleem heeft gedetecteerd. Klik op de markering om details te bekijken en gebruik daarna de ingebouwde assistent om de fout te diagnosticeren.

2. Bekijk het compilatielogboek: Wanneer compilatie mislukt, toont het PDF-voorbeeldvenster een compilatielogboek. Richt je op de eerste foutmelding (bijvoorbeeld een ontbrekende \end{document}), omdat latere fouten vaak een kettingreactie zijn. Deel deze melding met Prism voor nauwkeurigere begeleiding.

3. Maak recente wijzigingen ongedaan: Als de fout verscheen na een recente bewerking, maak die wijziging dan ongedaan of zet die tijdelijk in commentaar om te zien of compilatie slaagt.

4. Beperk het tot een minimaal voorbeeld: Als problemen blijven bestaan, vereenvoudig het document dan tot alleen de essentiële inhoud. Door niet-gerelateerde secties te verwijderen, kun je de bron van de fout beter isoleren.

3. Best practices om problemen te voorkomen

1. Blijf ingelogd: Werk altijd terwijl je bent ingelogd om ervoor te zorgen dat je wijzigingen worden opgeslagen en beschikbaar zijn in alle sessies.

2. Gebruik ondersteunde pakketten: Prism ondersteunt veel veelgebruikte LaTeX-pakketten. Zeldzame, verouderde of niet-onderhouden pakketten kunnen onverwachte compileerfouten veroorzaken.

3. Bewerk stapsgewijs: Breng kleine wijzigingen aan en compileer vaak. Zo is het makkelijker om te achterhalen welke bewerking een fout heeft veroorzaakt en snel te herstellen.

LaTeX-projecten verplaatsen naar Prism

Deze gids legt uit hoe je bestaande LaTeX-projecten—van Overleaf of van je lokale computer—naar prism verplaatst. Door je projecten te importeren blijft alles op één plek en kun je blijven werken zonder je bestanden handmatig opnieuw op te bouwen.

Projecten importeren vanuit Overleaf

Om een project van Overleaf naar prism te verplaatsen, download je eerst de projectbestanden van Overleaf en upload je die daarna naar prism.

Eén project downloaden

1. Open je Overleaf-projectdashboard.

2. Zoek het project dat je wilt overzetten.

3. Klik op het downloadpictogram in dezelfde rij als de projectnaam.

4. Overleaf downloadt het volledige project als een .zip-bestand naar je computer.

Meerdere projecten downloaden

1. Open je Overleaf-projectlijst.

2. Selecteer de projecten met het selectievakje aan het begin van elke rij.

   

3. Om alles te selecteren, klik je op het eerste selectievakje in de lijst.

4. Zodra alles is geselecteerd, klik je op het downloadpictogram rechtsboven in de projectlijst.

   

De geselecteerde projecten worden gedownload als .zip-bestanden.

Projecten importeren in Prism

Prism kan projecten op drie manieren importeren: door een map te uploaden, een .zip-archief te uploaden of bestanden te slepen en neer te zetten in de weergave All Projects.


Een project importeren vanuit het menu Import:

1. Open Prism en ga naar Import.

2. Klik op de chevron naast Import om het importtype te kiezen.

Selecteer een van de volgende opties:

1. Open prism en ga naar de optie Import.

2. Klik op de chevron naast Import om het importtype te kiezen.

3. Selecteer een van de volgende opties:

Een .zip-bestand importeren: Kies het gedownloade projectarchief op je computer. Prism pakt het project automatisch uit en laadt het.

Een map importeren: Kies de projectmap op je computer. Prism importeert je .tex-bestanden, bibliografiebestanden, afbeeldingen en andere projectbronnen.

Importeren via slepen en neerzetten: Sleep vanuit de weergave All Projects een projectmap of .zip-bestand naar Prism en zet het neer. Prism maakt automatisch een nieuw project aan en importeert de bestanden voor je.

Nadat de upload is voltooid, opent Prism het volledige project zodat je kunt beginnen met bewerken en compileren.

Overige veelgestelde vragen

Account, beveiliging en facturering

V: Waar kan ik jullie privacybeleid vinden?
A: Je vindt het privacybeleid van Prism hier.

V: Trainen jullie op mijn gegevens?
A: Gebruikers hebben volledige controle over de vraag of hun gegevens worden gebruikt om onze modellen te helpen verbeteren, in overeenstemming met ons privacybeleid.

V: Gebruiken jullie “geen gegevensbewaring” (ZDR)? Welke logging/bewaring vindt plaats?
A: Prism gebruikt momenteel niet de API-optie “geen gegevensbewaring” (ZDR) en bewaart gedurende een periode logs na verzoeken om het product te verbeteren.


V: Bieden jullie een privacymodus waarin geen tekst wordt opgeslagen of door mensen wordt beoordeeld, en/of uitsluitend EU-gegevensresidentie?
A: Dat zijn gevraagde functies; ze staan op de roadmap/backlog, maar er is nog geen vastgelegde planning.

Delen en samenwerken

V: Waarom kan ik geen link delen met “iedereen kan bewerken”? (De vervolgkeuzelijst laat alleen “iedereen kan bekijken” toe.)
A: Dit is momenteel bewust zo ontworpen. Delen via links met “door iedereen bewerkbaar” wordt nog niet ondersteund; redacteuren moeten als bijdragers worden toegevoegd (met een Prism-account).

V: Bijdragers ontvangen geen uitnodigingsmails—hoe krijgen ze toegang tot het project?
A: Vraag hen hun map met spam/ongewenste mail te controleren en laat hen inloggen met het uitgenodigde e-mailadres; het gedeelde project zou na de eerste aanmelding voor hen moeten verschijnen.

Project importeren en exporteren

V: Mijn ZIP-upload/import blijft hangen op “je project wordt geïmporteerd”. Wat moet ik doen?
A: Probeer de upload opnieuw. Als deze na opnieuw proberen nog steeds vastloopt, deel het ZIP-bestand dan met Support zodat het importpad kan worden onderzocht.

V: Hoe exporteer/download ik mijn project als ZIP?
A: Klik op de projectnaam en kies daarna Export om een gecomprimeerde kopie van het project te downloaden. Het kan een paar seconden duren voordat de backendverbinding tot stand is gebracht voordat je kunt exporteren.

Betrouwbaarheid, storingen en connectiviteit

V: Mijn projecten verdwenen na vernieuwen. Zijn ze kwijt?
A: Vernieuw opnieuw en controleer de projectlijst nogmaals; je gegevens zouden weer moeten verschijnen.

V: Mijn projecten verdwenen na het vernieuwen van de pagina. Zijn ze kwijt?
A: Dit kan gebeuren tijdens een storing bij een provider. Probeer het opnieuw; je projecten zouden weer moeten verschijnen. Zo niet, dan kan support helpen ze te herstellen.

V: De site lijkt offline / de app zegt dat er geen verbinding kan worden gemaakt met de backend. Wat moet ik doen?
A: Probeer het opnieuw/herlaad. Als het probleem aanhoudt, stuur support dan de details van wat je ziet (en, indien mogelijk, een projectlink), zodat het kan worden onderzocht.

Gegevensintegriteit, herstel, back-ups en versiegeschiedenis

V: Mijn document liep vast, daarna verdween inhoud en versprongen reactieankers. Kan ik het herstellen?
A: Begin met het downloaden van een .zip-back-up. Prism bevat ook versiegeschiedenis, waarmee je mogelijk een eerdere versie kunt herstellen. Posities van reactieankers zijn mogelijk niet altijd herstelbaar, en reacties worden momenteel niet geëxporteerd in back-ups. Als de opmaak is veranderd, probeer dan de code formatter om die te herstellen.

V: Ik opende een project opnieuw en bestanden/inhoud waren teruggezet of verdwenen—wat is er gebeurd?
A: Er was een periode waarin het opslaan van projecten afhankelijk was van een externe provider die een piek in gebruik niet aankon. Het opslaan is gemigreerd naar een intern systeem om verbindingsfouten te verminderen en herhaling te voorkomen, en er zijn extra waarborgen toegevoegd.

V: Zijn reactieposities herstelbaar, en worden reacties opgenomen in projectback-ups?
A: Reactieposities zijn achteraf mogelijk niet herstelbaar. Er zijn nu periodieke back-ups (bijv. elke ~10 minuten) voor herstel bij toekomstige incidenten, maar reacties worden momenteel niet geëxporteerd in ZIP-back-ups.

Integraties

Zotero

V: Waarom kan ik Zotero-groepsbibliotheken niet importeren in Prism?
A: Zotero-groepsbibliotheken worden nog niet ondersteund; individuele bibliotheken werken wel, maar groepsbibliotheken worden momenteel niet ondersteund.

V: Mijn Zotero-integratie blijft hangen (bijv. na het wijzigen van accounts of API-sleutels). Hoe kan dit worden opgelost?
A: Support heeft je numerieke Zotero-ID nodig (niet je gebruikersnaam) om de integratie los te koppelen van de vorige/anonieme gebruiker, waarna je die opnieuw aan je account kunt koppelen. Voorbeeld van hoe je dit doet: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

V: Kan ik een Prism-project via Git clonen (GitHub/GitLab) of gesynchroniseerd houden met het Git-platform van mijn instituut?
A: Git-integratie is nog niet beschikbaar, maar het is een ontwikkelproject met hoge prioriteit dat eraan komt.

LaTeX-build en probleemoplossing

V: Hoe forceer ik een schone rebuild (Aux/toc/bbl-artefacten wissen)?
A: Herlaad de pagina. Een paginavernieuwing forceert een nieuwe, schone build.

V: Figuren/afbeeldingen laden niet in Prism, maar dezelfde LaTeX werkt elders wel.
A: Gebruik paden die relatief zijn ten opzichte van het .tex-bestand dat de import uitvoert. Als het .tex-bestand in een submap staat en de afbeelding in de projectroot, zet dan ../ voor het pad.

V: Compilatie is extreem traag of wordt nooit voltooid. Hoe bepaal ik de oorzaak?
A: Zet secties in commentaar (en daarna kleinere delen binnen die secties) totdat compilatie slaagt, en werk dan terug naar de exacte regel die het probleem veroorzaakt. Bekijk ook waarschuwingen en fouten in de logs, beginnend bij de eerste.

V: Ik krijg waarschuwingen “Underfull/Overfull \hbox” in de gegenereerde .bbl. Is dit een compileerfout?
A: Nee, dit zijn zetwaarschuwingen, geen fatale compileerfouten. Als de PDF-uitvoer er acceptabel uitziet, kan de waarschuwing doorgaans worden genegeerd.

V: Waarom geven lstlisting/listings-omgevingen in Beamer een fout binnen een frame (bijv. “Extra }, or forgotten \endgroup”)?
A: Markeer het Beamer-frame als [fragile] wanneer je listing-omgevingen gebruikt; dat lost deze fouten vaak op.

V: Mijn \cite-verwijzingen worden weergegeven als “[?]”, ook al bestaat mijn .bib en zijn bibliografiecommando's aanwezig. Wat is een werkende configuratie?
Een tijdelijke oplossing die succesvol is gebleken, is ervoor te zorgen dat de bibliografie correct vanuit het hoofddocument wordt opgenomen; neem voor BibTeX-achtige workflows \bibliographystyle{plain} en \bibliography{refs} op (waarbij refs.bib jouw bestand is).

Product-UI en functieverzoeken

V: Biedt Prism een lichte modus?
A: Ja. Prism ondersteunt drie weergave-instellingen: Systeem, Licht en Donker. Je kunt het thema kiezen dat het beste voor je werkt.