> ## 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 Entegrasyonu

> Kullanıcıların Zotero kitaplıklarından bir projeye .bib dosyası aktarmasını sağlayın.

> [!NOTE]
>
> Bu özellik başlangıçta [davrot](https://github.com/davrot) ve [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep) tarafından geliştirilmiş, [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) tarafından OAuth ile değiştirilmiştir. v6.2.0 ve sonrasında sunulmuştur. Hâlâ beta aşamasındadır. Herhangi bir sorun yaşarsanız geri bildiriminize ihtiyacımız var.

![](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 Entegrasyonunu Kurma

1. Bir Zotero OAuth istemcisi oluşturmak için [bu bağlantıyı](https://www.zotero.org/oauth/apps) açın (görselde gösterildiği gibi)
2. **Application Type** olarak **Browser** seçin
3. Callback URL'yi `${OVERLEAF_SITE_URL}/user/zotero/oauth/callback` olarak ayarlayın
4. `config/variables.env` dosyanızı yapılandırın

![](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=
```

### Notlar

> [!WARNING]
>
> Zotero'ya bağlı kaynakça dosyaları içeren mevcut bir kurulumu yeniden yayımlanan 6.3.0 sürümüne yükseltirken [#ayakaleaf-pro-6.3.0](https://ayakaleaf-pro.mintlify.site/tr/on-premises/release-notes/release-notes-6.x.x.md#ayakaleaf-pro-6.3.0 "mention") bölümündeki geçiş talimatlarını izleyin. Yeni kurulumların bu geçişe ihtiyacı yoktur.

> [!CAUTION]
>
> Ayakaleaf işbirliğine dayalı bir platform olduğundan, güvenliği artırmak için 6.3.0 sürümünden itibaren içe aktarılan dosyayı yalnızca Reference `bib` dosyasının asıl oluşturucusu güncelleyebilecektir.

Örneğin, proje sahibi Kullanıcı A'nın bağlantı paylaşımını etkinleştirdiğini ve projede kendi Zotero hesabına bağlı bir `test.bib` dosyası oluşturduğunu varsayalım. Başka bir kullanıcı, Kullanıcı B, projeye paylaşılan bağlantı üzerinden erişirse `test.bib` dosyasını okuyabilir ve indirebilir, ancak dosyayı güncellemesine veya Zotero'dan yeniden içe aktarmasına izin verilmez. Güncellemeleri yalnızca Reference dosyasının asıl oluşturucusu olan Kullanıcı A yapabilir. Başka bir deyişle, `.bib` dosyasını güncelleme izni yalnızca dosyanın asıl oluşturucusuna aittir.

### Soru\&Cevap

> [accordion] Zotero'yu bir projede nasıl kullanırım?
>
> **Yanıt:** Zotero'yu **Account Settings** bölümünde bağladıktan sonra bir proje açın ve **New file → From Zotero** öğesine tıklayın. Bir dosya adı (varsayılan olarak `zotero.bib`) ve kitaplığı seçin, ardından dosyayı oluşturun. Girdilerine her zamanki gibi atıfta bulunun, örneğin `\bibliography{zotero}` ile.
>
> Dosya düzenleyicide salt okunurdur. Zotero kitaplığınızı değiştirdikten sonra dosyayı açın ve yeniden içe aktarmak için **Refresh** düğmesine tıklayın.

> [accordion] "Main bibliography file for this project" neden boş veya devre dışı?
>
> **Yanıt:** Bu ayar yalnızca düzenleyicide düzenlenebilen `.bib` dosyalarını listeler. Zotero'dan içe aktarılan dosyalar salt okunur olduğundan listelenmez. Bu beklenen bir davranıştır: girdilerine yine de atıfta bulunabilirsiniz.

> [accordion] Örneğimin internetten erişilebilir olması gerekiyor mu?
>
> **Yanıt:** Hayır. Zotero'nun bağlanması kullanıcının tarayıcısı üzerinden gerçekleşir; bu nedenle Zotero'ya yalnızca sunucunun ulaşabilmesi gerekir. Bunun için bir proxy gerekiyorsa `ZOTERO_PROXY_URL` değerini ayarlayın.


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