Prism-ongelmien vianmääritys ja ohjeiden saaminen

Prism on edistyneisiin malleihin perustuva, yhteistyöhön tarkoitettu ja tekoälyä hyödyntävä LaTeX-työtila, joka auttaa tutkijoita ajattelemaan, kirjoittamaan ja kehittämään työtään nopeammin. Sen sisäänrakennettu älykkyys lisää tieteellisen työn nopeutta ja syvyyttä.

Tässä oppaassa kerrotaan, miten yleisiä ongelmia voi ratkaista ja mistä saa lisäohjeita.

Prismiin pääseminen

Prism on saatavilla osoitteessa prism.openai.com kaikille käyttäjille, joilla on Free-, Go-, Plus- tai Pro-tason ChatGPT-tili ja jotka eivät ole eivätkä ole olleet Business- tai Enterprise-työtilan jäseniä. Laajennamme käyttöoikeuden Business-, Enterprise- ja Edu-käyttäjille lähitulevaisuudessa.

1. Prismin sisäänrakennetun älykkyyden käyttäminen

Prism sisältää editoriin integroidun avustajan, joka perustuu OpenAI:n edistyneisiin malleihin. Se ymmärtää asiakirjasi asiayhteyden ja voi luoda LaTeXia, diagnosoida virheitä ja ehdottaa korjauksia suoraan editorissa. Voit käyttää sitä työtilan alareunassa olevasta paneelista.

1. Luo LaTeX-katkelmia: Pyydä Prismiä luomaan yleisiä LaTeX-elementtejä esimerkiksi kehotteilla ”Luo 4 × 4 -taulukko” tai ”Lisää kuvatekstillinen kuva”. Prism palauttaa käyttövalmiin LaTeX-koodin sekä Säilytä- ja Kumoa-vaihtoehdot, jotta voit lisätä sen suoraan projektiisi.

2. Diagnosoi käännösongelmia: Jos asiakirjan kääntäminen epäonnistuu, kuvaile ongelma paneelissa, esimerkiksi ”Asiakirjani ei käänny”. Prism esittää tarkentavia kysymyksiä ja auttaa selvittämään todennäköisiä syitä, kuten puuttuvia komentoja tai ratkaisemattomia viittauksia.

3. Korjaa virheet suoraan tekstissä: Virheet ja varoitukset näkyvät punaisina tai keltaisina merkintöinä editorin reunuksessa. Voit pyytää Prismiä korjaamaan tietyn virheen. Se analysoi olennaiset rivit, selittää ongelman ja ehdottaa kohdennettuja muokkauksia. Voit ottaa ehdotuksen käyttöön suoraan ja varmistaa korjauksen kääntämällä asiakirjan uudelleen.

4. Oikolue: Pyydä Prismiä oikolukemaan osio, korostamaan virheet ja päättelyaukot sekä ehdottamaan, miten osion selkeyttä voisi parantaa. Voit hyödyntää taitoja, kuten artikkelin arviointia, saadaksesi toimituksellista ja faktapohjaista palautetta.

5. Kirjallisuushaku: Lisää artikkeliini lähdeluettelo ja ehdota myös aiheeseen liittyviä tutkimuksia, jotka ovat saattaneet jäädä minulta huomaamatta.

2. Käännösvirheiden diagnosointi

Jos LaTeX-asiakirjasi ei käänny, kokeile seuraavia vaiheita:

1. Tarkista virhemerkintä: Punaiset ja keltaiset merkinnät osoittavat kohdat, joissa Prism havaitsi ongelman. Näytä tiedot napsauttamalla merkintää ja diagnosoi sitten virhe sisäänrakennetun avustajan avulla.

2. Tarkista käännösloki: Jos käännös epäonnistuu, PDF-esikatseluruudussa näkyy käännösloki. Keskity ensimmäiseen virheilmoitukseen (esimerkiksi puuttuvaan \end{document}-komentoon), sillä myöhemmät virheet ovat usein sen kerrannaisvaikutuksia. Jaa tämä ilmoitus Prismille, jotta saat täsmällisempiä ohjeita.

3. Kumoa viimeisimmät muutokset: Jos virhe ilmestyi äskettäisen muokkauksen jälkeen, kumoa muutos tai kommentoi se tilapäisesti pois ja tarkista, onnistuuko käännös.

