Odpravljanje težav in pomoč v Prismu

Prism je sodelovalni delovni prostor za LaTeX, zasnovan posebej za umetno inteligenco in zgrajen na prelomnih modelih, ki raziskovalcem pomaga hitreje razmišljati, pisati in izboljševati delo. Vgrajena inteligenca pospešuje znanstveno delo in ga hkrati poglablja.

V tem vodniku je pojasnjeno, kako odpraviti pogoste težave in kje poiskati dodatno pomoč.

Kako dostopati do Prism

Prism je na voljo na prism.openai.com vsem uporabnikom z računom Free, Go, Plus ali Pro ChatGPT, ki niso in niso bili člani delovnega prostora Business ali Enterprise. Dostop bomo v bližnji prihodnosti razširili na Business, Enterprise in Edu.

1. Uporaba vgrajene inteligence v Prismu

Prism vključuje pomočnika, vgrajenega v urejevalnik, ki ga poganjajo prelomni modeli OpenAI. Razume kontekst dokumenta ter vam lahko pomaga ustvarjati kodo LaTeX, ugotavljati vzroke napak in predlagati popravke, ne da bi morali zapustiti urejevalnik. Do njega lahko dostopate v podoknu na dnu delovnega prostora.

1. Ustvarjanje izsekov LaTeX: Prosite Prism, naj ustvari pogoste elemente LaTeX, na primer »Ustvari tabelo 4 × 4« ali »Dodaj sliko z napisom«. Prism bo vrnil kodo LaTeX, pripravljeno za uporabo, ter ponudil možnosti Obdrži in Razveljavi, da jo lahko neposredno vstavite v projekt.

2. Odkrivanje težav pri prevajanju: Če dokumenta ni mogoče prevesti, v podoknu opišite težavo, na primer »Mojega dokumenta ni mogoče prevesti«. Prism bo postavil dodatna vprašanja in vas vodil skozi verjetne vzroke, kot so manjkajoči ukazi ali nerazrešeni sklici.

3. Sprotno odpravljanje napak: Napake in opozorila so na robu urejevalnika označeni z rdečimi ali rumenimi oznakami. Prism lahko prosite, naj odpravi določeno napako. Analiziral bo ustrezne vrstice, pojasnil težavo in predlagal ciljne popravke. Predlog lahko uporabite neposredno in dokument znova prevedete, da preverite popravek.

4. Lektoriranje: Prosite Prism, naj lektorira razdelek, označi napake ali vrzeli v logiki ter predlaga, kako lahko izboljšate jasnost razdelka. Za uredniške in stvarne povratne informacije lahko uporabite veščine, kot je pregled članka.

5. Iskanje literature: Dodaj bibliografijo mojemu članku in predlagaj sorodna dela, ki sem jih morda spregledal.

2. Odkrivanje napak pri prevajanju

Če dokumenta LaTeX ni mogoče prevesti, poskusite naslednje:

1. Preverite oznako napake: Rdeče in rumene oznake kažejo, kje je Prism zaznal težavo. Kliknite oznako, da si ogledate podrobnosti, nato pa z vgrajenim pomočnikom ugotovite vzrok napake.

2. Preglejte dnevnik prevajanja: Če prevajanje ne uspe, se v podoknu za predogled PDF-ja prikaže dnevnik prevajanja. Osredotočite se na prvo sporočilo o napaki (na primer manjkajoči \end{document}), saj so poznejše napake pogosto le verižne posledice. Za natančnejša navodila to sporočilo posredujte Prismu.

3. Razveljavite nedavne spremembe: Če se je napaka pojavila po nedavnem urejanju, spremembo razveljavite ali jo začasno zakomentirajte in preverite, ali prevajanje uspe.

4. Dokument skrčite na najmanjši možni primer: Če težave ne odpravite, poenostavite dokument tako, da vsebuje le bistveno vsebino. Z odstranitvijo nepovezanih razdelkov boste lažje osamili vir napake.

3. Priporočila za preprečevanje težav

1. Ostanite prijavljeni: Vedno delajte prijavljeni, da se spremembe shranijo in so na voljo tudi v naslednjih sejah.

2. Uporabljajte podprte pakete: Prism podpira številne pogosto uporabljene pakete LaTeX. Redki, zastareli ali nevzdrževani paketi lahko povzročijo nepričakovane napake pri prevajanju.

3. Urejajte postopoma: Spreminjajte po malem in pogosto prevajajte dokument. Tako boste lažje ugotovili, katera sprememba je povzročila napako, in hitro obnovili delujoče stanje.

Prenos projektov LaTeX v Prism

V tem vodniku je pojasnjeno, kako obstoječe projekte LaTeX iz Overleafa ali lokalnega računalnika prenesete v Prism. Z uvozom projektov ohranite vse na enem mestu in lahko nadaljujete delo, ne da bi morali ročno znova sestaviti datoteke.

Uvoz projektov iz Overleafa

Če želite projekt prenesti iz Overleafa v Prism, najprej prenesite projektne datoteke iz Overleafa in jih nato naložite v Prism.

