> 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/sorular-ve-cevaplar/81-tips-and-tricks-for-troubleshooting-latex.md).

# LaTeX sorunlarını giderme için ipuçları ve püf noktaları

LaTeX sorunlarını belirlemenize ve çözmenize yardımcı olmak için kullanabileceğiniz birkaç ipucu ve püf noktası vardır. Genellikle hata ayıklamayı şu seçenek açıkken yapmanızı öneririz: [İlk Hata Üzerinde Dur derleme modu açık](/latex/tr/bilgi-bankasi/149-using-the-stop-on-first-error-compilation-mode.md), çünkü hata birikmesini önlemenizi sağlar. Bir hatayla karşılaştığınızda, bunu çözmek için şu adımları izleyebilirsiniz:

1. **Bir hata ya da uyarı var mı?**

   "Logs and output files" simgesine bakarak başlayın; bu simge Recompile düğmesinin hemen sağındadır.

   !["Logs and output files" simgesindeki bir uyarı göstergesi](/files/dc44ca43c897fd04e4d7a9a3731c652e9a031318)

   Uyarı mesajları turuncu renkte gösterilir. Bunlar çoğu zaman yalnızca LaTeX'in alışılmadık bir şey bulduğunu ve otomatik düzeltmeler yaptığını bildiren uyarılardır. Belgenizin son görünümünü etkilemiyorlarsa genellikle göz ardı edilebilirler.

   Örneğin, birçok kayan nesne ve kenar boşluğu/boşluk sorunu, kullanıcının düzeltmesine gerek kalmadan LaTeX tarafından düzeltilir. Overleaf özel bir uyarı sınıfı bildirir, [yetersiz dolu ve aşırı dolu kutu uyarıları](/latex/tr/bilgi-bankasi/138-understanding-underfull-and-overfull-box-warnings.md#overfull-or-underfull-boxes-are-not-errors), mavi renkte—bunların çoğu güvenle göz ardı edilebilir, ancak bazen kontrol edilmesi gereken belgenizin bir bölümünü vurgularlar.

   !["Logs and output files" simgesinde bir hata göstergesi.](/files/29d01ea94f4994cc0890f3872f4f80b7e8c435af)

   Hata mesajları kırmızı renkte gösterilir. Bunlar genellikle daha sorunludur ve belgenin düzgün derlenmesini engelleyebilir. Kritik hatalar belgenin tamamen derlenmesini engelleyebilir.

   Yaygın hataların ve bunların nasıl çözüleceğinin bir listesi vardır [burada](/latex/tr/latex-temelleri/05-errors.md). Hataların mümkün olan en kısa sürede düzeltilmesini öneririz; çünkü birikmelerine izin vermek gelecekte ayıklaması zor ve kritik hatalara yol açabilir.
2. **Mesaj belirli bir hatayı veya satır numarasını belirtiyor mu?**

   ![Satır numarası içeren bir hata mesajı.](/files/a4d4ea20fb3f59fee1f13b59846da05c311caeb4)

   Çoğu durumda, LaTeX motoru tam hatayı anlayacak ve size bir satır numarası verecek kadar akıllıdır. Yukarıdaki örnekte bir sembol vardı `_`, ve LaTeX bunu şu şekilde kaçırmanızı gerektirir: `\_`. Hata mesajı hatta hatanın 29. satırda olduğunu belirtir, ilgili satırı vurgular ve sorunun bulunduğu metnin bir bölümünü gösterir. Hatanın kaynak kodda oluştuğu dosya ve satır numarasına doğrudan gitmek için hata mesajına tıklayabilirsiniz.

   Eğer satır numarası belirtilmiyorsa, aşağıdaki adımlardan bazılarını denemeye devam edin.
3. **Hata metni bir ipucu veriyor mu?**

   ![Sorunun .bbl dosyasında olduğunu belirten bir hata mesajı; bu da kaynakça ile ilgili bir soruna işaret ediyor.](/files/e092a3693fcd7e55d8ff6e06ed131b27c7babfc4)

   Yukarıdaki hata mesajında bir satır numarası veriliyor, ancak genellikle düzenlediğiniz bir dosya için değil. Burada dosya uzantısı olan .bbl, derlemeyi engelleyen hatanın bir BibTeX sorunu olduğuna dair ipucu veriyor.

   .bib dosyanızda vurgulanan metni aramak, hatanın kaynağını bulmanızı sağlar. Bazen [yardımcı ve günlük dosyalarını kontrol etmek](/latex/tr/bilgi-bankasi/150-view-generated-files.md) kısa mesaj diyaloglarının sunduğundan daha ayrıntılı bilgiler ortaya çıkarabilir.
4. **Önceki sürümleri karşılaştırın ve değişiklikleri geri alın**

   Projeniz daha önce sorunsuz derleniyorsa, son düzenlemelerinizde projeye muhtemelen bir hata eklemişsinizdir. Şunu kullanabilirsiniz: [Geçmiş özelliği](/latex/tr/daha-fazla-konu/49-using-the-history-feature.md) son değişiklikleri geri almak için.
5. **\end{document} komutunu taşımayı deneyin**

   Hatanın konumunu hâlâ daraltamadıysanız, şunu kesin: `\end{document}` ana .tex dosyanızın en sonundan alıp projenizin çeşitli bölümlerine yapıştırmayı deneyin. Ana .tex dosyasıyla başlayın ve ardından gerekirse ana dosyanızda şununla çağırdığınız tüm alt dosyalara geçin: `\input{}` ya da `\include{}`. Proje/belgenin en sonundan belgenin başına doğru sistematik bir şekilde ilerleyin ve bu işlemi her seferinde bir bölüm için tekrarlayın. Özellikle küçük hatalara açık denklemlere veya diğer karmaşık bölümlere dikkat edin.

   Bu, hatayı içeren bölümü izole edene kadar belgenizi giderek daha küçük bir belgeyle sınırlamanıza yardımcı olmalıdır. Belge aniden derlenmeye başlarsa, hatalı bölümü bulmuşsunuz demektir. Çoğu durumda sorun, yanlış yazılmış bir komut, kaçırılmamış bir özel karakter veya eksik bir köşeli parantez kadar basit olabilir.
6. **Bu bir derleme "zaman aşımı" hatası mı?**

   Bazı durumlarda, kullanıcılar belirli koşullar altında zaman aşımı derleme hatalarıyla karşılaşabilir. Bunun nedeni sunucularımızdaki kaynak/derleme süresi sınırlarıdır. Ücretsiz hesaplar ve ücretli hesaplar için farklı süre sınırlarımız vardır. Şunu yapmak için elimizde bir dizi ipucu var: [belgenizin daha hızlı derlenmesini sağlamak](/latex/tr/bilgi-bankasi/038-fixing-and-preventing-compile-timeouts.md), ve bunlar işe yaramazsa, bizimle şu konuda iletişime geçmekten çekinmeyin: [destek talebi](https://www.overleaf.com/contact).
7. **Bu bir “PDF oluşturma” hatası mı?**

   Diğer çevrimiçi hizmetlerde olduğu gibi, Overleaf kullanırken bazen sorunlarla karşılaşabilirsiniz. Tarayıcı durumu, tarayıcı uzantıları, hizmet sağlayıcıların kısa süreli kesintileri ve ağ yapılandırma sorunları potansiyel olarak problemlere neden olabilir.

   Bağlantı sorunları yaşıyorsanız veya editör ya da PDF görüntüleyicisinin bir bölümü yüklenmiyor ya da beklendiği gibi görüntülenmiyorsa, lütfen şu sayfadaki sorun giderme adımlarını deneyin: [bu sayfa](/latex/tr/bilgi-bankasi/125-resolving-access-loading-and-display-problems.md).
8. **Forumları deneyin**

   Eğer satır numarası verilmemişse ve verilen hata mesajını çözemiyorsanız, en sevdiğiniz arama motorunda hızlı bir "kopyala-yapıştır" araması, benzer bir sorun yaşamış uzman kullanıcılardan bilgi ortaya çıkarabilir. TeX ile ilgili bazı mükemmel forumlar şunlardır: [LaTeX Stack Exchange](https://tex.stackexchange.com/) ve [LaTeX Community](https://latex.org/forum/).
9. **Bize ulaşın**

   Son olarak, ama en az önemlisi, bize her zaman şunu gönderebilirsiniz: [destek talebi](https://www.overleaf.com/contact). Sorununuz ne olursa olsun, LaTeX'e özgü ya da siteye özgü fark etmez, Overleaf deneyiminizden en iyi şekilde yararlanmanıza yardımcı olmaktan memnuniyet duyarız.


---

# 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/sorular-ve-cevaplar/81-tips-and-tricks-for-troubleshooting-latex.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.