Kesalahan umum dan cara memperbaikinya
Sebagian besar masalah tidak menghentikan dokumen: perintah yang tidak dikenal dilewati dan dicantumkan di tab Masalah, rumus yang tidak bisa dibaca ditampilkan merah dan disebutkan di sana, serta gambar atau sitasi yang hilang ditandai di tempatnya; hanya gambar EPS yang menghentikan seluruh dokumen.
Cara masalah dilaporkan
Instalasi TeX berhenti pada kesalahan pertama dan menanyakan apa yang harus dilakukan. Scissor LaTeX terus berjalan: ia menata sebanyak mungkin bagian dokumen dan mencantumkan apa yang tidak bisa ditanganinya di tab Masalah di bawah pratinjau. Setiap entri menyertakan baris yang dimaksud jika baris itu diketahui, dan mengkliknya akan melompat ke sana.
Ada empat jenis hasil:
| Yang Anda lihat | Artinya | Tempat melihat |
|---|---|---|
| Pesan di tab Masalah, dokumen baik-baik saja | Ada yang dilewati atau dihilangkan. | Bagian-bagian di bawah. |
| Rumus yang ditampilkan sebagai kode sumber merah | Rumus itu tidak bisa dibaca. | Rumus merah |
[key?] merah atau kotak putus-putus abu-abu | Sebuah sitasi atau gambar hilang. | Sitasi dan gambar yang hilang |
| Tidak ada halaman sama sekali, ada kesalahan di atas | Seluruh dokumen gagal. | Saat seluruh dokumen tidak bisa ditata |
"Skipped N unknown commands"
Ini pesan yang paling sering Anda lihat, dan padanan dari "Undefined control sequence" di LaTeX. Perintah yang tidak dikenal Scissor LaTeX dilewati: namanya hilang, dan teks di dalam kurung kurawalnya tetap ada.
Perintah yang tidak dikenal: namanya hilang, teksnya tetap
The value is \highlightvalue{44} and the unit is \unitname{kg}.Tab Masalah: Skipped 2 unknown commands: \highlightvalue, \unitname
Yang perlu dilakukan:
- Periksa ejaannya.
\textbfberfungsi,\textboldtidak. - Jika perintah itu berasal dari sebuah paket, cari paketnya di halaman-halaman paket. Sebagian perintah memiliki pengganti yang sederhana.
- Jika itu perintah Anda sendiri, pastikan perintah itu didefinisikan dengan
\newcommandsebelum dipakai (lihat Perintah Anda sendiri).
Lingkungan yang tidak dikenal berbeda: lingkungan itu dihapus diam-diam dan isinya tetap, tanpa pesan. Jika teks tampak tidak berformat, periksa nama lingkungannya.
"Package ... is not available here"
\usepackage tidak pernah gagal. Paket yang tidak dikenal Scissor LaTeX dicatat di tab Masalah, dan formatnya tidak diterapkan. Bagian dokumen lainnya ditata seperti biasa, dan perintah dari paket itu yang tidak dikenal dilaporkan sebagai tidak dikenal.
Paket 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.
Rumus merah
Jika sebuah rumus berisi sesuatu yang tidak bisa dibaca oleh pengonversi matematika, rumus itu ditampilkan sebagai kode sumber merah. Bagian dokumen lainnya tidak terpengaruh. Tab Masalah menyebutkan rumusnya, barisnya, dan alasannya, seperti "This formula could not be read: \symbf{v} (unknown command: \symbf)"; setelah sepuluh rumus, satu baris tambahan memberikan jumlah sisanya.
\symbf tidak tersedia, jadi rumusnya merah
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.Ditampilkan merah: rumus tidak dapat dibaca, jadi kode sumbernya yang ditampilkan.
Penyebab umum dan perbaikannya:
| Penyebab | Perbaikan |
|---|---|
\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 ulang rumusnya tanpa perintah itu. |
$ tanpa pasangannya | Tutup rumusnya. $ yang tidak ditutup tidak menjadi merah: ia mengubah sisa paragrafnya menjadi matematika miring yang menyatu, sampai baris kosong berikutnya. |
Sitasi dan gambar yang hilang
Kunci sitasi yang tidak ada di file .bib mana pun tercetak sebagai [key?] merah, dan tab Masalah mencantumkan kunci-kunci yang hilang. Gambar yang hilang menjadi kotak putus-putus abu-abu berisi nama file.
Gambar yang tidak ada di proyek
\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
Unggah file itu ke proyek dengan path yang sama, atau perbaiki path-nya. Tanpa ekstensi, file .png, .jpg, .jpeg, dan .svg akan ditemukan; gambar PDF dan EPS juga menampilkan kotak tersebut (lihat Gambar dan citra). Untuk sitasi, lihat Daftar pustaka dan sitasi.
Pesan lain
| Pesan | Artinya | Yang perlu dilakukan |
|---|---|---|
| "N included files are not part of this conversion" | \subfile, \import, \lstinputlisting, \inputminted, atau \includepdf dilewati. | Pakai \input, atau tempel isinya langsung. |
| "File not found: ..." | \input atau \include menyebut file yang tidak ada di proyek. | Periksa path-nya dari folder teratas proyek. |
| "N pictures of an unsupported kind are not included" | Lingkungan tikzcd, circuitikz, forest, atau picture dihilangkan. | Lihat Ilustrasi dengan TikZ. |
| "TikZ option '...' is not supported yet" | Sebuah gambar memakai opsi yang tidak dikenal mesin gambar. Gambarnya digambar tanpa opsi itu. | Periksa opsinya, atau hilangkan. |
| "Layout in the style of ... Not official." | Kelas atau paket konferensi beralih ke tata letak tiruan. | Tidak perlu apa-apa; ini sekadar informasi. |
| "Macro expansion stopped at the safety limit" | Sebuah perintah mengembang menjadi dirinya sendiri, atau menjadi teks yang sangat banyak. | Cari \newcommand yang memakai namanya sendiri. |
| "This formula could not be read: ..." | Rumusnya ditampilkan merah; alasannya ada di dalam kurung. | Lihat Rumus merah. |
| "References to labels that do not exist (shown as ??): ..." | \ref, \eqref, \pageref, atau \cref menyebut label yang tidak didefinisikan, atau label pada rumus merah. | Periksa ejaan labelnya. |
| "Bibliography style ... is not available; using numbered references [1] instead" | \bibliographystyle menyebut gaya yang tidak ada di daftar, seperti alpha. | Pilih gaya dari daftar, atau tetap pakai referensi bernomor. |
| "Skipped .bib entries: ..." | Entri-entri file .bib ini tidak bisa dibaca (kurung kurawal hilang, kunci ganda); entri lainnya tetap dipakai. | Perbaiki entri di baris yang disebutkan. |
Kesalahan LaTeX yang tidak akan Anda lihat di sini
Beberapa kesalahan LaTeX klasik tidak menghentikan apa pun di Scissor LaTeX, sehingga mudah terlewat:
| Kesalahan LaTeX | Yang dilakukan Scissor LaTeX |
|---|---|
"Missing $ inserted" untuk x_1 di teks | Mencetak x_1 apa adanya. Letakkan matematika di dalam $...$. |
| "Misplaced alignment tab character &" | Mencetak & apa adanya. Tulis \& untuk tanda ampersand. |
| "Extra }, or forgotten $" | Mengabaikan kurung kurawal yang tidak seimbang. |
| "\begin{itemize} ended by \end{document}" | Menutup lingkungan itu untuk Anda. |
| "Reference ... undefined" | Mencetak ?? tebal; tab Masalah mencantumkan label yang hilang. |
Teks yang akan ditolak LaTeX
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.Dokumen seperti ini mungkin tetap gagal di instalasi TeX, jadi perbaikilah meskipun pratinjaunya tampak baik.
Apa yang berbeda dari instalasi TeX
Untuk daftar periksa berdasarkan gejala, lihat Pemecahan masalah.
Tanya jawab
Apa arti "Undefined control sequence"?
LaTeX tidak mengenal sebuah perintah, biasanya karena salah ketik atau paket yang belum dimuat. Di Scissor LaTeX, situasi yang sama muncul sebagai "Skipped N unknown commands" di tab Masalah, dan dokumennya tetap ditata.
Mengapa rumus saya merah?
Rumus itu berisi perintah yang tidak dikenal pengonversi matematika, seperti \symbf atau \abs. Tab Masalah menyebutkannya. Ganti perintah itu; tabel di halaman ini mencantumkan pengganti yang umum.
Mengapa saya melihat [key?] di dokumen saya?
Kunci sitasinya tidak ada di file .bib mana pun di proyek. Periksa ejaannya dan pastikan file .bib sudah diunggah.
Setiap contoh di halaman ini ditata oleh Scissor LaTeX saat situs dibuat. Terakhir diperbarui 2026-11-07.