Tệp lớp của trường đại học không biên dịch được
Phân loại ưu tiên: lỗi đầu tiên, engine, gói lỗi thời, tìm kiếm nhị phân.
Tệp lớp của trường đại học không biên dịch được
Mẫu luận văn của trường đại học là một dạng mã kế thừa đặc biệt. Một sinh viên cao học đã viết tệp lớp cách đây mười lăm năm cho bản phân phối TeX thời đó, rồi tốt nghiệp và để nó đóng băng trong khi hệ sinh thái LaTeX vẫn tiến lên. Khi hôm nay bạn tải universitythesis.cls về và nó báo cả màn hình lỗi, thường thì tệp lớp không hẳn bị hỏng mà chỉ bị mắc kẹt trong thời gian. Dù vậy, các kiểu lỗi có thể đoán trước được, và một thứ tự phân loại cố định sẽ giải quyết phần lớn chúng.
Chỉ bắt đầu từ lỗi đầu tiên
Lỗi LaTeX lan truyền theo tầng: một lệnh chưa được định nghĩa ở đầu tệp lớp có thể sinh ra hàng chục lỗi phía sau vô nghĩa. Hãy cuộn nhật ký đến dòng đầu tiên bắt đầu bằng !, sửa lỗi đó rồi biên dịch lại trước khi đọc bất cứ thứ gì khác. Lặp lại vòng này thường xóa sạch bức tường lỗi đáng sợ chỉ sau ba hoặc bốn lượt. Nếu lỗi đầu tiên là một lệnh không xác định, bài Trình tự điều khiển không xác định sẽ hướng dẫn cách chẩn đoán.
Kiểm tra engine
Nhiều mẫu giả định một engine cụ thể và hỏng một cách kỳ quặc trên bất kỳ engine nào khác. Một tệp lớp nạp fontspec hoặc đặt phông chữ theo tên đòi hỏi XeLaTeX hoặc LuaLaTeX; một tệp lớp xây quanh các primitive riêng của pdftex có thể hỏng trên cả hai. Hãy tìm một chú thích gần đầu tệp lớp, hoặc một dòng trong hướng dẫn của trường nêu tên engine dự kiến, và chọn khớp với nó trước khi gỡ lỗi bất cứ điều gì khác. Sự khác biệt được tóm tắt trong Chọn engine nào cho dự án này.
Hiện đại hóa phần bạn kiểm soát
Các mẫu cũ nạp những gói lỗi thời trong khi bản thay thế hiện đại của chúng đã có sẵn trong bản phân phối của bạn, và hai bên sẽ xung đột nhau; Các gói xung đột với nhau liệt kê những cặp kinh điển. Chiến lược khả thi là để nguyên tệp lớp, vì các yêu cầu định dạng của trường nằm ở đó, và chỉ hiện đại hóa phần mở đầu của riêng bạn: xóa các dòng \usepackage lỗi thời, nạp hyperref muộn, và tránh nạp lại bất cứ thứ gì tệp lớp đã nạp.
Tìm kiếm nhị phân trong phần mở đầu
Khi lỗi không chịu lộ ra khi soi, hãy chú thích (comment out) nửa sau của phần mở đầu rồi biên dịch lại. Nếu lỗi biến mất, thủ phạm nằm ở nửa đã chú thích; hãy khôi phục một nửa của nó và lặp lại. Chỉ cần vài lần biên dịch là cô lập được dòng gây lỗi, nhanh hơn nhiều so với việc suy luận về một phần mở đầu mà bạn không viết.
Tìm kiếm trước khi chịu khổ
Mọi sinh viên ở trường đó đều biên dịch cùng một tệp lớp, nên lỗi của bạn gần như chắc chắn đã có người gặp. Hãy tìm đúng thông báo lỗi cùng với tên tệp lớp, và kiểm tra xem trường hoặc một sinh viên khóa sau có duy trì một bản fork đã vá trên GitHub hay không. Dùng một bản fork còn được duy trì, nếu có, tốt hơn việc tự sửa lại các lỗi đã biết.