Řešení problémů a získání nápovědy v Prism

Prism je kolaborativní pracovní prostor pro LaTeX s nativní podporou AI, který využívá průkopnické modely a pomáhá výzkumníkům rychleji přemýšlet, psát a upravovat svou práci. Integrovaná inteligence urychluje vědeckou práci a zároveň umožňuje jít více do hloubky.

Tato příručka vysvětluje, jak řešit běžné problémy a kde najít další pomoc.

Jak získat přístup k Prism

Prism je dostupný na adrese prism.openai.com všem uživatelům s účtem ChatGPT Free, Go, Plus nebo Pro, kteří nejsou a nebyli členy pracovního prostoru Business nebo Enterprise. V blízké budoucnosti rozšíříme přístup pro Business, Enterprise a Edu.

1. Používání integrované inteligence Prism

Prism obsahuje asistenta integrovaného přímo do editoru, který využívá průkopnické modely OpenAI. Rozumí kontextu dokumentu a bez nutnosti opustit editor vám pomůže generovat LaTeX, diagnostikovat chyby a navrhovat opravy. Asistenta najdete na panelu ve spodní části pracovního prostoru.

1. Generování úryvků LaTeXu: Požádejte Prism, aby vytvořil běžné prvky LaTeXu, například „Vytvoř tabulku 4 × 4“ nebo „Přidej obrázek s popiskem“. Prism vrátí LaTeX připravený k použití a nabídne možnosti Ponechat a Vrátit zpět, takže ho můžete vložit přímo do projektu.

2. Diagnostika problémů s kompilací: Pokud dokument nelze zkompilovat, popište problém na panelu, například „Dokument se mi nedaří zkompilovat“. Prism položí upřesňující otázky a provede vás pravděpodobnými příčinami, například chybějícími příkazy nebo nevyřešenými odkazy.

3. Opravy chyb přímo v textu: Chyby a varování se na okraji editoru zobrazují jako červené nebo žluté značky. Můžete Prism požádat o opravu konkrétní chyby. Analyzuje příslušné řádky, vysvětlí problém a navrhne cílené úpravy. Návrh můžete přímo použít a opětovnou kompilací ověřit, zda se problém vyřešil.

4. Korektura: Požádejte Prism, aby provedl korekturu oddílu, upozornil na chyby či mezery v logice a navrhl, jak text zpřehlednit. Pro redakční a faktickou zpětnou vazbu můžete využít Dovednosti, například Posouzení odborného článku.

5. Vyhledávání literatury: Přidej do mého článku bibliografii a navrhni související práce, které jsem mohl(a) přehlédnout.

2. Diagnostika chyb při kompilaci

Pokud dokument LaTeX nelze zkompilovat, vyzkoušejte následující postup:

1. Zkontrolujte značku chyby: Červené a žluté značky označují místa, kde Prism zjistil problém. Kliknutím na značku zobrazte podrobnosti a poté chybu diagnostikujte pomocí integrovaného asistenta.

2. Projděte protokol kompilace: Když se kompilace nezdaří, zobrazí se v podokně náhledu PDF protokol kompilace. Zaměřte se na první chybovou zprávu (například chybějící \end{document}), protože pozdější chyby jsou často jen jejími následky. Sdílejte tuto zprávu s Prism, abyste získali přesnější pokyny.

3. Vraťte zpět poslední změny: Pokud se chyba objevila po nedávné úpravě, vraťte ji zpět nebo ji dočasně zakomentujte a ověřte, zda kompilace proběhne úspěšně.

4. Omezte dokument na minimální příklad: Pokud problémy přetrvávají, zjednodušte dokument tak, aby obsahoval jen to podstatné. Odstranění nesouvisejících oddílů pomůže určit zdroj chyby.

3. Doporučené postupy, jak předcházet problémům

1. Zůstaňte přihlášení: Vždy pracujte po přihlášení, aby se změny uložily a zůstaly dostupné i při dalších relacích.

2. Používejte podporované balíčky: Prism podporuje mnoho běžně používaných balíčků LaTeX. Vzácné, zastaralé nebo neudržované balíčky mohou způsobovat neočekávané chyby kompilace.

3. Upravujte postupně: Provádějte malé změny a často kompilujte. Snáze tak zjistíte, která úprava způsobila chybu, a rychle se z ní zotavíte.

Přesun projektů LaTeX do Prism

Tato příručka vysvětluje, jak do Prism přesunout existující projekty LaTeX z Overleafu nebo z místního počítače. Import uchová všechny projekty na jednom místě a umožní vám pokračovat v práci, aniž byste museli soubory ručně znovu vytvářet.

Import projektů z Overleafu

Chcete-li přesunout projekt z Overleafu do Prism, nejprve stáhněte soubory projektu z Overleafu a poté je nahrajte do Prism.

Stažení jednoho projektu

1. Otevřete řídicí panel projektů v Overleafu.

