Các lỗi thường gặp và cách khắc phục
Phần lớn sự cố không làm tài liệu dừng lại: lệnh không xác định bị bỏ qua và được liệt kê trong thẻ Sự cố, công thức không đọc được hiển thị màu đỏ và được nêu tên ở đó, còn hình ảnh hoặc trích dẫn bị thiếu được đánh dấu tại chỗ; chỉ một hình ảnh EPS mới làm toàn bộ tài liệu dừng lại.
Sự cố được báo cáo như thế nào
Một bản cài đặt TeX dừng lại ở lỗi đầu tiên và hỏi bạn phải làm gì. Scissor LaTeX thì tiếp tục: nó dàn trang được càng nhiều phần của tài liệu càng tốt và liệt kê những gì nó không xử lý được trong thẻ Sự cố bên dưới bản xem trước. Mỗi mục có kèm dòng mà nó đề cập khi biết được, và nhấp vào mục sẽ chuyển đến dòng đó.
Có bốn loại kết quả:
| Bạn thấy gì | Điều đó có nghĩa là gì | Xem ở đâu |
|---|---|---|
| Một thông báo trong thẻ Sự cố, tài liệu vẫn ổn | Có gì đó đã bị bỏ qua hoặc bị lược đi. | Các mục bên dưới. |
| Một công thức hiển thị dưới dạng mã nguồn màu đỏ | Công thức đó không đọc được. | Công thức màu đỏ |
Một [key?] màu đỏ hoặc một hộp viền nét đứt màu xám | Thiếu một trích dẫn hoặc một hình ảnh. | Trích dẫn và hình ảnh bị thiếu |
| Không có trang nào, một lỗi ở phía trên | Toàn bộ tài liệu đã thất bại. | Khi toàn bộ tài liệu không dàn trang được |
"Skipped N unknown commands" (bỏ qua N lệnh không xác định)
Đây là thông báo bạn sẽ thấy thường xuyên nhất, và là bản tương ứng với "Undefined control sequence" của LaTeX. Một lệnh mà Scissor LaTeX không biết sẽ bị bỏ qua: tên của nó biến mất, còn văn bản trong dấu ngoặc nhọn được giữ lại.
Một lệnh không xác định: tên mất đi, văn bản được giữ lại
The value is \highlightvalue{44} and the unit is \unitname{kg}.Thẻ Sự cố: Skipped 2 unknown commands: \highlightvalue, \unitname
Cách xử lý:
- Kiểm tra chính tả.
\textbfhoạt động,\textboldthì không. - Nếu lệnh đến từ một gói, hãy tra gói đó trong các trang về gói lệnh. Một số lệnh có cách thay thế đơn giản.
- Nếu đó là lệnh của riêng bạn, hãy kiểm tra xem nó đã được định nghĩa bằng
\newcommandtrước khi dùng chưa (xem Lệnh của riêng bạn).
Một môi trường không xác định thì khác: nó bị loại bỏ mà không báo gì và nội dung của nó được giữ lại, không có thông báo. Nếu văn bản trông như chưa được định dạng, hãy kiểm tra tên môi trường.
"Package ... is not available here" (gói không có sẵn ở đây)
\usepackage không bao giờ thất bại. Một gói mà Scissor LaTeX không biết sẽ được ghi chú trong thẻ Sự cố, và định dạng của nó không được áp dụng. Phần còn lại của tài liệu vẫn dàn trang như thường, và các lệnh không xác định từ gói đó được báo là lệnh không xác định.
Một gói không có sẵn
\documentclass{article}
\usepackage{fancyboxes2}
\begin{document}
The document still typesets.
\end{document}Thẻ Sự cố: Package fancyboxes2 isn't supported in the preview, so its formatting is not applied. If it is your own package, add fancyboxes2.sty to the project.
Công thức màu đỏ
Khi một công thức chứa thứ mà bộ chuyển đổi toán không đọc được, công thức đó hiển thị dưới dạng mã nguồn màu đỏ. Phần còn lại của tài liệu không bị ảnh hưởng. Thẻ Sự cố nêu tên công thức, dòng của nó và lý do, chẳng hạn "This formula could not be read: \symbf{v} (unknown command: \symbf)"; sau mười công thức, một dòng nữa cho biết số lượng còn lại.
\symbf không có sẵn, nên công thức có màu đỏ
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.Hiển thị màu đỏ: không đọc được công thức, nên mã nguồn của nó được hiển thị thay thế.
Nguyên nhân thường gặp và cách khắc phục:
| Nguyên nhân | Cách khắc phục |
|---|---|
\abs{x}, \norm{x}, \dv{f}{x} (physics) | \left\lvert x \right\rvert, \left\lVert x \right\rVert, \frac{df}{dx} |
\SI{44}{\kilo\gram} (siunitx) | 44\,\mathrm{kg} |
\sideset | Viết lại công thức mà không dùng nó. |
Một $ thiếu dấu đóng tương ứng | Đóng công thức lại. Một $ chưa đóng không làm công thức đỏ: nó biến phần còn lại của đoạn thành toán in nghiêng dính liền, cho đến dòng trống tiếp theo. |
Trích dẫn và hình ảnh bị thiếu
Một khóa trích dẫn không có trong tệp .bib nào được in thành [key?] màu đỏ, và thẻ Sự cố liệt kê các khóa bị thiếu. Một hình ảnh bị thiếu trở thành một hộp viền nét đứt màu xám kèm tên tệp.
Một hình ảnh không có trong dự án
\begin{figure}[h]
\centering
\includegraphics[width=0.5\linewidth]{figures/plot.png}
\caption{A plot that has not been uploaded yet.}
\end{figure}
Thẻ Sự cố: Images not in the project: figures/plot.png
Hãy tải tệp lên dự án với cùng đường dẫn, hoặc sửa lại đường dẫn. Khi không có phần mở rộng, các tệp .png, .jpg, .jpeg và .svg sẽ được tìm thấy; hình PDF và EPS cũng hiển thị hộp này (xem Hình và ảnh). Về trích dẫn, xem Tài liệu tham khảo và trích dẫn.
Các thông báo khác
| Thông báo | Ý nghĩa | Cách xử lý |
|---|---|---|
| "N included files are not part of this conversion" | \subfile, \import, \lstinputlisting, \inputminted hoặc \includepdf đã bị bỏ qua. | Dùng \input, hoặc dán nội dung vào. |
| "File not found: ..." | Một \input hoặc \include nêu tên một tệp không có trong dự án. | Kiểm tra đường dẫn tính từ thư mục gốc của dự án. |
| "N pictures of an unsupported kind are not included" | Một môi trường tikzcd, circuitikz, forest hoặc picture đã bị lược đi. | Xem Vẽ hình với TikZ. |
| "TikZ option '...' is not supported yet" | Một hình vẽ dùng tùy chọn mà bộ máy vẽ không biết. Hình được vẽ mà không có tùy chọn đó. | Kiểm tra tùy chọn, hoặc bỏ nó đi. |
| "Layout in the style of ... Not official." | Một lớp hoặc gói hội nghị đã chuyển sang bố cục mô phỏng. | Không cần làm gì; đây chỉ là thông tin. |
| "Macro expansion stopped at the safety limit" | Một lệnh khai triển thành chính nó, hoặc thành một lượng văn bản khổng lồ. | Tìm một \newcommand dùng chính tên của nó. |
| "This formula could not be read: ..." | Công thức hiển thị màu đỏ; lý do nằm trong ngoặc. | Xem Công thức màu đỏ. |
| "References to labels that do not exist (shown as ??): ..." | Một \ref, \eqref, \pageref hoặc \cref nêu tên một nhãn chưa được định nghĩa, hoặc một nhãn nằm trên công thức màu đỏ. | Kiểm tra chính tả của nhãn. |
| "Bibliography style ... is not available; using numbered references [1] instead" | \bibliographystyle nêu tên một kiểu không có trong danh sách, như alpha. | Chọn một kiểu trong danh sách, hoặc giữ tài liệu tham khảo đánh số. |
| "Skipped .bib entries: ..." | Những mục này của tệp .bib không đọc được (thiếu dấu ngoặc nhọn, khóa trùng lặp); các mục khác vẫn được dùng. | Sửa mục tại dòng được nêu. |
Những lỗi LaTeX bạn sẽ không thấy ở đây
Một số lỗi LaTeX kinh điển không làm dừng gì trong Scissor LaTeX, nên rất dễ bị bỏ sót:
| Lỗi LaTeX | Scissor LaTeX làm gì |
|---|---|
"Missing $ inserted" với x_1 trong văn bản | In nguyên văn x_1. Hãy đặt toán trong $...$. |
| "Misplaced alignment tab character &" | In nguyên văn &. Viết \& để có dấu và (ampersand). |
| "Extra }, or forgotten $" | Bỏ qua các dấu ngoặc nhọn không cân bằng. |
| "\begin{itemize} ended by \end{document}" | Tự đóng môi trường giúp bạn. |
| "Reference ... undefined" | In ?? đậm; thẻ Sự cố liệt kê các nhãn bị thiếu. |
Văn bản mà LaTeX sẽ từ chối
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.Những tài liệu này vẫn có thể thất bại trong một bản cài đặt TeX, vì vậy hãy sửa chúng dù bản xem trước trông vẫn ổn.
Khác biệt so với một bản cài đặt TeX
Để có danh sách kiểm tra theo triệu chứng, xem Khắc phục sự cố.
Hỏi và đáp
"Undefined control sequence" có nghĩa là gì?
LaTeX không biết một lệnh, thường là do gõ sai hoặc thiếu gói. Trong Scissor LaTeX, tình huống tương tự hiển thị là "Skipped N unknown commands" trong thẻ Sự cố, và tài liệu vẫn được dàn trang.
Vì sao công thức của tôi có màu đỏ?
Công thức chứa một lệnh mà bộ chuyển đổi toán không biết, như \symbf hoặc \abs. Thẻ Sự cố nêu tên lệnh đó. Hãy thay lệnh đó; bảng trên trang này liệt kê các cách thay thế thường gặp.
Vì sao tôi thấy [key?] trong tài liệu?
Khóa trích dẫn không có trong tệp .bib nào của dự án. Hãy kiểm tra chính tả và kiểm tra xem tệp .bib đã được tải lên chưa.
Mọi ví dụ trên trang này đều được Scissor LaTeX dàn trang khi xây dựng trang web. Cập nhật lần cuối 2026-11-07.