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

# Integración con Zotero

> Permite a los usuarios importar un archivo .bib de su biblioteca de Zotero a un proyecto.

> [!NOTE]
>
> Esta funcionalidad fue desarrollada inicialmente por [davrot](https://github.com/davrot) y [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), y modificada por [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) con OAuth. Se introdujo a partir de la v6.2.0. Todavía está en fase beta. Si tienes algún problema, necesitamos tus comentarios.

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

### Configurar la integración con Zotero

1. Abre [este enlace](https://www.zotero.org/oauth/apps) para crear un cliente OAuth de Zotero (como se muestra en la imagen)
2. Elige **Application Type**: **Browser**
3. Configura la URL de callback con tu `${OVERLEAF_SITE_URL}/user/zotero/oauth/callback`
4. Configura tu `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=
```

### Notas

> [!WARNING]
>
> Al actualizar una instalación existente con archivos de bibliografía vinculados a Zotero a la versión 6.3.0 republicada, sigue las instrucciones de migración de [#ayakaleaf-pro-6.3.0](https://ayakaleaf-pro.mintlify.site/es/on-premises/release-notes/release-notes-6.x.x.md#ayakaleaf-pro-6.3.0 "mention"). Las instalaciones nuevas no necesitan esta migración.

> [!CAUTION]
>
> Como Ayakaleaf es una plataforma colaborativa, para mejorar la seguridad, a partir de la versión 6.3.0 solo el creador original de un archivo `bib` de referencias podrá actualizar el archivo importado.

Por ejemplo, supongamos que el propietario del proyecto, el usuario A, habilita el uso compartido mediante enlace y crea un archivo `test.bib` en el proyecto, vinculándolo a su propia cuenta de Zotero. Si otro usuario, el usuario B, accede al proyecto a través del enlace compartido, el usuario B podrá seguir leyendo y descargando `test.bib`, pero no podrá actualizar ni volver a importar el archivo desde Zotero. Solo el usuario A, como creador original del archivo de referencias, puede realizar actualizaciones. Dicho de otro modo, solo el creador original del archivo `.bib` tiene permiso para actualizarlo.

### Preguntas y respuestas

> [accordion] ¿Cómo uso Zotero en un proyecto?
>
> **Respuesta:** Después de vincular Zotero en **Account Settings**, abre un proyecto y haz clic en **New file → From Zotero**. Elige un nombre de archivo, `zotero.bib` por defecto, y la biblioteca, y después crea el archivo. Cita sus entradas como de costumbre, por ejemplo con `\bibliography{zotero}`.
>
> El archivo es de solo lectura en el editor. Después de cambiar tu biblioteca de Zotero, abre el archivo y haz clic en **Refresh** para volver a importarlo.

> [accordion] ¿Por qué «Main bibliography file for this project» está vacío o deshabilitado?
>
> **Respuesta:** Este ajuste solo muestra los archivos `.bib` que se pueden editar en el editor. Los archivos importados desde Zotero son de solo lectura, así que no aparecen. Es el comportamiento esperado: puedes seguir citando sus entradas.

> [accordion] ¿Mi instancia tiene que ser accesible desde internet?
>
> **Respuesta:** No. La vinculación de Zotero pasa por el navegador del usuario, así que solo el servidor necesita llegar a Zotero. Si para ello necesita un proxy, establece `ZOTERO_PROXY_URL`.


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