Я использую версию MiKTeX 2.8 для Windows.
В первую очередь мы разрабатываем программное обеспечение и используем LaTeX для составления пользовательских инструкций. Мы используем LaTeX, потому что:
- Отлично под контролем версий для отслеживания изменений и т. Д.
- Исходные файлы не могут внезапно стать поврежденными, в отличие от документов Word.
- Несколько документов могут иметь общие разделы, поэтому мы можем применить принцип DRY к нашей документации и избежать рассинхронизации одних документов с другими. Вы можете иметь составные документы в Word, но я обнаружил, что они чертовски нестабильны.
Как часть процесса автоматической сборки на нашем сервере сборки, мы создаем документацию, используя исполняемый файл Texify от MiKTeX. Это работает довольно хорошо.
Однако проблемы возникают, когда разработчик делает ошибку (например, \ ref на \ label, который не существует). Такая ошибка генерирует предупреждение только в LaTeX. Предупреждение остаётся незамеченным для texify, и мы остаемся с ошибками в документации.
В настоящее время у меня есть этап сборки, который сканирует файлы журналов на наличие строк, начинающихся с «Предупреждение LaTeX», и не выполняет сборку, если таковые имеются. Это работает, но, очевидно, довольно нестабильно и может пропускать предупреждения. В настоящее время он не используется в локальных сборках на машинах разработчиков, но если это единственный способ сделать это, мне, возможно, придется интегрировать его с редактором, который мы сейчас используем (TeXworks поставляется с MiKTeX).
Я бы хотел прервать сборку, если появятся какие-либо предупреждения, такие как неопределенная ссылка, и я бы предпочел не проводить нестабильное сканирование файлов журнала. Что-нибудь предлагает эту функцию?
Если я смогу использовать эту функцию в локальных сборках на машинах разработчиков, а также на сервере сборки, это будет огромным бонусом.
