Sorun giderme
Sık görülen LaTeX hataları ne anlama gelir; eksik paket, zaman aşımı, derleme sınırı ve boş önizleme nasıl çözülür?
Derleme Başarısız olduğunda önce Derleme günlüğüne bakın. ! ile başlayan ilk satır asıl hatadır; sonraki hatalar çoğu zaman ilkinin sonucudur. l.15 gibi bir ifade hatanın bulunduğu satırı gösterir ve editörde o satırın yanında kırmızı bir işaret çıkar.
Sık görülen hatalar
- Günlükteki mesaj
Undefined control sequence- Anlamı ve çözümü
- Komut adı yanlış yazılmış (
\drw,\nod) ya da komutu sağlayan paket yüklenmemiş. Satırdaki komutun yazımını ve gerekli\usepackagesatırını kontrol edin.
- Günlükteki mesaj
File 'xyz.sty' not found- Anlamı ve çözümü
- Paket bulunamadı. Tectonic'te bu paket önbellekte yoktur: motoru pdfLaTeX yapıp yeniden deneyin. Kendi
.stydosyanızsa projeye yüklediğinizden emin olun.
- Günlükteki mesaj
I did not find the tikz library 'xyz'- Anlamı ve çözümü
- TikZ kütüphanesinin adı yanlış ya da Tectonic'te önbellekte yok. Adını kontrol edin, sonra pdfLaTeX ile deneyin.
- Günlükteki mesaj
Environment tikzpicture undefined- Anlamı ve çözümü
- Önsözde
\usepackage{tikz}eksik.
- Günlükteki mesaj
I do not know the key '/tikz/...'- Anlamı ve çözümü
- Seçenek adı yanlış yazılmış (ör.
colour=red) ya da gerekli kütüphane yüklenmemiş (ör.-Stealthokları için\usetikzlibrary{arrows.meta}). Türkçebabelkullanıyorsanız Türkçe belgeler sayfasındaki ayarı yapın.
- Günlükteki mesaj
Missing $ inserted- Anlamı ve çözümü
x^2,\alphagibi matematik ifadeleri$...$dışında yazılmış. Düğüm metninde de{$x^2$}biçimini kullanın.
- Günlükteki mesaj
Missing } inserted,Extra },File ended while scanning- Anlamı ve çözümü
- Süslü parantezler dengeli değil. Açılan her
{için bir}olmalı.
- Günlükteki mesaj
Emergency stop/no legal \end found- Anlamı ve çözümü
\end{document}satırı eksik ya da bir ortam (\begin{...}) kapatılmamış.
- Günlükteki mesaj
Can be used only in preamble- Anlamı ve çözümü
\usepackageveya\usetikzlibrarysatırı\begin{document}sonrasına yazılmış; önsöze taşıyın.
- Günlükteki mesaj
No shape named 'A' is known- Anlamı ve çözümü
(A)adıyla başvurduğunuz düğüm tanımlanmamış ya da adı farklı yazılmış (büyük-küçük harf önemlidir).
- Günlükteki mesaj
Dimension too large- Anlamı ve çözümü
- Çizilen değerler çok büyük (ör.
1/xsıfır yakınında). Grafiğindomainaralığını daraltın veyaydeğerlerini sınırlayın.
- Günlükteki mesaj
Ana dosya bulunamadı.- Anlamı ve çözümü
- Projede derlenecek dosya yok. Dosyalar panelinden bir
.texdosyası oluşturup Ana dosya yap seçin.
| Günlükteki mesaj | Anlamı ve çözümü |
|---|---|
Undefined control sequence | Komut adı yanlış yazılmış (\drw, \nod) ya da komutu sağlayan paket yüklenmemiş. Satırdaki komutun yazımını ve gerekli \usepackage satırını kontrol edin. |
File 'xyz.sty' not found | Paket bulunamadı. Tectonic'te bu paket önbellekte yoktur: motoru pdfLaTeX yapıp yeniden deneyin. Kendi .sty dosyanızsa projeye yüklediğinizden emin olun. |
I did not find the tikz library 'xyz' | TikZ kütüphanesinin adı yanlış ya da Tectonic'te önbellekte yok. Adını kontrol edin, sonra pdfLaTeX ile deneyin. |
Environment tikzpicture undefined | Önsözde \usepackage{tikz} eksik. |
I do not know the key '/tikz/...' | Seçenek adı yanlış yazılmış (ör. colour=red) ya da gerekli kütüphane yüklenmemiş (ör. -Stealth okları için \usetikzlibrary{arrows.meta}). Türkçe babel kullanıyorsanız Türkçe belgeler sayfasındaki ayarı yapın. |
Missing $ inserted | x^2, \alpha gibi matematik ifadeleri $...$ dışında yazılmış. Düğüm metninde de {$x^2$} biçimini kullanın. |
Missing } inserted, Extra }, File ended while scanning | Süslü parantezler dengeli değil. Açılan her { için bir } olmalı. |
Emergency stop / no legal \end found | \end{document} satırı eksik ya da bir ortam (\begin{...}) kapatılmamış. |
Can be used only in preamble | \usepackage veya \usetikzlibrary satırı \begin{document} sonrasına yazılmış; önsöze taşıyın. |
No shape named 'A' is known | (A) adıyla başvurduğunuz düğüm tanımlanmamış ya da adı farklı yazılmış (büyük-küçük harf önemlidir). |
Dimension too large | Çizilen değerler çok büyük (ör. 1/x sıfır yakınında). Grafiğin domain aralığını daraltın veya y değerlerini sınırlayın. |
Ana dosya bulunamadı. | Projede derlenecek dosya yok. Dosyalar panelinden bir .tex dosyası oluşturup Ana dosya yap seçin. |
Tectonic'te eksik paket veya kütüphane
Tectonic hızlıdır ama yalnızca derleme ortamında önceden hazırlanmış paketleri kullanabilir ve internete çıkamaz. Yerel bilgisayarınızda çalışan bir belge burada "not found" hatası verebilir. Çözüm:
- Üst çubuktaki motor seçiminden pdfLaTeX'i seçin.
- Yeniden Derle'ye basın.
- Belgeniz
fontspeckullanıyorsa XeLaTeX,biblatexkullanıyorsa pdfLaTeX + Biber seçin.
pdfLaTeX'te de bulunamayan paketler derleme ortamına kurulu değildir. Bu durumda paketin .sty dosyasını projeye yükleyebilir veya sunucu yöneticisinden eklemesini isteyebilirsiniz.
Zaman aşımı
Bir derleme yaklaşık 12 saniyeden uzun sürerse durdurulur ve durum Zaman aşımı olur. Sık nedenleri:
- Grafiklerde çok yüksek
samplesdeğeri. Çoğu eğri içinsamples=50ile100arası yeterlidir. - Çok büyük
\foreachdöngüleri veya iç içe döngüler. - Uzun, çok sayfalı belgeler. Tek tek şekilleri ayrı
standalonedosyalarda hazırlamak daha hızlıdır. - Sonsuz döngüye giren bir makro.
% Yavaş: samples=2000
\draw[domain=-3:3, samples=80, smooth, variable=\x] plot ({\x}, {sin(\x r)});"Çok fazla derleme isteği" uyarısı
Dakikada en fazla 5 derleme yapabilirsiniz. Bu uyarıyı görürseniz bir dakika bekleyin. Her küçük değişiklikten sonra derlemek yerine birkaç değişikliği birlikte yapıp sonra derleyin.
Önizleme boş veya hatalı
- "Henüz önizleme yok" yazıyorsa proje henüz başarıyla derlenmemiştir. Durum rozetine bakın: Başarısız ise günlükteki hatayı düzeltin.
- Derleme Başarılı ama sayfa boşsa belgenizde görünür bir içerik olmayabilir (ör. boş bir
tikzpicture) ya da çizim sayfanın dışına taşmış olabilir.standalonebelge sınıfı sayfayı çizime göre kırpar. - "PDF yüklenemedi" yazıyorsa veya gri bir kutu görüyorsanız sayfayı yenileyin (Ctrl+Shift+R, Mac'te Cmd+Shift+R). Eski derleme dosyaları 24 saat sonra silinir; yeniden derleyin.
Diğer sorunlar
- Kaydedilemedi rozeti: bağlantınız kopmuş olabilir. Kodunuzu bir yere kopyalayın, sayfayı yenileyin ve tekrar yapıştırın.
- Dosya yüklenmiyor: dosya 5 MB'tan büyük olabilir. Dosya adındaki boşluklar otomatik olarak tireye çevrilir; Türkçe harfler korunur. Bkz. Projeler ve dosyalar.
- `\input` ile çağırdığım dosya bulunamıyor: yol proje köküne göre yazılmalıdır (
sekiller/ucgen.tex); dosya adının harfi harfine (büyük/küçük harf dahil) aynı olduğundan emin olun.