> ## 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 連携

> ユーザーが Zotero ライブラリから .bib ファイルをプロジェクトにインポートできるようにします。

> [!NOTE]
>
> この機能は当初 [davrot](https://github.com/davrot) と [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep) によって開発され、[ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) によって OAuth 対応に改修されました。v6.2.0 以降で導入されています。現在もベータ版です。問題があればぜひフィードバックをお寄せください。

![](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 連携のセットアップ

1. [このリンク](https://www.zotero.org/oauth/apps)を開いて Zotero OAuth クライアントを作成します（画像を参照）
2. **Application Type** で **Browser** を選択します
3. Callback URL に `${OVERLEAF_SITE_URL}/user/zotero/oauth/callback` を設定します
4. `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=
```

### 注意事項

> [!WARNING]
>
> Zotero のリンクされた参考文献ファイルがある既存のインストールを再リリースされた 6.3.0 にアップグレードする場合は、[#ayakaleaf-pro-6.3.0](https://ayakaleaf-pro.mintlify.site/ja/on-premises/release-notes/release-notes-6.x.x.md#ayakaleaf-pro-6.3.0 "mention")に従ってください。新規インストールではこの移行は必要ありません。

> [!CAUTION]
>
> Ayakaleaf は共同作業プラットフォームであるため、セキュリティ向上のため、バージョン 6.3.0 以降では、参考文献の `bib` ファイルを最初に作成したユーザーのみがインポートしたファイルを更新できます。

たとえば、プロジェクトのオーナーであるユーザー A がリンク共有を有効にし、プロジェクト内に `test.bib` ファイルを作成して自分の Zotero アカウントにリンクしたとします。別のユーザー B が共有リンクからプロジェクトにアクセスした場合、ユーザー B は `test.bib` を読み取ったりダウンロードしたりすることはできますが、Zotero からファイルを更新したり再インポートしたりすることはできません。更新を行えるのは、参考文献ファイルの最初の作成者であるユーザー A だけです。つまり、`.bib` ファイルを更新する権限を持つのは、そのファイルの最初の作成者のみです。

### Q\&A

> [accordion] プロジェクトで Zotero を使用するにはどうすればよいですか？
>
> **回答：** **Account Settings** で Zotero を連携した後、プロジェクトを開いて **New file → From Zotero** をクリックします。ファイル名(デフォルトは `zotero.bib`)とライブラリを選択し、ファイルを作成します。たとえば `\bibliography{zotero}` のように、通常どおりそのエントリを引用できます。
>
> このファイルはエディターでは読み取り専用です。Zotero ライブラリを変更した後は、ファイルを開いて **Refresh** をクリックし、再度インポートしてください。

> [accordion] 「Main bibliography file for this project」が空または無効になっているのはなぜですか？
>
> **回答：** この設定には、エディターで編集可能な `.bib` ファイルのみが表示されます。Zotero からインポートしたファイルは読み取り専用のため、表示されません。これは想定された動作であり、そのエントリは引き続き引用できます。

> [accordion] インスタンスはインターネットからアクセス可能である必要がありますか？
>
> **回答：** いいえ。Zotero の連携はユーザーのブラウザを経由して行われるため、Zotero にアクセスできる必要があるのはサーバーのみです。そのためにプロキシが必要な場合は、`ZOTERO_PROXY_URL` を設定してください。


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