الأخطاء الشائعة وكيفية إصلاحها
معظم المشكلات لا توقف المستند: تُتخطى الأوامر غير المعروفة وتُسرد في تبويب «المشكلات»، وتُعرض الصيغة التي لا يمكن قراءتها باللون الأحمر ويُذكر اسمها هناك، وتُعلَّم الصور أو الاستشهادات المفقودة في مكانها؛ ولا يوقف المستند كله إلا صورة EPS.
كيف يُبلَّغ عن المشكلات
يتوقف تثبيت TeX عند أول خطأ ويسألك ماذا تفعل. أما Scissor LaTeX فيواصل: ينضّد أكبر قدر ممكن من المستند ويسرد ما لم يستطع التعامل معه في تبويب «المشكلات» تحت المعاينة. ولكل مدخل السطر الذي يشير إليه حين يكون معروفًا، والنقر عليه ينقلك إليه.
هناك أربعة أنواع من النتائج:
| ما تراه | ما يعنيه | أين تبحث |
|---|---|---|
| رسالة في تبويب «المشكلات»، والمستند سليم | تُخطي شيء ما أو حُذف. | الأقسام أدناه. |
| صيغة معروضة على شكل شيفرة مصدرية حمراء | تعذّرت قراءة تلك الصيغة. | الصيغ الحمراء |
[key?] أحمر أو مربع رمادي متقطع الحدود | استشهاد أو صورة مفقودة. | الاستشهادات والصور المفقودة |
| لا صفحات على الإطلاق، وخطأ في الأعلى | فشل المستند كله. | حين لا يُنضَّد المستند كله |
"Skipped N unknown commands"
هذه هي الرسالة التي ستراها أكثر من غيرها، وهي المقابل لرسالة LaTeX "Undefined control sequence". يُتخطى الأمر الذي لا يعرفه 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.