Отладка ошибок конвертации в Pandoc

Рассмотрим способы получения информации об ошибка при конвертации файлов через Pandoc. Все примеры расположены в репозитории.

Попробуем конвертировать md-файл в html:

Появляется предупреждение:

Файл всё равно будет конвертирован. Причем pandoc завершит работу без кода ошибки. Если нужно чтобы в случае предупреждения код ошибки был не равен 0, то используйте команду --fail-if-warnings:

Результатом будет:

Код ошибки 3 — специальный код ошибки для предупреждений.

Параметр --quiet скрывает предупреждения:

Параметры --fail-if-warnings и --quiet могут работать одновременно: предупреждения не будут выводится, но код ошибки изменится.

Для более детального вывода испольуйте параметр --verbose:

Дополнительно будут выведены информационные сообщения:

Детальный вывод особенно полезен при отладке конвертации в PDF.

Все виды сообщений можно дополнительно вывести в файл. Имя файла задаётся параметром --log=FILE_NAME:

Файл будет содержать данные в JSON:

Ссылки

Если вы нашли ошибку, пожалуйста, выделите фрагмент текста и нажмите Ctrl+Enter.

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *