Re: [Docutils-users] Visible comments?

[David G. <go...@py...>]

On Thu, Apr 27, 2017 at 5:56 PM, Matěj Cepl <mc...@ce...> wrote:
> Hi,
>
> is there a way (perhaps rst2html5 option) to render comments
> visible? I would like to send a draft of my text as HTML5 (or
> PDF via rst2xetex) to somebody for review, and then my current
> comments may be useful for better understanding of context and
> what stands behind my text.
>
> Any ideas?

There is no way currently.

There is a --leave-comments option will transform reST comments into
<!-- HTML/XML comments -->. They won't show up in the output, but a
simple text substitution (after Docutils processing) could transform
them into something visible.

It would be straightforward to write a transform that converts
comments into some other form, like a "comment"-class admonition or
something.

David Goodger
<http://python.net/~goodger>