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

# İlk Hata Durdurma derleme modunu kullanma

Bu makale, Overleaf’in nasıl kullanılacağını açıklar **İlk hatada dur** derleme modu; ayrıca aşağıdakiler de dâhil olmak üzere bazı önemli arka plan konularını gözden geçirir:

* Nedir [LaTeX derleme modu](#introduction-to-latex-errors-and-compilation)?
* [Overleaf’te derleme modları](#compilation-modes-on-overleaf)
* Nasıl **İlk hatada dur** şu olabilir [hata ayıklama için kullanışlıdır](#benefits-of-using-the-stop-on-first-error-mode)

Arka plan bilgilerini atlamak için, açıklayan bölüme doğrudan geçebilirsiniz [İlk hatada dur derleme modunun nasıl etkinleştirileceğini](#the-stop-on-first-error-compilation-mode).

## LaTeX hataları ve derlemeye giriş

Bir LaTeX belgesinin dizilmiş bir PDF dosyasına dönüştürülmesi, *derleme*olarak adlandırılan bir sürecin sonucudur: “LaTeX derleyicisi” olarak bilinen çalıştırılabilir bir program, belgenizin içeriğini okur ve dizilmiş PDF dosyasını oluşturmak için bileşen LaTeX komutlarını çalıştırır.

LaTeX işaretlemesi (kod) yazarken, derleme sırasında derleyicinin neyi *düşündüğü* sorun(lar)a neden olduğunu düşündüğü. Diğer programlama dillerinde olduğu gibi, belgenizin LaTeX kodundaki tek bir hata, her biri kendi iletisine sahip bir hata zincirini tetikleyebilir. Overleaf’te derleme hata iletileri kullanıcıya [yanındaki kırmızı bir bildirim aracılığıyla **Yeniden derle** düğmesine tıklayın](#overleafs-latex-error-reporting), ve **Günlükler ve çıktı dosyaları** simgesine tıklayarak bunları görüntüleyebilirsiniz.

### Hataların ele alınması: derleme modları

LaTeX derleyicileri, [TeX motorları](/latex/tr/derinlemesine-makaleler/55-what-s-in-a-name-a-guide-to-the-many-flavours-of-tex.md), yerleşik (kullanıcı tarafından seçilebilir) *derleme modları* bunlar hataların nasıl ele alınacağını belirler. Aşağıdaki madde listesi Overleaf’in *kendi açıklayıcı/betimleyici adını* bu modların her biri için kullanır:

* **Hatalara rağmen derlemeyi dene**—özünde, hatalarla karşılaşmanıza rağmen derlemeyi sürdürün, en iyisini umun; belki bir PDF dosyası oluşturulur, ancak bu dosya dizgi hataları içerebilir.
* **İlk hatada dur**—aslında, ilk sorun belirtisinde “vazgeçip çıkın”, kullanıcıya bir mesaj verin ve PDF oluşturmadan çıkın. Bu, sonraki hata zincirini tetiklemeyi önler; böylece ilk hatayı düzeltmeye ve belgeyi yeniden derlemeye odaklanabilirsiniz.
* **Kullanıcıyla etkileşim kurmak için derlemeyi duraklat**—yardım sunmak ve kullanıcıların hataları düzeltip derlemeye devam edebilmesi için mekanizmalar sağlamak amacıyla derlemeyi duraklatın. Bu, yerel bir LaTeX kurulumuyla mümkündür, ancak Overleaf’te pratik değildir.

## Overleaf’te derleme modları

Overleaf, LaTeX’in derleme sürecini yönetmek için bir [latexmk adlı bir derleme aracı](/latex/tr/bilgi-bankasi/064-how-does-overleaf-compile-my-project.md) kullanır; varsayılan olarak, Overleaf’in ... olarak adlandırdığı bir derleme modunu kullanır **Hatalara rağmen derlemeyi dene:** derleme aracı, olsa bile dizilmiş bir PDF üretmeye çalışır [LaTeX derleme hataları](/latex/tr/latex-temelleri/05-errors.md).

İçinde **Hatalara rağmen derlemeyi dene** derleme modunda LaTeX derleyicisi hatalar algılanırsa durmaz; bunun yerine, kullanıcının niyetini mümkün olan en iyi şekilde tahmin etmeye çalışır ve bu tahmine dayalı “düzeltmeler” uygular — sorunlu kod ayrıca “atlanabilir”. Derleyici *belki* sonunda PDF oluşturmak üzere derleme sürecinin tamamlanabileceği bir duruma dönebilir; ancak üretilen PDF yanlış çıktı içerebilir. Çoğu zaman, karşılaşılan hatalar LaTeX derleyicisinin düzeltemeyeceği kadar ciddi ya da fazla sayıda olabilir; bu yüzden yine de PDF oluşturmadan “vazgeçip çıkabilir”.

### Overleaf’in LaTeX hata bildirimi

Yukarıda belirtildiği gibi, derleme sırasında üretilen hata iletileri kullanıcıya, ... yanındaki kırmızı bir bildirim aracılığıyla bildirilir **Yeniden derle** düğmesi:

![Overleaf’te bildirilen LaTeX hatalarını gösteren ekran görüntüsü](/files/a4b7f4da7d8a8c306063f5259e0b15d0e6033480)

üzerine tıklayabilirsiniz **Günlükler ve çıktı dosyaları** simgesine, hatalar hakkında daha fazla ayrıntı görmek için. Örneğin, yanlışlıkla `\texbf{word}` yerine `\textbf{word}`, Overleaf yine de tanımsız komutla ilgili hata mesajıyla birlikte derlenmiş bir PDF önizlemesi gösterirdi, ancak PDF’de “word” kalın olmazdı!

## İlk hatada dur derleme modu

Kullanıcılar artık LaTeX derleme modunu, ... geçerek değiştirebilir **İlk hatada dur** bu mod, Overleaf’in ilk hata algılandığı anda derlemeyi hemen sonlandırmasına neden olur.

### İlk hatada dur nasıl etkinleştirilir

... yanındaki küçük üçgeni seçin **Yeniden derle** düğmesini seçin, ardından **İlk hatada dur** şu paketten: **Yeniden derle** açılır menüsündeki derleme modu altında etkinleştirin:

![İlk hatada dur derleme modunun nasıl etkinleştirileceğini gösteren ekran görüntüsü](/files/14cd649b0f871cf652822b96bf382186ad2e25c3)

#### Bu mod ayarının kapsamı

Bu **İlk hatada dur** modu, kullanıcı başına, proje başına bir ayardır. Bu modu etkinleştirmek *yapmaz* diğer projelerinizi veya aynı projedeki herhangi bir işbirlikçiyi etkileyecektir.

### İlk hatada dur özelliğini devre dışı bırakma

Ne zaman **İlk hatada dur** etkin olduğunda, mavi düğmeyi seçerek varsayılan derleme moduna geri dönebilirsiniz **“İlk hatada dur” seçeneğini devre dışı bırak** bu, bir derleme hatası olduğunda görünen iletişim kutusunda yer alır:

![Derleme başarısızlığı mesajını gösteren ekran görüntüsü](/files/87d2994e64c49c1cbf57c37f859ecc50995af748)

Ayrıca **Yeniden derle** açılır menüsüne gidip **Hatalara rağmen derlemeyi dene** modunu:

![İlk hatada dur derleme modunun nasıl devre dışı bırakılacağını gösteren ekran görüntüsü](/files/0f6ffbbe592993d2dc18ef44c5eee9aad334398b)

### Ek notlar ve tavsiyeler

Projeniz LaTeX derleme hatalarından arınmışsa, her zamanki gibi bir PDF önizlemesi gösterilir. Projeniz *yapar* LaTeX derleme hataları içeriyorsa, derleme ilk hatada hemen durur. İlk hata mesajı aşağıdaki ekran görüntüsünde gösterildiği gibi görüntülenir; böylece kaynak kodunuzdaki hatayı ayıklamaya odaklanabilirsiniz. Bu ekran görüntüsünde hata, `\caption{...}\label{...}` tabular ortamı içinde. 15. satır, öncesine taşınmalıdır `\begin{tabular}`.

![Tipik bir LaTeX hatasını gösteren ekran görüntüsü](/files/7e25152c267401121a00fb54a5c407147c6ccbda)

üzerine tıklayın **Yeniden derle** her hatayı düzelttikten sonra ve ardından sonraki her derleme hatası için bu hata ayıklama sürecini tekrarlayın. Projeniz LaTeX hatalarından arındığında, **İlk hatada dur** modu başarıyla derlenmiş PDF’yi gösterecektir.

### İlk hatada dur modunu kullanmanın avantajları

* **Derleme zaman aşımı hatalarının ayıklanmasına yardımcı olur.** Bazı derleme hataları o kadar ciddidir ki (örn. yanlışlıkla oluşan özyineleme), **Hatalara rağmen derlemeyi dene** derleme modu, [derleme zaman aşımına](/latex/tr/bilgi-bankasi/038-fixing-and-preventing-compile-timeouts.md#fatal-compile-errors-blocking-the-compilation) bir Overleaf projesinde. ... etkinleştirmek **İlk hatada dur** modu, bu tür hataları bulup ayıklamaya yardımcı olabilir.
* **Hatalarınızın birikmesine izin vermeyin.** Bazı kullanıcılar, derleme sürecinin karşılaşılan ilk LaTeX hatasında durduğu diğer LaTeX düzenleyicilerin davranışını tercih edebilir; böylece yeniden derlemeden önce hatayı düzeltebilirler. Hataların zincirleme şekilde yayılmasını — daha fazla hatadan oluşan bir çığı tetiklemesini — önlemek, ayıklanması zor ve bir hayli zahmetli olabilen 100’den fazla derleme hata mesajını çözme zorunluluğunu ortadan kaldırır.
* **İlk hatada dur modunu etkinleştirmek, hatalarınızı (varsa) hızlıca tespit edebilir.** Derlenmesi daha uzun süren büyük veya karmaşık bir belgeniz varsa, **Hatalara rağmen derlemeyi dene** mod, derlemenin bitmesini beklemenizi gerektirir. Düzeltmeniz gereken hatalar varsa, ilk derleme hatasını görüp düzeltmeye çalışmadan önce beklemek zaman alıcı olabilir.
* **Hataları ayıklamayı öğrenmek, LaTeX öğrenmenin temel bir parçasıdır.** Bu **İlk hatada dur** modu, LaTeX başlangıç seviyesindekilerin iyi LaTeX kodlama alışkanlıklarını erken dönemde öğrenmesine ve benimsemesine yardımcı olabilir; bu da belki LaTeX yeterliliğine giden yolculuklarını hızlandırır. LaTeX hataları o kadar garip ve ezoterik görünebilir ki, onları görmezden gelip derleyicinin devam etmesine izin vermek çok cazip gelir — hatta PDF dizgi hataları içerse bile, sonunda bir PDF’nin çıkmasını umut ederek. Uzun vadede, derleme hatalarını yok saymak kötü kodlama alışkanlıklarına yol açabilir; bunlar sonunda ileride, belki de önemli bir dergi makalesi gönderirken, sizi zor durumda bırakabilir! Eğer bir LaTeX dersi veriyorsanız, öğrencileriniz **İlk hatada dur** modunu, LaTeX hatalarını ayıklama becerileri geliştirmek için kullanabilir.

## Dosyalarınızın içinde oluşuyor gibi görünmeyen hatalar

Derlemeyi manuel olarak **Hatalara rağmen derlemeyi dene** modunda, ardından **İlk hatada dur**, sonraki derleme şu gibi görünüşte rastgele hata iletileri verebilir: `! File ended while scanning use of \@writefile`, dosyalarınızın içinden kaynaklanmıyor gibi görünen. Bu tür hatalar, önceki eksik derlemenin ürettiği ve geride bıraktığı kısaltılmış dosyalardan kaynaklanıyor olabilir. Bu durumda, [Sıfırdan yeniden derle](/latex/tr/bilgi-bankasi/028-clearing-the-cache.md) böylece sonraki derleme, hâlâ **İlk hatada dur** modu, temiz bir başlangıç yapma ve ilk ilgili hatayı gösterme şansına sahip olur. Hâlâ görünürde olmayan bir dosyadan kaynaklanan hatalar alıyorsanız — örn., `output.aux`, `output.toc` vb.—şuna bir göz atın [bu yardım sayfasına](/latex/tr/bilgi-bankasi/066-how-to-find-and-fix-errors-reported-in-generated-files.md).

## Daha düşük seviyeli bazı ayrıntılar

Bu **Hatalara rağmen derlemeyi dene** derleme modu `latexmk` aşağıdaki bayraklarla:

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

Bu **İlk hatada dur** derleme modu ise bunun yerine latexmk’i aşağıdaki bayraklarla çalıştırır:

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

Buradayken, hakkında daha fazla okumak da ilginizi çekebilir [Overleaf’in nasıl kullandığı `latexmk` aracı](/latex/tr/bilgi-bankasi/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/tr/bilgi-bankasi/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.