Integrasi Zotero

Memungkinkan pengguna mengimpor file .bib dari pustaka Zotero mereka ke dalam proyek.

Fitur ini awalnya dikembangkan oleh davrot dan yu-i-i/overleaf-cep, lalu dimodifikasi oleh ayaka-notes/ayakaleaf-pro dengan OAuth. Fitur ini diperkenalkan mulai v6.2.0 dan seterusnya. Fitur ini masih berstatus beta. Kami membutuhkan masukan Anda jika Anda mengalami masalah.

​

Menyiapkan Integrasi Zotero

1. Buka tautan ini untuk membuat klien OAuth Zotero (seperti yang ditunjukkan pada gambar)
2. Pilih Application Type: Browser
3. Atur Callback URL dengan ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback Anda
4. Konfigurasikan config/variables.env Anda

config/variables.env

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

​

Catatan

Saat melakukan upgrade instalasi yang sudah ada dengan file bibliografi tertaut Zotero ke 6.3.0 yang dirilis ulang, ikuti #ayakaleaf-pro-6.3.0. Instalasi baru tidak memerlukan migrasi ini.

Karena Ayakaleaf adalah platform kolaboratif, untuk meningkatkan keamanan, mulai versi 6.3.0, hanya pembuat asli file Referensi bib yang diizinkan untuk memperbarui file yang diimpor.

Sebagai contoh, misalkan pemilik proyek, Pengguna A, mengaktifkan berbagi tautan dan membuat file test.bib di dalam proyek, lalu menautkannya ke akun Zotero miliknya sendiri. Jika pengguna lain, Pengguna B, mengakses proyek melalui tautan yang dibagikan, Pengguna B tetap dapat membaca dan mengunduh test.bib, tetapi tidak diizinkan untuk memperbarui atau mengimpor ulang file tersebut dari Zotero. Hanya Pengguna A, sebagai pembuat asli file Referensi, yang dapat melakukan pembaruan. Dengan kata lain, hanya pembuat asli file .bib yang memiliki izin untuk memperbaruinya.

​

Tanya Jawab

Bagaimana cara menggunakan Zotero di dalam proyek?

Jawaban: Setelah menautkan Zotero di Account Settings, buka sebuah proyek dan klik New file → From Zotero. Pilih nama file, zotero.bib secara default, dan pustakanya, lalu buat file tersebut. Kutip entrinya seperti biasa, misalnya dengan \bibliography{zotero}.

File tersebut bersifat hanya-baca di editor. Setelah mengubah pustaka Zotero Anda, buka file tersebut dan klik Refresh untuk mengimpornya kembali.

Mengapa "Main bibliography file for this project" kosong atau dinonaktifkan?

Jawaban: Pengaturan ini hanya mencantumkan file .bib yang dapat diedit di editor. File yang diimpor dari Zotero bersifat hanya-baca, sehingga tidak dicantumkan. Hal ini memang diharapkan: Anda tetap dapat mengutip entrinya.

Apakah instans saya perlu dapat dijangkau dari internet?

Jawaban: Tidak. Penautan Zotero dilakukan melalui browser pengguna, sehingga hanya server yang perlu menjangkau Zotero. Jika memerlukan proxy untuk itu, atur ZOTERO_PROXY_URL.