שגיאות נפוצות ואיך לתקן אותן
רוב הבעיות לא עוצרות את המסמך: פקודות לא מוכרות מדולגות ומופיעות בלשונית הבעיות, נוסחה שאי אפשר לקרוא מוצגת באדום ומצוינת שם, ותמונות או ציטוטים חסרים מסומנים במקומם; רק תמונת EPS עוצרת את כל המסמך.
איך מדווחות בעיות
התקנת TeX נעצרת בשגיאה הראשונה ושואלת מה לעשות. Scissor LaTeX ממשיך: הוא מסדר כמה שיותר מהמסמך ומפרט את מה שלא הצליח לטפל בו בלשונית הבעיות שמתחת לתצוגה המקדימה. לכל רשומה מצוינת השורה שאליה היא מתייחסת, כשהיא ידועה, ולחיצה עליה קופצת לשם.
יש ארבעה סוגים של תוצאה:
| מה רואים | מה זה אומר | איפה לחפש |
|---|---|---|
| הודעה בלשונית הבעיות, המסמך תקין | משהו דולג או הושמט. | הפרקים שבהמשך. |
| נוסחה שמוצגת כקוד מקור אדום | אי אפשר היה לקרוא את הנוסחה הזו. | נוסחאות אדומות |
[key?] אדום או מסגרת מקווקוות אפורה | ציטוט או תמונה חסרים. | ציטוטים ותמונות חסרים |
| אין עמודים בכלל, שגיאה למעלה | כל המסמך נכשל. | כשהמסמך כולו לא מסתדר |
"Skipped N unknown commands"
זו ההודעה שתראו הכי הרבה, והמקבילה ל-"Undefined control sequence" של LaTeX. פקודה ש-Scissor LaTeX לא מכיר מדולגת: השם שלה נעלם, והטקסט שבסוגריים המסולסלים שלה נשאר.
פקודה לא מוכרת: השם נעלם, הטקסט נשאר
The value is \highlightvalue{44} and the unit is \unitname{kg}.לשונית הבעיות: Skipped 2 unknown commands: \highlightvalue, \unitname
מה לעשות:
- בודקים את האיות.
\textbfעובד,\textboldלא. - אם הפקודה מגיעה מחבילה, מחפשים את החבילה בדפי החבילות. לחלק מהפקודות יש תחליף פשוט.
- אם זו פקודה שלך, בודקים שהיא מוגדרת עם
\newcommandלפני שמשתמשים בה (ראו פקודות משלך).
סביבה לא מוכרת היא מקרה אחר: היא מוסרת בשקט והתוכן שלה נשאר, בלי הודעה. אם טקסט נראה לא מעוצב, בודקים את שם הסביבה.
"Package ... is not available here"
\usepackage אף פעם לא נכשל. חבילה ש-Scissor LaTeX לא מכיר מצוינת בלשונית הבעיות, והעיצוב שלה לא מוחל. שאר המסמך מסתדר כרגיל, ופקודות לא מוכרות מהחבילה מדווחות כפקודות לא מוכרות.
חבילה שאינה זמינה
\documentclass{article}
\usepackage{fancyboxes2}
\begin{document}
The document still typesets.
\end{document}לשונית הבעיות: 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.
נוסחאות אדומות
כשנוסחה מכילה משהו שממיר המתמטיקה לא מצליח לקרוא, הנוסחה הזו מוצגת כקוד מקור אדום. שאר המסמך לא מושפע. לשונית הבעיות מציינת את הנוסחה, את השורה שלה ואת הסיבה, למשל "This formula could not be read: \symbf{v} (unknown command: \symbf)"; אחרי עשר נוסחאות, שורה אחת נוספת נותנת את מספר השאר.
\symbf לא זמינה, ולכן הנוסחה אדומה
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.באדום: אי אפשר לקרוא את הנוסחה, ולכן מוצג קוד המקור שלה במקומה.
סיבות נפוצות ותיקונים:
| סיבה | תיקון |
|---|---|
\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 | כותבים את הנוסחה מחדש בלעדיה. |
$ בלי בן הזוג שלו | סוגרים את הנוסחה. $ שלא נסגר לא הופך לאדום: הוא הופך את שאר הפסקה שלו למתמטיקה נטויה ורצופה, עד השורה הריקה הבאה. |
ציטוטים ותמונות חסרים
מפתח ציטוט שלא נמצא באף קובץ .bib מודפס כ-[key?] אדום, ולשונית הבעיות מפרטת את המפתחות החסרים. תמונה חסרה הופכת למסגרת מקווקוות אפורה עם שם הקובץ.
תמונה שלא נמצאת בפרויקט
\begin{figure}[h]
\centering
\includegraphics[width=0.5\linewidth]{figures/plot.png}
\caption{A plot that has not been uploaded yet.}
\end{figure}
לשונית הבעיות: Images not in the project: figures/plot.png
מעלים את הקובץ לפרויקט באותו נתיב, או מתקנים את הנתיב. בלי סיומת, נמצאים קבצים מסוג .png, .jpg, .jpeg ו-.svg; גם איורי PDF ו-EPS מציגים את המסגרת (ראו איורים ותמונות). לציטוטים, ראו ביבליוגרפיות וציטוטים.
הודעות אחרות
| הודעה | משמעות | מה לעשות |
|---|---|---|
| "N included files are not part of this conversion" | \subfile, \import, \lstinputlisting, \inputminted או \includepdf דולגו. | משתמשים ב-\input, או מדביקים את התוכן. |
| "File not found: ..." | \input או \include מציינים קובץ שלא נמצא בפרויקט. | בודקים את הנתיב מהתיקייה העליונה של הפרויקט. |
| "N pictures of an unsupported kind are not included" | סביבת tikzcd, circuitikz, forest או picture הושמטה. | ראו ציורים עם TikZ. |
| "TikZ option '...' is not supported yet" | תמונה משתמשת באפשרות שמנוע הציור לא מכיר. התמונה מצוירת בלעדיה. | בודקים את האפשרות, או משמיטים אותה. |
| "Layout in the style of ... Not official." | מחלקה או חבילה של כנס עברו לפריסה דומה למקור. | אין צורך לעשות דבר; זה מידע בלבד. |
| "Macro expansion stopped at the safety limit" | פקודה מתפרשת לעצמה, או לכמות עצומה של טקסט. | מחפשים \newcommand שמשתמש בשם של עצמו. |
| "This formula could not be read: ..." | הנוסחה מוצגת באדום; הסיבה מופיעה בסוגריים. | ראו נוסחאות אדומות. |
| "References to labels that do not exist (shown as ??): ..." | \ref, \eqref, \pageref או \cref מציינים תווית שלא מוגדרת, או תווית של נוסחה אדומה. | בודקים את האיות של התווית. |
| "Bibliography style ... is not available; using numbered references [1] instead" | \bibliographystyle מציין סגנון שלא נמצא ברשימה, כמו alpha. | בוחרים סגנון מהרשימה, או נשארים עם ההפניות הממוספרות. |
| "Skipped .bib entries: ..." | אי אפשר היה לקרוא את הרשומות האלה בקובץ ה-.bib (סוגר חסר, מפתח כפול); האחרות בשימוש. | מתקנים את הרשומה בשורה שצוינה. |
שגיאות LaTeX שלא תראו כאן
כמה שגיאות LaTeX קלאסיות לא עוצרות שום דבר ב-Scissor LaTeX, ולכן קל לפספס אותן:
| שגיאת LaTeX | מה Scissor LaTeX עושה |
|---|---|
"Missing $ inserted" עבור x_1 בטקסט | מדפיס את x_1 כפשוטו. שמים מתמטיקה בתוך $...$. |
| "Misplaced alignment tab character &" | מדפיס & כפשוטו. כותבים \& בשביל התו &. |
| "Extra }, or forgotten $" | מתעלם מסוגריים מסולסלים לא מאוזנים. |
| "\begin{itemize} ended by \end{document}" | סוגר את הסביבה בשבילך. |
| "Reference ... undefined" | מדפיס ?? מודגש; לשונית הבעיות מפרטת את התוויות החסרות. |
טקסט ש-LaTeX היה דוחה
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.מסמכים כאלה עלולים עדיין להיכשל בהתקנת TeX, ולכן כדאי לתקן אותם גם אם התצוגה המקדימה נראית תקינה.
מה שונה מהתקנת TeX
לרשימת בדיקה לפי תסמין, ראו פתרון בעיות.
שאלות ותשובות
מה המשמעות של "Undefined control sequence"?
LaTeX לא מכיר פקודה, בדרך כלל בגלל שגיאת הקלדה או חבילה חסרה. ב-Scissor LaTeX אותו מצב מופיע כ-"Skipped N unknown commands" בלשונית הבעיות, והמסמך עדיין מסתדר.
למה הנוסחה שלי אדומה?
הנוסחה מכילה פקודה שממיר המתמטיקה לא מכיר, כמו \symbf או \abs. לשונית הבעיות מציינת אותה. מחליפים את הפקודה; הטבלה בדף הזה מפרטת תחליפים נפוצים.
למה מופיע [key?] במסמך שלי?
מפתח הציטוט לא נמצא באף קובץ .bib בפרויקט. בודקים את האיות ושקובץ ה-.bib הועלה.
כל דוגמה בדף הזה מסודרת על ידי Scissor LaTeX בזמן בניית האתר. עודכן לאחרונה: 2026-11-07.