Prenos posameznega projekta

1. Odprite nadzorno ploščo projektov Overleaf.

2. Poiščite projekt, ki ga želite prenesti.

3. Kliknite ikono za prenos v isti vrstici kot ime projekta.

4. Overleaf v računalnik prenese celoten projekt kot datoteko .zip.

Prenos več projektov

1. Odprite seznam projektov Overleaf.

2. Projekte izberite s potrditvenim poljem na začetku vsake vrstice.

1. Če želite izbrati vse, kliknite prvo potrditveno polje na seznamu.

2. Ko izberete projekte, kliknite ikono za prenos v zgornjem desnem kotu seznama projektov.

Izbrani projekti se bodo prenesli kot datoteke .zip.

Uvoz projektov v Prism

Prism lahko projekte uvozi na tri načine: z nalaganjem mape, nalaganjem arhiva .zip ali vlečenjem in spuščanjem datotek v pogledu Vsi projekti.


Uvoz projekta iz menija Uvoz:

1. Odprite Prism in izberite Uvoz.

2. Kliknite škarnico ob možnosti Uvoz, da izberete vrsto uvoza.

Izberite eno od naslednjih možnosti:

1. Odprite Prism in poiščite možnost Uvoz.

2. Kliknite škarnico ob možnosti Uvoz, da izberete vrsto uvoza.

3. Izberite eno od naslednjih možnosti:

Uvozi datoteko .zip: V računalniku izberite preneseni arhiv projekta. Prism bo projekt samodejno razširil in naložil.


Uvozi mapo: V računalniku izberite mapo projekta. Prism bo uvozil datoteke .tex, bibliografske datoteke, slike in druge vire projekta.


Uvoz z vlečenjem in spuščanjem: V pogledu Vsi projekti povlecite mapo projekta ali datoteko .zip v Prism in jo spustite. Prism bo samodejno ustvaril nov projekt in uvozil datoteke.

Ko se nalaganje konča, Prism odpre celoten projekt, da ga lahko začnete urejati in prevajati.

Druga pogosta vprašanja

Račun, varnost in obračunavanje

V: Kje lahko najdem vaš pravilnik o zasebnosti? O: Pravilnik o zasebnosti za Prism najdete tukaj.

V: Ali moje podatke uporabljate za učenje modelov? O: Uporabniki imajo popoln nadzor nad tem, ali se njihovi podatki uporabljajo za izboljševanje naših modelov, skladno z našim pravilnikom o zasebnosti.

V: Ali uporabljate »ničelno hrambo podatkov« (ZDR)? Kakšno beleženje oziroma hramba se izvaja? O: Prism trenutno ne uporablja možnosti API-ja »ničelna hramba podatkov« (ZDR) in zaradi izboljševanja izdelka še nekaj časa po zahtevah hrani dnevnike.


V: Ali ponujate način zasebnosti, pri katerem se besedilo ne shranjuje in ga ljudje ne pregledujejo, oziroma lokalno hrambo podatkov izključno v EU? O: Uporabniki so te funkcije že predlagali. So na časovnem načrtu oziroma seznamu načrtovanih opravil, vendar datum uvedbe še ni določen.

Deljenje in sodelovanje

V: Zakaj ne morem deliti povezave z možnostjo »ureja lahko vsak«? (Na spustnem seznamu je na voljo le »ogleda si lahko vsak«.) O: Trenutno je tako predvideno. Deljenje prek povezave z možnostjo »ureja lahko vsak« še ni podprto. Urednike je treba dodati kot sodelavce, ki imajo račun Prism.


V: Sodelavci ne prejemajo e-poštnih povabil. Kako lahko dostopajo do projekta? O: Prosijo naj preverijo mapo z vsiljeno oziroma neželeno pošto in se prijavijo z e-poštnim naslovom, na katerega so prejeli povabilo. Po prvi prijavi bi se jim moral prikazati projekt v skupni rabi.

Uvoz in izvoz projektov

V: Nalaganje oziroma uvoz datoteke ZIP je obtičal pri sporočilu »uvažanje projekta«. Kaj naj storim? O: Poskusite datoteko znova naložiti. Če postopek tudi po ponovnem poskusu obstane, datoteko ZIP posredujte podpori, da lahko raziščejo napako v postopku uvoza.


V: Kako izvozim oziroma prenesem projekt kot datoteko ZIP? O: Kliknite ime projekta in izberite Izvozi, da prenesete stisnjeno kopijo projekta. Pred izvozom lahko vzpostavljanje povezave z zalednim sistemom traja nekaj sekund.

Zanesljivost, izpadi in povezljivost

V: Po osvežitvi so moji projekti izginili. Ali so izgubljeni? O: Znova osvežite stran in preverite seznam projektov. Vaši podatki bi se morali znova prikazati.


V: Po osvežitvi strani so moji projekti izginili. Ali so izgubljeni? O: To se lahko zgodi med izpadom ponudnika. Poskusite znova; projekti bi se morali spet prikazati. Če se ne, vam jih lahko pomaga obnoviti podpora.