2. Najděte projekt, který chcete přenést.

3. Klikněte na ikonu stažení ve stejném řádku jako název projektu.

4. Overleaf stáhne celý projekt do počítače jako soubor .zip.

Stažení více projektů

1. Otevřete seznam projektů v Overleafu.

2. Vyberte projekty pomocí zaškrtávacího políčka na začátku každého řádku.

1. Chcete-li vybrat vše, klikněte na první zaškrtávací políčko v seznamu.

2. Po výběru klikněte na ikonu stažení v pravém horním rohu seznamu projektů.

Vybrané projekty se stáhnou jako soubory .zip.

Import projektů do Prism

Prism umožňuje importovat projekty třemi způsoby: nahráním složky, nahráním archivu .zip nebo přetažením souborů do zobrazení Všechny projekty.


Import projektu z nabídky Importovat:

1. Otevřete Prism a přejděte na Importovat.

2. Klikněte na šipku vedle možnosti Importovat a zvolte typ importu.

Vyberte jednu z následujících možností:

1. Otevřete Prism a přejděte na možnost Importovat.

2. Klikněte na šipku vedle možnosti Importovat a zvolte typ importu.

3. Vyberte jednu z následujících možností:

Import souboru .zip: Vyberte v počítači stažený archiv projektu. Prism projekt automaticky rozbalí a načte.


Import složky: Vyberte v počítači složku projektu. Prism importuje soubory .tex, soubory bibliografie, obrázky a další prostředky projektu.


Import přetažením: V zobrazení Všechny projekty přetáhněte do Prism složku projektu nebo soubor .zip. Prism automaticky vytvoří nový projekt a soubory do něj importuje.

Po dokončení nahrávání Prism otevře celý projekt, abyste ho mohli začít upravovat a kompilovat.

Další časté dotazy

Účet, zabezpečení a fakturace

Otázka: Kde najdu vaše zásady ochrany soukromí? Odpověď: Zásady ochrany soukromí služby Prism najdete zde.

Otázka: Trénujete na mých datech? Odpověď: Uživatelé mají plnou kontrolu nad tím, zda budou jejich data použita ke zlepšování našich modelů, v souladu s našimi zásadami ochrany soukromí.

Otázka: Používáte „nulové uchovávání dat“ (ZDR)? Jaká data protokolujete a uchováváte? Odpověď: Prism v současnosti nevyužívá možnost API „nulové uchovávání dat“ (ZDR) a po vyřízení požadavků po určitou dobu uchovává protokoly za účelem zlepšování produktu.


Otázka: Nabízíte režim ochrany soukromí, ve kterém se neukládá žádný text ani ho nekontrolují lidé, případně datovou rezidenci pouze v EU? Odpověď: Tyto funkce uživatelé požadují a jsou uvedeny v plánu či seznamu úkolů, zatím ale nemají pevně stanovený termín.

Sdílení a spolupráce

Otázka: Proč nemohu sdílet odkaz s možností „kdokoli může upravovat“? (V rozbalovací nabídce je pouze možnost „kdokoli může zobrazit“.) Odpověď: V současnosti jde o záměrné omezení. Sdílení pomocí odkazu s možností „kdokoli může upravovat“ zatím není podporováno. Editory je nutné přidat jako spolupracovníky, kteří musí mít účet Prism.


Otázka: Spolupracovníci nedostávají e-maily s pozvánkou. Jak mohou získat přístup k projektu? Odpověď: Požádejte je, aby zkontrolovali složku se spamem či nevyžádanou poštou a přihlásili se pomocí e-mailové adresy, na kterou dostali pozvánku. Sdílený projekt by se jim měl zobrazit po prvním přihlášení.

Import a export projektů

Otázka: Nahrávání nebo import souboru ZIP se zastavil na zprávě „importujeme váš projekt“. Co mám dělat? Odpověď: Zkuste soubor nahrát znovu. Pokud se import zastaví i po opakovaném pokusu, sdílejte soubor ZIP s podporou, aby mohla zjistit příčinu problému v procesu importu.


Otázka: Jak mohu projekt exportovat nebo stáhnout ve formátu ZIP? Odpověď: Klikněte na název projektu a poté vyberte možnost Exportovat. Stáhne se komprimovaná kopie projektu. Než bude možné projekt exportovat, může navázání spojení s backendem trvat několik sekund.

Spolehlivost, výpadky a připojení

Otázka: Po obnovení stránky zmizely mé projekty. Jsou ztracené? Odpověď: Obnovte stránku znovu a zkontrolujte seznam projektů. Vaše data by se měla opět zobrazit.


Otázka: Po obnovení stránky zmizely mé projekty. Jsou ztracené? Odpověď: K tomu může dojít během výpadku poskytovatele. Zkuste to znovu, projekty by se měly opět zobrazit. Pokud se nezobrazí, podpora vám je může pomoci obnovit.


