Trikčių šalinimas ir pagalbos gavimas naudojant Prism

Prism – bendradarbiauti skirta, iš pagrindų dirbtiniam intelektui pritaikyta LaTeX darbo erdvė, veikianti su priešakiniais modeliais ir padedanti tyrėjams sparčiau mąstyti, rašyti bei tobulinti savo darbus. Integruotas intelektas padeda mokslinius darbus atlikti ir greičiau, ir išsamiau.

Šiame vadove paaiškinama, kaip šalinti dažnas triktis ir kur rasti papildomos pagalbos.

Kaip pasiekti „Prism“

„Prism“ pasiekiama adresu prism.openai.com visiems naudotojams, turintiems „Free“, „Go“, „Plus“ arba „Pro“ ChatGPT paskyrą, kurie nėra ir nebuvo „Business“ arba „Enterprise“ darbo erdvės nariai. Artimiausiu metu išplėsime prieigą prie „Business“, „Enterprise“ ir „Edu“.

1. Prism integruoto intelekto naudojimas

Prism turi redaktoriuje integruotą asistentą, veikiantį su OpenAI priešakiniais modeliais. Jis supranta dokumento kontekstą ir neišeinant iš redaktoriaus gali padėti generuoti LaTeX kodą, diagnozuoti klaidas bei siūlyti pataisymus. Jį rasite darbo erdvės apačioje esančiame skydelyje.

1. Generuokite LaTeX fragmentus. Paprašykite Prism sukurti įprastus LaTeX elementus, pavyzdžiui: „Sukurk 4 × 4 lentelę“ arba „Pridėk iliustraciją su antrašte“. Prism pateiks paruoštą naudoti LaTeX kodą ir parinktis „Palikti“ bei „Atšaukti“, kad galėtumėte jį tiesiogiai įterpti į projektą.

2. Diagnozuokite kompiliavimo problemas. Jei dokumento nepavyksta sukompiliuoti, aprašykite problemą skydelyje (pavyzdžiui: „Mano dokumento nepavyksta sukompiliuoti“). Prism užduos patikslinamųjų klausimų ir padės patikrinti tikėtinas priežastis, pavyzdžiui, trūkstamas komandas ar neišspręstas nuorodas.

3. Taisykite klaidas tiesiogiai. Klaidos ir įspėjimai redaktoriaus paraštėje rodomi kaip raudoni arba geltoni žymekliai. Galite paprašyti Prism ištaisyti konkrečią klaidą. Jis išanalizuos susijusias eilutes, paaiškins problemą ir pasiūlys tikslingų pakeitimų. Pasiūlymą galite pritaikyti tiesiogiai ir iš naujo sukompiliuoti dokumentą, kad patikrintumėte pataisymą.

4. Redaguokite tekstą. Paprašykite Prism suredaguoti dalį, pažymėti klaidas ar logikos spragas ir pasiūlyti, kaip aiškiau išdėstyti mintis. Redakcinėms pastaboms ir faktams patikrinti galite naudoti įgūdžius, pavyzdžiui, straipsnio recenzavimą.

5. Ieškokite literatūros. Pridėkite prie mano straipsnio bibliografiją ir pasiūlykite susijusių darbų, kurių galėjau nepastebėti.

2. Kompiliavimo klaidų diagnostika

Jei LaTeX dokumento nepavyksta sukompiliuoti, išbandykite šiuos veiksmus:

1. Patikrinkite klaidos žymeklį. Raudoni ir geltoni žymekliai nurodo vietas, kuriose Prism aptiko problemą. Spustelėkite žymeklį, kad peržiūrėtumėte išsamią informaciją, tada klaidą diagnozuokite naudodami integruotą asistentą.

2. Peržiūrėkite kompiliavimo žurnalą. Jei kompiliuoti nepavyksta, PDF peržiūros srityje rodomas kompiliavimo žurnalas. Daugiausia dėmesio skirkite pirmajam klaidos pranešimui (pavyzdžiui, kai trūksta \end{document}), nes vėlesnės klaidos dažnai kyla dėl pirmosios. Pasidalykite šiuo pranešimu su Prism, kad gautumėte tikslesnių nurodymų.

