Hibaelhárítás és segítségkérés a Prismben

A Prism egy együttműködésre épülő, MI-alapú LaTeX-munkaterület, amely élvonalbeli modellekre épül — azért készült, hogy segítsen a kutatóknak gyorsabban gondolkodni, írni és iterálni. Beágyazott intelligenciája növeli a tudományos munka sebességét és mélységét is.

Ez az útmutató bemutatja, hogyan háríthatók el a gyakori problémák, és hol talál további segítséget.

A Prism elérése

A Prism a prism.openai.com oldalon érhető el minden olyan felhasználó számára, aki Free, Go, Plus vagy Pro ChatGPT-fiókkal rendelkezik, és nem tagja, illetve korábban sem volt tagja Business vagy Enterprise munkaterületnek. A közeljövőben kiterjesztjük a hozzáférést a Business, Enterprise és Edu csomagokra is.

1. A Prism beépített intelligenciájának használata

A Prism tartalmaz egy szerkesztőbe épített asszisztenst, amelyet az OpenAI élvonalbeli modelljei működtetnek. Megérti a dokumentum kontextusát, és segíthet LaTeX előállításában, hibák diagnosztizálásában és javítási javaslatokban anélkül, hogy elhagyná a szerkesztőt. Ezt a munkaterület alján található panelről érheti el.

1. LaTeX-kódrészletek létrehozása: Kérje meg a Prismet, hogy hozzon létre gyakori LaTeX-elemeket, például „Készíts egy 4×4-es táblázatot” vagy „Adj hozzá egy ábrát felirattal”. A Prism használatra kész LaTeX-et ad vissza, és Megtartás valamint Visszavonás lehetőségeket biztosít, így közvetlenül beillesztheti azt a projektjébe.

2. Fordítási problémák diagnosztizálása: Ha a dokumentum nem fordul le, írja le a problémát a panelen (például: „A dokumentumom nem fordul le”). A Prism pontosító kérdéseket tesz fel, és végigvezeti a valószínű okokon, például a hiányzó parancsokon vagy a feloldatlan hivatkozásokon.

3. Hibák javítása közvetlenül a szövegben: A hibák és figyelmeztetések piros vagy sárga jelölőként jelennek meg a szerkesztő margóján. Megkérheti a Prismet egy adott hiba javítására, és az elemzi az érintett sorokat, elmagyarázza, mi a gond, és célzott szerkesztési javaslatokat tesz. A javaslatot közvetlenül alkalmazhatja, majd újrafordíthatja a javítás megerősítéséhez.

4. Lektorálás: Kérje meg a Prismet, hogy lektoráljon egy szakaszt, emelje ki az esetleges hibákat vagy logikai hiányosságokat, és tegyen javaslatokat arra is, hogyan javítható a szakasz érthetősége. Használhat Skills funkciókat is, például a Paper Review-t szerkesztői és tényszerű visszajelzéshez.

5. Irodalomkeresés: Adjon bibliográfiát a cikkemhez, beleértve a kapcsolódó munkák javaslatát is, amelyeket esetleg kihagytam.

2. Fordítási hibák diagnosztizálása

Ha a LaTeX-dokumentuma nem fordul le, próbálja meg a következő lépéseket:

1. Ellenőrizze a hibajelölőt: A piros és sárga jelölők kiemelik, hol észlelt a Prism problémát. Kattintson a jelölőre a részletek megtekintéséhez, majd a beépített asszisztenssel diagnosztizálja a hibát.

2. Nézze át a fordítási naplót: Ha a fordítás sikertelen, a PDF-előnézeti panelen megjelenik a fordítási napló. Az első hibaüzenetre összpontosítson (például egy hiányzó \end{document} esetén), mert a későbbi hibák gyakran tovagyűrűző következmények. Ossza meg ezt az üzenetet a Prismmel a pontosabb útmutatásért.

3. Vonja vissza a legutóbbi módosításokat: Ha a hiba egy friss szerkesztés után jelent meg, vonja vissza vagy ideiglenesen kommentezze ki azt a módosítást, hogy lássa, sikerül-e a fordítás.

