よくあるエラーと直し方
ほとんどの問題は文書を止めません。不明なコマンドは飛ばされて問題タブに一覧表示され、読み取れない数式は赤で表示されてそこに名前が挙がり、見つからない画像や引用はその場所に印が付きます。文書全体を止めるのは EPS 画像だけです。
問題の報告のされ方
TeX のインストール環境は最初のエラーで止まり、どうするかを尋ねてきます。Scissor LaTeX は止まりません。文書をできる限り組版し、扱えなかったものをプレビューの下の問題タブに一覧表示します。各項目には、わかる場合は該当する行が示され、クリックするとそこにジャンプします。
結果は 4 種類あります。
| 見えるもの | 意味 | 参照先 |
|---|---|---|
| 問題タブのメッセージ、文書は問題なし | 何かが飛ばされたか、省かれた。 | 以下の各セクション。 |
| 赤いソースコードとして表示される数式 | その数式を読み取れなかった。 | 赤い数式 |
赤い [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)」のように、数式、その行、理由が表示されます。10 個を超えると、残りの数を示す行が 1 行追加されます。
\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 の動作 |
|---|---|
テキスト中の x_1 に対する「Missing $ inserted」 | 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