Belajar LaTeX - Troubleshooting & Common Issues

#Pendahuluan

Setelah di episode 25 kita memilih alat kerja, pada episode ini kita menghadapi kenyataan yang tak terelakkan: error. Semua penulis LaTeX, dari pemula hingga veteran, menghadapi error — yang membedakan adalah kemampuan menanganinya dengan cepat.

Kita akan membedah masalah paling umum yang muncul dalam pengalaman menulis LaTeX: file hilang, perintah tak dikenal, baris terlalu lebar, backend bibliografi, frame beamer yang meluber, dan masalah encoding. Untuk tiap masalah, ada diagnosis singkat dan solusi praktis yang bisa langsung kalian terapkan.

#"File 'x.sty' not found"

Error klasik:

text

! LaTeX Error: File 'amsmath.sty' not found.

Artinya: package yang kalian minta (\usepackage{amsmath}) tidak terinstall di distribusi.

Solusi: install package lewat manajer distribusi:

Instal package di TeX Live

tlmgr install amsmath

Di MiKTeX, auto-install package biasanya menawarkan mengunduh otomatis saat kompilasi. Di Overleaf, package sudah lengkap — error ini jarang terjadi; pastikan penulisan nama package benar.

Tip

Sebelum tlmgr install, pastikan nama package persis seperti di CTAN. Kadang nama package ≠ nama .sty (ekstensi library). Error ini juga bisa berarti typo di \usepackage — periksa ejaannya dulu.

#Undefined control sequence

text

! Undefined control sequence.
l.7 \section{Pendahuluan\emph{}
 
?

Artinya: LaTeX menemukan perintah yang tidak dikenal — typo, makro belum didefinisikan, atau package yang menyediakan perintah belum dimuat.

Solusi:

Periksa ejaan (\section vs \sectionx).
Pastikan package yang menyediakan perintah dimuat (mis. \mathbb butuh amssymb; \SI butuh siunitx).
Bila memakai \newcommand sendiri, pastikan sudah didefinisikan sebelum dipakai.

Sering error ini adalah rantai: satu huruf salah ketik menyebabkan seluruh blok tersasar. Perbaiki yang pertama, kompilasi ulang.

#Overfull \hbox

text

Overfull \hbox (12.5pt too wide) in paragraph at lines 4--5

Artinya: sebuah baris/box melebihi lebar yang diizinkan, biasanya karena kata/URL panjang tanpa titik pecah, atau tabel/gambar terlalu lebar. Ini peringatan, bukan error fatal.

Solusi:

Untuk URL: muat \usepackage{url} atau \usepackage{hyperref} agar URL bisa dipecah.
Untuk teks: gunakan \sloppy pada paragraf tertentu, atau \raggedright bila justify tidak krusial.
Untuk tabel: kurangi lebar (pakai tabularx dengan kolom X, episode 6/15) atau perkecil font tabel.
Kata kustom: \hyphenation{ke-ta} untuk memberi titik pecah.

#Biber not found / "Compiler longer"

text

Can't find "biber" executable

Artinya: kalian memakai biblatex dengan backend biber, tetapi binary biber tidak terinstall.

Solusi: install biber:

Instal biber

tlmgr install biber

Penting juga menjalankan kompilasi dengan urutan benar. Cara terbaik: pakai latexmk yang otomatis menjalankan biber bila mendeteksi biblatex:

Kompilasi dengan biblatex via latexmk

latexmk -pdf -pdflatex="lualatex %O %S" main.tex

Warning

Jangan campur bibtex dengan \usepackage{biblatex} yang memakai biber. Jika ingin BibTeX, gunakan \bibliographystyle + \bibliography (bukan biblatex). Mencampurnya menyebabkan error bibliografi yang sulit dilacak.

#Frame Beamer Terlalu Panjang

text

! Dimension too large.  (di dalam frame beamer)

Artinya: isi frame melebihi tinggi slide.

Solusi: tambahkan opsi allowframebreaks untuk membagi isi otomatis ke beberapa slide:

latex

\begin{frame}[allowframebreaks]{Judul Panjang}
    banyak konten...
\end{frame}

Untuk kode dengan karakter khusus, pastikan pakai [fragile] (episode 11). Atau pecah manual menjadi beberapa frame yang lebih pendek.

#Masalah Encoding Windows

Di Windows (atau file yang disimpan dengan encoding berbeda), karakter seperti é, —, atau tanda kutip bisa muncul rusak.

text

! Package inputenc Error: Unicode character ...

Solusi (modern): hindari inputenc lama untuk Unicode. Gunakan engine XeLaTeX/LuaLaTeX yang menangani Unicode murni (episode 13):

latex

\usepackage{fontspec}

Simpan file sebagai UTF-8 di editor (kebanyakan editor default sudah UTF-8). Dengan fontspec + engine Unicode, kalian tidak memerlukan inputenc — karakter langsung ditulis apa adanya.

#Ringkasan Solusi Cepat

Masalah	Solusi
File `.sty` tidak ditemukan	`tlmgr install <package>` / periksa ejaan
Undefined control sequence	Cek typo & package; definisikan makro
Overfull `\hbox`	`url`, `\sloppy`, `\raggedright`, kurangi lebar
Biber not found	`tlmgr install biber`; pakai `latexmk`
Frame beamer panjang	`[allowframebreaks]` / pecah frame
Encoding Windows	`fontspec` + Xe/LuaLaTeX, simpan UTF-8

Note

Aturan emas dari episode 19 berlaku juga di sini: kompilasi sering, baca error dari yang pertama, perbaiki satu per satu. Kebanyakan "mendadak error banyak" adalah rantai dari satu akar masalah — jangan panik.

#Penutup

Pada episode 26 ini, kalian telah menguasai troubleshooting.

Inti yang harus dibawa pulang:

File not found → tlmgr install atau periksa nama package.
Undefined control sequence → typo & package yang belum dimuat.
Overfull hbox → url, \sloppy, \raggedright, kurangi lebar.
Biber not found → tlmgr install biber, pakai latexmk.
Frame beamer panjang → [allowframebreaks].
Encoding Windows → fontspec + Xe/LuaLaTeX, simpan UTF-8.

Di episode 27 selanjutnya — episode penutup — kita akan melakukan studi kasus & refleksi: merangkum seluruh alur belajar, membuat paper 4 halaman + presentasi Beamer + PDF bertag, dan merefleksikan mengapa LaTeX adalah investasi jangka panjang. Sampai jumpa di episode 27!