Sık karşılaşılan hatalar ve çözümleri
Çoğu sorun belgeyi durdurmaz: bilinmeyen komutlar atlanır ve Sorunlar sekmesinde listelenir, okunamayan bir formül kırmızı gösterilir ve orada belirtilir, eksik görseller veya atıflar yerinde işaretlenir; yalnızca bir EPS görseli belgenin tamamını durdurur.
Sorunlar nasıl bildirilir
Bir TeX kurulumu ilk hatada durur ve ne yapacağınızı sorar. Scissor LaTeX ise devam eder: belgenin olabildiğince büyük bir kısmını dizer ve işleyemediklerini önizlemenin altındaki Sorunlar sekmesinde listeler. Bilindiği durumlarda her girdi ilgili olduğu satırı gösterir; girdiye tıklamak sizi oraya götürür.
Dört tür sonuç vardır:
| Ne görürsünüz | Ne anlama gelir | Nereye bakmalı |
|---|---|---|
| Sorunlar sekmesinde bir ileti, belge sorunsuz | Bir şey atlandı veya dışarıda bırakıldı. | Aşağıdaki bölümler. |
| Kırmızı kaynak kod olarak gösterilen bir formül | O formül okunamadı. | Kırmızı formüller |
Kırmızı bir [key?] veya gri kesikli bir kutu | Bir atıf veya bir görsel eksik. | Eksik atıflar ve görseller |
| Hiç sayfa yok, üstte bir hata | Belgenin tamamı başarısız oldu. | Belgenin tamamı dizilmediğinde |
"Skipped N unknown commands"
En sık göreceğiniz ileti budur ve LaTeX'in "Undefined control sequence" hatasının karşılığıdır. Scissor LaTeX'in tanımadığı bir komut atlanır: adı kaybolur, süslü parantezlerindeki metin kalır.
Bilinmeyen bir komut: ad gider, metin kalır
The value is \highlightvalue{44} and the unit is \unitname{kg}.Sorunlar sekmesi: Skipped 2 unknown commands: \highlightvalue, \unitname
Ne yapmalı:
- Yazımı kontrol edin.
\textbfçalışır,\textboldçalışmaz. - Komut bir paketten geliyorsa paketi paket sayfalarında arayın. Bazı komutların basit bir karşılığı vardır.
- Kendi komutunuzsa kullanılmadan önce
\newcommandile tanımlandığından emin olun (bkz. Kendi komutlarınız).
Bilinmeyen bir ortam ise farklıdır: hiçbir ileti olmadan sessizce kaldırılır ve içeriği kalır. Metin biçimlendirilmemiş görünüyorsa ortamın adını kontrol edin.
"Package ... is not available here"
\usepackage hiçbir zaman başarısız olmaz. Scissor LaTeX'in tanımadığı bir paket Sorunlar sekmesinde not edilir ve biçimlendirmesi uygulanmaz. Belgenin geri kalanı her zamanki gibi dizilir; paketten gelen ve tanınmayan komutlar bilinmeyen komut olarak bildirilir.
Kullanılamayan bir paket
\documentclass{article}
\usepackage{fancyboxes2}
\begin{document}
The document still typesets.
\end{document}Sorunlar sekmesi: Package fancyboxes2 isn't supported in the preview, so its formatting is not applied. If it is your own package, add fancyboxes2.sty to the project.
Kırmızı formüller
Bir formül, matematik dönüştürücünün okuyamadığı bir şey içerdiğinde o formül kırmızı kaynak kod olarak gösterilir. Belgenin geri kalanı etkilenmez. Sorunlar sekmesi formülü, satırını ve nedenini belirtir, örneğin "This formula could not be read: \symbf{v} (unknown command: \symbf)"; on formülden sonra ek bir satır kalanların sayısını verir.
\symbf mevcut değil, bu yüzden formül kırmızı
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.Kırmızıyla gösterilir: formül okunamıyor, bu yüzden yerine kaynak kodu gösteriliyor.
Yaygın nedenler ve çözümler:
| Neden | Çözüm |
|---|---|
\abs{x}, \norm{x}, \dv{f}{x} (physics) | \left\lvert x \right\rvert, \left\lVert x \right\rVert, \frac{df}{dx} |
\SI{44}{\kilo\gram} (siunitx) | 44\,\mathrm{kg} |
\sideset | Formülü onsuz yeniden yazın. |
Eşi olmayan bir $ | Formülü kapatın. Kapatılmamış bir $ kırmızı olmaz: paragrafın geri kalanını, bir sonraki boş satıra kadar, birbirine yapışık italik matematiğe çevirir. |
Eksik atıflar ve görseller
Hiçbir .bib dosyasında bulunmayan bir atıf anahtarı kırmızı bir [key?] olarak yazdırılır ve Sorunlar sekmesi eksik anahtarları listeler. Eksik bir görsel, dosya adını taşıyan gri kesikli bir kutuya dönüşür.
Projede olmayan bir görsel
\begin{figure}[h]
\centering
\includegraphics[width=0.5\linewidth]{figures/plot.png}
\caption{A plot that has not been uploaded yet.}
\end{figure}
Sorunlar sekmesi: Images not in the project: figures/plot.png
Dosyayı aynı yolla projeye yükleyin ya da yolu düzeltin. Uzantı verilmediğinde .png, .jpg, .jpeg ve .svg dosyaları bulunur; PDF ve EPS şekiller de kutuyu gösterir (bkz. Şekiller ve görseller). Atıflar için Kaynakçalar ve atıflar sayfasına bakın.
Diğer iletiler
| İleti | Anlamı | Ne yapmalı |
|---|---|---|
| "N included files are not part of this conversion" | \subfile, \import, \lstinputlisting, \inputminted veya \includepdf atlandı. | \input kullanın ya da içeriği yapıştırın. |
| "File not found: ..." | Bir \input veya \include, projede olmayan bir dosyayı belirtiyor. | Yolu projenin en üst klasöründen itibaren kontrol edin. |
| "N pictures of an unsupported kind are not included" | Bir tikzcd, circuitikz, forest veya picture ortamı dışarıda bırakıldı. | Bkz. TikZ ile çizimler. |
| "TikZ option '...' is not supported yet" | Bir resim, çizim motorunun tanımadığı bir seçenek kullanıyor. Resim o seçenek olmadan çizilir. | Seçeneği kontrol edin ya da çıkarın. |
| "Layout in the style of ... Not official." | Bir konferans sınıfı veya paketi benzer bir düzene geçti. | Bir şey yapmanıza gerek yok; bu bir bilgidir. |
| "Macro expansion stopped at the safety limit" | Bir komut kendi içine ya da çok büyük miktarda metne açılıyor. | Kendi adını kullanan bir \newcommand arayın. |
| "This formula could not be read: ..." | Formül kırmızı gösterilir; neden köşeli parantez içindedir. | Bkz. Kırmızı formüller. |
| "References to labels that do not exist (shown as ??): ..." | Bir \ref, \eqref, \pageref veya \cref, tanımlanmamış bir etiketi ya da kırmızı bir formüldeki etiketi belirtiyor. | Etiketin yazımını kontrol edin. |
| "Bibliography style ... is not available; using numbered references [1] instead" | \bibliographystyle, alpha gibi listede olmayan bir stil belirtiyor. | Listeden bir stil seçin ya da numaralı kaynakları kullanmaya devam edin. |
| "Skipped .bib entries: ..." | .bib dosyasındaki bu girdiler okunamadı (eksik bir parantez, yinelenen bir anahtar); diğerleri kullanılır. | Belirtilen satırdaki girdiyi düzeltin. |
Burada görmeyeceğiniz LaTeX hataları
Bazı klasik LaTeX hataları Scissor LaTeX'te hiçbir şeyi durdurmaz; bu da onları gözden kaçırmayı kolaylaştırır:
| LaTeX hatası | Scissor LaTeX ne yapar |
|---|---|
Metindeki x_1 için "Missing $ inserted" | x_1 ifadesini harfi harfine yazdırır. Matematiği $...$ içine koyun. |
| "Misplaced alignment tab character &" | & işaretini harfi harfine yazdırır. Ve işareti için \& yazın. |
| "Extra }, or forgotten $" | Dengesiz süslü parantezleri yok sayar. |
| "\begin{itemize} ended by \end{document}" | Ortamı sizin yerinize kapatır. |
| "Reference ... undefined" | Kalın bir ?? yazdırır; Sorunlar sekmesi eksik etiketleri listeler. |
LaTeX'in reddedeceği metin
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.Bu belgeler bir TeX kurulumunda yine de başarısız olabilir, bu yüzden önizleme düzgün görünse bile onları düzeltin.
TeX kurulumundan farklı olanlar
Belirtilere göre bir kontrol listesi için Sorun giderme sayfasına bakın.
Sorular ve yanıtlar
"Undefined control sequence" ne anlama gelir?
LaTeX bir komutu tanımıyor; bunun nedeni genellikle bir yazım hatası ya da eksik bir pakettir. Scissor LaTeX'te aynı durum Sorunlar sekmesinde "Skipped N unknown commands" olarak görünür ve belge yine de dizilir.
Formülüm neden kırmızı?
Formül, matematik dönüştürücünün tanımadığı bir komut içeriyor; örneğin \symbf veya \abs. Sorunlar sekmesi onu belirtir. O komutu değiştirin; bu sayfadaki tablo yaygın karşılıkları listeler.
Belgemde neden [key?] görüyorum?
Atıf anahtarı projenin hiçbir .bib dosyasında yok. Yazımı ve .bib dosyasının yüklendiğini kontrol edin.
Bu sayfadaki her örnek, site oluşturulurken Scissor LaTeX tarafından dizilir. Son güncelleme: 2026-11-07.