> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/id/basis-pengetahuan/138-understanding-underfull-and-overfull-box-warnings.md). # Memahami peringatan kotak underfull dan overfull ## Pendahuluan Setelah menata letak dokumen LaTeX, Overleaf sering menampilkan pesan yang melaporkan sebuah underfull atau overfull `\hbox` (atau `\vbox`), bersama dengan yang disebut `badness` nilai untuk kotak underfull atau jumlah kelebihan kotak overfull. Pertama-tama, penting untuk dicatat bahwa pesan-pesan ini bukanlah kesalahan—[lihat di bawah untuk detail lebih lanjut](#overfull-or-underfull-boxes-are-not-errors). Pesan-pesan ini adalah *peringatan* atau, lebih tepatnya, “pesan diagnostik” yang berasal dari dalam mesin TeX yang digunakan untuk menata letak dokumen LaTeX Anda. Dalam artikel bantuan ini kami akan memberikan latar belakang pengantar mengenai sumber dan penyebab pesan-pesan tersebut dan mencantumkan beberapa masalah umum beserta solusi yang disarankan. Bagi pembaca yang tertarik pada detail lebih lanjut, kami telah menerbitkan artikel pendamping di Galeri Overleaf: [Menjelajahi kotak underfull atau overfull dan perhitungan badness](https://www.overleaf.com/latex/examples/exploring-underfull-or-overfull-boxes-and-badness-calculations/wpfsjnbkrfhv). Daftar sumber daya tambahan juga dapat ditemukan [di akhir artikel ini](#further-reading). ## Apakah proyek saya memiliki peringatan overfull atau underfull? Untuk memeriksa apakah proyek Anda melaporkan peringatan ini, Anda perlu mengeklik ikon yang ditunjukkan pada tangkapan layar di bawah. Meskipun dokumen Anda mungkin telah dikompilasi tanpa kesalahan, sangat umum melihat pesan-pesan ini dan siapa pun yang masih baru mengenal TeX/LaTeX mungkin bertanya-tanya apa artinya dan apakah mereka perlu mengkhawatirkannya. ![Gambar layar yang menunjukkan Overleaf melaporkan kotak underfull atau overfull](/files/7f4273bc5a06e622d2f20b0a2cd3f7993ab1b12e) Saat menata letak dokumen, LaTeX akan mencoba membuat bagian-bagian konten Anda pas dalam batas “ukuran” tertentu; misalnya, saat menata paragraf dan memecah baris ke panjang tertentu—paling mudah didemonstrasikan dengan menggunakan perintah seperti `\parbox`. Jika kita mencoba menata letak paragraf berikut menggunakan lebar baris 50pt: ```latex \parbox{50pt}{Some text typeset using a \texttt{\string\parbox}} ``` Overleaf melaporkan dua `Underfull \hbox...` peringatan: ![Gambar layar yang menunjukkan Overleaf melaporkan kotak underfull](/files/67200542967d5d26a00588c7a6e721a2cbd02abd) Pesan-pesan ini `Underfull \hbox...` peringatan ini muncul karena mesin TeX tidak dapat menghasilkan pemenggalan baris yang “bagus” dalam batasan \parbox ini. Di dalam mesin TeX, setiap baris paragraf yang ditata menjadi sebuah \hbox, yang selanjutnya akan diperiksa dan dilaporkan oleh mesin, yang berpotensi menghasilkan peringatan untuk setiap baris teks yang ditata yang diklasifikasikan mesin TeX sebagai “tidak diinginkan”. Seperti yang dapat Anda lihat pada gambar-gambar berikut, baris-baris teks sangat renggang dan peringatan TeX `Underfull \hbox...` memberi tahu Anda tentang hal ini—meskipun, dalam contoh ini, hal itu jelas terlihat. ![Gambar layar yang menunjukkan sebuah parbox](/files/2fc301486db8a40f806e3c49d570ed7042eea33a) Perhatikan, untuk contoh ini Anda dapat menghindari peringatan ini dengan menggunakan \raggedright: ```latex \parbox{50pt}{\raggedright Some text typeset using a \texttt{\string\parbox}} ``` ![Gambar layar yang menunjukkan sebuah parbox](/files/08e106f5a01ea4301b98e52341c7cde206bba6b5) ## Kotak overfull dan underfull Fitur `\parbox` contoh ini menunjukkan masalah yang jauh lebih umum: saat memproses kode LaTeX Anda, mesin TeX yang digunakan untuk menata dokumen Anda (pdfTeX, XeTeX, atau LuaTeX) mungkin menganggap bahwa permintaan LaTeX menghasilkan konten yang ditata yang tidak “pas dengan baik” dalam batas kotak yang disediakan atau diminta. Jika demikian, mesin TeX akan mengeluarkan peringatan dan materi Anda akan ditata, tetapi hasilnya mungkin, pada beberapa kesempatan, tidak sedap dipandang secara estetis dan Anda mungkin perlu memperbaikinya. Ada baiknya memahami arti pesan-pesan tersebut dan mengenali kapan Anda perlu mengambil tindakan untuk menanganinya. Peringatan yang berkaitan dengan kotak ini berbentuk ``` Overfull \hbox (pt terlalu lebar) ... pada baris ... Overfull \vbox (pt terlalu tinggi) ... pada baris ... Underfull \hbox (badness ) ... pada baris ... Underfull \vbox (badness ) ... pada baris ... ``` Sebuah `\hbox` merujuk pada sebuah *kotak horizontal* di mana mesin TeX menempatkan daftar item berdampingan dan `\vbox` merujuk pada sebuah *kotak vertikal* di mana mesin TeX menumpuk item satu di atas yang lain. Jika materinya terlalu sedikit, mesin TeX akan melaporkan sebuah `Underfull \hbox` peringatan atau `Underfull \vbox` peringatan: * **Kotak underfull** tidak memiliki materi yang cukup untuk memenuhi dimensi (kotak) yang dialokasikan untuk menampungnya dan mesin TeX perlu “meregangkan” kontennya dalam upayanya mengisi ruang tersebut. Untuk kotak underfull, Overleaf juga akan melaporkan yang disebut “badness” TeX (`badness `) yang merupakan ukuran seberapa jauh TeX perlu “meregangkan” konten Anda untuk mengisi ruang yang disediakan untuk menampungnya. Nilai badness biasanya berkisar dari 0 hingga 10000. Jika materinya terlalu banyak, mesin TeX akan melaporkan peringatan \`Overfull \hbox\` atau peringatan \`Overfull \vbox\`: * **Kotak overfull** memiliki terlalu banyak konten untuk muat dalam dimensi (kotak) yang dialokasikan untuk menampungnya dan TeX tidak dapat “memasukkannya dengan rapat” ke dalam ruang yang disediakan. Mesin TeX melaporkan jumlah (``), dalam poin, sebesar konten Anda melebihi ruang yang tersedia—materi Anda terlalu lebar untuk sebuah `\hbox` atau terlalu tinggi untuk sebuah `\vbox`. ## Kotak overfull atau underfull bukanlah kesalahan Seperti disebutkan, overfull/underfull `\hbox` atau `\vbox` pesan bukanlah kesalahan melainkan “pesan peringatan diagnostik” yang dikeluarkan oleh mesin TeX (pdfTeX, XeTeX, atau LuaTeX) yang digunakan untuk menata letak dokumen LaTeX Anda. Meskipun *dilaporkan* kepada Anda oleh Overleaf, peringatan ini bukan *yang dihasilkan* dari Overleaf: pesan-pesan ini berasal dari dalam mesin TeX. Selama penataan letak, pesan-pesan ini ditulis ke `.log` berkas—sebuah berkas teks yang dihasilkan oleh mesin TeX untuk mencatat berbagai informasi saat memproses kode LaTeX Anda. Overleaf memproses `.log` berkas untuk mengekstrak pesan overfull/underfull dari mesin TeX `\hbox` atau `\vbox` pesan peringatan dan menampilkannya di antarmuka Overleaf. Ini membantu Anda menemukan dan mengidentifikasi bagian-bagian dokumen Anda yang mungkin perlu diedit untuk menghasilkan hasil penataan yang sebaik mungkin. ## Perlukah saya khawatir tentang peringatan ini? Pengguna yang baru mengenal TeX/LaTeX mungkin merasa khawatir dengan peringatan ini, bertanya-tanya apakah itu menandakan masalah serius pada dokumen mereka, tetapi sering kali sebagian besar darinya dapat diabaikan dengan aman. Namun, peringatan ini terkadang menyoroti bagian dokumen Anda yang memang perlu diperiksa dan mungkin perlu diedit untuk memperbaiki hasil penataan yang terlihat. Diperlukan sedikit latihan untuk menafsirkan pesan-pesan ini, jadi jika Anda baru mengenal TeX/LaTeX, ada baiknya meluangkan waktu untuk membangun pengalaman Anda dengan menemukan titik dalam kode sumber Anda yang menghasilkan peringatan tersebut. Dengan begitu Anda akan segera belajar mengenali peringatan yang memang menyoroti masalah yang mungkin perlu Anda tangani. ## Bagaimana saya dapat menemukan sumber peringatannya? 1. Dari dalam antarmuka Overleaf, klik pesan peringatan dan editor akan menggulir ke lokasi yang sesuai dalam kode sumber LaTeX Anda. 2. Di sebelah kiri lokasi dalam kode sumber Anda akan ada segitiga kuning kecil berisi tanda seru (!). 3. Jika Anda mengarahkan penunjuk mouse ke atas segitiga tersebut, Overleaf akan menampilkan pesan peringatan. Klip video singkat ini menunjukkan langkah-langkah di atas. {% embed url="" %} ## Bagaimana saya dapat menemukan lokasi PDF yang sesuai dengan kode LaTeX saya? Setelah menemukan kode LaTeX yang menghasilkan peringatan tertentu, Anda dapat melompat ke posisi yang sesuai dalam PDF dengan menggunakan panah yang terletak pada bilah pemisah yang memisahkan panel editor dan PDF yang ditata. ![Gambar layar yang menunjukkan sebuah parbox](/files/cb31e1f3ff6f97c8aa08b7f4a79f279979d3b501) Jika Anda tidak melihat panah-panah ini, artikel bantuan kami [Bagaimana melompat ke kode sumber dari PDF yang ditata (SyncTeX)](/latex/id/basis-pengetahuan/069-how-to-jump-to-the-source-code-from-the-typeset-pdf-synctex.md) menunjukkan cara mengaktifkannya. ## Masalah umum dan cara memperbaikinya * Anda dapat menggunakan [paket microtype](https://ctan.org/pkg/microtype?lang=en) yang memanfaatkan ekstensi mikro-tipografi yang diperkenalkan oleh pdfTeX—menghasilkan penataan yang lebih berkualitas tinggi yang juga dapat menghasilkan lebih sedikit kotak buruk. * Jika Anda memiliki masalah dengan URL dan pemenggalan baris, Anda dapat menambahkan opsi `breaklinks` ke `hyperref` paket: `\usepackage[breaklinks]{hyperref}`. * Seperti `\parbox`, `minipage` lingkungan dapat menimbulkan peringatan kotak overfull atau underfull ketika mesin TeX mencoba memecah paragraf menjadi baris: ```latex \begin{minipage}{width} teks... \end{minipage} ``` Jika memungkinkan, tingkatkan nilai `width` untuk memberi mesin TeX peluang lebih baik menghasilkan pemenggalan baris yang baik—dan/atau gunakan [paket microtype](https://ctan.org/pkg/microtype?lang=en). ### Catatan tentang penggunaan \\\\ `\\` adalah sebuah makro (simbol kendali) yang definisi pastinya dapat bergantung pada konteks penggunaannya—pembahasan/penjelasan yang sangat baik dapat ditemukan dalam [jawaban di tex.stackexchange](https://tex.stackexchange.com/a/55481). * `\\` seharusnya tidak digunakan untuk menambahkan spasi vertikal antara paragraf—hal itu dianggap praktik yang sangat buruk. * `\\` dimaksudkan hanya untuk pemenggalan baris (mirip dengan Shift-Enter di Microsoft Word). Cara yang benar untuk membuat paragraf baru di LaTeX adalah memisahkan paragraf Anda dengan baris kosong dalam kode sumber. * Alih-alih menggunakan `\\` (atau `\newline`/`\vspace`) untuk mensimulasikan pemisahan paragraf, atau untuk menambah spasi antarapragraf, solusi yang direkomendasikan untuk mengatur spasi antarparagraf adalah memuat [parskip](https://ctan.org/pkg/parskip) paket: letakkan `\usepackage{parskip}` di bagian preamble dokumen Anda. * Menggunakan `\\` di seluruh paragraf dalam dokumen dapat mengganggu algoritme LaTeX yang menghitung lokasi optimum untuk menempatkan float, memecah halaman, dll., dan dapat menyebabkan kesalahan kompilasi dalam dokumen besar. * Penggunaan yang sah dari `\\` dijelaskan dalam jawaban di [tex.stackexchange](https://tex.stackexchange.com/). Misalnya, lihat: * [Kapan menggunakan `\par` dan kapan `\\`, `\newline`, atau baris kosong](https://tex.stackexchange.com/a/82666) * [Apa yang dilakukan `\\*` ?](https://tex.stackexchange.com/a/55481) ## Mengontrol kotak mana yang dilaporkan TeX kepada Anda Mesin TeX menyediakan sejumlah perintah primitif tingkat rendah yang dapat Anda gunakan untuk membimbing heuristik TeX dan menetapkan nilai ambang untuk seberapa “buruk” sebuah kotak sebelum TeX akan melaporkannya. Berikut adalah beberapa tautan bagi pembaca yang tertarik pada perintah-perintah tersebut: * [\hfuzz dan \vfuzz](/latex/id/primitif-tex-latex/06-hfuzz.md) * [\hbadness dan \vbadness](/latex/id/primitif-tex-latex/05-hbadness.md) ## Bacaan lanjutan Untuk bacaan latar belakang lebih lanjut tentang penggunaan kotak dan glue oleh TeX, pembaca yang berminat dirujuk ke sumber-sumber ini: * Artikel Overleaf [Bagaimana TeX Menghitung Pengaturan Glue dalam sebuah \hbox](/latex/id/artikel-mendalam/24-how-tex-calculates-glue-settings-in-an-hbox.md). * Sebuah artikel Overleaf sepanjang 17 halaman yang ditulis untuk mendampingi item bantuan ini: [Menjelajahi kotak underfull atau overfull dan perhitungan badness](https://www.overleaf.com/latex/examples/exploring-underfull-or-overfull-boxes-and-badness-calculations/wpfsjnbkrfhv). Artikel tersebut juga membahas primitif TeX `\hfuzz` dan `\hbadness`. * FAQ TeX di . * [tex.stackexchange](https://tex.stackexchange.com/) berisi banyak saran dari para pakar TeX/LaTeX terkemuka. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/id/basis-pengetahuan/138-understanding-underfull-and-overfull-box-warnings.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.