V: Spletno mesto očitno ne deluje oziroma aplikacija sporoča, da se ne more povezati z zalednim sistemom. Kaj naj storim? O: Poskusite znova oziroma znova naložite stran. Če težava ne izgine, podpori pošljite podrobnosti o tem, kaj se prikazuje, in po možnosti povezavo do projekta, da lahko težavo raziščejo.

Celovitost podatkov, obnovitev, varnostne kopije in zgodovina različic

V: Dokument je zamrznil, nato je vsebina izginila, sidra komentarjev pa so se premaknila. Ali ga lahko obnovim? O: Najprej prenesite varnostno kopijo .zip. Prism vključuje tudi zgodovino različic, s katero boste morda lahko obnovili starejšo različico. Položajev sider komentarjev ni vedno mogoče obnoviti, komentarji pa se trenutno ne izvozijo v varnostne kopije. Če se je oblikovanje spremenilo, ga poskusite popraviti z oblikovalnikom kode.


V: Ko sem znova odprl projekt, so se datoteke oziroma vsebina povrnile na starejšo različico ali izginile. Kaj se je zgodilo? O: Nekaj časa je bilo shranjevanje projektov odvisno od zunanjega ponudnika, ki med nenadnim porastom uporabe ni zmogel obremenitve. Shranjevanje je bilo preneseno v notranji sistem, da bi zmanjšali število napak pri povezovanju in preprečili ponovitev težave, dodani pa so bili tudi dodatni varnostni ukrepi.


V: Ali je mogoče obnoviti položaje komentarjev in ali so komentarji vključeni v varnostne kopije projektov? O: Položajev komentarjev pozneje morda ne bo mogoče obnoviti. Za obnovitev ob prihodnjih incidentih se zdaj redno ustvarjajo varnostne kopije (na primer približno vsakih 10 minut), vendar se komentarji trenutno ne izvozijo v varnostne kopije ZIP.

Integracije

Zotero

V: Zakaj skupinskih knjižnic Zotero ne morem uvoziti v Prism? O: Skupinske knjižnice Zotero še niso podprte. Posamezne knjižnice delujejo, skupinske pa trenutno ne.


V: Integracija z Zotero se je zataknila, na primer po zamenjavi računa ali ključev API. Kako jo lahko popravim? O: Podpori morate posredovati številčni ID za Zotero, ne uporabniškega imena, da lahko prekine povezavo integracije s prejšnjim oziroma anonimnim uporabnikom. Nato jo lahko znova povežete s svojim računom. Primer postopka: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

V: Ali lahko projekt Prism kloniram z Gitom (GitHub/GitLab) ali ga sinhroniziram s platformo Git svoje ustanove? O: Integracija z Gitom še ni na voljo, vendar je njen razvoj načrtovan in ima visoko prednost.

Prevajanje kode LaTeX in odpravljanje težav

V: Kako vsilim povsem novo prevajanje kode (in počistim artefakte Aux/toc/bbl)? O: Znova naložite stran. Osvežitev strani vsili povsem novo prevajanje.


V: Slike se v Prismu ne naložijo, čeprav ista koda LaTeX drugje deluje. O: Uporabite poti, ki so relativne glede na datoteko .tex, iz katere poteka uvoz. Če je datoteka .tex v podmapi, slika pa v korenski mapi projekta, poti dodajte predpono ../.


V: Prevajanje je izjemno počasno ali se nikoli ne konča. Kako ugotovim vzrok? O: Zakomentirajte razdelke, nato pa še njihove manjše dele, dokler prevajanje ne uspe. Nato postopoma poiščite točno vrstico, ki povzroča težavo. Preglejte tudi opozorila in napake v dnevnikih, začenši s prvim.


V: V ustvarjeni datoteki .bbl se prikazujejo opozorila »Underfull/Overfull \hbox«. Ali je to napaka pri prevajanju? O: Ne. To so opozorila o stavljenju, ne usodne napake pri prevajanju. Če je ustvarjeni PDF videti ustrezno, lahko opozorilo običajno prezrete.


V: Zakaj okolja lstlisting/listings v Beamerju povzročijo napako znotraj okvirja (na primer »Extra }, or forgotten \endgroup«)? O: Ko uporabljate okolja za izpise, okvir Beamer označite z [fragile]. To pogosto odpravi takšne napake.


V: Moji sklici \cite se prikazujejo kot »[?]«, čeprav datoteka .bib obstaja in so ukazi za bibliografijo vključeni. Katera nastavitev deluje? Ena od uspešnih rešitev je zagotoviti, da je bibliografija pravilno vključena iz glavnega dokumenta. Pri delovnih postopkih v slogu BibTeX vključite \bibliographystyle{plain} in \bibliography{refs}, pri čemer je refs.bib vaša datoteka.

Uporabniški vmesnik izdelka in predlogi funkcij

V: Ali Prism ponuja svetli način? O: Da. Prism podpira tri nastavitve videza: Sistemsko, Svetlo in Temno. Izberete lahko temo, ki vam najbolj ustreza.