Грамотная трансляция документа

Вот LaTeX закончил транслировать документ и выдал список допущенных нами ошибок. Поговорим о том, как быстрее разобраться с ними и меньше допускать в будущем.

Новый документ

Если вы только приступили к созданию документа, транслируйте его небольшими порциями. А именно:

• наберите небольшой фрагмент текста, например, абзац;
• транслируйте его;
• найдите первую из появившихся в набранном тексте ошибок;
  • Первая из ошибок, выданных LaTeX по результатам трансляции — самая важная. Нередко все остальные являются следствиями этой первой ошибки и исчезнут сразу же, как только она будет устранена.
  • Найти ошибку поможет редактор. Современные редакторы находят строку с ошибкой по одному нажатию кнопки;
• исправьте найденную ошибку (все остальные пока можно проигнорировать);
• снова транслируйте документ (скорее всего, список ошибок сократится больше чем на одну ошибку);
• найдите первую из ошибок;
• ...

Найти ошибки будет просто, так как "под подозрением" окажется всего один абзац текста.

По мере приобретения опыта размер набираемого фрагмента будет расти и со временем вы просто перестанете задумываться об этом.

Существующий документ

Если ошибку нужно найти в готовом документе, то поставьте в нём \end{document}, стараясь часть текста, содержащую ошибку. Здесь может помочь бинарный поиск

• поставьте \end{document} в середине документа;
• если ошибок не обнаружено, переместите \end{document} в середину отсеченной части текста;
• если ошибки есть, то вновь разделите документ пополам...

После того как корректно набранная часть текста будет определена, перемещайте \end{document} вперёд, исправляя найденные ошибки.

Если документ состоит из нескольких файлов, подключенных с помощью \input или \include, то на первое время эти команды можно закомментировать. Кроме того, по тексту из подключаемых файлов можно перемещать команду \endinput, которая работает для этих файлов так же, как \end{document} для основного документа.

Как поступать с найденными ошибками

Принцип здесь простой: если не понимаешь смысла сообщения об ошибке, скопируй его и поищи в Гугле или Яндексе.

Строка с ошибкой может быть указана неточно. Например, ошибка находится внутри абзаца, а сообщение указывает на последнюю строку этого абзаца. Нужно поискать ошибку в окрестности того места, на которое указывает сообщение.

Используйте специализированный редактор

Современные редакторы TeX-документов, например, Texmaker и TeXstudio автоматически закрывают окружения, дополняют команды и могут указать на незакрытые скобки. Используйте редакторы, предназначенные для работы с TeX или имеющие плагины для такой работы — и ошибок станет меньше.

Система контроля версий

При создании важных документов используйте системы контроля версий, например, svn. Использовать такие системы сейчас можно прямо из редактора.