BibTeX-opschoner & -validator

Zo gebruik je de BibTeX-opschoner

1. 1. Plak of laad je .bib-bestand. De lezer neemt het hele bestand op zoals BibTeX het zelf leest: @string-macro's, #-samenvoegingen, @preamble, @comment, geneste accolades en notities tussen de items.
2. 2. Kies de opschoning. Elke optie staat standaard aan, behalve de bescherming van hoofdletters en het sorteren; zet uit wat je ongewijzigd wilt laten. Het resultaat past zich aan terwijl je opties wijzigt.
3. 3. Lees de problemen. Fouten en waarschuwingen worden vermeld met hun regel en citatiesleutel, van een ontbrekend tijdschrift tot een sleutel die tweemaal wordt gebruikt.
4. 4. Controleer de wijzigingen en download. Elke wijziging is per item en veld vastgelegd, met de waarde voor en na; het resultaat downloadt als cleaned.bib.

Wat de validator controleert

Klassieke BibTeX definieert veertien itemtypen en de velden die elk verplicht zijn. De validator past die tabel toe, uit Oren Patashniks BibTeXing — de documentatie die bij BibTeX wordt meegeleverd — en accepteert de namen van biblatex voor dezelfde gegevens. Zo tellen journaltitle, date en de institution van een scriptie als hun klassieke equivalenten.

Hij markeert ook een sleutel die tweemaal wordt gebruikt (BibTeX houdt alleen het eerste item), sleutels die alleen in hoofdletters verschillen, sleutels met een spatie of een ander teken dat BibTeX niet in een sleutel kan lezen, dezelfde DOI in twee items, dezelfde titel en hetzelfde jaar in twee items, een veld dat tweemaal wordt gegeven, een macro die wordt gebruikt maar nooit met @string is gedefinieerd, en een jaartal dat geen vier cijfers heeft. Een item dat de lezer niet kan afmaken — een ontbrekende komma of een niet-sluitende accolade — wordt met regelnummer gemeld en ongewijzigd bewaard, zodat opschonen nooit tekst verwijdert.

Wat de opschoning verandert

• Itemtypen en veldnamen in kleine letters: @ARTICLE wordt @article, Author wordt author.
• Witruimte: regeleinden en reeksen spaties binnen een waarde worden samengevoegd tot enkele spaties.
• Scheidingstekens: tussen aanhalingstekens geplaatste waarden gaan naar accolades, die een losse aanhalingsteken in een titel overleven.
• Paginabereiken met het dubbele koppelteken dat LaTeX als en-streepje afdrukt: 16569-16572 wordt 16569--16572.
• Maanden als BibTeX-macro's, jan tot en met dec, zonder accolades geschreven zodat elke stijl ze kan afdrukken of afkorten.
• Lege velden zoals note = {} worden verwijderd.
• DOI's verliezen het voorvoegsel https://doi.org/; stijlen die de DOI afdrukken, voegen dat zelf weer toe.
• Hoofdletters in titels (optioneel): accolades rond acroniemen en woorden met gemengde letters — {DNA}, {mRNA}, {iPhone} — of rond elk hoofdletterwoord na het eerste, zodat stijlen die titels in zinsvorm zetten ze niet kunnen verkleinen.
• Veldvolgorde: author, title, journal of boektitel, volume, number, pages, year, month, publisher, daarna identificatoren; of alfabetisch; of zoals het was.
• Sorteren (optioneel): op sleutel, eerste auteur of jaar. @string-definities blijven bovenaan, omdat een macro moet zijn gedefinieerd voordat een item hem gebruikt.

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

Het wijzigingslogboek voor dat item heeft zeven regels: het type in kleine letters, Author hernoemd naar author, de titel naar accolades verplaatst, November omgezet in de macro nov, het paginabereik voorzien van het dubbele koppelteken, de lege note verwijderd en de velden in volgorde gezet. Het jaartal blijft een kaal getal, wat BibTeX accepteert.

BibTeX of biblatex?

Hetzelfde .bib-bestand kan twee systemen voeden. Klassieke BibTeX, met stijlen zoals plain of het .bst-bestand van een tijdschrift, kent de veertien standaardtypen en negeert velden die het niet herkent, zonder iets te zeggen. biblatex, verwerkt door biber, voegt typen toe zoals @online, @report en @thesis, velden zoals journaltitle, date, location, urldate en eprint, en leest geaccentueerde letters direct in, in plaats van LaTeX-accentcommando's nodig te hebben. De validator waarschuwt als een item een type gebruikt dat alleen in biblatex bestaat — een klassieke stijl valt dan terug op @misc met een waarschuwing — maar meldt nooit een biblatex-veldnaam als ontbrekend veld.

Veelgestelde vragen

Hoe controleer ik een BibTeX-bestand op fouten?

Plak het in het vak hierboven of laad het .bib-bestand. De validator somt elk probleem op met regelnummer en citatiesleutel: items die niet gelezen kunnen worden, ontbrekende verplichte velden, dubbele sleutels, herhaalde DOI's of titels, niet-gedefinieerde macro's en jaartallen die geen vier cijfers hebben. Los de fouten eerst op; dat zijn de fouten waardoor BibTeX waarschuwt of een referentie laat vallen.

Wat betekent de melding „I'm skipping whatever remains of this entry”?

Het betekent dat BibTeX een item opgeeft dat het niet kan lezen — meestal door een ontbrekende komma tussen twee velden, een niet-sluitende accolade of een aanhalingsteken binnen een tussen aanhalingstekens geplaatste waarde. De opschoner meldt dezelfde items als leesfouten met hun regelnummers en bewaart ze in de uitvoer precies zoals ze zijn, zodat je ze op de plaats zelf kunt herstellen.

Moet ik in BibTeX -- gebruiken voor paginabereiken?

Ja. BibTeX geeft het veld pages door aan LaTeX, waar -- een en-streepje afdrukt, het juiste teken voor een bereik. Veel standaardstijlen maken een enkel koppelteken zelf tot --, maar niet elke stijl doet dat. Schrijf -- dus in het bestand; de opschoner doet dat voor je.

Waarom zet BibTeX mijn titel in kleine letters, en hoe stop ik dat?

Veel stijlen drukken artikeltitels in zinsvorm af en zetten elke letter die niet door accolades is beschermd om in kleine letters, dus DNA wordt dna. Een woord tussen accolades zetten — {DNA} — beschermt het. De optie voor hoofdletters van de opschoner voegt die accolades toe aan acroniemen en woorden met gemengde letters, of aan elk hoofdletterwoord na het eerste als je titels vol eigennamen staan.

Zijn dubbele citatiesleutels een probleem?

Ja. BibTeX gebruikt het eerste item met een sleutel en negeert de rest, dus een citaat kan stilzwijgend naar het verkeerde werk verwijzen. Sleutels die alleen in hoofdletters verschillen, worden ook gemarkeerd: BibTeX waarschuwt ervoor, en biber behandelt ze als twee sleutels, dus hetzelfde citaat kan zich bij elk anders gedragen.

Wordt mijn .bib-bestand geüpload?

Nee. Het bestand wordt volledig in je browser gelezen en opgeschoond; er wordt niets naar een server gestuurd, en de opgeschoonde kopie wordt op je eigen apparaat gemaakt wanneer je downloadt.