4. Supista vähimmäisesimerkiksi: Jos ongelma jatkuu, yksinkertaista asiakirja niin, että siinä on vain olennainen sisältö. Asiaan liittymättömien osioiden poistaminen auttaa rajaamaan virheen lähteen.

3. Parhaat käytännöt ongelmien välttämiseen

1. Pysy kirjautuneena: Työskentele aina sisäänkirjautuneena, jotta muutoksesi tallentuvat ja ovat käytettävissä myös seuraavilla käyttökerroilla.

2. Käytä tuettuja paketteja: Prism tukee monia yleisesti käytettyjä LaTeX-paketteja. Harvinaiset, vanhentuneet tai ylläpitämättömät paketit voivat aiheuttaa odottamattomia käännösvirheitä.

3. Muokkaa vaiheittain: Tee pieniä muutoksia ja käännä asiakirja usein. Näin virheen aiheuttanut muutos on helpompi tunnistaa ja siitä voi palautua nopeasti.

LaTeX-projektien siirtäminen Prismiin

Tässä oppaassa kerrotaan, miten olemassa olevia LaTeX-projekteja siirretään Overleafista tai paikalliselta tietokoneelta Prismiin. Kun tuot projektit, kaikki pysyy yhdessä paikassa ja voit jatkaa työskentelyä rakentamatta tiedostoja uudelleen käsin.

Projektien tuominen Overleafista

Siirrä projekti Overleafista Prismiin lataamalla ensin projektitiedostot Overleafista ja lähettämällä ne sitten Prismiin.

Yhden projektin lataaminen

1. Avaa Overleafin projektien hallintanäkymä.

2. Etsi projekti, jonka haluat siirtää.

3. Napsauta latauskuvaketta samalla rivillä kuin projektin nimi.

4. Overleaf lataa koko projektin tietokoneellesi .zip-tiedostona.

Useiden projektien lataaminen

1. Avaa Overleafin projektiluettelo.

2. Valitse projektit kunkin rivin alussa olevalla valintaruudulla.

1. Valitse kaikki napsauttamalla luettelon ensimmäistä valintaruutua.

2. Kun olet tehnyt valinnat, napsauta projektiluettelon oikeassa yläkulmassa olevaa latauskuvaketta.

Valitut projektit ladataan .zip-tiedostoina.

Projektien tuominen Prismiin

Prism voi tuoda projekteja kolmella tavalla: lataamalla kansion tai .zip-arkiston tai vetämällä ja pudottamalla tiedostoja Kaikki projektit -näkymään.


Projektin tuominen Tuo-valikosta:

1. Avaa Prism ja siirry kohtaan Tuo.

2. Valitse tuontitapa napsauttamalla kohdan Tuo vieressä olevaa nuolta.

Valitse jokin seuraavista:

1. Avaa Prism ja siirry Tuo-vaihtoehtoon.

2. Valitse tuontitapa napsauttamalla Tuo-kohdan vieressä olevaa nuolta.

3. Valitse jokin seuraavista:

Tuo .zip-tiedosto: Valitse ladattu projektiarkisto tietokoneeltasi. Prism purkaa ja lataa projektin automaattisesti.


Tuo kansio: Valitse projektikansio tietokoneeltasi. Prism tuo .tex-tiedostot, lähdeluettelotiedostot, kuvat ja muut projektin resurssit.


Tuonti vetämällä ja pudottamalla: Vedä projektikansio tai .zip-tiedosto Kaikki projektit -näkymästä Prismiin ja pudota se sinne. Prism luo automaattisesti uuden projektin ja tuo tiedostot puolestasi.

Kun lataus on valmis, Prism avaa koko projektin, jotta voit aloittaa muokkaamisen ja kääntämisen.

Muut usein kysytyt kysymykset

Tili, turvallisuus ja laskutus

K: Mistä löydän tietosuojakäytäntönne? V: Prismiä koskeva tietosuojakäytäntö löytyy täältä.

K: Käytättekö tietojani mallien kouluttamiseen? V: Käyttäjät voivat hallita täysin sitä, käytetäänkö heidän tietojaan malliemme kehittämiseen tietosuojakäytäntömme mukaisesti.

