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

# Pesquisa avançada de referências

> Encontre uma referência pelo autor, título, periódico ou ano e insira-a em uma citação.

A pesquisa de referências percorre todos os arquivos `.bib` do seu projeto, para que você encontre uma referência sem lembrar da chave de citação. Não é preciso configurar nada.

Seu projeto precisa de pelo menos um arquivo `.bib`. Você pode enviar um ou importar sua biblioteca do [Zotero](https://ayakaleaf-pro.mintlify.site/pt/on-premises/user-guide/users/zotero-integration.md) ou do [Mendeley](https://ayakaleaf-pro.mintlify.site/pt/on-premises/user-guide/users/mendeley-integration.md).

## Inserir uma citação

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

Em um arquivo `.tex`, digite `\cite{`. O editor adiciona a chave de fechamento. Abaixo do cursor você vê as chaves de citação e uma caixa azul, **Open advanced reference search**.

![O editor com \cite\{}, a lista de chaves de citação e a caixa azul com um botão Search](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/reference-search-hint.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=1438156d0ee9a9c866987e23c0aa8a15)

A caixa azul abaixo de uma citação

O botão **Insert citation** da barra de ferramentas e **Insert** seguido de **Citation** também iniciam um `\cite{}` para você. A caixa aparece também para outros comandos de citação, como `\citep`, `\autocite`, `\parencite` e `\textcite`.

**2. Abrir a pesquisa**

Clique em **Search** na caixa azul ou pressione Ctrl+Espaço entre as chaves. A caixa de diálogo lista todas as entradas, com título, chave de citação, autor, periódico e ano.

![A caixa de diálogo Search the .bib files in this project listando cinco entradas](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/reference-search-dialog.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=e6ee13f3a5f3b1f95c2dbeb9d2cc1e29)

Todas as entradas do projeto

**3. Encontrar a entrada**

Digite na caixa de pesquisa. Ela procura na chave de citação, no autor, no título, no periódico e no ano, e destaca o que encontrou. Todas as palavras precisam corresponder, então `turing 1936` encontra o artigo de Turing de 1936. Outros campos, como a editora, não são pesquisados.

![A caixa de pesquisa com turing 1936 e uma entrada com as correspondências em vermelho](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/reference-search-filter.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=7690a4c194fdf292980d229b60ef6f1e)

Pesquisa por autor e ano

**4. Escolher uma ou mais entradas**

Clique em uma entrada. Ela fica verde e sua chave aparece acima da lista. Para adicionar outra, clique nela ou pesquise novamente: o que você escolheu é mantido. Para remover uma, clique nela novamente ou no **×** ao lado da sua chave.

![As chaves knuth1984 e einstein1905 acima da lista e suas entradas em verde](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/reference-search-selected.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=a660175f9908e03c671ed61062f4ef8f)

Duas entradas escolhidas

**5. Clicar em Insert**

As chaves de citação aparecem entre as chaves, separadas por vírgulas. Se o seu documento ainda não tem bibliografia, adicione estas linhas antes de `\end{document}`, usando os nomes dos seus arquivos `.bib` sem a extensão:

```latex theme={null}
\bibliographystyle{plain}
\bibliography{refs,more}
```

Clique em **Recompile**. As referências aparecem no PDF.

![O editor com \cite\{knuth1984, einstein1905} e o PDF com as duas referências](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/reference-search-compiled.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=b0928f1bbd09e6cb56ecc1b2ed239ccd)

A citação compilada

A pesquisa funciona da mesma forma no editor **Visual**.

## Alterar uma citação

**Adicionar uma referência:** coloque o cursor entre as chaves de uma citação existente e abra a pesquisa. **Insert** adiciona as novas chaves depois das que já estão lá.

**Substituir referências:** selecione as chaves no editor e pressione Ctrl+Espaço. As chaves aparecem acima da lista e o botão agora diz **Replace**. Remova as que você não quer, adicione outras e clique em **Replace**. Uma chave que não está em nenhum arquivo `.bib` permanece até você removê-la.

![A caixa de diálogo com knuth1984, missing2000 e turing1936 acima da lista e o botão Replace](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/reference-search-replace.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=74a8cac10eb8fff69c5961039e678004)

Substituir as chaves selecionadas

## Usar o teclado

| Tecla | O que faz |
| - | - |
| **Seta para baixo** | Passa da caixa de pesquisa para a lista e depois desce na lista |
| **Seta para cima** | Sobe na lista |
| **Espaço** | Escolhe a entrada ou a remove do que você escolheu |
| **Enter** | Insere o que você escolheu, quando você está na lista |
| **Tab** | Alterna entre a caixa de pesquisa, a lista e os botões |
| **Esc** | Fecha a caixa de diálogo sem alterar nada |

## De onde vêm as entradas

A pesquisa abrange todos os arquivos `.bib` do projeto, incluindo os importados do Zotero ou do Mendeley. Quando você edita um arquivo `.bib`, a próxima pesquisa encontra as novas entradas.

## Se algo der errado

| O que você vê | Por quê | O que fazer |
| - | - | - |
| A lista na caixa de diálogo está vazia | O projeto não tem arquivo `.bib` | Envie um ou crie um |
| Não há caixa azul, e Ctrl+Espaço lista comandos LaTeX | O cursor não está entre as chaves de uma citação | Clique entre as chaves |
| Ctrl+Espaço não faz nada | Seu computador usa esse atalho para outra coisa | Clique em **Search** na caixa azul |
| Uma entrada não é encontrada | A pesquisa abrange apenas chave, autor, título, periódico e ano | Pesquise por um desses campos |


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