Pembersih dan Validator BibTeX

Cara Menggunakan Pembersih BibTeX

1. 1. Tempel atau muat file .bib Anda. Pembaca mengambil seluruh file sebagaimana BibTeX sendiri membacanya: makro @string, penggabungan #, @preamble, @comment, kurung kurawal bersarang, dan catatan di antara entri.
2. 2. Pilih pembersihan. Setiap opsi aktif secara default kecuali perlindungan huruf kapital dan pengurutan; matikan yang ingin Anda biarkan. Hasilnya diperbarui saat Anda mengubah opsi.
3. 3. Baca masalahnya. Kesalahan dan peringatan dicantumkan dengan baris dan kunci sitasinya, mulai dari jurnal yang hilang hingga kunci yang dipakai dua kali.
4. 4. Periksa perubahan, lalu unduh. Setiap perubahan dicatat per entri dan bidang, dengan nilai sebelum dan sesudahnya; hasilnya diunduh sebagai cleaned.bib.

Apa yang Diperiksa Validator

BibTeX klasik mendefinisikan empat belas jenis entri dan bidang yang wajib untuk masing-masing. Validator menerapkan tabel itu, dari BibTeXing karya Oren Patashnik — dokumentasi yang disertakan dengan BibTeX — dan menerima nama biblatex untuk data yang sama, sehingga journaltitle, date, dan institution pada tesis dihitung sebagai padanan klasiknya.

Validator juga menandai kunci yang dipakai dua kali (BibTeX hanya menyimpan entri pertama), kunci yang hanya berbeda pada huruf kapital, kunci yang mengandung spasi atau karakter lain yang tidak dapat dibaca BibTeX, DOI yang sama pada dua entri, judul dan tahun yang sama pada dua entri, bidang yang diberikan dua kali, makro yang dipakai tetapi tidak pernah didefinisikan dengan @string, dan tahun yang bukan empat digit. Entri yang tidak dapat diselesaikan pembaca — koma yang hilang, kurung kurawal yang tidak seimbang — dilaporkan dengan nomor barisnya dan dibiarkan persis seperti aslinya, sehingga pembersihan tidak pernah menghapus teks.

Apa yang Diubah oleh Pembersihan

• Jenis entri dan nama bidang dalam huruf kecil: @ARTICLE menjadi @article, Author menjadi author.
• Spasi: pemisah baris dan deretan spasi di dalam nilai digabung menjadi satu spasi.
• Pembatas: nilai yang diapit tanda kutip dipindahkan ke dalam kurung kurawal, yang tetap aman jika ada tanda kutip yang tidak sengaja di judul.
• Rentang halaman dengan tanda hubung ganda yang dicetak LaTeX sebagai tanda hubung panjang (en dash): 16569-16572 menjadi 16569--16572.
• Bulan sebagai makro BibTeX, jan sampai dec, ditulis tanpa kurung kurawal agar setiap gaya dapat mencetak atau menyingkatnya.
• Bidang kosong seperti note = {} dihapus.
• DOI kehilangan awalan https://doi.org/; gaya yang mencetak DOI menambahkannya sendiri.
• Huruf kapital dalam judul (opsional): kurung kurawal di sekitar akronim dan kata campuran — {DNA}, {mRNA}, {iPhone} — atau di sekitar setiap kata berhuruf kapital setelah yang pertama, sehingga gaya yang menulis judul dalam kalimat tidak dapat mengubahnya menjadi huruf kecil.
• Urutan bidang: author, title, journal atau booktitle, volume, number, pages, year, month, publisher, lalu pengenal; atau abjad; atau dibiarkan seperti semula.
• Pengurutan (opsional): berdasarkan kunci, penulis pertama, atau tahun. Definisi @string tetap di atas, karena makro harus didefinisikan sebelum entri memakainya.

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