3. Atšaukite naujausius pakeitimus. Jei klaida atsirado po neseniai atlikto pakeitimo, jį atšaukite arba laikinai paverskite komentaru ir patikrinkite, ar dokumentas sukompiliuojamas.

4. Sukurkite minimalų pavyzdį. Jei problemos išlieka, palikite dokumente tik būtiniausią turinį. Pašalinus nesusijusias dalis, lengviau nustatyti klaidos šaltinį.

3. Kaip išvengti problemų: geriausia praktika

1. Likite prisijungę. Visada dirbkite prisijungę, kad pakeitimai būtų įrašomi ir pasiekiami kituose seansuose.

2. Naudokite palaikomus paketus. Prism palaiko daug dažnai naudojamų LaTeX paketų. Reti, pasenę ar nebepalaikomi paketai gali sukelti netikėtų kompiliavimo klaidų.

3. Redaguokite palaipsniui. Atlikite nedidelius pakeitimus ir dažnai kompiliuokite. Taip lengviau nustatyti, kuris pakeitimas sukėlė klaidą, ir greitai atkurti ankstesnę būseną.

LaTeX projektų perkėlimas į Prism

Šiame vadove paaiškinama, kaip perkelti esamus LaTeX projektus iš Overleaf arba vietinio kompiuterio į Prism. Importavę projektus viską laikysite vienoje vietoje ir galėsite tęsti darbą, neperkurdami failų rankiniu būdu.

Projektų importavimas iš Overleaf

Norėdami perkelti projektą iš Overleaf į Prism, pirmiausia atsisiųskite projekto failus iš Overleaf, tada įkelkite juos į Prism.

Vieno projekto atsisiuntimas

1. Atidarykite savo Overleaf projektų valdymo skydą.

2. Raskite projektą, kurį norite perkelti.

3. Toje pačioje eilutėje kaip projekto pavadinimas spustelėkite atsisiuntimo piktogramą.

4. Overleaf atsisiųs visą projektą į jūsų kompiuterį kaip .zip failą.

Kelių projektų atsisiuntimas

1. Atidarykite savo Overleaf projektų sąrašą.

2. Pasirinkite projektus pažymėdami kiekvienos eilutės pradžioje esantį žymimąjį langelį.

1. Norėdami pasirinkti viską, spustelėkite sąrašo pirmąjį žymimąjį langelį.

2. Pasirinkę projektus, spustelėkite projektų sąrašo viršutiniame dešiniajame kampe esančią atsisiuntimo piktogramą.

Pasirinkti projektai bus atsisiųsti kaip .zip failai.

Projektų importavimas į Prism

Prism projektus gali importuoti trimis būdais: įkeliant aplanką, įkeliant .zip archyvą arba nuvilkus failus į rodinį „Visi projektai“.


Norėdami importuoti projektą iš meniu „Importuoti“:

1. Atidarykite Prism ir eikite į skiltį „Importuoti“.

2. Spustelėkite šalia parinkties „Importuoti“ esančią rodyklę ir pasirinkite importavimo tipą.

Pasirinkite vieną iš šių parinkčių:

1. Atidarykite Prism ir pasirinkite parinktį „Importuoti“.

2. Spustelėkite šalia parinkties „Importuoti“ esančią rodyklę ir pasirinkite importavimo tipą.

3. Pasirinkite vieną iš šių parinkčių:

Importuoti .zip failą. Kompiuteryje pasirinkite atsisiųstą projekto archyvą. Prism automatiškai išskleis ir įkels projektą.


Importuoti aplanką. Kompiuteryje pasirinkite projekto aplanką. Prism importuos .tex failus, bibliografijos failus, vaizdus ir kitus projekto išteklius.


Norėdami importuoti nuvilkdami: rodinyje „Visi projektai“ nuvilkite projekto aplanką arba .zip failą į Prism. Prism automatiškai sukurs naują projektą ir importuos failus.

Baigus įkelti, Prism atidarys visą projektą, kad galėtumėte pradėti jį redaguoti ir kompiliuoti.

Kiti DUK

Paskyra, saugumas ir atsiskaitymas

K. Kur galiu rasti jūsų privatumo politiką? A. Prism privatumo politiką rasite čia.

K. Ar mano duomenis naudojate modeliams mokyti? A. Naudotojai gali visiškai kontroliuoti, ar jų duomenys naudojami mūsų modeliams tobulinti, kaip numatyta mūsų privatumo politikoje.