K: Käytättekö ”tietojen määräaikainen säilyttäminen” -vaihtoehtoa (ZDR)? Mitä lokitietoja tallennetaan ja kuinka kauan niitä säilytetään? V: Prism ei tällä hetkellä käytä API:n ”tietojen määräaikainen säilyttäminen” -vaihtoehtoa (ZDR), vaan säilyttää pyyntöjen jälkeen lokitietoja jonkin aikaa tuotteen kehittämiseksi.


K: Tarjoatteko tietosuojatilan, jossa tekstiä ei tallenneta eikä ihminen tarkista sitä, ja/tai tietojen sijaintipaikan rajaamista EU:hun? V: Näitä ominaisuuksia on pyydetty, ja ne ovat kehityssuunnitelmassa tai työjonossa, mutta niille ei ole vielä vahvistettua aikataulua.

Jakaminen ja yhteistyö

K: Miksi en voi jakaa ”kuka tahansa voi muokata” -linkkiä? (Avattavassa valikossa on vain ”kuka tahansa voi tarkastella”.) V: Tämä on tällä hetkellä tarkoituksellista. Linkkipohjaista ”kuka tahansa voi muokata” -jakamista ei vielä tueta, vaan muokkaajat on lisättävä yhteistyökumppaneiksi, joilla on Prism-tili.


K: Yhteistyökumppanit eivät saa kutsuviestejä. Miten he pääsevät projektiin? V: Pyydä heitä tarkistamaan roskapostikansionsa ja kirjautumaan sisään kutsun saaneella sähköpostiosoitteella. Jaetun projektin pitäisi tulla näkyviin ensimmäisen kirjautumisen jälkeen.

Projektien tuonti ja vienti

K: ZIP-tiedoston lataus tai tuonti on juuttunut ”projektiasi tuodaan” -vaiheeseen. Mitä teen? V: Yritä latausta uudelleen. Jos se on uuden yrityksen jälkeenkin jumissa, jaa ZIP-tiedosto tuelle, jotta tuontiprosessi voidaan selvittää.


K: Miten vien tai lataan projektini ZIP-tiedostona? V: Napsauta projektin nimeä ja lataa sitten projektin pakattu kopio valitsemalla Vie. Taustajärjestelmäyhteyden muodostuminen voi kestää muutaman sekunnin, ennen kuin vienti onnistuu.

Luotettavuus, käyttökatkot ja yhteydet

K: Projektini katosivat päivittämisen jälkeen. Ovatko ne hävinneet? V: Päivitä sivu uudelleen ja tarkista projektiluettelo. Tietojesi pitäisi tulla jälleen näkyviin.


K: Projektini katosivat sivun päivittämisen jälkeen. Ovatko ne hävinneet? V: Näin voi käydä palveluntarjoajan käyttökatkon aikana. Yritä uudelleen, niin projektiesi pitäisi tulla jälleen näkyviin. Jos näin ei käy, tuki voi auttaa palauttamaan ne.


K: Sivusto vaikuttaa olevan poissa käytöstä tai sovellus ilmoittaa, ettei se saa yhteyttä taustajärjestelmään. Mitä teen? V: Yritä uudelleen tai lataa sivu uudelleen. Jos ongelma jatkuu, lähetä tuelle tiedot näkemästäsi ja mahdollisuuksien mukaan linkki projektiin, jotta asia voidaan tutkia.

Tietojen eheys, palautus, varmuuskopiot ja versiohistoria

K: Asiakirjani jumiutui, minkä jälkeen sisältöä katosi ja kommenttien ankkurit siirtyivät. Voinko palauttaa sen? V: Lataa ensin .zip-varmuuskopio. Prism sisältää myös versiohistorian, jonka avulla voit ehkä palauttaa aiemman version. Kommenttien ankkurien sijainteja ei välttämättä voida palauttaa, eikä kommentteja tällä hetkellä viedä varmuuskopioihin. Jos muotoilu muuttui, yritä korjata se koodin muotoilutyökalulla.


K: Avasin projektin uudelleen, ja tiedostot tai sisältö olivat palautuneet aiempaan tilaan tai kadonneet. Mitä tapahtui? V: Projektien tallennus oli jonkin aikaa ulkoisen palveluntarjoajan varassa, eikä tämä pysynyt mukana käytön äkillisesti kasvaessa. Tallennus siirrettiin sisäiseen järjestelmään yhteysvirheiden vähentämiseksi ja ongelman toistumisen estämiseksi. Lisäksi käyttöön otettiin uusia suojatoimia.


