خطاهای رایج و راه رفع آن‌ها
بیشتر مشکلات سند را متوقف نمی‌کنند: فرمان‌های ناشناخته نادیده گرفته و در زبانهٔ مشکلات فهرست می‌شوند، فرمولی که خوانده نشود به رنگ قرمز نشان داده و آنجا نام برده میشود، و تصویرها یا استنادهای گم‌شده در جای خود علامت می‌خورند؛ فقط یک تصویر 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.