From: Günter M. <mi...@us...> - 2018-01-16 11:19:25
|
A comparison of several alternatives is attached (LaTeX and PDF, as rSTt would require a custom preamble). * The "framed" and "mdframed" variants are most simple in terms of definition but require additional packages. * There is no need to exactly reproduce the current look (or the look in HTML). I'd prefer a simple, failproof implementation and documentation on how to style this in the preamble. * With paragraph separation by "parskip.sty", the "vertical-space fixed" alternative does not differ from the simpler lrbox approach. * We could also just fully escape TeX special characters in a literal block. However, IMV it is cleaner to change to an "admonition environment", because admonitions are block-level elements. Attachments: - [admonitiontest.tex](https://sourceforge.net/p/docutils/bugs/_discuss/thread/2757cd1f/1e56/attachment/admonitiontest.tex) (6.2 kB; text/x-tex) --- ** [bugs:#339] literal block with caret symbol inside an admonition causes failed PDF build from latex** **Status:** open **Group:** Default **Created:** Sun Jan 14, 2018 07:39 PM UTC by jfbu **Last Updated:** Mon Jan 15, 2018 07:15 PM UTC **Owner:** nobody Test file: ~~~rst Test ==== .. important:: This is a power:: x^2 ~~~ Then do ``rst2latex.py test.rst test.tex`` and ``latex test.tex``. Gives error: ~~~console ! Missing $ inserted. <inserted text> $ l.69 } ~~~ This is caused by `alltt` environment being encapsulated as argument to ``\DUadmonition[important]`` macro hence too late to change catcodes. --- Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/bugs/ To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/bugs/options. Or, if this is a mailing list, you can unsubscribe from the mailing list. |