> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Zotero-integraatio

> Anna käyttäjien tuoda .bib-tiedosto Zotero-kirjastostaan projektiin.

> [!NOTE]
>
> Tämän ominaisuuden kehittivät alun perin [davrot](https://github.com/davrot) ja [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), ja [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) muokkasi sitä OAuth-tuella. Se on otettu käyttöön versiosta v6.2.0 alkaen. Ominaisuus on yhä beta-vaiheessa. Tarvitsemme palautettasi, jos kohtaat ongelmia.

![](https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/img-b751b9f6.png?fit=max\&auto=format\&n=x9kfDjtWlyyhG_mR\&q=85\&s=80eb902caf484c8cfc1c776017ac2c66)

![](https://mintcdn.com/ayakaleaf-pro/UZ_4Jfz7cU6MnXtE/images/on-premises/image-41.png?fit=max\&auto=format\&n=UZ_4Jfz7cU6MnXtE\&q=85\&s=366c8e9396506163e23ffdc92fbe8c02)

### Zotero-integraation määrittäminen

1. Avaa [tämä linkki](https://www.zotero.org/oauth/apps) ja luo Zotero OAuth -asiakas (kuten kuvassa)
2. Valitse **Application Type**: **Browser**
3. Aseta Callback URL -osoitteeksi `${OVERLEAF_SITE_URL}/user/zotero/oauth/callback`
4. Määritä tiedosto `config/variables.env`

![](https://mintcdn.com/ayakaleaf-pro/UZ_4Jfz7cU6MnXtE/images/on-premises/image-42.png?fit=max\&auto=format\&n=UZ_4Jfz7cU6MnXtE\&q=85\&s=7b2ed79ba28f7d77bc07711068ca71fc)

```dotenv title="config/variables.env" theme={null}
#################
#    Zotero     #
#################
# 'zotero' must be in ENABLED_LINKED_FILE_TYPES (set in develop/docker-compose.yml)
ENABLED_LINKED_FILE_TYPES=project_file,project_output_file,url,zotero

# From a Zotero OAuth client (register at https://www.zotero.org/oauth/apps)
# Application Type: Browser 
# Callback URL -> ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback
ZOTERO_CLIENT_ID=
ZOTERO_CLIENT_SECRET=
# Encrypts the Zotero API key in mongo (set in dev to avoid writing a key file
# to /var/lib/overleaf/data, which the dev web container can't create)
# How to generate: `openssl rand -hex 32`
ZOTERO_CIPHER_PASSWORD=dev-zotero-cipher-password
# Optional: route the module's server-side Zotero requests (OAuth + API) through
# an HTTP proxy (must be reachable from the web container; same as github-sync)
# http://10.0.0.1:10808
# (Optional) ZOTERO_PROXY_URL=
```

### Huomautuksia

> [!WARNING]
>
> Kun päivität olemassa olevaa asennusta, jossa on Zoteroon linkitettyjä lähdeluettelotiedostoja, uudelleenjulkaistuun versioon 6.3.0, noudata [#ayakaleaf-pro-6.3.0](https://ayakaleaf-pro.mintlify.site/fi/on-premises/release-notes/release-notes-6.x.x.md#ayakaleaf-pro-6.3.0 "mention"). Uudet asennukset eivät tarvitse tätä siirtoa.

> [!CAUTION]
>
> Koska Ayakaleaf on yhteistyöalusta, tietoturvan parantamiseksi versiosta 6.3.0 alkaen vain viite-`bib`-tiedoston alkuperäinen luoja saa päivittää tuotua tiedostoa.

Oletetaan esimerkiksi, että projektin omistaja, käyttäjä A, ottaa linkin jakamisen käyttöön ja luo projektiin `test.bib`-tiedoston, jonka hän linkittää omaan Zotero-tiliinsä. Jos toinen käyttäjä, käyttäjä B, avaa projektin jaetun linkin kautta, käyttäjä B voi edelleen lukea ja ladata `test.bib`-tiedoston, mutta hän ei saa päivittää tiedostoa tai tuoda sitä uudelleen Zoterosta. Vain käyttäjä A viitetiedoston alkuperäisenä luojana voi tehdä päivityksiä. Toisin sanoen vain `.bib`-tiedoston alkuperäisellä luojalla on oikeus päivittää sitä.

### Q\&A

> [accordion] Miten käytän Zoteroa projektissa?
>
> **Vastaus:** Kun olet linkittänyt Zoteron kohdassa **Account Settings**, avaa projekti ja napsauta **New file → From Zotero**. Valitse tiedostonimi, oletuksena `zotero.bib`, ja kirjasto, ja luo sitten tiedosto. Viittaa sen merkintöihin tavalliseen tapaan, esimerkiksi komennolla `\bibliography{zotero}`.
>
> Tiedosto on editorissa vain luku -tilassa. Kun olet muuttanut Zotero-kirjastoasi, avaa tiedosto ja napsauta **Refresh** tuodaksesi sen uudelleen.

> [accordion] Miksi ”Main bibliography file for this project” on tyhjä tai poissa käytöstä?
>
> **Vastaus:** Tämä asetus luettelee vain `.bib`-tiedostot, joita voi muokata editorissa. Zoterosta tuodut tiedostot ovat vain luku -tilassa, joten niitä ei luetella. Tämä on odotettua: voit silti viitata niiden merkintöihin.

> [accordion] Täytyykö instanssini olla tavoitettavissa internetistä?
>
> **Vastaus:** Ei. Zoteron linkittäminen kulkee käyttäjän selaimen kautta, joten vain palvelimen tarvitsee tavoittaa Zotero. Jos se tarvitsee siihen välityspalvelimen, aseta `ZOTERO_PROXY_URL`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.