Limpiador y verificador de BibTeX

Cómo usar el limpiador de BibTeX

1. 1. Pega o carga tu archivo .bib. El lector toma el archivo completo tal como lo lee el propio BibTeX: macros @string, concatenación con #, @preamble, @comment, llaves anidadas y notas entre entradas.
2. 2. Elige la limpieza. Todas las opciones están activadas por defecto, salvo la protección de mayúsculas y la ordenación; desactiva lo que quieras dejar tal cual. El resultado se actualiza al cambiar las opciones.
3. 3. Lee los problemas. Los errores y las advertencias se listan con su línea y su clave de cita, desde una revista que falta hasta una clave usada dos veces.
4. 4. Revisa los cambios y descarga. Cada cambio se registra por entrada y campo, con el valor anterior y el posterior; el resultado se descarga como cleaned.bib.

Qué comprueba el verificador

BibTeX clásico define catorce tipos de entrada y los campos que exige cada uno. El verificador aplica esa tabla, de BibTeXing de Oren Patashnik —la documentación que acompaña a BibTeX—, y acepta los nombres de biblatex para los mismos datos, así que journaltitle, date y la institution de una tesis cuentan como sus equivalentes clásicos.

También señala una clave usada dos veces (BibTeX conserva solo la primera entrada), claves que solo se diferencian en mayúsculas, claves con un espacio u otro carácter que BibTeX no puede leer, el mismo DOI en dos entradas, el mismo título y año en dos entradas, un campo escrito dos veces, una macro usada pero nunca definida con @string y un año que no tiene cuatro dígitos. Una entrada que el lector no puede terminar —una coma que falta, una llave sin cerrar— se notifica con su número de línea y se conserva exactamente como estaba, así que la limpieza nunca borra texto.

Qué cambia la limpieza

• Tipos de entrada y nombres de campo en minúsculas: @ARTICLE pasa a @article y Author a author.
• Espacios en blanco: los saltos de línea y los espacios repetidos dentro de un valor se reducen a un solo espacio.
• Delimitadores: los valores entre comillas pasan a llaves, que sobreviven a una comilla suelta en un título.
• Rangos de páginas con el doble guion que LaTeX imprime como guion largo: 16569-16572 pasa a 16569--16572.
• Meses como macros de BibTeX, jan a dec, escritas sin llaves para que cualquier estilo pueda imprimirlos o abreviarlos.
• Campos vacíos, como note = {}, se eliminan.
• DOI pierden el prefijo https://doi.org/; los estilos que imprimen el DOI añaden el suyo.
• Mayúsculas en títulos (opcional): llaves alrededor de siglas y palabras con mayúsculas mixtas —{DNA}, {mRNA}, {iPhone}— o alrededor de cada palabra con mayúscula después de la primera, para que los estilos que componen los títulos en mayúsculas y minúsculas no las conviertan en minúsculas.
• Orden de campos: autor, título, revista o título del libro, volumen, número, páginas, año, mes, editorial y, al final, los identificadores; o alfabético; o tal como estaba.
• Ordenación (opcional): por clave, por primer autor o por año. Las definiciones @string se quedan al principio, porque una macro debe definirse antes de que una entrada la use.

@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
}

El registro de cambios de esa entrada tiene siete líneas: el tipo pasa a minúsculas, Author se renombra a author, el título se pasa a llaves, November se convierte en la macro nov, el rango de páginas recibe su doble guion, el note vacío se elimina y los campos se ordenan. El año se queda como número sin comillas, que BibTeX acepta.

¿BibTeX o biblatex?

El mismo archivo .bib puede alimentar dos sistemas. El BibTeX clásico, con estilos como plain o el archivo .bst propio de una revista, conoce los catorce tipos estándar e ignora en silencio los campos que no reconoce. Biblatex, procesado por biber, añade tipos como @online, @report y @thesis, campos como journaltitle, date, location, urldate y eprint, y lee las letras acentuadas directamente en lugar de necesitar órdenes de acento de LaTeX. El verificador avisa cuando una entrada usa un tipo exclusivo de biblatex —un estilo clásico recurre a @misc con una advertencia—, pero nunca informa de un nombre de campo de biblatex como si fuera un campo obligatorio que falta.

Preguntas frecuentes

¿Cómo reviso un archivo BibTeX en busca de errores?

Pégalo en el cuadro de arriba o carga el archivo .bib. El verificador lista cada problema con su número de línea y su clave de cita: entradas que no se pueden leer, campos obligatorios que faltan, claves repetidas, DOI o títulos repetidos, macros sin definir y años que no tienen cuatro dígitos. Corrige primero los errores; son los que hacen que BibTeX avise o descarte una referencia.

¿Qué significa el aviso «I'm skipping whatever remains of this entry»?

Es BibTeX renunciando a una entrada que no puede analizar, normalmente por una coma que falta entre dos campos, una llave sin cerrar o una comilla dentro de un valor entre comillas. El limpiador informa de las mismas entradas como errores de análisis con sus números de línea y las conserva en la salida exactamente como estaban, para que puedas repararlas en su sitio.

¿Debo usar -- en los rangos de páginas de BibTeX?

Sí. BibTeX pasa el campo pages a LaTeX, donde -- imprime un guion largo, la marca correcta para un rango. Muchos estilos estándar convierten un guion simple en -- por sí mismos, pero no todos lo hacen, así que escribir -- en el archivo es la opción segura, y el limpiador lo hace por ti.

¿Por qué BibTeX pasa mi título a minúsculas, y cómo lo evito?

Muchos estilos imprimen los títulos de artículos en mayúscula y minúscula y pasan a minúscula cada letra que no esté protegida por llaves, así que DNA se convierte en dna. Poner una palabra entre llaves —{DNA}— la protege. La opción de mayúsculas del limpiador añade esas llaves a siglas y palabras con mayúsculas mixtas, o a cada palabra con mayúscula después de la primera si tus títulos están llenos de nombres propios.

¿Son un problema las claves de cita duplicadas?

Sí. BibTeX usa la primera entrada con una clave y descarta el resto, así que una cita puede apuntar en silencio a la obra equivocada. Las claves que solo se diferencian en mayúsculas también se señalan: BibTeX avisa de ellas y biber las trata como dos claves, así que la misma cita puede comportarse de forma distinta con cada uno.

¿Se sube mi archivo .bib a algún sitio?

No. El archivo se lee y se limpia por completo en tu navegador; no se envía a ningún servidor, y la copia limpia se crea en tu propio dispositivo cuando la descargas.