Обсуждение совместимости с pandoc (и/или другими конвертерами в word)

История вопроса:

https://github.com/AndreyAkinshin/Russian-Phd-LaTeX-Dissertation-Template/issues/329#issuecomment-531479722

> > `latex2rtf` на этом шаблоне не работает, например. Как и `pandoc`.
>
> @Barracuda72
> Как эти конвертеры должны бы работать на данном шаблоне, на Ваш взгляд? И как сохранять их работоспособность в реальном проекте пользователя, унаследованном от данного шаблона?

https://github.com/AndreyAkinshin/Russian-Phd-LaTeX-Dissertation-Template/issues/329#issuecomment-531503043
> > Как эти конвертеры должны бы работать на данном шаблоне, на Ваш взгляд?
>
> Хоть как-нибудь. Хотя бы чтоб текстовка и более-менее картинки конвертировались, формулы и таблицы уже не так существенно. Основная задача конвертации (для меня) - отправить работу человеку, который ни в TeX, ни в Git не может (и не хочет), чтобы он мог сделать какие-то правки / замечания к тексту работы. Честно говоря, я сам в TeX всего лишь пользователь, и не особо разбираюсь во всей нутрянке, поэтому не знаю, возможно ли это на текущем уровне сложности шаблона. Пока обхожусь PDF -> Word -> DOCX, но там тоже свои нюансы есть.
>
> > И как сохранять их работоспособность в реальном проекте пользователя, унаследованном от данного шаблона?
>
> Ну, это уже проблема пользователя, думается мне.

https://github.com/AndreyAkinshin/Russian-Phd-LaTeX-Dissertation-Template/issues/329#issuecomment-562324466
> > > Как эти конвертеры должны бы работать на данном шаблоне, на Ваш взгляд?
> >
> >
> > Хоть как-нибудь. Хотя бы чтоб текстовка и более-менее картинки конвертировались, формулы и таблицы уже не так существенно. Основная задача конвертации (для меня) - отправить работу человеку, который ни в TeX, ни в Git не может (и не хочет), чтобы он мог сделать какие-то правки / замечания к тексту работы
>
> У меня та же самая проблема. Последняя версия `pandoc` использует всю доступную память и подкачку, затем падает. `make4ht` выдаёт тонну ошибок. Кроме конвертации pdf->Word никаого решения я пока не нашёл
>
> > > И как сохранять их работоспособность в реальном проекте пользователя, унаследованном от данного шаблона?
> >
> >
> > Ну, это уже проблема пользователя, думается мне.
>
> Именно.

https://github.com/AndreyAkinshin/Russian-Phd-LaTeX-Dissertation-Template/issues/329#issuecomment-562437118
> > make4ht выдаёт тонну ошибок
>
> Посмотрите, если поудалять latex-код, то когда компиляция пройдет нормально (можно вообще начать с пробы на каждой из глав в шаблоне)?
>
> > Последняя версия pandoc использует всю доступную память и подкачку, затем падает.
>
> Предлагаю сделать воспроизводимый пример для авторов `pandoc` и отправить им issue (может быть, подойдет и ссылка на конкретную версию репозитория шаблона). Если инструмент не сообщает, что ему в шаблоне "не нравится", то и искать способы улучшить совместимость шаблона с ним становится проблематично.

https://github.com/AndreyAkinshin/Russian-Phd-LaTeX-Dissertation-Template/issues/329#issuecomment-562582353
> > Посмотрите, если поудалять latex-код, то когда компиляция пройдет нормально (можно вообще начать с пробы на каждой из глав в шаблоне)?
>
> Компиляция не доходит до dissertation.tex, похоже
>
> > :~/Template$ make4ht dissertation
> > [STATUS] make4ht: Conversion started
> > [STATUS] make4ht: Input file: dissertation
> > [ERROR] htlatex: Compilation errors in the htlatex run
> > [ERROR] htlatex: Filename Line Message
> > [ERROR] htlatex: /usr/local/texlive/2019/texmf-dist/tex/latex/cleveref/cleveref.sty 2954 Undefined control sequence.
> > [ERROR] htlatex: /usr/local/texlive/2019/texmf-dist/tex/latex/cleveref/cleveref.sty 2954
> > LaTeX Error: Missing \begin{document}.
> > [ERROR] htlatex: ? 259 Undefined control sequence.
> > [ERROR] htlatex: ? 264 Missing \endcsname inserted.
> > [ERROR] htlatex: ? 264 Extra \or.
> > [ERROR] htlatex: ? 264 Extra \or.
> > [ERROR] htlatex: ? 264 Extra \or.
> > [ERROR] htlatex: ? 264 Extra \or.

@kagalenko-m-b
Да, вот так итеративно пробуйте вычислить, что из задействованного в шаблоне несовместимо с конвертерами. В данном примере надо сначала стереть/закомментировать вызов `cleveref`, потом отключить примеры его использования, убедиться что шаблон сам по себе собирается нормально, и потом пробовать конвертер заново.

@Barracuda72
Вас также упоминаю в этом issue, как заинтересованного в работе с pandoc.

Дополнительная информация, тоже может пригодиться:
https://github.com/AndreyAkinshin/Russian-Phd-LaTeX-Dissertation-Template/issues/153#issuecomment-245990349

https://github.com/jgm/pandoc/issues/5811
https://github.com/jgm/pandoc/issues/5964 (к вопросу о создании воспроизводимого примера для разработчиков pandoc)

https://stackoverflow.com/a/32620710
https://blog.terryburton.co.uk/2015/02/20/Creating-PDF-Documentation-From-a-GitHub-Wiki-Using-Pandoc.html
https://stackoverflow.com/q/14288699