K. Ar naudojate „nulinį duomenų saugojimą“ (ZDR)? Kokie duomenys registruojami ir kiek laiko saugomi? A. Šiuo metu Prism nenaudoja API parinkties „nulinis duomenų saugojimas“ (ZDR) ir, siekiant tobulinti produktą, po užklausų tam tikrą laiką saugo žurnalus.


K. Ar siūlote privatumo režimą, kuriame tekstas nesaugomas ir jo neperžiūri žmonės, ir (arba) duomenų saugojimo vietą tik ES? A. Šių funkcijų prašoma ir jos įtrauktos į planus bei neatliktų darbų sąrašą, tačiau konkretus įgyvendinimo terminas dar nenustatytas.

Bendrinimas ir bendradarbiavimas

K. Kodėl negaliu bendrinti nuorodos su parinktimi „redaguoti gali visi“? (Išskleidžiamajame meniu galima pasirinkti tik „peržiūrėti gali visi“.) A. Šiuo metu taip numatyta. Bendrinimas per nuorodą, kai redaguoti gali visi, dar nepalaikomas. Redaktorius reikia pridėti kaip bendradarbius, turinčius Prism paskyrą.


K. Bendradarbiai negauna kvietimų el. paštu. Kaip jie gali pasiekti projektą? A. Paprašykite jų patikrinti pašto šiukšlių aplanką ir prisijungti naudojant el. pašto adresą, kuriuo gavo kvietimą. Pirmą kartą prisijungus bendrinamas projektas turėtų būti rodomas.

Projektų importavimas ir eksportavimas

K. ZIP failo įkėlimas ar importavimas užstrigo ties pranešimu „Projektas importuojamas“. Ką daryti? A. Pabandykite įkelti dar kartą. Jei pakartojus veiksmą procesas vis tiek užstringa, nusiųskite ZIP failą palaikymo komandai, kad ji galėtų nustatyti importavimo proceso triktį.


K. Kaip eksportuoti arba atsisiųsti projektą ZIP formatu? A. Spustelėkite projekto pavadinimą, tada pasirinkite „Eksportuoti“, kad atsisiųstumėte suglaudintą projekto kopiją. Prieš eksportuojant gali tekti kelias sekundes palaukti, kol bus užmegztas ryšys su vidine sistema.

Patikimumas, veikimo sutrikimai ir ryšys

K. Atnaujinus puslapį dingo mano projektai. Ar jie prarasti? A. Atnaujinkite dar kartą ir iš naujo patikrinkite projektų sąrašą. Jūsų duomenys turėtų vėl pasirodyti.


K. Atnaujinus puslapį dingo mano projektai. Ar jie prarasti? A. Taip gali nutikti sutrikus paslaugų teikėjo veiklai. Pabandykite dar kartą – projektai turėtų vėl pasirodyti. Jei nepasirodo, juos atkurti gali padėti palaikymo komanda.


K. Atrodo, kad svetainė neveikia, arba programėlė praneša negalinti prisijungti prie vidinės sistemos. Ką daryti? A. Pabandykite dar kartą arba įkelkite puslapį iš naujo. Jei problema išlieka, nusiųskite palaikymo komandai išsamią informaciją apie tai, ką matote, ir, jei įmanoma, projekto nuorodą, kad ji galėtų ištirti problemą.

Duomenų vientisumas, atkūrimas, atsarginės kopijos ir versijų istorija

K. Mano dokumentas užstrigo, tada dingo turinys ir pasislinko komentarų žymos. Ar galiu jį atkurti? A. Pirmiausia atsisiųskite .zip atsarginę kopiją. Prism taip pat saugo versijų istoriją, todėl galbūt galėsite atkurti ankstesnę versiją. Komentarų žymų vietų ne visada įmanoma atkurti, o komentarai šiuo metu į atsargines kopijas neeksportuojami. Jei pasikeitė formatavimas, pabandykite jį pataisyti naudodami kodo formatavimo priemonę.


