Chú thích khớp với số hiệu

Đặt label sau caption để số hiệu khớp.

Chú thích khớp với số hiệu

Tham chiếu chéo là một trong những việc LaTeX làm tốt hơn trình soạn thảo văn bản thông thường. Bạn không bao giờ gõ tay “Hình 3”. Thay vào đó, bạn gắn một nhãn vào hình và để LaTeX điền số hiệu ở mọi chỗ được nhắc đến, nên các con số luôn đúng dù bạn sắp xếp lại, chèn thêm hay xóa bớt bao nhiêu. Cơ chế này có một quy tắc mà gần như ai cũng vấp ít nhất một lần: thứ tự của \caption và \label rất quan trọng.

Vì sao thứ tự quan trọng

Lệnh \caption làm hai việc. Nó in chữ chú thích bên dưới hình hoặc bảng của bạn, và nó tăng bộ đếm, biến float này thành Hình 3. Lệnh \label làm một việc đơn giản hơn nhiều so với người ta tưởng: nó ghi lại con số nào được gán gần đây nhất, dù con số đó là gì. Nó không hề biết mình đang “ở trong một hình”. Vì vậy label phải đặt sau caption:

\caption{A neat diagram.}
\label{fig:neat}

Nếu bạn đặt \label trước \caption, caption chưa tăng bộ đếm hình, nên label ghi lại con số gần nhất đến từ một nơi hoàn toàn khác, thường là mục hiện tại. Khi đó văn bản của bạn viết “xem Hình 2.4” trong khi hình thực ra là Hình 7. Đây là triệu chứng kinh điển: tham chiếu trỏ tới số mục thay vì số hình hầu như luôn nghĩa là label bị đặt quá sớm. Thói quen an toàn nhất là viết \label ở dòng ngay sau \caption, lần nào cũng vậy, cho cả hình lẫn bảng.

Tham chiếu đến label

Trong văn bản, hãy viết tham chiếu như sau:

Figure~\ref{fig:neat}

\ref{fig:neat} được khai triển thành con số trần, còn chữ “Hình” do bạn tự thêm. Dấu ~ giữa chúng là một khoảng trắng không ngắt dòng, giúp LaTeX không bao giờ kết thúc dòng ngay sau chữ “Hình” rồi bắt đầu dòng kế tiếp bằng “3”. Các tiền tố như fig:, tab:, sec: và eq: hoàn toàn chỉ là quy ước, LaTeX không diễn giải chúng, nhưng chúng giữ cho label dễ đọc và tránh việc một hình và một bảng vô tình trùng tên.

Lưu ý rằng \pageref{fig:neat} cho ra số trang mà hình rơi vào, hữu ích trong các tài liệu dài, nơi một float có thể trôi rất xa khỏi chỗ được nhắc đến. Để xem đầy đủ các lệnh tham chiếu, hãy đọc giải thích mọi lệnh.

Biên dịch hai lần và những cái bẫy khác

Tham chiếu được giải quyết qua nhiều lần chạy trình biên dịch: lượt đầu ghi vị trí của các label vào tệp .aux, và lượt thứ hai đọc chúng lại. Cho đến lượt thứ hai đó, các tham chiếu được in thành dấu hỏi chấm đậm, nên ?? trong PDF của bạn thường chỉ có nghĩa là “hãy biên dịch lại”, chứ không phải có gì đó hỏng. Phần lớn trình soạn thảo, kể cả Oleafly, tự chạy lại các lượt cho bạn. Nếu ?? vẫn còn sau nhiều lần biên dịch, thì label đó không tồn tại. Nguyên nhân có thể là gõ sai tên label, hoặc một \caption bạn đã xóa mà để sót \label lại.

Quay lại Float và mực