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

# Integração com Zotero

> Permita que os usuários importem um arquivo .bib da biblioteca do Zotero para um projeto.

> [!NOTE]
>
> Este recurso foi desenvolvido inicialmente por [davrot](https://github.com/davrot) e [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep) e modificado por [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) com OAuth. Foi introduzido a partir da v6.2.0. Ainda está em fase beta. Precisamos do seu feedback caso tenha algum problema.

![](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 a integração com Zotero

1. Abra [este link](https://www.zotero.org/oauth/apps) para criar um cliente OAuth do Zotero (como mostra a imagem)
2. Escolha **Application Type**: **Browser**
3. Configure a Callback URL com o seu `${OVERLEAF_SITE_URL}/user/zotero/oauth/callback`
4. Configure o seu `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=
```

### Observações

> [!WARNING]
>
> Ao atualizar uma instalação existente com arquivos de bibliografia vinculados ao Zotero para a versão 6.3.0 relançada, siga as [#ayakaleaf-pro-6.3.0](https://ayakaleaf-pro.mintlify.site/pt/on-premises/release-notes/release-notes-6.x.x.md#ayakaleaf-pro-6.3.0 "mention"). Novas instalações não precisam dessa migração.

> [!CAUTION]
>
> Como o Ayakaleaf é uma plataforma colaborativa, para melhorar a segurança, a partir da versão 6.3.0, apenas o criador original de um arquivo `bib` de referências poderá atualizar o arquivo importado.

Por exemplo, suponha que o proprietário do projeto, o Usuário A, ative o compartilhamento por link e crie um arquivo `test.bib` no projeto, vinculando-o à sua própria conta do Zotero. Se outro usuário, o Usuário B, acessar o projeto pelo link compartilhado, o Usuário B ainda poderá ler e baixar `test.bib`, mas não poderá atualizar nem reimportar o arquivo do Zotero. Somente o Usuário A, como criador original do arquivo de referências, pode realizar atualizações. Em outras palavras, apenas o criador original do arquivo `.bib` tem permissão para atualizá-lo.

### Q\&A

> [accordion] Como usar o Zotero em um projeto?
>
> **Resposta:** Depois de vincular o Zotero em **Account Settings**, abra um projeto e clique em **New file → From Zotero**. Escolha um nome de arquivo, `zotero.bib` por padrão, e a biblioteca; em seguida, crie o arquivo. Cite as entradas normalmente, por exemplo com `\bibliography{zotero}`.
>
> O arquivo é somente leitura no editor. Depois de alterar sua biblioteca do Zotero, abra o arquivo e clique em **Refresh** para importá-lo novamente.

> [accordion] Por que “Main bibliography file for this project” está vazio ou desativado?
>
> **Resposta:** Essa configuração lista apenas arquivos `.bib` que podem ser editados no editor. Os arquivos importados do Zotero são somente leitura, por isso não são listados. Isso é esperado: você ainda pode citar as entradas deles.

> [accordion] Minha instância precisa estar acessível pela internet?
>
> **Resposta:** Não. A vinculação do Zotero passa pelo navegador do usuário, então apenas o servidor precisa alcançar o Zotero. Se precisar de um proxy para isso, defina `ZOTERO_PROXY_URL`.


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