Verificador e limpador de BibTeX

Como usar o limpador de BibTeX

1. 1. Cole ou carregue o seu arquivo .bib. O leitor considera o arquivo inteiro como o próprio BibTeX o lê: macros @string, concatenação com #, @preamble, @comment, chaves aninhadas e notas entre as entradas.
2. 2. Escolha a limpeza. Todas as opções vêm ativadas por padrão, exceto a proteção de maiúsculas e a ordenação; desative o que quiser deixar como está. O resultado é atualizado conforme você muda as opções.
3. 3. Leia os problemas. Erros e avisos são listados com a linha e a chave da citação, de um periódico ausente a uma chave usada duas vezes.
4. 4. Confira as alterações e baixe. Cada alteração é registrada por entrada e campo, com o valor antes e depois; o resultado é baixado como cleaned.bib.

O que o verificador checa

O BibTeX clássico define quatorze tipos de entrada e os campos que cada um exige. O verificador aplica essa tabela, do BibTeXing de Oren Patashnik — a documentação que acompanha o BibTeX — e aceita os nomes do biblatex para os mesmos dados, então journaltitle, date e o institution de uma tese contam como seus equivalentes clássicos.

Ele também sinaliza uma chave usada duas vezes (o BibTeX mantém apenas a primeira entrada), chaves que diferem só em maiúsculas, chaves com espaço ou com outro caractere que o BibTeX não lê, o mesmo DOI em duas entradas, o mesmo título e ano em duas entradas, um campo dado duas vezes, uma macro usada mas nunca definida com @string e um ano que não tem quatro dígitos. Uma entrada que o leitor não consegue concluir — uma vírgula faltando, uma chave sem fechar — é apontada com o número da linha e mantida exatamente como estava, de modo que a limpeza nunca apaga texto.

O que a limpeza altera

• Tipos de entrada e nomes de campos em minúsculas: @ARTICLE vira @article, Author vira author.
• Espaços em branco: quebras de linha e sequências de espaços dentro de um valor são reduzidas a um único espaço.
• Delimitadores: valores entre aspas passam para chaves, que sobrevivem a uma aspa perdida em um título.
• Intervalos de páginas com o traço duplo que o LaTeX imprime como travessão: 16569-16572 vira 16569--16572.
• Meses como macros do BibTeX, jan a dec, escritos sem chaves para que todo estilo possa imprimi-los ou abreviá-los.
• Campos vazios, como note = {}, são removidos.
• DOIs perdem o prefixo https://doi.org/; os estilos que imprimem o DOI acrescentam o seu próprio.
• Maiúsculas em títulos (opcional): chaves em torno de siglas e palavras com letras maiúsculas e minúsculas — {DNA}, {mRNA}, {iPhone} — ou em torno de toda palavra capitalizada após a primeira, para que estilos que usam caixa de frase não as convertam em minúsculas.
• Ordem dos campos: autor, título, periódico ou título do livro, volume, número, páginas, ano, mês, editora e depois os identificadores; ou em ordem alfabética; ou como estava.
• Ordenação (opcional): por chave, primeiro autor ou ano. As definições @string ficam no topo, porque uma macro precisa ser definida antes de uma entrada usá-la.

@ARTICLE{hirsch2005,
  Author = {Hirsch, J. E.},
  title = "An index to quantify an individual's scientific research output",
  journal = {Proceedings of the National Academy of Sciences},
  year = 2005, month = {November},
  pages = {16569-16572},
  note = {}
}

@article{hirsch2005,
  author  = {Hirsch, J. E.},
  title   = {An index to quantify an individual's scientific research output},
  journal = {Proceedings of the National Academy of Sciences},
  pages   = {16569--16572},
  year    = 2005,
  month   = nov
}

O registro de alterações dessa entrada tem sete linhas: o tipo em minúsculas, Author renomeado para author, o título movido para chaves, November transformado na macro nov, o intervalo de páginas com o traço duplo, o note vazio removido e os campos colocados em ordem. O ano continua um número simples, que o BibTeX aceita.

BibTeX ou biblatex?

O mesmo arquivo .bib pode alimentar dois sistemas. O BibTeX clássico, com estilos como plain ou o arquivo .bst de um periódico, conhece os quatorze tipos padrão e ignora em silêncio os campos que não reconhece. O biblatex, processado pelo biber, acrescenta tipos como @online, @report e @thesis, campos como journaltitle, date, location, urldate e eprint, e lê letras acentuadas diretamente, em vez de precisar de comandos de acento do LaTeX. O verificador avisa quando uma entrada usa um tipo exclusivo do biblatex — um estilo clássico recorre a @misc com um aviso —, mas nunca aponta um nome de campo do biblatex como campo obrigatório ausente.

Perguntas frequentes

Como verifico um arquivo BibTeX em busca de erros?

Cole-o na caixa acima ou carregue o arquivo .bib. O verificador lista cada problema com o número da linha e a chave da citação: entradas que não podem ser lidas, campos obrigatórios ausentes, chaves duplicadas, DOIs ou títulos repetidos, macros indefinidas e anos que não têm quatro dígitos. Corrija primeiro os erros; são eles que fazem o BibTeX emitir avisos ou descartar uma referência.

O que significa a mensagem « I'm skipping whatever remains of this entry »?

É o BibTeX desistindo de uma entrada que não consegue analisar — geralmente por causa de uma vírgula faltando entre dois campos, de uma chave sem par ou de uma aspa dentro de um valor entre aspas. O limpador aponta essas mesmas entradas como erros de análise, com o número da linha, e as mantém na saída exatamente como estavam, para que você possa corrigi-las no lugar.

Os intervalos de páginas devem usar -- no BibTeX?

Sim. O BibTeX passa o campo pages ao LaTeX, onde -- imprime um travessão, a marca correta para um intervalo. Muitos estilos padrão transformam um hífen simples em -- por conta própria, mas nem todo estilo faz isso, então escrever -- no arquivo é a escolha segura — e o limpador faz isso por você.

Por que o BibTeX põe meu título em minúsculas, e como evitar?

Muitos estilos imprimem títulos de artigos em caixa de frase e convertem em minúsculas toda letra que não esteja protegida por chaves, então DNA vira dna. Colocar a palavra entre chaves — {DNA} — a protege. A opção de maiúsculas do limpador acrescenta essas chaves a siglas e palavras com letras maiúsculas e minúsculas, ou a toda palavra capitalizada após a primeira, quando os seus títulos estão cheios de nomes próprios.

Chaves de citação duplicadas são um problema?

Sim. O BibTeX usa a primeira entrada com uma chave e ignora as demais, então uma citação pode apontar em silêncio para a obra errada. Chaves que diferem apenas em maiúsculas também são sinalizadas: o BibTeX avisa sobre elas e o biber as trata como duas chaves, então a mesma citação pode se comportar de forma diferente em cada um.

Meu arquivo .bib é enviado a algum lugar?

Não. O arquivo é lido e limpo inteiramente no seu navegador; nada é enviado a um servidor, e a cópia limpa é criada no seu próprio dispositivo quando você a baixa.