Verificatore e Pulitore BibTeX

Come usare il pulitore BibTeX

1. 1. Incolla o carica il tuo file .bib. Lo strumento legge l'intero file come lo legge BibTeX stesso: macro @string, concatenazione con #, @preamble, @comment, graffe annidate e note tra le voci.
2. 2. Scegli la pulizia. Ogni opzione è attiva per impostazione predefinita, tranne la protezione delle maiuscole e l'ordinamento; disattiva quelle che vuoi lasciare intatte. Il risultato si aggiorna mentre cambi le opzioni.
3. 3. Leggi i problemi. Errori e avvisi sono elencati con la loro riga e la chiave di citazione, da una rivista mancante a una chiave usata due volte.
4. 4. Controlla le modifiche, poi scarica. Ogni modifica è registrata per voce e campo, con il valore prima e dopo; il risultato si scarica come cleaned.bib.

Che cosa controlla il verificatore

Il BibTeX classico definisce quattordici tipi di voce e i campi che ciascuno richiede. Il verificatore applica quella tabella, tratta da BibTeXing di Oren Patashnik — la documentazione che accompagna BibTeX — e accetta i nomi di biblatex per gli stessi dati, quindi journaltitle, date e institution di una tesi valgono come i loro equivalenti classici.

Segnala anche una chiave usata due volte (BibTeX mantiene solo la prima voce), le chiavi che differiscono solo per le maiuscole, le chiavi che contengono uno spazio o un carattere che BibTeX non può leggere, lo stesso DOI in due voci, lo stesso titolo e anno in due voci, un campo dato due volte, una macro usata ma mai definita con @string, e un anno che non ha quattro cifre. Una voce che il lettore non riesce a completare — una virgola mancante, una graffa non bilanciata — viene segnalata con il suo numero di riga e mantenuta esattamente com'era, quindi la pulizia non cancella mai testo.

Che cosa cambia la pulizia

• Tipi di voce e nomi dei campi in minuscolo: @ARTICLE diventa @article, Author diventa author.
• Spazi: le interruzioni di riga e le sequenze di spazi dentro un valore si riducono a spazi singoli.
• Delimitatori: i valori tra virgolette passano tra graffe, che sopravvivono a un virgolette sbagliato in un titolo.
• Intervalli di pagine con il doppio trattino che LaTeX stampa come trattino lungo: 16569-16572 diventa 16569--16572.
• Mesi come macro di BibTeX, da jan a dec, scritti senza graffe perché ogni stile possa stamparli o abbreviarli.
• Campi vuoti come note = {} vengono rimossi.
• DOI perdono il prefisso https://doi.org/; gli stili che stampano il DOI aggiungono il proprio.
• Maiuscole nei titoli (facoltativo): graffe intorno ad acronimi e parole con maiuscole miste — {DNA}, {mRNA}, {iPhone} — oppure intorno a ogni parola maiuscola dopo la prima, così gli stili che impostano i titoli in maiuscolo/minuscolo non possono abbassarle.
• Ordine dei campi: author, title, journal o booktitle, volume, number, pages, year, month, publisher, poi gli identificativi; oppure alfabetico; oppure lasciato com'era.
• Ordinamento (facoltativo): per chiave, primo autore o anno. Le definizioni @string restano in cima, perché una macro deve essere definita prima che una voce la usi.

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

Il registro delle modifiche per quella voce ha sette righe: il tipo scritto in minuscolo, Author rinominato in author, il titolo racchiuso tra graffe, November trasformato nella macro nov, l'intervallo di pagine con il doppio trattino, la nota vuota note rimossa e i campi riordinati. L'anno resta un numero semplice, che BibTeX accetta.

BibTeX o biblatex?

Lo stesso file .bib può alimentare due sistemi. Il BibTeX classico, con stili come plain o il file .bst di una rivista, conosce i quattordici tipi standard e ignora in silenzio i campi che non riconosce. biblatex, elaborato da biber, aggiunge tipi come @online, @report e @thesis, campi come journaltitle, date, location, urldate ed eprint, e legge direttamente le lettere accentate invece di richiedere comandi di accento LaTeX. Il verificatore avvisa quando una voce usa un tipo solo di biblatex — uno stile classico ripiega su @misc con un avviso — ma non segnala mai un nome di campo biblatex come campo mancante.

Domande frequenti

Come controllo un file BibTeX per gli errori?

Incollalo nella casella qui sopra o carica il file .bib. Il verificatore elenca ogni problema con il numero di riga e la chiave di citazione: voci che non si possono leggere, campi obbligatori mancanti, chiavi duplicate, DOI o titoli ripetuti, macro non definite e anni che non hanno quattro cifre. Correggi prima gli errori: sono quelli che fanno avvisare BibTeX o scartare un riferimento.

Che cosa significa “I'm skipping whatever remains of this entry”?

È BibTeX che rinuncia a una voce che non riesce a leggere — di solito per una virgola mancante tra due campi, una graffa non bilanciata o un virgolette dentro un valore tra virgolette. Il pulitore segnala le stesse voci come errori di lettura con i loro numeri di riga e le conserva nell'output esattamente com'erano, così puoi ripararle sul posto.

In BibTeX bisogna usare -- per gli intervalli di pagine?

Sì. BibTeX passa il campo pages a LaTeX, dove -- stampa un trattino lungo, il segno corretto per un intervallo. Molti stili standard trasformano un singolo trattino in --, ma non tutti, quindi scrivere -- nel file è la scelta sicura — e il pulitore lo fa per te.

Perché BibTeX mi abbassa il titolo, e come lo impedisco?

Molti stili stampano i titoli degli articoli in maiuscolo e minuscolo normale e abbassano ogni lettera non protetta da graffe, quindi DNA diventa dna. Racchiudere una parola tra graffe — {DNA} — la protegge. L'opzione sulle maiuscole del pulitore aggiunge quelle graffe ad acronimi e parole con maiuscole miste, oppure a ogni parola maiuscola dopo la prima quando i tuoi titoli sono pieni di nomi propri.

Le chiavi di citazione duplicate sono un problema?

Sì. BibTeX usa la prima voce con una chiave e ignora le altre, quindi una citazione può puntare in silenzio all'opera sbagliata. Vengono segnalate anche le chiavi che differiscono solo per le maiuscole: BibTeX avvisa, e biber le tratta come due chiavi, quindi la stessa citazione può comportarsi in modo diverso con ciascuna delle due.

Il mio file .bib viene caricato?

No. Il file viene letto e pulito interamente nel tuo browser; nulla viene inviato a un server, e la copia pulita viene creata sul tuo dispositivo quando la scarichi.