4. Csökkentse minimális példára: Ha a probléma továbbra is fennáll, egyszerűsítse a dokumentumot csak a lényegi tartalomra. A nem kapcsolódó részek eltávolítása segít elkülöníteni a hiba forrását.

3. Jó gyakorlatok a problémák elkerülésére

1. Maradjon bejelentkezve: Mindig bejelentkezve dolgozzon, hogy a módosításai mentésre kerüljenek, és a munkamenetek között is elérhetők legyenek.

2. Használjon támogatott csomagokat: A Prism számos gyakran használt LaTeX-csomagot támogat. A ritka, elavult vagy karbantartatlan csomagok váratlan fordítási hibákat okozhatnak.

3. Szerkesszen fokozatosan: Kis módosításokat végezzen, és gyakran fordítsa le a dokumentumot. Így könnyebb azonosítani, melyik szerkesztés okozta a hibát, és gyorsabban helyreállni.

LaTeX-projektek áthelyezése a Prismbe

Ez az útmutató bemutatja, hogyan vihet át meglévő LaTeX-projekteket — akár az Overleafből, akár a helyi számítógépéről — a Prismbe. A projektek importálásával mindent egy helyen tarthat, és manuális újraépítés nélkül folytathatja a munkát a fájljaival.

Projektek importálása az Overleafből

Ha egy projektet át szeretne vinni az Overleafből a Prismbe, először töltse le a projekt fájljait az Overleafből, majd töltse fel őket a Prismbe.

Egyetlen projekt letöltése

1. Nyissa meg az Overleaf projektirányítópultját.

2. Keresse meg az átvinni kívánt projektet.

3. Kattintson a letöltési ikonra a projekt nevével azonos sorban.

4. Az Overleaf a teljes projektet .zip fájlként tölti le a számítógépére.

Több projekt letöltése

1. Nyissa meg az Overleaf projektlistáját.

2. Jelölje ki a projekteket az egyes sorok elején lévő jelölőnégyzettel.

   

3. Az összes kijelöléséhez kattintson a lista első jelölőnégyzetére.

4. A kijelölés után kattintson a projektlista jobb felső sarkában lévő letöltési ikonra.

   

A kijelölt projektek .zip fájlokként töltődnek le.

Projektek importálása a Prismbe

A Prism háromféleképpen tud projekteket importálni: egy mappa feltöltésével, egy .zip archívum feltöltésével, vagy fájlok áthúzásával az All Projects nézetbe.


Projekt importálása az Import menüből:

1. Nyissa meg a Prismet, és lépjen az Import menüpontra.

2. Kattintson az Import melletti lefelé mutató nyílra az importálás típusának kiválasztásához.

Válassza az alábbi lehetőségek egyikét:

1. Nyissa meg a Prismet, és navigáljon az Import lehetőséghez.

2. Kattintson az Import melletti lefelé mutató nyílra az importálás típusának kiválasztásához.

3. Válassza az alábbi lehetőségek egyikét:

.zip fájl importálása: Válassza ki a letöltött projektarchívumot a számítógépéről. A Prism automatikusan kicsomagolja és betölti a projektet.

Mappa importálása: Válassza ki a projektmappát a számítógépéről. A Prism importálja a .tex fájlokat, bibliográfiai fájlokat, képeket és egyéb projektforrásokat.

Importálás áthúzással: Az All Projects nézetből húzzon egy projektmappát vagy .zip fájlt a Prismbe. A Prism automatikusan létrehoz egy új projektet, és importálja Ön helyett a fájlokat.

A feltöltés befejezése után a Prism megnyitja a teljes projektet, így elkezdheti a szerkesztést és a fordítást.

További GYIK

Fiók, biztonság és számlázás

K: Hol találom az adatvédelmi irányelveket?
V: A Prism adatvédelmi irányelveit itt találja.


K: Tanítják a modelljeiket az adataimon?
V: A felhasználók teljes körűen szabályozhatják, hogy adataikat felhasználjuk-e modelljeink fejlesztéséhez, az adatvédelmi irányelveinkkel összhangban.


