ข้ามไปยังเนื้อหา
Scissor LaTeX

ข้อผิดพลาดที่พบบ่อยและวิธีแก้ไข

ปัญหาส่วนใหญ่ไม่ทำให้เอกสารหยุด: คำสั่งที่ไม่รู้จักจะถูกข้ามและแสดงในแท็บปัญหา สูตรที่อ่านไม่ได้จะแสดงเป็นสีแดงและถูกระบุไว้ที่นั่น รูปภาพหรือการอ้างอิงที่หายไปจะถูกทำเครื่องหมายไว้ตรงตำแหน่ง มีเพียงรูปภาพ EPS เท่านั้นที่ทำให้ทั้งเอกสารหยุด

ปัญหาถูกรายงานอย่างไร

การติดตั้ง TeX จะหยุดที่ข้อผิดพลาดแรกและถามว่าคุณจะทำอะไรต่อ Scissor LaTeX ทำงานต่อไป: มันจัดหน้าเอกสารให้ได้มากที่สุดเท่าที่ทำได้ และแสดงรายการสิ่งที่จัดการไม่ได้ในแท็บ ปัญหา ใต้ตัวอย่าง แต่ละรายการระบุบรรทัดที่เกี่ยวข้องเมื่อทราบ และการคลิกจะพาไปยังบรรทัดนั้น

ผลลัพธ์มีสี่แบบ:

สิ่งที่คุณเห็นความหมายดูที่ไหน
ข้อความในแท็บปัญหา เอกสารปกติมีบางอย่างถูกข้ามหรือถูกตัดออกหัวข้อด้านล่าง
สูตรแสดงเป็นซอร์สโค้ดสีแดงอ่านสูตรนั้นไม่ได้สูตรสีแดง
[key?] สีแดง หรือกรอบเส้นประสีเทาการอ้างอิงหรือรูปภาพหายไปการอ้างอิงและรูปภาพที่หายไป
ไม่มีหน้าเลย มีข้อผิดพลาดอยู่ด้านบนทั้งเอกสารล้มเหลวเมื่อทั้งเอกสารจัดหน้าไม่ได้

"Skipped N unknown commands" (ข้ามคำสั่งที่ไม่รู้จัก)

นี่คือข้อความที่คุณจะเห็นบ่อยที่สุด และเทียบเท่ากับ "Undefined control sequence" ของ LaTeX คำสั่งที่ Scissor LaTeX ไม่รู้จักจะถูกข้าม: ชื่อของมันหายไป และข้อความในวงเล็บปีกกายังคงอยู่

คำสั่งที่ไม่รู้จัก: ชื่อหายไป ข้อความยังอยู่

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 ไม่รู้จักจะถูกบันทึกไว้ในแท็บปัญหา และการจัดรูปแบบของมันจะไม่ถูกนำไปใช้ ส่วนที่เหลือของเอกสารจัดหน้าตามปกติ และคำสั่งจากแพ็กเกจที่ไม่รู้จักจะถูกรายงานว่าไม่รู้จัก

แพ็กเกจที่ไม่มีให้ใช้

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 สูตรจึงเป็นสีแดง

LaTeXเปิดในตัวแก้ไข
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?] สีแดง และแท็บปัญหาจะแสดงรายการคีย์ที่หายไป รูปภาพที่หายไปจะกลายเป็นกรอบเส้นประสีเทาพร้อมชื่อไฟล์

รูปภาพที่ไม่อยู่ในโปรเจกต์

LaTeXส่วนนำ: \usepackage{graphicx}เปิดในตัวแก้ไข
\begin{figure}[h]
  \centering
  \includegraphics[width=0.5\linewidth]{figures/plot.png}
  \caption{A plot that has not been uploaded yet.}
\end{figure}
จัดหน้าโดย Scissor LaTeX: รูปภาพที่ไม่อยู่ในโปรเจกต์

แท็บปัญหา: 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 จะปฏิเสธ

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