Zotero 연동

사용자가 Zotero 라이브러리의 .bib 파일을 프로젝트로 가져올 수 있도록 합니다.

이 기능은 처음에 davrot와 yu-i-i/overleaf-cep가 개발했으며, ayaka-notes/ayakaleaf-pro가 OAuth를 적용해 수정했습니다. v6.2.0 이상에서 도입되었으며 아직 베타 상태입니다. 문제가 있으면 피드백을 보내 주세요.

​

Zotero 연동 설정

1. 이 링크를 열어 Zotero OAuth 클라이언트를 생성합니다(이미지 참조).
2. Application Type으로 Browser를 선택합니다.
3. Callback URL을 ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback으로 설정합니다.
4. config/variables.env를 구성합니다.

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=

​

참고 사항

Zotero 연결 참고문헌 파일이 있는 기존 설치를 재배포된 6.3.0으로 업그레이드하는 경우, #ayakaleaf-pro-6.3.0를 따르세요. 새로 설치하는 경우에는 이 마이그레이션이 필요하지 않습니다.

Ayakaleaf는 협업 플랫폼이므로 보안 강화를 위해 버전 6.3.0부터는 참고문헌 bib 파일을 처음 생성한 사용자만 가져온 파일을 업데이트할 수 있습니다.

예를 들어 프로젝트 소유자인 사용자 A가 링크 공유를 활성화하고 프로젝트에 test.bib 파일을 만들어 자신의 Zotero 계정에 연결했다고 가정해 보겠습니다. 다른 사용자인 사용자 B가 공유 링크로 프로젝트에 접근하면 test.bib를 읽고 다운로드할 수는 있지만, Zotero에서 파일을 업데이트하거나 다시 가져올 수는 없습니다. 참고문헌 파일을 처음 생성한 사용자 A만 업데이트할 수 있습니다. 즉, .bib 파일을 처음 생성한 사용자만 해당 파일을 업데이트할 권한을 가집니다.

​

Q&A

프로젝트에서 Zotero를 어떻게 사용하나요?

답변: Account Settings에서 Zotero를 연결한 후 프로젝트를 열고 New file → From Zotero를 클릭하세요. 파일 이름(기본값 zotero.bib)과 라이브러리를 선택한 다음 파일을 생성합니다. 평소처럼 해당 항목을 인용하면 됩니다. 예: \bibliography{zotero}.

이 파일은 편집기에서 읽기 전용입니다. Zotero 라이브러리를 변경한 후에는 파일을 열고 Refresh를 클릭하여 다시 가져오세요.

“Main bibliography file for this project”가 비어 있거나 비활성화되어 있는 이유는 무엇인가요?

답변: 이 설정에는 편집기에서 편집할 수 있는 .bib 파일만 나열됩니다. Zotero에서 가져온 파일은 읽기 전용이므로 나열되지 않습니다. 이는 정상적인 동작이며, 해당 항목은 여전히 인용할 수 있습니다.

인스턴스가 인터넷에서 접근 가능해야 하나요?

답변: 아니요. Zotero 연결은 사용자의 브라우저를 통해 이루어지므로 서버만 Zotero에 접근할 수 있으면 됩니다. 이를 위해 프록시가 필요한 경우 ZOTERO_PROXY_URL을 설정하세요.