K: Használnak „zéró adatmegőrzést” (ZDR)? Milyen naplózás/adatmegőrzés történik?
V: A Prism jelenleg nem használja a „zéró adatmegőrzés” (ZDR) API-opciót, és a termék javítása érdekében a kérések után egy ideig naplókat tárol.


K: Kínálnak olyan adatvédelmi módot, amelyben semmilyen szöveg nincs tárolva vagy ember által felülvizsgálva, és/vagy csak EU-s adatok tárolási helye opciót?
V: Ezek kért funkciók; szerepelnek az ütemterven/elmaradási listán, de egyelőre nincs vállalt idővonal.

Megosztás és együttműködés

K: Miért nem tudok „bárki szerkesztheti” linket megosztani? (A legördülő menüben csak a „bárki megtekintheti” opció érhető el.)
V: Ez jelenleg szándékosan ilyen. Linkalapú, „bárki szerkesztheti” megosztás még nem támogatott; a szerkesztőket együttműködőként kell hozzáadni (Prism-fiókkal).

K: Az együttműködők nem kapják meg a meghívó e-maileket — hogyan férhetnek hozzá a projekthez?
V: Kérje meg őket, hogy ellenőrizzék a spam/levélszemét mappát, és jelentkezzenek be a meghívott e-mail-címmel; a megosztott projektnek az első bejelentkezés után meg kell jelennie náluk.

Projektimportálás és -exportálás

K: A ZIP-feltöltésem/importálásom elakadt annál, hogy „projekt importálása”. Mit tegyek?
V: Próbálja meg újra a feltöltést. Ha az újrapróbálkozás után is elakad, ossza meg a ZIP-fájlt a támogatással, hogy az importálási folyamat hibakereshető legyen.

K: Hogyan exportálhatom/tölthetem le a projektemet ZIP-ként?
V: Kattintson a projekt nevére, majd válassza az Exportálás lehetőséget a projekt tömörített másolatának letöltéséhez. Eltarthat néhány másodpercig, amíg létrejön a háttérrendszer-kapcsolat, mielőtt exportálni tudna.

Megbízhatóság, leállások és kapcsolat

K: A projektjeim eltűntek frissítés után. Elvesztek?
V: Frissítsen újra, és ellenőrizze ismét a projektlistát; az adatai újra meg kell jelenjenek.

K: A projektjeim eltűntek az oldal frissítése után. Elvesztek?
V: Ez előfordulhat egy szolgáltatói leállás során. Próbálja újra; a projektjeinek újra meg kell jelenniük. Ha nem, a támogatás segíthet a helyreállításukban.

K: Úgy tűnik, hogy az oldal nem érhető el / az alkalmazás azt írja, hogy nem tud csatlakozni a háttérrendszerhez. Mit tegyek?
V: Próbálja újra / töltse újra. Ha a probléma továbbra is fennáll, küldje el a támogatásnak a látott részleteket (és lehetőség szerint egy projektlinket), hogy ki lehessen vizsgálni.

Adatintegritás, helyreállítás, biztonsági mentések és verzióelőzmények

K: A dokumentumom lefagyott, aztán tartalom tűnt el, és a megjegyzéshorgonyok elmozdultak. Vissza tudom állítani?
V: Először töltsön le egy .zip biztonsági mentést. A Prism verzióelőzményeket is tartalmaz, amelyek lehetővé tehetik egy korábbi verzió visszaállítását. A megjegyzéshorgonyok helyzete nem mindig állítható helyre, és a megjegyzések jelenleg nem exportálhatók a biztonsági mentésekbe. Ha a formázás megváltozott, próbálja meg a kódformázót a javításához.

K: Újra megnyitottam egy projektet, és a fájlok/tartalom visszaálltak egy korábbi állapotra vagy eltűntek — mi történt?
V: Volt egy időszak, amikor a projektmentés egy külső szolgáltatótól függött, amely egy használati csúcs alatt nem tudott lépést tartani. A mentést egy belső rendszerbe migrálták a kapcsolódási hibák csökkentése és az ismétlődés megelőzése érdekében, és további biztosítékokat is bevezettek.