K: Voidaanko kommenttien sijainnit palauttaa, ja sisältyvätkö kommentit projektien varmuuskopioihin? V: Kommenttien sijainteja ei välttämättä voida palauttaa jälkikäteen. Tulevia häiriötilanteita varten varmuuskopioita luodaan nyt säännöllisesti, esimerkiksi noin 10 minuutin välein, mutta kommentteja ei tällä hetkellä viedä ZIP-varmuuskopioihin.

Integraatiot

Zotero

K: Miksi en voi tuoda Zoteron ryhmäkirjastoja Prismiin? V: Zoteron ryhmäkirjastoja ei vielä tueta. Henkilökohtaiset kirjastot toimivat, mutta ryhmäkirjastoja ei tällä hetkellä tueta.


K: Zotero-integraationi on jumissa esimerkiksi tilin tai API-avainten vaihtamisen jälkeen. Miten sen voi korjata? V: Tuki tarvitsee Zoteron numeerisen tunnuksesi (ei käyttäjänimeäsi), jotta integraatio voidaan poistaa edellisen tai anonyymin käyttäjän tililtä. Sen jälkeen voit yhdistää sen uudelleen tiliisi. Esimerkki tämän tekemisestä: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

K: Voinko kloonata Prism-projektin Gitin (GitHubin/GitLabin) kautta tai synkronoida sen oppilaitokseni Git-alustan kanssa? V: Git-integraatiota ei vielä ole, mutta sen kehittäminen on tulevien hankkeiden tärkeimpiä tavoitteita.

LaTeX-käännös ja vianmääritys

K: Miten pakotan täysin uuden käännöksen ja tyhjennän Aux-, toc- ja bbl-tiedostot? V: Lataa sivu uudelleen. Sivun päivittäminen pakottaa uuden, puhtaan käännöksen.


K: Kuviot tai kuvat eivät lataudu Prismissä, vaikka sama LaTeX toimii muualla. V: Käytä polkuja, jotka ovat suhteessa tuonnin tekevään .tex-tiedostoon. Jos .tex-tiedosto on alikansiossa ja kuva projektin juurihakemistossa, lisää polun alkuun ../.


K: Käännös on erittäin hidas tai ei valmistu koskaan. Miten selvitän syyn? V: Kommentoi osioita pois (ja sitten niiden pienempiä osia), kunnes käännös onnistuu. Rajaa ongelma tämän jälkeen tarkalleen sen aiheuttavaan riviin. Tarkista myös lokien varoitukset ja virheet ensimmäisestä alkaen.


K: Luodussa .bbl-tiedostossa näkyy ”Underfull/Overfull \hbox” -varoituksia. Onko kyse käännösvirheestä? V: Ei. Ne ovat ladontavaroituksia eivätkä vakavia käännösvirheitä. Jos PDF näyttää hyväksyttävältä, varoituksen voi yleensä ohittaa.


K: Miksi lstlisting/listings-ympäristöt aiheuttavat Beamerissa virheen kehyksen sisällä (esim. ”Extra }, or forgotten \endgroup”)? V: Merkitse Beamer-kehys määritteellä [fragile], kun käytät listing-ympäristöjä. Tämä ratkaisee virheet usein.


K: \cite-viittaukseni näkyvät muodossa ”[?]”, vaikka .bib-tiedostoni ja lähdeluettelokomennot ovat olemassa. Millainen määritys toimii? Yksi toimivaksi todettu ratkaisu on varmistaa, että lähdeluettelo sisällytetään oikein pääasiakirjasta. Lisää BibTeX-työnkulkuihin \bibliographystyle{plain} ja \bibliography{refs}, kun tiedostosi nimi on refs.bib.

Tuotteen käyttöliittymä ja ominaisuuspyynnöt

K: Onko Prismissä vaalea tila? V: Kyllä. Prism tukee kolmea ulkoasuasetusta: Järjestelmä, Vaalea ja Tumma. Voit valita itsellesi parhaiten sopivan teeman.