Yleiskatsaus

Prism on yhteistyöhön tarkoitettu LaTeX-työtila, jonka ytimessä on edistyneisiin malleihin perustuva tekoäly. Se auttaa tutkijoita ajattelemaan, kirjoittamaan ja kehittämään työtään nopeammin. Sen sisäänrakennettu tekoäly nopeuttaa tieteellistä työtä ja auttaa syventämään sitä.

Tässä oppaassa kerrotaan, miten voit ratkaista yleisiä ongelmia ja mistä saat lisäapua.

Prismin käyttöoikeus

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

Hyödynnä Prismin sisäänrakennettua tekoälyä

Prismin editorissa on sisäänrakennettu avustaja, joka hyödyntää OpenAI:n edistyneitä malleja. Se ymmärtää asiakirjasi kontekstin ja auttaa luomaan LaTeX-koodia, selvittämään virheiden syitä ja ehdottamaan korjauksia ilman, että sinun tarvitsee poistua editorista. Voit käyttää sitä työtilan alareunassa olevasta paneelista.

1. Luo LaTeX-koodikatkelmia: Pyydä Prismiä luomaan tavallisia LaTeX-elementtejä esimerkiksi näin: ”Luo 4 × 4 -taulukko” tai ”Lisää kuva kuvateksteineen”. Prism tuottaa käyttövalmista LaTeX-koodia ja tarjoaa vaihtoehdot Säilytä ja Kumoa, joten voit lisätä koodin suoraan projektiisi.

2. Selvitä käännösongelmien syyt: Jos asiakirjan kääntäminen ei onnistu, kuvaile ongelmaa paneelissa (esimerkiksi ”Asiakirjani kääntäminen ei onnistu”). Prism esittää tarkentavia kysymyksiä ja auttaa selvittämään todennäköiset syyt, kuten puuttuvat komennot tai viittaukset, joiden kohdetta ei löydy.

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

4. Oikolue: Pyydä Prismiä oikolukemaan osio, merkitsemään virheet ja päättelyn puutteet sekä ehdottamaan tapoja selkeyttää tekstiä. Voit hyödyntää taitoja, kuten artikkelin arviointia, saadaksesi palautetta tekstin kieliasusta ja asiatiedoista.

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

Selvitä käännösvirheiden syyt

Jos LaTeX-asiakirjasi kääntäminen ei onnistu, kokeile seuraavia ohjeita:

1. Tarkista virhemerkintä: Punaiset ja keltaiset merkinnät osoittavat kohdat, joissa Prism on havainnut ongelman. Näytä lisätiedot napsauttamalla merkintää ja selvitä sitten virheen syy sisäänrakennetun avustajan avulla.

2. Tarkista käännösloki: Jos kääntäminen epäonnistuu, PDF-esikatseluruudussa näkyy käännösloki. Keskity ensimmäiseen virheilmoitukseen (esimerkiksi puuttuvaan \end{document}-komentoon), sillä myöhemmät virheet johtuvat usein siitä. Jaa tämä virheilmoitus Prismille, niin saat tarkempia ohjeita.

3. Kumoa viimeisimmät muutokset: Jos virhe ilmeni muokkauksen jälkeen, kumoa muutos tai muuta se tilapäisesti kommentiksi ja kokeile, onnistuuko kääntäminen.

4. Karsi mahdollisimman pieneksi esimerkiksi: Jos ongelmat jatkuvat, jätä asiakirjaan vain olennainen sisältö. Asiaan liittymättömien osioiden poistaminen auttaa paikantamaan virheen lähteen.

Vältä yleiset ongelmat

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

2. Käytä tuettuja paketteja: Prism tukee monia yleisesti käytettyjä LaTeX-paketteja. Harvinaiset, vanhentuneet tai ilman ylläpitoa jääneet paketit voivat aiheuttaa odottamattomia käännösvirheitä.

3. Muokkaa vaiheittain: Tee pieniä muutoksia ja käännä asiakirja usein. Näin voit helpommin tunnistaa virheen aiheuttaneen muutoksen ja korjata tilanteen nopeasti.

Siirrä LaTeX-projekteja Prismiin

Tässä oppaassa kerrotaan, miten siirrät olemassa olevia LaTeX-projekteja Overleafista tai omalta tietokoneeltasi Prismiin. Tuomalla projektisi pidät kaiken yhdessä paikassa ja voit jatkaa työskentelyä luomatta tiedostoja käsin uudelleen.

Tuo projekteja Overleafista

Jos haluat siirtää projektin Overleafista Prismiin, lataa ensin projektin tiedostot Overleafista tietokoneellesi ja tuo ne sitten Prismiin.

Lataa yksittäinen projekti

1. Avaa Overleafin projektien hallintanäkymä.

2. Etsi projekti, jonka haluat siirtää.

