Panele git

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 \usepackage satı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 .sty dosyanı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. -Stealth okları için \usetikzlibrary{arrows.meta}). Türkçe babel kullanıyorsanız Türkçe belgeler sayfasındaki ayarı yapın.
Günlükteki mesaj
Missing $ inserted
Anlamı ve çözümü
x^2, \alpha gibi 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ü
\usepackage veya \usetikzlibrary satı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/x sıfır yakınında). Grafiğin domain aralığını daraltın veya y değerlerini sınırlayın.
Günlükteki mesaj
Ana dosya bulunamadı.
Anlamı ve çözümü
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:

  1. Üst çubuktaki motor seçiminden pdfLaTeX'i seçin.
  2. Yeniden Derle'ye basın.
  3. Belgeniz fontspec kullanıyorsa XeLaTeX, biblatex kullanı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 samples değeri. Çoğu eğri için samples=50 ile 100 arası yeterlidir.
  • Çok büyük \foreach döngüleri veya iç içe döngüler.
  • Uzun, çok sayfalı belgeler. Tek tek şekilleri ayrı standalone dosyalarda hazırlamak daha hızlıdır.
  • Sonsuz döngüye giren bir makro.
Daha hızlı bir grafik
% 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. standalone belge 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.
Tüm yardım konuları