Czyszczenie i walidacja BibTeX

Jak korzystać z narzędzia do czyszczenia BibTeX

1. 1. Wklej lub wczytaj plik .bib. Czytnik przyjmuje cały plik tak, jak czyta go sam BibTeX: makra @string, łączenie #, @preamble, @comment, zagnieżdżone klamry i notatki między wpisami.
2. 2. Wybierz porządki. Każda opcja jest domyślnie włączona oprócz ochrony wielkich liter i sortowania; wyłącz to, co ma pozostać bez zmian. Wynik aktualizuje się po każdej zmianie opcji.
3. 3. Przeczytaj problemy. Błędy i ostrzeżenia są wypisane z wierszem i kluczem cytowania: od brakującego czasopisma po klucz użyty dwa razy.
4. 4. Sprawdź zmiany, a potem pobierz. Każda zmiana jest zapisana według wpisu i pola, z wartością przed i po; wynik pobierzesz jako cleaned.bib.

Co sprawdza walidator

Klasyczny BibTeX definiuje czternaście typów wpisów i pola wymagane dla każdego z nich. Walidator stosuje tę tabelę z BibTeXing Orena Patashnika — dokumentacji dołączonej do BibTeX — i przyjmuje nazwy biblatex dla tych samych danych, więc journaltitle, date i pole institution pracy dyplomowej liczą się jako ich klasyczne odpowiedniki.

Walidator zgłasza też klucz użyty dwa razy (BibTeX zachowuje tylko pierwszy wpis), klucze różniące się tylko wielkością liter, klucze zawierające spację albo inny znak, którego BibTeX nie odczyta w kluczu, ten sam DOI w dwóch wpisach, ten sam tytuł i rok w dwóch wpisach, pole podane dwa razy, makro użyte, ale niezdefiniowane przez @string, oraz rok, który nie ma czterech cyfr. Wpis, którego czytnik nie może dokończyć — brakujący przecinek, niezrównoważona klamra — jest zgłaszany z numerem wiersza i zostaje zachowany dokładnie tak, jak był napisany, więc czyszczenie nigdy nie usuwa tekstu.

Co zmienia czyszczenie

• Typy wpisów i nazwy pól małymi literami: @ARTICLE staje się @article, Author staje się author.
• Odstępy: podziały wierszy i ciągi spacji wewnątrz wartości zwijają się do pojedynczych spacji.
• Ograniczniki: wartości w cudzysłowach przechodzą w klamry, które przetrwają przypadkowy cudzysłów w tytule.
• Zakresy stron z podwójnym myślnikiem, który LaTeX drukuje jako myślnik półfiszki: 16569-16572 staje się 16569--16572.
• Miesiące jako makra BibTeX-a, jan do dec, zapisane bez klamer, aby każdy styl mógł je wydrukować lub skrócić.
• Puste pola, takie jak note = {}, są usuwane.
• DOI tracą prefiks https://doi.org/; style, które drukują DOI, dodają własny.
• Wielkie litery w tytułach (opcjonalnie): klamry wokół akronimów i słów o mieszanej wielkości liter — {DNA}, {mRNA}, {iPhone} — albo wokół każdego wielkiego słowa po pierwszym, aby style ustawiające tytuły zdaniowo nie zamieniły ich na małe litery.
• Kolejność pól: autor, tytuł, czasopismo lub tytuł książki, tom, numer, strony, rok, miesiąc, wydawca, a potem identyfikatory; albo alfabetyczna; albo pozostawiona bez zmian.
• Sortowanie (opcjonalnie): według klucza, pierwszego autora lub roku. Definicje @string zostają na górze, ponieważ makro musi być zdefiniowane, zanim wpis go użyje.

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

Dziennik zmian dla tego wpisu ma siedem linii: typ zapisany małymi literami, Author zmieniony na author, tytuł przeniesiony w klamry, November zamienione na makro nov, zakres stron z podwójnym myślnikiem, usunięte puste note i pola ułożone w kolejności. Rok pozostaje gołą liczbą, którą BibTeX przyjmuje.

BibTeX czy biblatex?

Ten sam plik .bib może zasilać dwa systemy. Klasyczny BibTeX, z takimi stylami jak plain albo plik .bst czasopisma, zna czternaście standardowych typów i po cichu ignoruje nierozpoznane pola. biblatex, przetwarzany przez biber, dodaje typy takie jak @online, @report i @thesis, pola takie jak journaltitle, date, location, urldate i eprint oraz czyta litery z akcentami bezpośrednio zamiast wymagać poleceń akcentów LaTeX-a. Walidator ostrzega, gdy wpis używa typu wyłącznie biblatex — klasyczny styl przechodzi wtedy na @misc z ostrzeżeniem — ale nigdy nie zgłasza nazwy pola biblatex jako brakującego pola.

Najczęstsze pytania

Jak sprawdzić plik BibTeX pod kątem błędów?

Wklej go do pola powyżej albo wczytaj plik .bib. Walidator wypisuje każdy problem z numerem wiersza i kluczem cytowania: wpisy, których nie da się odczytać, brakujące wymagane pola, zduplikowane klucze, powtarzające się DOI lub tytuły, niezdefiniowane makra i lata niezapisane czterema cyframi. Najpierw napraw błędy; to one sprawiają, że BibTeX ostrzega albo gubi odwołanie.

Co oznacza komunikat „I'm skipping whatever remains of this entry”?

To BibTeX rezygnujący z wpisu, którego nie potrafi przetworzyć — zwykle z powodu brakującego przecinka między dwoma polami, niezrównoważonej klamry albo cudzysłowu wewnątrz wartości w cudzysłowie. Czyszczenie zgłasza te same wpisy jako błędy składni z numerami wierszy i zachowuje je w wyniku dokładnie tak, jak były napisane, abyś mógł je naprawić na miejscu.

Czy w BibTeX zakresy stron powinny używać --?

Tak. BibTeX przekazuje pole pages do LaTeX-a, gdzie -- drukuje myślnik półfiszki, poprawny znak zakresu. Wiele standardowych stylów samo zamienia pojedynczy myślnik na --, ale nie każdy styl to robi, więc zapisanie -- w pliku to bezpieczny wybór — a czyszczenie robi to za Ciebie.

Dlaczego BibTeX zmienia mój tytuł na małe litery i jak temu zapobiec?

Wiele stylów drukuje tytuły artykułów w zdaniowej wielkości liter i zamienia na małe każdą literę niechronioną klamrami, więc DNA staje się dna. Owinięcie słowa w klamry — {DNA} — je chroni. Opcja wielkich liter w czyszczeniu dodaje te klamry do akronimów i słów o mieszanej wielkości liter albo do każdego wielkiego słowa po pierwszym, jeśli Twoje tytuły są pełne nazw własnych.

Czy zduplikowane klucze cytowań są problemem?

Tak. BibTeX używa pierwszego wpisu z danym kluczem i ignoruje resztę, więc cytowanie może po cichu wskazywać na złą pracę. Klucze różniące się tylko wielkością liter też są zgłaszane: BibTeX ostrzega o nich, a biber traktuje je jako dwa klucze, więc to samo cytowanie może działać różnie w każdym z nich.

Czy mój plik .bib jest wysyłany?

Nie. Plik jest czytany i czyszczony w całości w przeglądarce; nic nie trafia na serwer, a oczyszczona kopia powstaje na Twoim urządzeniu w chwili pobrania.