3. Napsauta latauskuvaketta projektin nimen kanssa samalla rivillä.

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.

Tuo projekteja Prismiin

Voit tuoda projekteja Prismiin kolmella tavalla: lataamalla kansion, lataamalla .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 Tuo-kohdan vieressä olevaa nuolta.

Valitse jokin seuraavista:

1. Avaa Prism ja siirry kohtaan Tuo.

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

3. Valitse jokin seuraavista:

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


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


Tuominen vetämällä ja pudottamalla: Avaa Prismin Kaikki projektit -näkymä ja vedä ja pudota siihen projektikansio tai .zip-tiedosto. Prism luo uuden projektin ja tuo tiedostot automaattisesti.

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

Usein kysytyt kysymykset

Tili, tietoturva ja laskutus

K: Mistä löydän tietosuojakäytäntönne? V: Löydät Prismin tietosuojakäytännön täältä.

K: Käytättekö tietojani mallien kouluttamiseen? V: Käyttäjät voivat itse päättää, käytetäänkö heidän tietojaan malliemme parantamiseen tietosuojakäytäntömme mukaisesti.

K: Käytättekö ”tietojen määräaikaista säilyttämistä” (ZDR)? Mitä lokitietoja kerätään ja miten niitä säilytetään? V: Prism ei tällä hetkellä käytä API:n ”tietojen määräaikainen säilyttäminen” (ZDR) -asetusta. Se säilyttää lokitietoja jonkin aikaa pyyntöjen jälkeen tuotteen parantamiseksi.


K: Onko tarjolla yksityisyystilaa, jossa tekstiä ei tallenneta eikä ihminen tarkista sitä, tai mahdollisuutta rajata tietojen sijaintipaikka vain EU:n alueelle? V: Näitä ominaisuuksia on toivottu, ja ne ovat kehityssuunnitelmissa tai odottavat toteutusta. Aikataulua ei kuitenkaan ole vielä vahvistettu.

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äkirjastoille ei tällä hetkellä ole tukea.


K: Zotero-integraationi on jumissa (esimerkiksi tilin tai API-avainten vaihtamisen jälkeen). Miten sen voi korjata? V: Tuki tarvitsee numeerisen Zotero-tunnuksesi (ei käyttäjänimeäsi), jotta se voi poistaa integraation linkityksen aiempaan tai anonyymiin käyttäjään. Sen jälkeen voit linkittää integraation uudelleen tiliisi. Katso ohjevideo: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

K: Voinko kloonata Prism-projektin Gitin (GitHub/GitLab) kautta tai pitää sen synkronoituna tutkimuslaitokseni Git-alustan kanssa? V: Git-integraatio ei ole vielä saatavilla, mutta se on tärkeä tuleva kehityshanke.

LaTeX-kääntäminen ja vianmääritys

K: Miten pakotan puhtaan uudelleenkäännöksen (poistan aux-/toc-/bbl-väliaikaistiedostot)? 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 kuvan tuovaan .tex-tiedostoon. Jos .tex-tiedosto on alikansiossa ja kuva projektin juuressa, lisää polun alkuun ../.


K: Kääntäminen on erittäin hidasta tai ei valmistu lainkaan. Miten selvitän syyn? V: Muuta osioita kommenteiksi (ja sitten niiden sisältä pienempiä osia), kunnes kääntäminen onnistuu. Rajaa sitten ongelma sen aiheuttavaan riviin. Tarkista myös lokien varoitukset ja virheet ensimmäisestä alkaen.


K: Saan luodussa .bbl-tiedostossa ”Underfull/Overfull \hbox” -varoituksia. Onko kyse käännösvirheestä? V: Ei. Ne ovat ladontavaroituksia, eivät kääntämisen estäviä virheitä. Jos PDF-tulos näyttää hyvältä, varoituksen voi yleensä jättää huomiotta.


K: Miksi lstlisting-/listings-ympäristöt aiheuttavat Beamerissa virheen frame-ympäristön sisällä (esim. ”Extra }, or forgotten \endgroup”)? V: Lisää Beamerin frame-ympäristöön [fragile]-asetus, kun käytät listings-ympäristöjä. Se ratkaisee usein nämä virheet.


K: \cite-viittaukseni näkyvät muodossa ”[?]”, vaikka .bib-tiedosto on olemassa ja lähdeluettelokomennot on lisätty. Millä asetuksilla saan viittaukset toimimaan? Yksi toimivaksi todettu ratkaisu on varmistaa, että lähdeluettelo sisällytetään oikein pääasiakirjaan. Jos käytät BibTeX-pohjaista työnkulkua, lisää \bibliographystyle{plain} ja \bibliography{refs} (jossa refs.bib on tiedostosi).

Tuotteen käyttöliittymä ja ominaisuustoiveet

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