Log perubahan untuk entri itu memiliki tujuh baris: jenis diubah menjadi huruf kecil, Author diganti menjadi author, judul diapit kurung kurawal, November diubah menjadi makro nov, rentang halaman diberi tanda hubung ganda, note yang kosong dihapus, dan bidang diurutkan. Tahun tetap sebagai angka tanpa tanda kutip, yang diterima BibTeX.

BibTeX atau biblatex?

File .bib yang sama dapat dipakai oleh dua sistem. BibTeX klasik, dengan gaya seperti plain atau file .bst milik sebuah jurnal, mengenal empat belas jenis standar dan diam-diam mengabaikan bidang yang tidak dikenalinya. biblatex, yang diproses oleh biber, menambahkan jenis seperti @online, @report, dan @thesis, bidang seperti journaltitle, date, location, urldate, dan eprint, serta membaca huruf beraksen secara langsung alih-alih memerlukan perintah aksen LaTeX. Validator memberi peringatan ketika entri memakai jenis khusus biblatex — gaya klasik akan beralih ke @misc dengan peringatan — tetapi tidak pernah melaporkan nama bidang biblatex sebagai bidang yang hilang.

Pertanyaan yang Sering Diajukan

Bagaimana cara memeriksa file BibTeX dari kesalahan?

Tempel ke dalam kotak di atas atau muat file .bib. Validator mencantumkan setiap masalah dengan nomor baris dan kunci sitasinya: entri yang tidak dapat dibaca, bidang wajib yang hilang, kunci ganda, DOI atau judul yang berulang, makro yang tidak terdefinisi, dan tahun yang bukan empat digit. Perbaiki kesalahan terlebih dahulu; itulah yang membuat BibTeX memberi peringatan atau menjatuhkan referensi.

Apa arti “I'm skipping whatever remains of this entry”?

Itu adalah BibTeX yang menyerah pada entri yang tidak dapat diuraikannya — biasanya karena koma yang hilang di antara dua bidang, kurung kurawal yang tidak seimbang, atau tanda kutip di dalam nilai yang diapit. Pembersih melaporkan entri yang sama sebagai kesalahan penguraian dengan nomor barisnya dan mempertahankannya di keluaran persis seperti aslinya, sehingga Anda dapat memperbaikinya di tempat.

Haruskah rentang halaman memakai -- di BibTeX?

Ya. BibTeX meneruskan bidang pages ke LaTeX, tempat -- dicetak sebagai en dash, tanda yang benar untuk rentang. Banyak gaya standar mengubah tanda hubung tunggal menjadi -- sendiri, tetapi tidak semua gaya melakukannya, sehingga menulis -- di dalam file adalah pilihan yang aman — dan pembersih melakukannya untuk Anda.

Mengapa BibTeX mengubah judul saya menjadi huruf kecil, dan bagaimana cara menghentikannya?

Banyak gaya mencetak judul artikel dalam kalimat dan mengubah menjadi huruf kecil setiap huruf yang tidak dilindungi kurung kurawal, sehingga DNA menjadi dna. Mengapit kata dengan kurung kurawal — {DNA} — melindunginya. Opsi huruf kapital pada pembersih menambahkan kurung itu ke akronim dan kata campuran, atau ke setiap kata berhuruf kapital setelah yang pertama ketika judul Anda banyak berisi nama diri.

Apakah kunci sitasi yang duplikat menjadi masalah?

Ya. BibTeX memakai entri pertama dengan suatu kunci dan mengabaikan sisanya, sehingga sebuah sitasi dapat diam-diam menunjuk ke karya yang salah. Kunci yang hanya berbeda pada huruf kapital juga ditandai: BibTeX memberi peringatan tentangnya dan biber memperlakukannya sebagai dua kunci, sehingga sitasi yang sama dapat berperilaku berbeda di masing-masing.

Apakah file .bib saya diunggah?

Tidak. File dibaca dan dibersihkan sepenuhnya di peramban Anda; tidak ada yang dikirim ke server, dan salinan yang sudah dibersihkan dibuat di perangkat Anda sendiri saat Anda mengunduhnya.