> 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/066-how-to-find-and-fix-errors-reported-in-generated-files.md).

# Cara menemukan dan memperbaiki kesalahan yang dilaporkan dalam file yang dihasilkan

## Pendahuluan

Kadang-kadang Overleaf akan melaporkan error yang muncul dari file dengan nama seperti `output.toc`, `output.bbl`, dll., tetapi file-file itu *bahkan tidak ada di proyek Anda*. Jadi file-file seperti itu berasal dari mana *berasal* dan, yang lebih penting, bagaimana Anda *temukan* dan *memperbaiki* error-nya?

> ![Gen-toc-error.png](/files/1e9a30e8afb6e2f3df99adb1f8034457fa166e61) “Tapi saya bahkan tidak **telah** ini `output.toc` file ini di proyek saya!”

“file misterius” ini adalah artefak: file tambahan yang dihasilkan selama proses kompilasi LaTeX, tetapi juga dapat memicu error yang biasanya berasal dari masalah pengodean di dalam file sumber proyek Anda. Artikel bantuan ini menggunakan sebuah [contoh nyata yang penuh error](#playing-detective-locating-errors-in-generated-files) untuk menunjukkan cara melacak error semacam itu hingga ke titik asalnya di dalam file sumber proyek Anda.

## File yang dihasilkan selama proses kompilasi LaTeX

Selain file output `ke format` proses kompilasi LaTeX menghasilkan beberapa jenis file yang berisi informasi tentang label, referensi silang, nomor halaman, dll. Beberapa jenis file tambahan tidak dibuat langsung oleh kompiler LaTeX, melainkan oleh alat pemrosesan lain yang digunakan selama penataan huruf: misalnya, daftar referensi dan indeks yang diformat. File-file yang dihasilkan ini harus dibaca oleh kompiler pada proses berikutnya, sehingga file final `ke format` diisi dengan daftar, sitasi, dan referensi silang yang benar.

Kebutuhan LaTeX, dan alat pemrosesan terkait, untuk menulis dan membaca file data tambahan berarti bahwa beberapa langkah kompilasi/pemrosesan mungkin diperlukan sebelum keseluruhan set data file menyatu (stabil) untuk menghasilkan hasil tata letak akhir yang stabil `ke format` file. Siklus penataan huruf yang umum mungkin seperti:

`pdflatex`$$\mapsto$$`bibtex`$$\mapsto$$`pdflatex`$$\mapsto$$`pdflatex`

Pada instalasi LaTeX lokal Anda mungkin perlu menjalankan sendiri setiap langkah perantara, atau Anda mungkin menggunakan alat build seperti [make](https://www.gnu.org/software/make/manual/), [latexmk](https://ctan.org/pkg/latexmk) atau [arara](https://ctan.org/pkg/arara), untuk mengotomatiskan rantai proses ini. [Overleaf menggunakan latexmk](/latex/id/basis-pengetahuan/064-how-does-overleaf-compile-my-project.md), dan video ini menunjukkan apa yang terjadi setiap kali Anda menekan tombol “Recompile” di proyek Overleaf Anda.

{% embed url="<https://videos.ctfassets.net/nrgyaltdicpt/Uo3I2FXEI8H6aFPBZq171/e2139f9575a4db6955dc2278dc08283c/latexmk-ol.mp4>" %}

Biasanya, file yang dihasilkan memiliki nama file yang sama dengan `.tex` file yang sedang dikompilasi; misalnya, jika Anda mengompilasi `**main**.tex`, file yang dihasilkan akan diberi nama `**main**.aux`, `**main**.toc`, `**main**.lof` dll. Namun, *di Overleaf* kompilasi `\jobname` selalu diatur ke `**output**`, jadi [file yang dihasilkan](/latex/id/basis-pengetahuan/150-view-generated-files.md) dari proyek Overleaf Anda selalu bernama `**output**.aux`, `**output**.toc`, `**output**.lof` dll. File-file yang dihasilkan ini dapat diunduh dari proyek Overleaf Anda, tetapi tidak dapat dilihat atau diedit di Overleaf.

## Error kompilasi yang dilaporkan dari file yang dihasilkan

Error pengodean di proyek utama `.tex` file dapat terbawa ke file yang dihasilkan. Misalnya, sebuah `&` di `\section{Introduction & Background}` yang tidak di-escape akan masuk ke `.toc` file yang dihasilkan. Ketika file yang dihasilkan `.toc` kemudian dibaca kembali oleh `pdflatex` proses kompilasi berikutnya, pesan error kemudian muncul sebagai “berasal dari file .toc”. Namun, log LaTeX saat ini dan pelaporan error tidak membuat kaitan apa pun dari baris-baris di `.toc` file (dan file yang dihasilkan lainnya) ke lokasi asalnya di file sumber `.tex` : mungkin tidak langsung jelas di mana error asli harus diperbaiki.

Berikut ini contoh bagaimana error disajikan di editor LaTeX lain: meskipun Anda dapat mengeklik pesan error untuk membuka baris terkait di file `.toc` atau `.aux` file yang dihasilkan, tidak ada jalur untuk berpindah dari error ke lokasi asal di `.tex` file. Dan bahkan jika Anda memperbaiki error dengan mengganti `&` dengan `\&` di `.toc` file, hal itu sebenarnya tidak menyelesaikan masalah: saat Anda mengompilasi `.tex` file berikutnya, file `.toc` akan dibuat ulang dan error yang sama akan ditulis ulang ke `.toc` .

![Texstudio-errors-generated-files.gif](/files/8ecc8746cf7fbd417e3c2cf841822aab5acf2d27)

Ketika sebuah error dilaporkan berasal dari file yang dihasilkan, cara yang tepat untuk menyelesaikannya adalah menemukan error asli yang benar di file sumber, lalu memperbaikinya. Pesan error biasanya menyertakan informasi kontekstual, beberapa teks atau kode di sekitar error, jadi melakukan pencarian teks di file sumber akan membantu menemukannya. Error itu sendiri sering kali umum: Anda mungkin mencari beberapa error umum di [halaman bantuan ini](/latex/id/dasar-dasar-latex/05-errors.md), atau di [daftar FAQ TeX](https://texfaq.org/#errors).

## Pertama, coba kosongkan file yang dihasilkan

Kadang-kadang, error di file yang dihasilkan adalah sisa dari kompilasi sebelumnya. Bahkan jika Anda sudah memperbaiki error di `.tex` file dan mengompilasi ulang, file yang dihasilkan, yang masih berisi error, mungkin masih dibaca oleh kompiler, sehingga menghasilkan error yang sama seperti sebelumnya. Anda dapat mencoba menghapus file yang dihasilkan sebelum mengompilasi ulang. Petunjuk tentang cara melakukannya di Overleaf dapat ditemukan [di sini](/latex/id/basis-pengetahuan/028-clearing-the-cache.md).

Jika Anda masih melihat error yang sama bahkan setelah menghapus semua file yang dihasilkan dan mengompilasi ulang, kemungkinan memang ada error asli di file sumber Anda.

## Bermain detektif: menemukan error di file yang dihasilkan

Bagian berikut menawarkan beberapa kiat tentang tempat mencari error semacam itu. Kita akan menggunakan *contoh yang sengaja penuh error* proyek contoh ini untuk latihan penyelidikan kita. Siap? Ayo mulai!

[Buka sebuah *penuh error* proyek Overleaf!](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Demo+of+LaTeX+compile+errors+reported+from+generated+files\&main_document=main.tex\&snip_uri=https%3A%2F%2Fassets.ctfassets.net%2Fnrgyaltdicpt%2F5qdEqgUidaYDHjOlBoKM7K%2F55395921a114edb36ed3d51d7b1c6edb%2Fdemoerrors.zip) Proyeknya seharusnya terlihat seperti ini 😲:

![Gambar yang menunjukkan error proyek LaTeX](/files/c88166136a8227c6f1f294390a89b66bfb058c8e)

### Error dari file .aux

Fitur `.aux` file berisi informasi tentang penggunaan `\label{...}` deklarasi dan `\cite{...}` di `.tex` file, jadi ini adalah hal-hal yang berguna untuk diperiksa.

Mari kita lihat error pertama ini dari proyek contoh kita yang penuh error.

![contoh error di file .aux akibat deklarasi \label yang salah](/files/86367d361b9a411070231f1070daa98108f6272e)

Error `Missing \endcsname inserted.` pada `\alpha` mungkin tampak cukup membingungkan pada pandangan pertama, dan tampaknya tidak terlalu membantu dalam debugging kita. Namun, kita lihat dari teks (konteks) pesan error bahwa error itu terjadi di suatu tempat dekat kode yang memiliki `sec:\alpha`, yang terkait dengan suatu label atau penghitung bernomor 1.1. Jadi, kita mungkin ingin memeriksa dengan cermat semua `\label{...}` dalam `.tex` file yang berisi cuplikan `sec:\alpha`.

Anda seharusnya segera menemukan jalannya ke baris 37 dari proyek contoh kita:

```latex
\label{sec:\alpha}
```

Argumen yang diteruskan ke `\label{...}` tidak boleh berisi perintah LaTeX atau sekuens kontrol apa pun, seperti `\alpha`. Oleh karena itu, memperbaiki label menjadi sesuatu seperti `\label{sec:alpha}`, serta semua `\ref{...}`yang sesuai, akan menghapus error ini.

Berikut error lain yang dilaporkan dari `.aux` file, dalam proyek contoh kita:

![contoh error di file .aux akibat spasi di key \cite{...}](/files/4604c333c4652ea1492a21b28970fac2f87b4cca)

Kali ini kompiler mengeluh tentang spasi putih dalam sebuah `\citation`; di mana key dimulai dengan “That”. Jadi kita ingin mencari `\cite{That ...}` dalam `.tex` file... dan kita menemukannya pada baris 23:

```latex
... justo \cite{That mandatory talk} eget magna ...
```

Key sitasi tidak boleh mengandung karakter spasi, jadi spasi dalam `\cite{...}`, serta key BIBTeX yang sesuai di `.bib` file, harus dihapus.

### Error dari file .toc

Fitur `.toc` file berisi entri untuk `\tableofcontents`. Ini diisi dari judul bagian dalam dokumen LaTeX, misalnya, `\chapter{...}`, `\section{...}`, dll. Karena itu, jika Anda melihat error dilaporkan dari file `.toc` , akan berguna untuk memeriksa judul bagian Anda yang memuat teks yang dilaporkan dalam pesan error.

![contoh error di file .toc akibat & yang tidak di-escape di key \section{...}](/files/1b9b24431c565809a7ea150bf246e1f56e5f4a5d)

Ini tampak seperti judul bagian yang akan diberi nomor “1”, dan berisi teks `Introduction & Welcome`. Pencarian cepat di `.tex` file akan membawa kita ke baris 12:

```latex
\section{Introduction & Welcome}
```

Fitur `&` tidak di-escape di sini, jadi kita perlu mengubahnya menjadi `\&` di `.tex` .

Contoh serupa lainnya:

![contoh error di file .toc akibat perintah matematika tidak dalam mode matematika di key \section{...}](/files/3bb7ad3b2d2b947eda01ee96d60810460aeee97b)

Demikian pula, tebakan kita adalah mencari judul bagian yang akan diberi nomor “1.1”, dan mungkin berisi `Setting \alpha`. Tebakan kita ternyata benar, di baris 36 dari `.tex` file:

```latex
\subsection{Setting \alpha}
```

`\alpha` adalah perintah matematika tetapi kita lupa menaruhnya dalam mode matematika di sini, jadi kita perlu mengoreksinya menjadi

```latex
\subsection{Setting $\alpha$}
```

atau

```latex
\subsection{Setting \(\alpha\)}
```

Kadang-kadang error muncul di `.toc` file karena error pada kode yang digunakan untuk menata entri di daftar isi:

![contoh error di file .toc akibat kode yang tidak tepat saat menata entri ToC](/files/6dde5be6f2594a88b02a01e991b8bfb2150334a1)

Di sini, mencari dengan `\itshae` akan membawa kita ke sebuah typo di baris 5 dari `.tex`: seharusnya `\itshape` sebagai gantinya. Dalam kasus ini, error dapat ditemukan di preamble `.tex` file, jadi kita bisa langsung memperbaikinya. Tetapi jika Anda menggunakan `.cls` atau `.sty` file yang disediakan oleh institusi Anda dan Anda menduga error disebabkan oleh salah konfigurasi dalam file yang disediakan, Anda harus menghubungi penulis atau pemelihara template atau paket agar mereka dapat memperbarui template.

### Error dari file .lof dan .lot

Fitur `.lof` file berisi entri untuk `\listoffigures`, dan diisi oleh `\caption{...}` sebesar `figure` environments.

Demikian pula, `.lot` file menggunakan `\caption{...}` dari `table` environments, untuk menghasilkan entri bagi `\listoftables`.

Karena itu, jika ada error LaTeX dari `.lof` atau `.lot` file, Anda harus memeriksa `\caption{...}` yang berisi cuplikan teks yang relevan.

Berdasarkan pesan error di sini, kita akan mencari `Effects of \alpha and var_coeff` dalam `\caption{...}`s, terutama untuk `figure`s:

![contoh error di file .lof akibat perintah matematika tidak dalam mode matematika di key \caption{...}](/files/3396a321832124f0c7abcf866dbb3a2a3d22e8c2)

dan sampai ke baris 19 di `.tex` file:

```latex
\caption{Effects of \alpha and var_coeff}
```

Fitur `\alpha` harus ditempatkan dalam mode matematika; dan jika `var_coeff` seharusnya berupa nama variabel, garis bawahnya perlu di-escape. Jangan gunakan `\verb|var_coeff|` karena ini bisa sangat berbahaya di `\caption{...}`juga!

```latex
\caption{Effects of $\alpha$ and \texttt{var\_coeff}}
```

Demikian pula, ketika melihat error ini, kita akan mencari `beberapa data contoh dengan n^i` di `table` `\caption{...}`, dengan dugaan bahwa kita lupa menaruh `n^i` ke dalam mode matematika juga.

![contoh error di file .lot akibat superskrip tidak dalam mode matematika di key \caption{...}](/files/1430959fff2b1cdc7f2b30d1c012e96e75ab15f6)

Dan jadi kita mengoreksi baris 31

```latex
\caption{Some sample data with n^i}
```

ke

```latex
\caption{Some sample data with $n^i$}
```

### Error dari file .bbl

Fitur `.bbl` file berisi entri untuk daftar referensi (bibliografi), dan dihasilkan oleh BIBTeX setelah memproses `.bib` file, menggunakan informasi penataan dari `.bst` file. Error yang dilaporkan dari `.bbl` biasanya berasal dari `.bib` .

Berikut error umum yang sering kami lihat dalam dukungan Overleaf:

![contoh error di file .bbl akibat & yang tidak di-escape di file .bib](/files/566cd2d278ef79f581922d4f3f8738cf0433e960)

Mencari `This & that` di `.bib` file dari proyek contoh akan membawa kita ke baris 13, di mana kita menyadari bahwa `&` harus di-escape sebagai `\&` atau diganti dengan kata `dan`.

```bibtex
    title   = {This & That},
```

Penulis sering menemui error terkait karakter Unicode di `.bbl` (dan karena itu `.bib`) file—terutama jika sumber informasinya disalin-tempel dari tempat lain:

![contoh error di file .bbl akibat karakter Unicode yang tidak didukung di file .bib](/files/95260b0933818afc18b662bcbcfd7c240169e55c)

Menyalin-tempel karakter ♣ dari pesan error dan mencarinya di dalam `.bib` file akan membawa Anda ke baris 3:

```bibtex
    title   = {Research ♣ Development},
```

Beberapa karakter Unicode tidak didukung oleh `latex` dan `pdflatex` kompiler. Untuk menghindari error, Anda dapat mencoba [mengubah kompiler proyek Anda](/latex/id/basis-pengetahuan/026-changing-compiler.md) ke `XeLaTeX` atau `LuaLaTeX`. Namun bahkan begitu, Anda masih perlu memastikan proyek Anda kompatibel dengan kompiler tersebut, dan bahwa Anda telah menggunakan font yang memiliki glyph untuk mewakili ♣ sehingga dirender dengan benar dalam PDF output. Karena itu, akan lebih baik menggunakan perintah LaTeX yang relevan:

```bibtex
    title   = {Research $\clubsuit$ Development},
```

Namun terkadang, karakter tersebut bisa jauh lebih sulit ditemukan:

![contoh error di file .bbl akibat karakter Unicode yang tidak didukung dan tidak dapat dicetak di file .bib](/files/82ab5c5477cc0d3492cc08d0d29520596c283324)

Di sini, U+3000 adalah [Karakter Unicode `SPASI IDEOGRAFIS`](https://www.fileformat.info/info/unicode/char/3000/index.htm), dan memang merupakan spasi putih. Mungkin sulit menyalin karakter persis ini dari pesan error agar Anda dapat mencarinya di `.bib` file. Jadi kita harus mencoba cara lain untuk menemukannya, dengan menggunakan `\DeclareUnicodeCharacter` untuk menggantikan `U+3000` dengan sesuatu yang lebih terlihat! Tambahkan baris-baris berikut di preamble proyek Anda, sebelum `\begin{document}`:

```latex
\usepackage{xcolor}
\DeclareUnicodeCharacter{3000}{\textcolor{red}{BAD!!}}
```

Mengompilasi proyek Anda kemudian akan membuat error hilang; tetapi Anda harus melihat dengan saksama di PDF output untuk BAD!!:

![PDF output menggantikan U+3000 dengan BAD!! merah](/files/c42104e7c7a4f394988508432082bfc9bb99468b)

Jadi sekarang kita tahu bahwa karakter yang buruk itu berada di antara `sebesar` dan `Wondrous`, untuk item bibliografi oleh “An Author”. Itu tampak sangat tidak mencurigakan di baris 5 dari `.bib` file karena karakternya tidak terlihat: tetapi jika Anda mengetik ulang `...of Wondrous...` secara manual dengan spasi biasa, error akan hilang setelah kompilasi ulang.

```bibtex
    journal = {Journal of　Wondrous Musings},
```

#### Catatan tentang biblatex

Jika Anda menggunakan `biblatex` paket, maka error serupa di `.bib` file kemungkinan besar semuanya akan dilaporkan seolah-olah berasal dari `\printbibliography` baris di `.tex` file Anda. Proses debuggingnya serupa: gunakan cuplikan teks pendek dalam pesan error untuk mencari di `.bib` file Anda guna menemukan baris yang bermasalah, lalu perbaiki.

### Error dari file .bst

`.bst` file adalah gaya bibliografi yang digunakan BIBTeX untuk memproses dan memformat daftar referensi. Jika Anda melihat error dari file `.bst` file, ini mungkin disebabkan oleh bug dalam `.bst` itu sendiri, terutama jika itu adalah file gaya yang sangat, sangat lama yang mungkin tidak lagi kompatibel dengan paket LaTeX terbaru. Namun, bisa juga sebenarnya disebabkan oleh error di `.bib` file juga. Error yang paling umum dalam kategori ini terlihat seperti ini:

![Bst-error-example-01.png](/files/04c6b0367ca618f0822fdb8aff70062757d7e7b4)

Entri dengan key BIBTeX `Someone:etal:2008` memiliki field `penulis` pada baris 12 dari `.bib` file:

```bibtex
    author  = {Strange Someone, Night Stranger, and Random Person},
```

Dalam sebuah `.bib` file, [daftar beberapa nama](/latex/id/referensi-dan-sitasi/01-bibliography-management-with-bibtex.md#multiple-authors) harus dipisahkan dengan `dan`, bukan koma maupun `&`. Karena itu field `penulis` ini harus diperbaiki menjadi

```bibtex
    author  = {Strange Someone and Night Stranger and Random Person},
```

### Error dari file .ttt dan .fff

Jenis file ini hanya dihasilkan jika Anda memuat [`endfloat` ke preambel dokumen Anda (seperti disarankan](https://www.ctan.org/pkg/endfloat), yang digunakan untuk memaksa semua environment tabel dan gambar dipindahkan ke akhir dokumen, sesuai persyaratan beberapa jurnal akademik saat pengiriman artikel.

Untuk melihat contoh error dari file yang dihasilkan ini, hapus tanda komentar pada baris 3 `\usepackage{endfloat}` dari `.tex` file dalam proyek contoh kita.

![Ttt-error-example-01.png](/files/858d59113ac1e0a2dc82a38aba3fb464614dd58a)

Fitur `.ttt` file berisi isi dari semua `table` environment di dokumen, jadi kita akan mencari `dummy & data` di `.tex` file, dengan memperhatikan tabel. Kita akan sampai ke baris 29 di `.tex` file, tempat kita melihat masalahnya: kita memiliki tiga kolom, satu lebih banyak dari dua yang dinyatakan. Jadi satu kolom ekstra mungkin perlu dihapus; atau kita harus menyisipkan `\\` setelah `dummy` untuk memulai baris baru; atau mungkin memang kita bermaksud mendeklarasikan tiga kolom `c | c | c` ternyata!

![Fff-error-example-01.png](/files/59bc7a6aee1230bee51d7513950ba40b3dc08df1)

Demikian pula, `.fff` file berisi isi dari semua `figure` environment, dan mencari typo `\includegraphcs` akan membawa kita ke baris 18 dari file `.tex` file, tempat kita dapat mengoreksinya menjadi `\includegraphics`.

## Bacaan lebih lanjut

* [Bagaimana Overleaf mengompilasi proyek saya?](/latex/id/basis-pengetahuan/064-how-does-overleaf-compile-my-project.md)
* [Error LaTeX umum](/latex/id/dasar-dasar-latex/05-errors.md)
* [daftar FAQ TeX](https://texfaq.org/#errors)


---

# 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/066-how-to-find-and-fix-errors-reported-in-generated-files.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.