Otázka: Web je zřejmě nedostupný nebo aplikace hlásí, že se nemůže připojit k backendu. Co mám dělat? Odpověď: Zkuste to znovu nebo stránku načtěte znovu. Pokud problém přetrvává, pošlete podpoře podrobnosti o tom, co se vám zobrazuje, a pokud možno také odkaz na projekt, aby mohla problém prošetřit.

Integrita dat, obnovení, zálohy a historie verzí

Otázka: Dokument se mi zasekl, poté zmizel obsah a přesunuly se kotvy komentářů. Mohu ho obnovit? Odpověď: Nejprve si stáhněte zálohu ve formátu .zip. Prism obsahuje také historii verzí, pomocí které můžete obnovit dřívější verzi. Pozice kotev komentářů se nemusí vždy podařit obnovit a komentáře se v současnosti do záloh neexportují. Pokud se změnilo formátování, zkuste ho opravit pomocí formátovače kódu.


Otázka: Znovu jsem otevřel(a) projekt a soubory nebo obsah se vrátily ke starší verzi či zmizely. Co se stalo? Odpověď: Po určitou dobu záviselo ukládání projektů na externím poskytovateli, který během prudkého nárůstu využití nestíhal. Ukládání bylo převedeno na interní systém, aby se omezily chyby připojení a zabránilo opakování problému. Byla přidána také další ochranná opatření.


Otázka: Lze obnovit pozice komentářů a jsou komentáře součástí záloh projektů? Odpověď: Pozice komentářů nemusí být možné zpětně obnovit. Pro případ budoucích incidentů se nyní vytvářejí pravidelné zálohy (např. přibližně každých 10 minut), ale komentáře se v současnosti do záloh ZIP neexportují.

Integrace

Zotero

Otázka: Proč nemohu do Prism importovat skupinové knihovny Zotero? Odpověď: Skupinové knihovny Zotero zatím nejsou podporovány. Individuální knihovny fungují, skupinové však v současnosti nikoli.


Otázka: Integrace se Zotero se zasekla, například po změně účtu nebo klíčů API. Jak ji lze opravit? Odpověď: Podpora bude potřebovat vaše číselné ID Zotero, nikoli uživatelské jméno, aby mohla integraci odpojit od předchozího nebo anonymního uživatele. Poté ji můžete znovu propojit se svým účtem. Příklad postupu: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

Otázka: Mohu projekt Prism naklonovat přes Git (GitHub/GitLab) nebo ho synchronizovat s platformou Git svého institutu? Odpověď: Integrace s Gitem zatím není dostupná, její vývoj má však do budoucna vysokou prioritu.

Sestavení LaTeXu a řešení problémů

Otázka: Jak vynutím nové čisté sestavení (vymazání pomocných souborů a artefaktů toc/bbl)? Odpověď: Znovu načtěte stránku. Obnovení stránky vynutí nové čisté sestavení.


Otázka: Obrázky se v Prism nenačítají, ale stejný LaTeX jinde funguje. Odpověď: Používejte cesty relativní k souboru .tex, který import provádí. Pokud je soubor .tex v podsložce a obrázek v kořenové složce projektu, přidejte před cestu ../.


Otázka: Kompilace je mimořádně pomalá nebo se nikdy nedokončí. Jak zjistím příčinu? Odpověď: Postupně zakomentujte jednotlivé oddíly a poté jejich menší části, dokud kompilace neproběhne úspěšně. Následně určete přesný řádek, který problém způsobuje. Projděte také varování a chyby v protokolech, počínaje první z nich.


Otázka: Ve vygenerovaném souboru .bbl se zobrazují varování „Underfull/Overfull \hbox“. Jde o chybu kompilace? Odpověď: Ne, jde o typografická varování, nikoli o kritické chyby kompilace. Pokud výsledné PDF vypadá přijatelně, lze tato varování obvykle ignorovat.


Otázka: Proč v Beameru prostředí lstlisting/listings uvnitř snímku způsobují chybu (např. „Extra }, or forgotten \endgroup“)? Odpověď: Při použití prostředí pro výpisy označte snímek Beamer jako [fragile]. Tím se tyto chyby často vyřeší.


Otázka: Citace \cite se zobrazují jako „[?]“, přestože soubor .bib existuje a příkazy pro bibliografii jsou uvedeny. Jaká konfigurace funguje? Jedním z osvědčených řešení je ověřit, že je bibliografie správně zahrnuta z hlavního dokumentu. U pracovních postupů využívajících BibTeX uveďte \bibliographystyle{plain} a \bibliography{refs}, kde refs.bib je váš soubor.

Uživatelské rozhraní a požadavky na funkce

Otázka: Nabízí Prism světlý režim? Odpověď: Ano. Prism podporuje tři nastavení vzhledu: Podle systému, Světlý a Tmavý. Můžete si vybrat motiv, který vám vyhovuje nejlépe.