Ralat biasa dan cara membetulkannya
Kebanyakan masalah tidak menghentikan dokumen: perintah yang tidak dikenali dilangkau dan disenaraikan dalam tab Masalah, formula yang tidak dapat dibaca ditunjukkan dalam warna merah dan dinamakan di situ, dan imej atau petikan yang tiada ditandakan di tempatnya; hanya imej EPS yang menghentikan seluruh dokumen.
Cara masalah dilaporkan
Pemasangan TeX berhenti pada ralat pertama dan bertanya kepada anda apa yang perlu dilakukan. Scissor LaTeX terus berjalan: ia mengatur huruf sebanyak mungkin daripada dokumen dan menyenaraikan apa yang tidak dapat dikendalikannya dalam tab Masalah di bawah pratonton. Setiap entri menunjukkan baris yang dirujuknya jika diketahui, dan mengkliknya akan melompat ke situ.
Terdapat empat jenis hasil:
| Apa yang anda lihat | Maksudnya | Di mana untuk melihat |
|---|---|---|
| Mesej dalam tab Masalah, dokumen baik | Sesuatu telah dilangkau atau ditinggalkan. | Bahagian di bawah. |
| Formula ditunjukkan sebagai kod sumber merah | Formula itu tidak dapat dibaca. | Formula merah |
[key?] merah atau kotak putus-putus kelabu | Petikan atau imej tiada. | Petikan dan imej yang tiada |
| Tiada halaman langsung, ralat di bahagian atas | Seluruh dokumen gagal. | Apabila seluruh dokumen tidak diatur huruf |
"Skipped N unknown commands"
Inilah mesej yang paling kerap anda lihat, dan padanan bagi "Undefined control sequence" dalam LaTeX. Perintah yang tidak dikenali oleh Scissor LaTeX dilangkau: namanya hilang, dan teks dalam kurungan kerintingnya kekal.
Perintah yang tidak dikenali: namanya hilang, teksnya kekal
The value is \highlightvalue{44} and the unit is \unitname{kg}.Tab Masalah: Skipped 2 unknown commands: \highlightvalue, \unitname
Apa yang perlu dilakukan:
- Semak ejaannya.
\textbfberfungsi,\textboldtidak. - Jika perintah itu datang daripada pakej, cari pakej itu dalam halaman pakej. Sesetengah perintah mempunyai pengganti yang mudah.
- Jika ia perintah anda sendiri, pastikan ia ditakrifkan dengan
\newcommandsebelum digunakan (lihat Perintah anda sendiri).
Persekitaran yang tidak dikenali berbeza: ia dibuang secara senyap dan kandungannya kekal, tanpa mesej. Jika teks kelihatan tidak berformat, semak nama persekitarannya.
"Package ... is not available here"
\usepackage tidak pernah gagal. Pakej yang tidak dikenali oleh Scissor LaTeX dicatat dalam tab Masalah, dan pemformatannya tidak dikenakan. Bahagian lain dokumen diatur huruf seperti biasa, dan perintah daripada pakej itu yang tidak dikenali dilaporkan sebagai tidak dikenali.
Pakej yang tidak tersedia
\documentclass{article}
\usepackage{fancyboxes2}
\begin{document}
The document still typesets.
\end{document}Tab Masalah: 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.
Formula merah
Apabila formula mengandungi sesuatu yang tidak dapat dibaca oleh penukar matematik, formula itu ditunjukkan sebagai kod sumber merah. Bahagian lain dokumen tidak terjejas. Tab Masalah menamakan formula itu, barisnya dan sebabnya, seperti "This formula could not be read: \symbf{v} (unknown command: \symbf)"; selepas sepuluh formula, satu baris lagi memberikan bilangan bakinya.
\symbf tidak tersedia, jadi formula itu merah
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.Ditunjukkan merah: formula tidak dapat dibaca, jadi kod sumbernya ditunjukkan sebagai ganti.
Punca biasa dan pembetulannya:
| Punca | Pembetulan |
|---|---|
\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 | Tulis semula formula itu tanpanya. |
$ tanpa pasangannya | Tutup formula itu. $ yang tidak ditutup tidak menjadi merah: ia menukar baki perenggannya menjadi matematik italik yang bercantum, sehingga baris kosong seterusnya. |
Petikan dan imej yang tiada
Kunci petikan yang tiada dalam mana-mana fail .bib dicetak sebagai [key?] merah, dan tab Masalah menyenaraikan kunci yang tiada. Imej yang tiada menjadi kotak putus-putus kelabu dengan nama failnya.
Imej yang tiada dalam projek
\begin{figure}[h]
\centering
\includegraphics[width=0.5\linewidth]{figures/plot.png}
\caption{A plot that has not been uploaded yet.}
\end{figure}
Tab Masalah: Images not in the project: figures/plot.png
Muat naik fail itu ke projek dengan laluan yang sama, atau betulkan laluannya. Tanpa sambungan, fail .png, .jpg, .jpeg dan .svg akan ditemui; rajah PDF dan EPS juga menunjukkan kotak itu (lihat Rajah dan imej). Untuk petikan, lihat Bibliografi dan petikan.
Mesej lain
| Mesej | Maksud | Apa yang perlu dilakukan |
|---|---|---|
| "N included files are not part of this conversion" | \subfile, \import, \lstinputlisting, \inputminted atau \includepdf telah dilangkau. | Gunakan \input, atau tampal kandungannya. |
| "File not found: ..." | \input atau \include menamakan fail yang tiada dalam projek. | Semak laluan dari folder teratas projek. |
| "N pictures of an unsupported kind are not included" | Persekitaran tikzcd, circuitikz, forest atau picture telah ditinggalkan. | Lihat Lukisan dengan TikZ. |
| "TikZ option '...' is not supported yet" | Gambar menggunakan pilihan yang tidak dikenali oleh enjin lukisan. Gambar itu dilukis tanpanya. | Semak pilihan itu, atau tinggalkannya. |
| "Layout in the style of ... Not official." | Kelas atau pakej persidangan bertukar kepada susun atur yang menyerupai. | Tiada; ini hanya maklumat. |
| "Macro expansion stopped at the safety limit" | Sesuatu perintah berkembang menjadi dirinya sendiri, atau menjadi teks yang sangat banyak. | Cari \newcommand yang menggunakan namanya sendiri. |
| "This formula could not be read: ..." | Formula itu ditunjukkan dalam warna merah; sebabnya ada dalam kurungan. | Lihat Formula merah. |
| "References to labels that do not exist (shown as ??): ..." | \ref, \eqref, \pageref atau \cref menamakan label yang tidak ditakrifkan, atau label pada formula merah. | Semak ejaan label itu. |
| "Bibliography style ... is not available; using numbered references [1] instead" | \bibliographystyle menamakan gaya yang tiada dalam senarai, seperti alpha. | Pilih gaya daripada senarai, atau kekalkan rujukan bernombor. |
| "Skipped .bib entries: ..." | Entri fail .bib ini tidak dapat dibaca (kurungan tiada, kunci pendua); yang lain digunakan. | Betulkan entri pada baris yang diberikan. |
Ralat LaTeX yang tidak akan anda lihat di sini
Sesetengah ralat LaTeX klasik tidak menghentikan apa-apa dalam Scissor LaTeX, menjadikannya mudah terlepas pandang:
| Ralat LaTeX | Apa yang dilakukan Scissor LaTeX |
|---|---|
"Missing $ inserted" untuk x_1 dalam teks | Mencetak x_1 secara literal. Letakkan matematik dalam $...$. |
| "Misplaced alignment tab character &" | Mencetak & secara literal. Tulis \& untuk ampersand. |
| "Extra }, or forgotten $" | Mengabaikan kurungan yang tidak seimbang. |
| "\begin{itemize} ended by \end{document}" | Menutup persekitaran itu untuk anda. |
| "Reference ... undefined" | Mencetak ?? tebal; tab Masalah menyenaraikan label yang tiada. |
Teks yang akan ditolak oleh LaTeX
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.Dokumen ini mungkin masih gagal dalam pemasangan TeX, jadi betulkannya walaupun pratonton kelihatan baik.
Perbezaan daripada pemasangan TeX
Untuk senarai semak mengikut gejala, lihat Penyelesaian masalah.
Soalan dan jawapan
Apakah maksud "Undefined control sequence"?
LaTeX tidak mengenali sesuatu perintah, biasanya kerana salah taip atau pakej yang tiada. Dalam Scissor LaTeX, situasi yang sama muncul sebagai "Skipped N unknown commands" dalam tab Masalah, dan dokumen itu masih diatur huruf.
Mengapakah formula saya merah?
Formula itu mengandungi perintah yang tidak dikenali oleh penukar matematik, seperti \symbf atau \abs. Tab Masalah menamakannya. Gantikan perintah itu; jadual pada halaman ini menyenaraikan pengganti yang biasa.
Mengapakah saya melihat [key?] dalam dokumen saya?
Kunci petikan itu tiada dalam mana-mana fail .bib projek. Semak ejaannya dan pastikan fail .bib telah dimuat naik.
Setiap contoh di halaman ini disusun atur oleh Scissor LaTeX semasa laman dibina. Kali terakhir dikemas kini 2026-11-07.