# Citações e bibliografia

Encontre uma fonte, inspecione os metadados dela, adicione-a à bibliografia certa, cite-a no cursor, escolha um estilo de citação do Typst e limpe uma biblioteca sem perder o original.

Uma citação é uma cadeia: a afirmação aponta para uma chave, a chave aponta para uma entrada da bibliografia e a entrada aponta para uma fonte real. O Oleafly mantém essa cadeia visível para que uma consulta rápida não vire uma referência misteriosa mais tarde.

![O painel Referências do Oleafly. Alterne entre Referências, Citações e Símbolos; filtre a visualização atual pelo campo de busca.](https://cdn.oleafly.com/images/screenshots/desktop/docs/references-panel-dark-window-v2.png#view=0,45,344,703)

## Cite enquanto escreve

![Citar a partir do projeto abre o seletor da bibliografia. Busque por chave, autor ou título; Localizar e adicionar uma nova citação abre a busca online.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-citation-picker-dark-window-v2.png#view=415,77,365,467)

Na barra de ferramentas de LaTeX ou Typst, escolha **Citar a partir do projeto** (o ícone `@`). Busque na bibliografia atual por chave, autor ou título e selecione uma entrada.

Você também pode executar **Adicionar citação** na paleta de comandos, com ⌘K ou Ctrl+K. O Oleafly insere a sintaxe do projeto ativo:

- `\cite{key}` em LaTeX;
- `@key` em Typst, adicionando uma linha `#bibliography(...)` no fim do documento principal quando ele não tem nenhuma;
- `[@key]` em Markdown, adicionando uma linha `bibliography:` ao front matter quando necessário.

Com o Zotero conectado, **Adicionar citação** lista primeiro as correspondências da sua biblioteca do Zotero.

## Cite a partir da sua biblioteca do Zotero

Depois que o [Zotero estiver conectado](/docs/integrations/research-sources/#zotero), digite `@` e parte do nome de um autor, uma palavra do título, um ano ou uma chave. Toda a sua biblioteca do Zotero aparece ao lado das referências do próprio projeto. Escolha um artigo e o Oleafly insere a citação do jeito que o documento já cita. O LaTeX recebe o comando que o documento mais usa, como `\citep` ou `\parencite`, o Typst recebe `@key`, e o Markdown recebe `[@key]`. Digitar `@` dentro de um `\cite{...}` existente adiciona outra chave a ele.

Só aquela entrada vai para o `.bib` do projeto, no fim do arquivo, e o resto do arquivo continua como estava. Um artigo que já está no `.bib`, pela chave ou pelo DOI, nunca é adicionado duas vezes. As entradas nunca incluem os caminhos dos PDFs no seu computador. Se o projeto ainda não tem uma linha de bibliografia, o Oleafly adiciona uma: `\bibliography` ou `\addbibresource` em LaTeX, `#bibliography` em Typst ou `bibliography:` no front matter do Markdown. Com mais de um arquivo `.bib`, o Oleafly pergunta uma vez qual arquivo recebe as novas referências e lembra da sua resposta.

Na primeira vez que você citar do Zotero em um artigo LaTeX que lista as referências à mão, em um ambiente `thebibliography`, o Oleafly se oferece para mover essa lista para o `.bib`. Todas as referências passam então a compartilhar uma única lista numerada.

### Mantenha o .bib em sincronia com o Zotero

Uma chave citada que falta no `.bib`, mas existe no Zotero, oferece **Adicionar do Zotero**. Execute **Adicionar citações ausentes do Zotero** na paleta ⌘K para conferir todas as chaves citadas de uma vez. Ele adiciona as que o Zotero tem, lista as que não tem e aponta as chaves que citam um artigo que já está na sua bibliografia.

Quando um artigo muda no Zotero, a entrada dele no `.bib` oferece **Atualizar do Zotero**. **Atualizar entradas do .bib a partir do Zotero**, na paleta, revisa todas as entradas alteradas. Uma entrada que você editou à mão só é substituída depois que você confirma. **Sincronizar biblioteca do Zotero** lê a biblioteca de novo. O Oleafly nunca remove nada do `.bib` por conta própria.

![Parte do título de um artigo colada, e a entrada BibTeX dele salva no refs.bib.](https://cdn.oleafly.com/images/gifs/desktop/add-citation.gif?v=2)

## Localize e adicione uma nova referência

Escolha **Localizar e adicionar uma nova citação** no seletor. Comece com qualquer um destes:

- um DOI como `10.1145/3592979`;
- um ID do arXiv como `1706.03762`;
- um ISBN-10 ou ISBN-13;
- um ID do PubMed (PMID);
- uma URL que contenha um desses identificadores;
- o título de um artigo.

As buscas por DOI, arXiv, ISBN e PubMed usam os catálogos públicos deles. Uma busca por título retorna possíveis correspondências com autores, ano e veículo, para você escolher em vez de aceitar um palpite.

Revise o BibTeX retornado e escolha **Adicionar ao .bib e citar**. O Oleafly:

1. adiciona uma chave sem colisão à bibliografia ativa;
2. reaproveita uma entrada existente quando o DOI já existe;
3. insere a citação no cursor atual;
4. atualiza na hora a árvore de arquivos e o painel Referências.

Os metadados são editáveis. Corrija o registro antes que ele passe a fazer parte do manuscrito.

Quando o documento declara mais de uma bibliografia, a caixa de diálogo mostra um menu **Bibliografia**. A entrada vai para o arquivo que você escolher, e o Oleafly lembra da escolha para aquele projeto.

## Como o Oleafly escolhe a bibliografia

Os projetos LaTeX seguem as declarações do documento principal efetivo:

- `\addbibresource{references.bib}` para o `biblatex`;
- `\bibliography{references}` para fluxos com BibTeX.

Os caminhos são resolvidos com o mesmo comportamento de extensão e de caminho relativo que a cadeia de ferramentas do TeX espera. Uma declaração que aponta para um arquivo inexistente é informada na linha de origem em vez de escrever silenciosamente em outro lugar.

Os projetos Typst seguem a chamada `#bibliography(...)`, quer ela nomeie um arquivo ou uma lista, quer os arquivos sejam BibTeX `.bib` ou Hayagriva `.yml` e `.yaml`. Uma nova citação vai para o arquivo que o documento declara. Se esse arquivo for Hayagriva, o Oleafly converte a entrada BibTeX antes de gravá-la. Quando a chamada nomeia mais de um arquivo, escolha o destino no menu **Bibliografia** da caixa de diálogo.

Os projetos Markdown seguem o campo `bibliography:` do front matter.

Quando nenhuma bibliografia é declarada, o Oleafly usa o primeiro `.bib` do projeto. Se não existir nenhum, ele cria `references.bib` e o deixa disponível na árvore de arquivos e no seletor de citações.

Para um projeto com várias bibliotecas, inspecione o destino selecionado antes de adicionar um registro.

## Escolha um estilo de citação do Typst

Quando um documento Typst tem uma chamada `#bibliography(...)`, a parte de baixo da visualização **Citações** do painel Referências mostra um menu **Estilo de citação**. Ele lista os estilos embutidos do Typst para a versão do Typst do projeto, além de quaisquer arquivos `.csl` do projeto. Escolher um estilo o grava no argumento `style:` dessa chamada. Sem um, o Typst usa `ieee`.

Em LaTeX, defina o estilo no código-fonte. `\bibliographystyle{` completa os estilos usuais do BibTeX; com o `biblatex`, use a opção `style=` dele.

## Importe uma biblioteca de referências inteira

No painel Referências, escolha **Importar biblioteca de referências**. Você pode importar um arquivo ou a sua biblioteca do Zotero.

**A partir de um arquivo**, escolha uma biblioteca exportada:

| Formato de origem | Arquivo |
| --- | --- |
| BibTeX | `.bib` |
| RIS | `.ris` |
| EndNote XML | `.xml` |
| Zotero RDF | `.rdf` |

**A partir do Zotero**, conecte a sua conta do zotero.org uma vez em **Configurações → Integrações → Zotero** e depois escolha **Importar biblioteca do Zotero** no cartão do Zotero. O Oleafly traz até 5.000 itens. [Conecte fontes de pesquisa](/docs/integrations/research-sources/#zotero) mostra a configuração passo a passo.

O Oleafly converte os registros em BibTeX e ignora qualquer referência cujo DOI já esteja na biblioteca de destino ou antes no mesmo lote. Ele cria chaves sem colisão e acrescenta o resultado em uma única gravação. A mensagem informa quantas referências foram adicionadas e quantas já estavam lá. Uma importação de biblioteca não insere uma citação no cursor.

Depois da importação, busque as novas entradas no seletor de citações e confira uma amostra com o catálogo original.

## Limpe uma biblioteca de referências

O painel Referências pode mostrar uma prévia de uma limpeza antes de alterar arquivos.

1. Abra o projeto e escolha **Limpar a biblioteca de referências** no painel Referências.
2. Selecione o arquivo `.bib` quando o projeto tiver mais de um.
3. Leia a lista de ações e o diff de antes e depois.
4. Inspecione cada renomeação de chave proposta, cada duplicata de DOI removida e cada aviso.
5. Aplique só depois que a prévia corresponder à sua intenção.

O limpador renomeia as chaves para um padrão consistente de autor-ano-título e atualiza as citações em todos os arquivos de código-fonte do projeto. Ele remove uma duplicata de DOI só quando a entrada mantida preserva todos os campos da removida. Registros de DOI conflitantes e títulos parecidos são sinalizados para revisão, e não mesclados por palpite.

Os comentários e as definições de string do BibTeX são preservados. Ao aplicar, ele confere se a biblioteca ainda corresponde à prévia e grava um backup antes de alterar os arquivos. Diffs grandes mostram as primeiras 500 linhas na prévia; os arquivos completos continuam sendo usados quando as alterações são aplicadas.

:::caution[Revise antes de aplicar]
Duas edições, traduções, versões de preprint e de periódico, ou artigos com títulos parecidos podem ser separados de propósito. Leia o aviso e compare as fontes reais antes de mesclar qualquer coisa manualmente.
:::

## Complete e navegue pelas referências

Dentro de comandos de citação do LaTeX como `\cite{}`, `\citep{}`, `\citet{}`, `\parencite{}` e `\textcite{}`, o autocompletar busca em todos os arquivos `.bib` do projeto. No Typst, `@` completa as chaves dos arquivos `.bib` e Hayagriva. Com o Zotero conectado, a lista inclui também a sua biblioteca do Zotero.

Uma citação a uma entrada que foi adicionada ao `.bib` enquanto esse arquivo não estava aberto, por exemplo pelo assistente ou a partir do Zotero, é resolvida na hora. Você não precisa digitar antes no documento.

- F12 ou o clique com uma tecla modificadora salta de uma chave de citação para a entrada dela.
- ⇧F12 lista todos os usos de uma fonte.
- F2 renomeia uma chave nos arquivos de código-fonte e de bibliografia.
- Ao passar o mouse, o destino é mostrado; as chaves não resolvidas ou ambíguas são marcadas antes da compilação.

[Inteligência de código](/docs/code-intelligence/) explica o modelo de navegação completo.

## Cite o Oleafly

Se o Oleafly ajudou em um artigo, execute **Citar o Oleafly neste artigo** na paleta de comandos ou na parte de baixo da visualização **Citações** do painel Referências. O Oleafly adiciona uma entrada com a chave `oleafly` à bibliografia que o documento declara, em BibTeX ou, para um arquivo Hayagriva, em Hayagriva. Uma mensagem informa o arquivo e a sintaxe a usar, como `\cite{oleafly}` ou `@oleafly`, com **Desfazer** ao lado. Se a entrada já estiver lá, você recebe um lembrete da chave em vez disso.

Um projeto sem arquivo de bibliografia fica inalterado, e uma caixa de diálogo mostra a entrada para você copiar. A mesma entrada está sempre em [Configurações → Ajuda e sobre](/docs/settings/help/#cite-oleafly-in-a-paper).

## Compilações de bibliografia e Biber

Para o `biblatex`, o Oleafly executa de novo a etapa correspondente do Biber quando o compilador não produziu um `.bbl` utilizável. As mensagens do Biber, incluindo um caminho de `.bib` ausente, aparecem no log de compilação e nos diagnósticos do editor.

Quando o próprio Biber falha, o log de compilação diz por quê. Ele nomeia a biblioteca do sistema que está faltando e sugere `\usepackage[backend=bibtex]{biblatex}` como um jeito de compilar sem o Biber. No Fedora, o `.rpm` do Oleafly recomenda as duas bibliotecas de que o Biber precisa.

Se as referências continuarem indefinidas:

1. Confira a declaração da bibliografia e o caminho.
2. Abra **Logs** e encontre a primeira mensagem do Biber ou da bibliografia.
3. Confirme que a chave de citação existe exatamente uma vez.
4. Compile de novo depois que o arquivo `.bib` for salvo.

Veja [Compilação e logs](/docs/compiling/) e [Motores LaTeX e pacotes](/docs/latex-engines/) para a recuperação específica de cada motor.

## Ferramentas de referências independentes

Você pode preparar referências sem abrir um projeto:

- O [Gerador de citações](/docs/tools/citation-generator/) aceita identificadores, títulos, campos estruturados ou BibTeX.
- O [Gerador de bibliografia](/docs/tools/bibliography-generator/) monta e valida uma lista.
- Os [Geradores de citação por estilo](/docs/tools/citation-styles/) comparam oito estilos.
- Ferramentas específicas cuidam de [DOIs](/docs/tools/doi-to-bibtex/), [ISBNs](/docs/tools/isbn-to-bibtex/), [IDs do PubMed](/docs/tools/pubmed-to-bibtex/), do [arXiv](/docs/tools/arxiv-citation-generator/) e de [endereços da web](/docs/tools/url-to-bibtex/).

A edição manual e a formatação de citações ficam locais. A busca por identificador e por título precisa de conexão. O [modo offline](/docs/settings/general/#offline-mode) bloqueia essas buscas, enquanto o autocompletar e a navegação da bibliografia existente continuam funcionando.

## Encontre evidências e depois verifique-as

[Encontrar citações](/docs/tools/find-citations/) pesquisa em índices acadêmicos ou examina o rascunho aberto em busca de trechos que podem precisar de apoio. Leia o artigo antes de citá-lo e mantenha cada afirmação dentro do que os métodos e os resultados estabelecem.