K: Helyreállíthatók a megjegyzések pozíciói, és a megjegyzések benne vannak a projekt biztonsági mentéseiben?
V: A megjegyzések pozíciói utólag nem feltétlenül állíthatók helyre. Most már vannak időszakos biztonsági mentések (pl. kb. 10 percenként) a jövőbeli incidensek utáni helyreállításhoz, de a megjegyzések jelenleg nem exportálhatók ZIP biztonsági mentésekben.

Integrációk

Zotero

K: Miért nem tudok Zotero-csoportkönyvtárakat importálni a Prismbe?
V: A Zotero-csoportkönyvtárak még nem támogatottak; az egyéni könyvtárak működnek, de a csoportkönyvtárak jelenleg nem támogatottak.

K: A Zotero-integrációm elakadt (pl. fiók vagy API-kulcs módosítása után). Hogyan javítható?
V: A támogatásnak szüksége lesz az Ön Zotero numerikus azonosítójára (nem a felhasználónevére), hogy lekapcsolja az integrációt a korábbi/anonim felhasználóról, ezután újra összekapcsolhatja a fiókjával. Példa erre itt található: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

K: Klónozhatok egy Prism-projektet Git segítségével (GitHub/GitLab), vagy szinkronban tarthatom az intézeti Git-platformommal?
V: A Git-integráció még nem érhető el, de ez egy magas prioritású, közelgő fejlesztési projekt.

LaTeX build és hibaelhárítás

K: Hogyan kényszeríthetek tiszta újrafordítást (Aux/toc/bbl artefaktumok törlését)?
V: Töltse újra az oldalt. Az oldal frissítése új, tiszta buildet kényszerít ki.

K: Az ábrák/képek nem töltődnek be a Prismben, pedig ugyanaz a LaTeX máshol működik.
V: Használjon az importot végző .tex fájlhoz viszonyított relatív elérési utakat. Ha a .tex fájl egy almappában van, a kép pedig a projekt gyökerében, tegye az elérési út elejére ezt: ../.

K: A fordítás rendkívül lassú, vagy soha nem fejeződik be. Hogyan azonosíthatom az okát?
V: Kommentezzen ki részeket (majd azokon belül kisebb részeket), amíg a fordítás sikeres nem lesz, aztán szűkítse le a problémát az azt okozó pontos sorra. Nézze át a naplókban a figyelmeztetéseket és hibákat is, az elsőtől kezdve.

K: „Underfull/Overfull \hbox” figyelmeztetéseket kapok a létrehozott .bbl fájlban. Ez fordítási hiba?
V: Nem, ezek szedési figyelmeztetések, nem végzetes fordítási hibák. Ha a PDF-kimenet megfelelőnek tűnik, a figyelmeztetés általában figyelmen kívül hagyható.

K: Beamerben miért ad hibát a lstlisting/listings környezet egy frame-en belül (pl. „Extra }, or forgotten \endgroup”)?
V: Listing környezetek használatakor jelölje a Beamer frame-et [fragile]-ként; ez gyakran megoldja ezeket a hibákat.

K: A \cite hivatkozásaim „[?]” formában jelennek meg, pedig a .bib fájl létezik, és a bibliográfiai parancsok is jelen vannak. Mi egy működő konfiguráció?
A sikeres kerülőmegoldások egyike, hogy biztosítsa, hogy a bibliográfia helyesen legyen beillesztve a fő dokumentumból; BibTeX-stílusú munkafolyamatoknál adja meg a \bibliographystyle{plain} és a \bibliography{refs} parancsokat (ahol a refs.bib az Ön fájlja).

Termékfelület és funkciókérések

K: Van a Prismben világos mód?
V: Igen. A Prism három megjelenési beállítást támogat: Rendszer, Világos és Sötét. Kiválaszthatja az Önnek legmegfelelőbb témát.