> 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/149-using-the-stop-on-first-error-compilation-mode.md).

# Menggunakan mode kompilasi Hentikan pada Kesalahan Pertama

Artikel ini menjelaskan cara menggunakan Overleaf **Stop on first error** mode kompilasi, serta meninjau beberapa topik latar belakang penting, termasuk:

* Apa itu [mode kompilasi LaTeX](#introduction-to-latex-errors-and-compilation)?
* [Mode kompilasi di Overleaf](#compilation-modes-on-overleaf)
* Bagaimana **Stop on first error** dapat berupa [berguna untuk penelusuran kesalahan](#benefits-of-using-the-stop-on-first-error-mode)

Untuk melewati informasi latar belakang, Anda dapat langsung menuju bagian yang menjelaskan [cara mengaktifkan mode kompilasi Hentikan pada kesalahan pertama](#the-stop-on-first-error-compilation-mode).

## Pengantar kesalahan dan kompilasi LaTeX

Konversi dokumen LaTeX menjadi berkas PDF yang diformat merupakan hasil dari proses yang disebut *kompilasi*: sebuah program yang dapat dieksekusi, yang dikenal sebagai “kompiler LaTeX”, membaca isi dokumen Anda dan menjalankan perintah-perintah LaTeX penyusunnya untuk menghasilkan berkas PDF yang diformat.

Saat menulis markup (kode) LaTeX, sangat wajar untuk membuat kesalahan yang, selama kompilasi, menyebabkan kompiler menampilkan pesan kesalahan yang mencoba menjelaskan apa yang menurut kompiler *mengira* telah menyebabkan masalah tersebut. Seperti pada bahasa pemrograman lain, satu kesalahan dalam kode LaTeX dokumen Anda dapat memicu rangkaian kesalahan, masing-masing dengan pesan yang sesuai. Di Overleaf, pesan kesalahan kompilasi dilaporkan kepada pengguna melalui [notifikasi merah di samping **Kompilasi ulang** tombol](#overleafs-latex-error-reporting), dan Anda dapat mengeklik **Log dan file output** ikon untuk melihatnya.

### Menangani kesalahan: mode kompilasi

Kompiler LaTeX, juga dikenal sebagai [mesin TeX](/latex/id/artikel-mendalam/55-what-s-in-a-name-a-guide-to-the-many-flavours-of-tex.md), memiliki (dapat dipilih pengguna) *mode kompilasi* yang menentukan bagaimana kesalahan ditangani. Daftar berpoin berikut menggunakan *nama penjelas/deskriptifnya sendiri* untuk masing-masing mode tersebut:

* **Coba kompilasi meskipun ada kesalahan**—pada dasarnya, terus mencoba mengompilasi meskipun menemui kesalahan, dengan harapan hasil terbaik, mungkin menghasilkan berkas PDF tetapi yang dapat berisi kesalahan penataan huruf.
* **Stop on first error**—pada praktiknya “mundur” pada tanda pertama masalah, memberikan pesan kepada pengguna dan keluar tanpa membuat PDF. Ini mencegah memicu rangkaian kesalahan berikutnya, sehingga Anda dapat fokus memperbaiki kesalahan pertama dan mengompilasi ulang dokumen.
* **Hentikan sementara kompilasi untuk berinteraksi dengan pengguna**—jeda kompilasi untuk menawarkan bantuan dan menyediakan mekanisme bagi pengguna untuk memperbaiki kesalahan dan melanjutkan kompilasi. Ini memungkinkan dengan instalasi LaTeX lokal tetapi tidak praktis di Overleaf.

## Mode kompilasi di Overleaf

Untuk mengelola proses kompilasi LaTeX, Overleaf menggunakan [alat build bernama latexmk](/latex/id/basis-pengetahuan/064-how-does-overleaf-compile-my-project.md) yang, secara default, menggunakan mode kompilasi yang disebut Overleaf sebagai **Coba kompilasi meskipun ada kesalahan:** alat build akan mencoba menghasilkan PDF yang diformat, bahkan jika ada [kesalahan kompilasi LaTeX](/latex/id/dasar-dasar-latex/05-errors.md).

Pada **Coba kompilasi meskipun ada kesalahan** mode kompilasi, kompiler LaTeX tidak berhenti jika kesalahan terdeteksi; sebaliknya, ia berupaya “menebak terbaik” maksud pengguna dan menerapkan “perbaikan” berdasarkan tebakan itu—kode yang bermasalah juga dapat “dilewati”. Kompiler *mungkin* kembali ke keadaan di mana proses kompilasi pada akhirnya dapat selesai untuk membuat PDF, meskipun PDF yang dihasilkan mungkin berisi keluaran yang salah. Sering kali, kesalahan yang ditemui mungkin terlalu serius, atau terlalu banyak, untuk diperbaiki oleh kompiler LaTeX sehingga ia mungkin tetap “mundur” tanpa menghasilkan PDF.

### Pelaporan kesalahan LaTeX di Overleaf

Seperti disebutkan di atas, pesan kesalahan yang dihasilkan selama kompilasi dilaporkan kepada pengguna melalui notifikasi merah di samping **Kompilasi ulang** tombol:

![Tangkapan layar yang menunjukkan kesalahan LaTeX yang dilaporkan di Overleaf](/files/c2ffbd17e74dd5135a4cf8b0cebb2c37a40c2724)

Anda dapat mengeklik **Log dan file output** ikon untuk melihat detail lebih lanjut tentang kesalahan tersebut. Misalnya, jika Anda keliru mengetik `\texbf{word}` bukannya `\textbf{word}`, Overleaf tetap akan menampilkan pratinjau PDF hasil kompilasi beserta pesan kesalahan tentang perintah yang tidak terdefinisi, tetapi “word” tidak akan tebal di PDF!

## Mode kompilasi Hentikan pada kesalahan pertama

Pengguna kini dapat mengubah mode kompilasi LaTeX dengan beralih ke **Stop on first error** mode yang menyebabkan Overleaf menghentikan kompilasi segera setelah mendeteksi kesalahan pertama.

### Cara mengaktifkan Hentikan pada kesalahan pertama

Pilih segitiga kecil di samping **Kompilasi ulang** tombol lalu pilih **Stop on first error** dari **Kompilasi ulang** menu tarik-turun:

![Tangkapan layar yang menunjukkan cara mengaktifkan mode kompilasi Stop on first error](/files/8658341c26970664d4611381ac99bf1638085d06)

#### Ruang lingkup pengaturan mode ini

Fitur **Stop on first error** mode ini adalah pengaturan per pengguna, per proyek. Mengaktifkan mode ini akan *berisi nilai data aktual yang disimpan dalam* memengaruhi proyek Anda yang lain, atau kolaborator mana pun dalam proyek yang sama.

### Menonaktifkan Hentikan pada kesalahan pertama

Saat **Stop on first error** diaktifkan, Anda dapat kembali ke mode kompilasi bawaan dengan memilih tombol biru **Nonaktifkan “Hentikan pada kesalahan pertama”** yang terletak di kotak dialog yang muncul saat ada kesalahan kompilasi:

![Tangkapan layar yang menunjukkan pesan kegagalan kompilasi](/files/585f477c7c6de6f29301c461e534f46089474c74)

Anda juga dapat pergi ke **Kompilasi ulang** menu tarik-turun, lalu pilih **Coba kompilasi meskipun ada kesalahan** mode:

![Tangkapan layar yang menunjukkan cara menonaktifkan mode kompilasi Hentikan pada kesalahan pertama](/files/b718b89cb1f69eaa0c66482064ad4823dbced24a)

### Catatan dan saran tambahan

Jika proyek Anda bebas dari kesalahan kompilasi LaTeX, pratinjau PDF akan ditampilkan seperti biasa. Jika proyek Anda *tidak* mengandung kesalahan kompilasi LaTeX, kompilasi akan berhenti segera pada kesalahan pertama. Pesan kesalahan pertama ditampilkan seperti pada tangkapan layar di bawah, sehingga Anda dapat fokus menelusuri kesalahan dalam kode sumber Anda. Pada tangkapan layar ini, kesalahan terjadi karena penggunaan yang salah dari `\caption{...}\label{...}` di dalam lingkungan tabular. Baris 15 harus dipindahkan ke sebelum `\begin{tabular}`.

![Tangkapan layar yang menunjukkan kesalahan LaTeX yang umum](/files/a1eed1eaa73d3673a114dbb70ceb9d668ec0ab01)

Klik **Kompilasi ulang** setelah memperbaiki setiap kesalahan, lalu ulangi proses penelusuran kesalahan ini untuk setiap kesalahan kompilasi berikutnya. Saat proyek Anda bebas dari kesalahan LaTeX,  **Stop on first error** mode akan menampilkan PDF yang berhasil dikompilasi.

### Manfaat menggunakan mode Hentikan pada kesalahan pertama

* **Membantu menelusuri waktu habis kompilasi.** Beberapa jenis kesalahan kompilasi sangat serius (mis., rekursi tidak disengaja) sehingga dapat memblokir **Coba kompilasi meskipun ada kesalahan** mode kompilasi, yang menyebabkan [waktu habis kompilasi](/latex/id/basis-pengetahuan/038-fixing-and-preventing-compile-timeouts.md#fatal-compile-errors-blocking-the-compilation) di proyek Overleaf. Mengaktifkan **Stop on first error** mode ini dapat membantu menemukan dan menelusuri kesalahan semacam itu.
* **Jangan biarkan kesalahan Anda menumpuk.** Beberapa pengguna mungkin lebih suka perilaku editor LaTeX lain, di mana proses kompilasi akan berhenti pada kesalahan LaTeX pertama yang ditemui sehingga mereka dapat memperbaiki kesalahan sebelum mengompilasi ulang. Mencegah kesalahan berantai—memicu rentetan kesalahan tambahan—menghindarkan keharusan menelusuri lebih dari 100 pesan kesalahan kompilasi yang bisa menjadi sulit dan agak membosankan.
* **Mengaktifkan mode Hentikan pada kesalahan pertama dapat dengan cepat mendeteksi kesalahan Anda (jika ada).** Jika Anda memiliki dokumen besar atau kompleks yang memerlukan waktu lebih lama untuk dikompilasi,  **Coba kompilasi meskipun ada kesalahan** mode ini mengharuskan Anda menunggu hingga kompilasi selesai. Jika ada kesalahan yang perlu diperbaiki, bisa memakan waktu karena Anda harus menunggu sebelum dapat melihat kesalahan kompilasi pertama dan mencoba memperbaikinya.
* **Belajar menelusuri kesalahan adalah bagian penting dari mempelajari LaTeX.** Fitur **Stop on first error** mode ini dapat membantu pemula LaTeX belajar dan membiasakan kebiasaan pengodean LaTeX yang baik sejak awal, mungkin mempercepat perjalanan mereka menuju kemahiran LaTeX. Kesalahan LaTeX bisa tampak sangat aneh dan esoteris sehingga sangat menggoda untuk mengabaikannya dan membiarkan kompiler terus berjalan—dengan harapan PDF pada akhirnya akan muncul, bahkan jika PDF tersebut berisi kesalahan penataan huruf. Dalam jangka panjang, mengabaikan kesalahan kompilasi dapat menyebabkan kebiasaan pengodean yang buruk yang pada akhirnya bisa menjebak Anda di masa depan, mungkin saat menyerahkan makalah jurnal penting! Jika Anda mengajar kelas LaTeX, para siswa Anda dapat menggunakan **Stop on first error** mode ini untuk mengembangkan keterampilan menelusuri kesalahan LaTeX.

## Kesalahan yang tampaknya tidak berasal dari berkas Anda

Jika Anda menghentikan kompilasi secara manual dalam **Coba kompilasi meskipun ada kesalahan** mode, lalu mengaktifkan **Stop on first error**, kompilasi berikutnya dapat menghasilkan beberapa pesan kesalahan yang tampaknya acak, seperti `! File ended while scanning use of \@writefile`, yang tampaknya tidak berasal dari berkas Anda. Kesalahan seperti itu mungkin disebabkan oleh berkas terpotong yang dihasilkan oleh, dan tertinggal dari, kompilasi sebelumnya yang tidak selesai. Dalam kasus itu, Anda mungkin ingin melakukan [Recompile from Scratch](/latex/id/basis-pengetahuan/028-clearing-the-cache.md) agar kompilasi berikutnya, masih dalam **Stop on first error** mode, memiliki peluang untuk memulai dari awal yang bersih dan menampilkan kesalahan pertama yang relevan. Jika Anda masih mendapatkan kesalahan dari berkas yang tampaknya tidak ada—mis., `output.aux`, `output.toc` dsb.—lihatlah [halaman bantuan ini](/latex/id/basis-pengetahuan/066-how-to-find-and-fix-errors-reported-in-generated-files.md).

## Beberapa detail tingkat rendah

Fitur **Coba kompilasi meskipun ada kesalahan** mode kompilasi dijalankan `latexmk` dengan flag berikut:

```latex
latexmk -f -interaction=nonstopmode …
```

Fitur **Stop on first error** mode kompilasi akan menjalankan latexmk dengan flag berikut sebagai gantinya:

```latex
latexmk -halt-on-error -interaction=nonstopmode …
```

Selagi Anda di sini, Anda mungkin juga tertarik membaca lebih lanjut tentang [bagaimana Overleaf menggunakan `latexmk` alat](/latex/id/basis-pengetahuan/064-how-does-overleaf-compile-my-project.md).


---

# 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/149-using-the-stop-on-first-error-compilation-mode.md?ask=<question>&goal=<endgoal>
```

`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.