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

> Ermöglichen Sie Benutzern, eine .bib-Datei aus ihrer Zotero-Bibliothek in ein Projekt zu importieren.

> [!NOTE]
>
> Diese Funktion wurde ursprünglich von [davrot](https://github.com/davrot) und [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep) entwickelt und von [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) um OAuth erweitert. Sie ist ab v6.2.0 verfügbar und befindet sich noch im Beta-Stadium. Wenn Sie auf Probleme stoßen, freuen wir uns über Ihr Feedback.

![](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-Integration einrichten

1. Öffnen Sie [diesen Link](https://www.zotero.org/oauth/apps), um einen Zotero-OAuth-Client zu erstellen (wie in der Abbildung gezeigt)
2. Wählen Sie als **Application Type**: **Browser**
3. Legen Sie die Callback-URL auf `${OVERLEAF_SITE_URL}/user/zotero/oauth/callback` fest
4. Konfigurieren Sie Ihre `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=
```

### Hinweise

> [!WARNING]
>
> Wenn Sie eine bestehende Installation mit Zotero-verknüpften Bibliografiedateien auf das neu veröffentlichte 6.3.0 aktualisieren, befolgen Sie die [Migrationsanleitung für Zotero / Mendeley](https://ayakaleaf-pro.mintlify.site/de/on-premises/release-notes/release-notes-6.x.x.md#ayakaleaf-pro-6.3.0 "mention"). Neue Installationen benötigen diese Migration nicht.

> [!CAUTION]
>
> Da Ayakaleaf eine kollaborative Plattform ist, darf zur Verbesserung der Sicherheit ab Version 6.3.0 nur die ursprüngliche Erstellerin bzw. der ursprüngliche Ersteller einer Referenz-`bib`-Datei die importierte Datei aktualisieren.

Angenommen, die Projekteigentümerin, Benutzerin A, aktiviert die Linkfreigabe und erstellt im Projekt eine Datei `test.bib`, die sie mit ihrem eigenen Zotero-Konto verknüpft. Wenn ein anderer Benutzer, Benutzer B, über den freigegebenen Link auf das Projekt zugreift, kann Benutzer B `test.bib` weiterhin lesen und herunterladen, darf die Datei jedoch nicht aktualisieren oder erneut aus Zotero importieren. Nur Benutzerin A als ursprüngliche Erstellerin der Referenzdatei kann Aktualisierungen durchführen. Umgekehrt hat nur die ursprüngliche Erstellerin bzw. der ursprüngliche Ersteller der `.bib`-Datei die Berechtigung, sie zu aktualisieren.

### Fragen & Antworten

> [accordion] Wie verwende ich Zotero in einem Projekt?
>
> **Antwort:** Nachdem Sie Zotero unter **Account Settings** verknüpft haben, öffnen Sie ein Projekt und klicken Sie auf **New file → From Zotero**. Wählen Sie einen Dateinamen, standardmäßig `zotero.bib`, und die Bibliothek aus und erstellen Sie dann die Datei. Zitieren Sie ihre Einträge wie gewohnt, zum Beispiel mit `\bibliography{zotero}`.
>
> Die Datei ist im Editor schreibgeschützt. Öffnen Sie die Datei nach Änderungen an Ihrer Zotero-Bibliothek und klicken Sie auf **Refresh**, um sie erneut zu importieren.

> [accordion] Warum ist „Main bibliography file for this project“ leer oder deaktiviert?
>
> **Antwort:** Diese Einstellung listet nur `.bib`-Dateien auf, die im Editor bearbeitet werden können. Aus Zotero importierte Dateien sind schreibgeschützt und werden daher nicht aufgeführt. Das ist so vorgesehen: Sie können ihre Einträge trotzdem zitieren.

> [accordion] Muss meine Instanz aus dem Internet erreichbar sein?
>
> **Antwort:** Nein. Das Verknüpfen von Zotero erfolgt über den Browser des Benutzers, daher muss nur der Server Zotero erreichen können. Falls er dafür einen Proxy benötigt, setzen Sie `ZOTERO_PROXY_URL`.


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