Công Cụ Làm Sạch & Kiểm Tra BibTeX

Cách Sử Dụng Công Cụ Làm Sạch BibTeX

1. 1. Dán hoặc tải tệp .bib. Công cụ đọc toàn bộ tệp như chính BibTeX đọc: các macro @string, phép nối #, @preamble, @comment, dấu ngoặc lồng nhau và ghi chú giữa các mục.
2. 2. Chọn cách làm sạch. Mọi tùy chọn đều bật sẵn trừ bảo vệ chữ hoa và sắp xếp; hãy tắt tùy chọn nào bạn muốn giữ nguyên. Kết quả cập nhật khi bạn thay đổi tùy chọn.
3. 3. Đọc các vấn đề. Lỗi và cảnh báo được liệt kê kèm dòng và khóa trích dẫn, từ thiếu tên tạp chí đến một khóa dùng hai lần.
4. 4. Kiểm tra các thay đổi, rồi tải về. Mọi thay đổi được ghi theo mục và trường, với giá trị trước và sau; kết quả tải về dưới tên cleaned.bib.

Công Cụ Kiểm Tra Những Gì

BibTeX cổ điển định nghĩa mười bốn loại mục và các trường bắt buộc của từng loại. Công cụ áp dụng bảng đó, lấy từ BibTeXing của Oren Patashnik — tài liệu đi kèm BibTeX — và chấp nhận tên của biblatex cho cùng dữ liệu, nên journaltitle, date và institution của luận văn được tính như các trường cổ điển tương ứng.

Công cụ cũng đánh dấu khóa được dùng hai lần (BibTeX chỉ giữ mục đầu tiên), các khóa chỉ khác nhau ở chữ hoa, khóa chứa dấu cách hoặc ký tự khác mà BibTeX không đọc được, cùng một DOI trong hai mục, cùng tiêu đề và năm trong hai mục, một trường được ghi hai lần, một macro được dùng nhưng chưa được định nghĩa bằng @string, và một năm không phải bốn chữ số. Mục mà bộ đọc không hoàn tất — thiếu dấu phẩy, dấu ngoặc không cân — được báo lỗi kèm số dòng và giữ nguyên như cũ, nên việc làm sạch không bao giờ xóa văn bản.

Làm Sạch Thay Đổi Những Gì

• Loại mục và tên trường viết thường: @ARTICLE thành @article, Author thành author.
• Khoảng trắng: ngắt dòng và các chuỗi dấu cách trong một giá trị được gộp thành một dấu cách.
• Dấu phân cách: giá trị trong ngoặc kép chuyển sang dấu ngoặc nhọn, giúp tiêu đề vẫn an toàn khi có dấu ngoặc kép lạc chỗ.
• Khoảng trang dùng dấu gạch kép mà LaTeX in thành gạch ngang: 16569-16572 thành 16569--16572.
• Tháng dưới dạng macro của BibTeX, jan đến dec, viết không có dấu ngoặc để mọi kiểu trích dẫn có thể in hoặc rút gọn.
• Trường rỗng như note = {} bị xóa.
• DOI bỏ tiền tố https://doi.org/; các kiểu trích dẫn in DOI sẽ tự thêm tiền tố riêng.
• Chữ hoa trong tiêu đề (tùy chọn): thêm dấu ngoặc nhọn quanh từ viết tắt và từ có chữ hoa lẫn thường — {DNA}, {mRNA}, {iPhone} — hoặc quanh mọi từ viết hoa sau từ đầu tiên, để các kiểu trích dẫn đặt tiêu đề theo kiểu câu không thể chuyển chữ thành thường.
• Thứ tự trường: author, title, journal hoặc booktitle, volume, number, pages, year, month, publisher, rồi các định danh; hoặc theo bảng chữ cái; hoặc giữ nguyên.
• Sắp xếp (tùy chọn): theo khóa, tác giả đầu tiên hoặc năm. Các định nghĩa @string vẫn nằm trên cùng, vì một macro phải được định nghĩa trước khi mục dùng nó.

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

