Pular para o conteúdo
Oleaflyv0.4.12

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.

A cadeia de citaçãoUm comando de citação no seu texto, como barra invertida cite vaswani2017, indica uma chave. A chave aponta para uma entrada em references.bib, e a entrada aponta para a fonte real pelo DOI ou pelo ID do arXiv. As entradas novas chegam ao .bib a partir da sua biblioteca do Zotero, de Localizar e adicionar com um DOI, um ID do arXiv ou um ISBN, ou de Importar biblioteca de referências.No seu texto\cite{vaswani2017}Em references.bib@article{vaswani2017A fonte realSeu DOI ou ID do arXivZoteroCitar com @Localizar e adicionarDOI, ID do arXiv, ISBNImportarUma biblioteca inteiraChaveDOIA cadeia de citaçãoUm comando de citação no seu texto, como barra invertida cite vaswani2017, indica uma chave. A chave aponta para uma entrada em references.bib, e a entrada aponta para a fonte real pelo DOI ou pelo ID do arXiv. As entradas novas chegam ao .bib a partir da sua biblioteca do Zotero, de Localizar e adicionar com um DOI, um ID do arXiv ou um ISBN, ou de Importar biblioteca de referências.No seu texto\cite{vaswani2017}Em references.bib@article{vaswani2017A fonte realSeu DOI ou ID do arXivEntradas novasZotero, Localizar e adicionar,Importar biblioteca de referênciasChaveDOI
A chave no seu texto aponta para uma entrada no .bib, e a entrada aponta para a fonte real. As entradas novas vêm do Zotero, de Localizar e adicionar ou de Importar.
O painel Referências do Oleafly. Alterne entre Referências, Citações e Símbolos; filtre a visualização atual pelo campo de busca.
O painel Referências do Oleafly. Alterne entre Referências, Citações e Símbolos; filtre a visualização atual pelo campo de busca. Abrir captura de tela completa
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.
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. Abrir captura de tela completa

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.

Depois que o Zotero estiver conectado, 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.

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.
Parte do título de um artigo colada, e a entrada BibTeX dele salva no refs.bib. Abrir captura de tela completa

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.

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.

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.

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

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.

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 explica o modelo de navegação completo.

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.

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 e Motores LaTeX e pacotes para a recuperação específica de cada motor.

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

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 bloqueia essas buscas, enquanto o autocompletar e a navegação da bibliografia existente continuam funcionando.

Encontrar citações 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.

Visualização da imagem

Não foi possível carregar as respostas da IA

Tente de novo ou pesquise na documentação.