K. Iš naujo atidarius projektą, failai ar turinys grįžo į ankstesnę būseną arba dingo. Kas nutiko? A. Kurį laiką projektų įrašymas priklausė nuo išorinio paslaugų teikėjo, kurio sistema neatlaikė staiga išaugusio naudojimo. Siekiant sumažinti ryšio klaidų ir neleisti problemai pasikartoti, įrašymas perkeltas į vidinę sistemą ir įdiegtos papildomos apsaugos priemonės.


K. Ar galima atkurti komentarų vietas ir ar komentarai įtraukiami į projekto atsargines kopijas? A. Po įvykio komentarų vietų gali būti neįmanoma atkurti. Kad ateityje po incidentų būtų galima atkurti duomenis, dabar periodiškai (pvz., maždaug kas 10 minučių) kuriamos atsarginės kopijos, tačiau komentarai šiuo metu į ZIP atsargines kopijas neeksportuojami.

Integracijos

Zotero

K. Kodėl negaliu importuoti Zotero grupių bibliotekų į Prism? A. Zotero grupių bibliotekos dar nepalaikomos. Asmeninės bibliotekos veikia, tačiau grupių bibliotekos šiuo metu nepalaikomos.


K. Mano Zotero integracija užstrigo (pvz., pakeitus paskyrą arba API raktus). Kaip ją pataisyti? A. Palaikymo komandai reikės jūsų skaitinio Zotero ID, o ne naudotojo vardo, kad galėtų atsieti integraciją nuo ankstesnio arba anoniminio naudotojo. Tada galėsite ją iš naujo susieti su savo paskyra. Kaip tai padaryti, parodyta čia: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

K. Ar galiu klonuoti Prism projektą per Git (GitHub/GitLab) arba sinchronizuoti jį su savo instituto Git platforma? A. Git integracija dar nepasiekiama, tačiau jos kūrimas yra vienas svarbiausių artimiausių projektų.

LaTeX kompiliavimas ir trikčių šalinimas

K. Kaip priverstinai atlikti švarų pakartotinį kompiliavimą (išvalyti Aux/toc/bbl artefaktus)? A. Įkelkite puslapį iš naujo. Atnaujinus puslapį priverstinai atliekamas naujas švarus kompiliavimas.


K. Prism neįkelia iliustracijų ar vaizdų, nors tas pats LaTeX kodas kitur veikia. A. Naudokite kelius, susietus su importuojančio .tex failo vieta. Jei .tex failas yra poaplankyje, o vaizdas – projekto šakniniame aplanke, kelio pradžioje įrašykite ../.


K. Kompiliavimas vyksta itin lėtai arba niekada nesibaigia. Kaip nustatyti priežastį? A. Paverskite dalis komentarais, o vėliau – mažesnius tų dalių fragmentus, kol kompiliavimas pavyks. Tada palaipsniui nustatykite konkrečią problemą sukeliančią eilutę. Taip pat peržiūrėkite žurnaluose pateiktus įspėjimus ir klaidas, pradėdami nuo pirmojo įrašo.


K. Sugeneruotame .bbl faile gaunu įspėjimų „Underfull/Overfull \hbox“. Ar tai kompiliavimo klaida? A. Ne, tai maketavimo įspėjimai, o ne kritinės kompiliavimo klaidos. Jei PDF rezultatas atrodo tinkamai, įspėjimo paprastai galima nepaisyti.


K. Kodėl Beamer aplinkoje lstlisting/listings blokai kadre sukelia klaidą (pvz., „Extra }, or forgotten \endgroup“)? A. Naudodami listing aplinkas pažymėkite Beamer kadrą kaip [fragile]. Tai dažnai pašalina šias klaidas.


K. Mano \cite citatos rodomos kaip „[?]“, nors .bib failas yra ir bibliografijos komandos įtrauktos. Kokia konfigūracija veikia? Vienas sėkmingai pritaikytas sprendimas – įsitikinti, kad bibliografija tinkamai įtraukta iš pagrindinio dokumento. Naudodami BibTeX tipo darbo eigą įtraukite \bibliographystyle{plain} ir \bibliography{refs} (čia refs.bib yra jūsų failas).

Produkto sąsaja ir funkcijų užklausos

K. Ar Prism turi šviesųjį režimą? A. Taip. Prism palaiko tris išvaizdos nuostatas: „Sistemos“, „Šviesi“ ir „Tamsi“. Galite pasirinkti jums tinkamiausią temą.