Nhật ký thay đổi cho mục đó có bảy dòng: loại mục đổi thành chữ thường, Author đổi thành author, tiêu đề chuyển vào dấu ngoặc nhọn, November đổi thành macro nov, khoảng trang được thêm gạch kép, trường note rỗng bị xóa và các trường được sắp xếp. Năm vẫn là số thuần, điều BibTeX chấp nhận.

BibTeX hay biblatex?

Cùng một tệp .bib có thể đưa vào hai hệ thống. BibTeX cổ điển, với các kiểu như plain hoặc tệp .bst riêng của một tạp chí, biết mười bốn loại chuẩn và lặng lẽ bỏ qua các trường nó không nhận ra. biblatex, được xử lý bởi biber, thêm các loại như @online, @report và @thesis, các trường như journaltitle, date, location, urldate và eprint, và đọc trực tiếp chữ có dấu thay vì cần các lệnh dấu của LaTeX. Công cụ cảnh báo khi một mục dùng loại chỉ có trong biblatex — một kiểu cổ điển sẽ chuyển về @misc kèm cảnh báo — nhưng không bao giờ báo một tên trường biblatex là trường bắt buộc còn thiếu.

Câu Hỏi Thường Gặp

Làm thế nào để kiểm tra tệp BibTeX có lỗi không?

Dán vào ô phía trên hoặc tải tệp .bib lên. Công cụ liệt kê mọi vấn đề kèm số dòng và khóa trích dẫn: các mục không đọc được, trường bắt buộc còn thiếu, khóa trùng, DOI hoặc tiêu đề bị lặp, macro chưa định nghĩa và năm không phải bốn chữ số. Hãy sửa lỗi trước; đó là những lỗi khiến BibTeX cảnh báo hoặc bỏ qua một tài liệu tham khảo.

Thông báo “I'm skipping whatever remains of this entry” nghĩa là gì?

Đó là BibTeX bỏ qua một mục nó không phân tích được — thường vì thiếu dấu phẩy giữa hai trường, dấu ngoặc không cân hoặc một dấu ngoặc kép bên trong giá trị trong ngoặc kép. Công cụ báo các mục này là lỗi phân tích kèm số dòng và giữ nguyên trong kết quả, để bạn có thể sửa tại chỗ.

Khoảng trang trong BibTeX có nên dùng -- không?

Có. BibTeX chuyển trường pages cho LaTeX, nơi -- được in thành gạch en, dấu đúng cho một khoảng. Nhiều kiểu chuẩn tự đổi một dấu gạch thành --, nhưng không phải kiểu nào cũng làm vậy, nên viết -- trong tệp là lựa chọn an toàn — và công cụ làm điều này cho bạn.

Vì sao BibTeX chuyển tiêu đề của tôi thành chữ thường, và làm thế nào để ngăn điều đó?

Nhiều kiểu trích dẫn in tiêu đề bài báo theo kiểu câu và chuyển thành chữ thường mọi chữ không được bảo vệ bởi dấu ngoặc nhọn, nên DNA thành dna. Bọc một từ trong dấu ngoặc nhọn — {DNA} — sẽ bảo vệ nó. Tùy chọn chữ hoa của công cụ thêm các dấu ngoặc đó vào từ viết tắt và từ có chữ hoa lẫn thường, hoặc vào mọi từ viết hoa sau từ đầu tiên khi tiêu đề của bạn có nhiều danh từ riêng.

Khóa trích dẫn trùng có phải là vấn đề không?

Có. BibTeX dùng mục đầu tiên có khóa và bỏ qua phần còn lại, nên một trích dẫn có thể âm thầm trỏ đến sai tài liệu. Các khóa chỉ khác nhau ở chữ hoa cũng được đánh dấu: BibTeX cảnh báo về chúng và biber coi chúng là hai khóa, nên cùng một trích dẫn có thể hoạt động khác nhau ở mỗi bên.

Tệp .bib của tôi có bị tải lên không?

Không. Tệp được đọc và làm sạch hoàn toàn trong trình duyệt của bạn; không có gì được gửi đến máy chủ, và bản đã làm sạch được tạo trên thiết bị của bạn khi bạn tải về.