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

> Vincule sua conta do Zotero, importe uma biblioteca para um arquivo .bib, cite a partir dele, atualize-o e desvincule a conta.

Importe uma biblioteca do Zotero para um projeto como um arquivo `.bib` e cite a partir dele como de costume. O arquivo é uma cópia: ele só muda quando você clica em **Refresh**.

> [!NOTE]
>
> Se você não vê nenhuma opção do Zotero em **Account settings**, peça ao seu administrador para ativar a [integração com Zotero](https://ayakaleaf-pro.mintlify.site/pt/on-premises/configuration/overleaf-toolkit/integrations/zotero-integration.md).

## Vincular sua conta do Zotero

Você faz isso uma única vez.

**1. Abrir as configurações da conta**

Clique em **Account** e depois em **Account settings**. Em **Reference managers**, encontre **Zotero** e clique em **Link to Zotero**.

![A seção Zotero das configurações da conta com um botão Link to Zotero](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-link.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=bd8103eadfb8c79e5d2f58a83a5ac33e)

Zotero nas configurações da conta

O cartão **Zotero** no painel **Integrations** do editor leva você ao mesmo lugar, na mesma aba.

![O painel Integrations com o cartão do Zotero](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-integrations.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=ee6c0da4ffd26db23956a92eebf60765)

O painel Integrations

**2. Autorizar no Zotero**

O Zotero é aberto. Faça login se for solicitado e depois autorize o aplicativo. Ele só pede para ler sua biblioteca e seus grupos, portanto não pode alterar nada no Zotero.

**3. Verificar o vínculo**

Você volta às configurações da conta. Uma mensagem verde diz **Reference manager linked**, e o botão agora diz **Unlink**.

![A seção Zotero das configurações da conta com uma mensagem verde e um botão Unlink](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-linked.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=185a0e5c172d3a5f6a9e50a325f32cf3)

Sua conta do Zotero está vinculada

Se você não permitir o acesso no Zotero, a mesma seção diz **Sorry, something went wrong**. Clique em **Link to Zotero** para tentar de novo.

## Criar um arquivo a partir da sua biblioteca

**1. Abrir a caixa de diálogo Add files**

Abra um projeto. Na árvore de arquivos, clique em **New file** e depois em **From Zotero**. Essa entrada só aparece depois que sua conta é vinculada.

**2. Escolher o nome do arquivo e a biblioteca**

**File Name** começa como `zotero.bib`. Mantenha a extensão `.bib`: sem ela, você não tem pré-visualização, e nem `\cite` nem `\bibliography` encontram as entradas.

**Library** começa como **My Library** e também lista suas bibliotecas de grupo. Um arquivo contém uma biblioteca.

![A aba From Zotero da caixa de diálogo Add files com zotero.bib e My Library](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-new-file.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=707728eb955b49101ab3977d1b19baa6)

Um arquivo da sua biblioteca pessoal

**3. Clicar em Create**

A caixa de diálogo fecha e o arquivo aparece na árvore de arquivos. Clique nele: ele mostra quando foi importado e suas entradas. Você não pode editá-lo no editor.

![O arquivo zotero.bib importado aberto no editor com um botão Refresh](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-file.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=b2d3560f942619fcc479ea875e7f7957)

O arquivo importado

Se **Create** parecer não fazer nada, já existe um arquivo com esse nome. Escolha outro nome.

### Importar uma biblioteca de grupo

Repita o processo com um nome de arquivo próprio e escolha o grupo em **Library**. Um projeto pode ter vários desses arquivos.

![A aba From Zotero com o nome de arquivo reading-group.bib e a biblioteca Reading group](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-group.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=a5cb43fdf5d97546eb1609160147aeee)

Um arquivo de uma biblioteca de grupo

## Citar a partir do arquivo

**1. Começar uma citação**

Em um arquivo `.tex`, digite `\cite{`. A lista mostra as entradas de todos os arquivos `.bib` do projeto. Clique em uma para inseri-la.

![O editor listando chaves de citação abaixo de uma citação](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-cite.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=394bda9a2a326e5d878fc16932ec0322)

As entradas dos arquivos importados

**2. Ou pesquisar por título ou autor**

Clique em **Search** abaixo da lista ou pressione Ctrl+Espaço entre as chaves. Digite para filtrar, clique em uma ou mais entradas e depois em **Insert**.

![A caixa de diálogo Search the .bib files in this project com uma entrada selecionada](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-search.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=027a2212a2b3cb83b7017014fe40ce22)

A pesquisa de referências

**3. Adicionar a bibliografia**

Adicione estas linhas antes de `\end{document}`, usando os nomes dos seus arquivos sem `.bib`, separados por vírgulas:

```latex theme={null}
\bibliographystyle{plain}
\bibliography{reading-group,zotero}
```

Clique em **Recompile**. A referência aparece no PDF.

![O editor com a citação e a bibliografia, e o PDF compilado com uma referência](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-compiled.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=9c593d72f5d12495dc4ec2863dd0546d)

A referência compilada

Os arquivos importados não são oferecidos em **Settings**, em **References**, **Main bibliography file for this project**, então a lista fica vazia se o projeto não tiver outro arquivo `.bib`. Você ainda pode citar a partir deles.

![A aba References das configurações do projeto com uma lista vazia e desativada](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-settings-references.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=48dad4818c2dac63afc46decea21790f)

A lista vazia é esperada

## Atualizar o arquivo

As alterações na sua biblioteca do Zotero não chegam ao projeto sozinhas, e a compilação não as busca.

**1. Abrir o arquivo**

Na árvore de arquivos, clique no arquivo importado.

**2. Clicar em Refresh**

O arquivo inteiro é importado novamente da biblioteca que você escolheu ao criá-lo: novas entradas aparecem e as removidas desaparecem. O horário no topo muda.

![O arquivo zotero.bib atualizado com uma nova entrada e um novo horário de importação](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-refresh.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=aa095ac91264ef0e4517a860fb94b5c9)

O arquivo atualizado

**3. Recompilar**

As novas entradas aparecem na lista de `\cite{` imediatamente. Clique em **Recompile** para atualizar o PDF.

Cada arquivo é atualizado separadamente: atualize o arquivo do seu grupo à parte. Para saber quem pode atualizar um arquivo em um projeto compartilhado, consulte as [notas para administradores](https://ayakaleaf-pro.mintlify.site/on-premises/configuration/overleaf-toolkit/integrations/zotero-integration.md#notes).

## Desvincular sua conta do Zotero

Em **Account settings**, em **Zotero**, clique em **Unlink** e depois em **Unlink** novamente na caixa de diálogo. O botão volta a dizer **Link to Zotero**.

![A caixa de diálogo Unlink Zotero Account](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-unlink.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=3783d8622dee66277c2420154294220e)

Desvincular sua conta

Os arquivos que você importou continuam nos seus projetos e ainda compilam. **From Zotero** some da caixa de diálogo **Add files**, e **Refresh** mostra um erro até você vincular sua conta novamente.

![Um arquivo importado com o erro Could not load references from Zotero, please re-link your account and try again](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-relink-error.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=d0c678b299fa6604d857398aad9bca18)

Atualizar sem uma conta vinculada

Depois de vincular novamente, **Refresh** funciona nos mesmos arquivos.

## Se algo der errado

**Could not load references from Zotero, please re-link your account and try again**, ou **There was an error accessing your Zotero data** na caixa de diálogo **Add files**: o Overleaf não consegue mais ler sua biblioteca, por exemplo porque você removeu o acesso dele no Zotero. Em **Account settings**, clique em **Unlink** e depois em **Link to Zotero**. Até lá, **Create** também falha, com a mensagem **The project that contains this file is not shared with you**, mesmo no seu próprio projeto.

![A aba From Zotero com as duas mensagens de erro](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-access-error.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=65bee2963ce16aec585fb55945e6554d)

O Overleaf não consegue mais ler sua biblioteca

**The remote service produced an error** ao clicar em **Refresh**: a solicitação ao Zotero falhou. O arquivo mantém seu conteúdo. Clique em **Refresh** novamente mais tarde.


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