Re: [Docutils-users] Visible comments?

[Guenter M. <mi...@us...>]

On 2017-04-28, Matěj Cepl wrote:
> On 2017-04-28, 00:02 GMT, David Goodger wrote:
>> 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.

> I have already created 
> https://mcepl.fedorapeople.org/tmp/comments.js , but I hoped 
> there could be some better solution.

You could create a custom role "notes", say and "style it away" with CSS in
the final version.

Thre are no "rst-level" custom directives. If the comments/notes shall be
block-level elements, you might consider (ab)using an existing directive
that is not used otherwise in the document.
(There is even a "note" directive.)

With the new (development and upcoming 0.14) version, you can also style
(some) block-level elements in LaTeX.

Günter