Re: [Docutils-users] toggle code

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

On 2017-06-07, Benoit Barthelet wrote:

> [-- Type: text/plain, Encoding:  --]

> Hello,

> I'm finding myself writing in rst and pasting long parts of code using the
> .. code:: directive

(BTW For complete code files, you can also use the "include" directive
with the "code" option.
http://docutils.sourceforge.net/docs/ref/rst/directives.html#including-an-external-document-fragment
)

> I'd like to be able to have togglable code when using rst2html.

> If I'm correct I can achieve that with or without javascript, in both case
> I seem to be missing one part of the puzzle to make it work effortlessly.

> With javascript, as described in
> https://stackoverflow.com/a/25543713/3581357 I can create a container and
> have the js code handle the toggle, this works fine for me, except that I'm
> unable to find a way to add the js code in question to the rst2html cli.

You can specify a custom html template to replace the default
docutils/writers/html4css1/template.txt
http://docutils.sourceforge.net/docs/user/config.html#template


Also, you can pass class arguments to (almost) any rST element using either
the "class" directive or (for directives) the "class" option::

  .. code-block:: xml
     :class: toggle-hide

So, maybe you don't need to wrap in a "container".



> I see there is a --script flag but only for rst2html5.

There is no such thing for rst2html5.py shipping with docutils.
http://docutils.sourceforge.net/docs/user/config.html#html5-writer



> Without javascript it seems like css can be used to get the toggle effect
> as described here:
> https://siongui.github.io/2017/02/27/css-only-toggle-dom-element/

> That solution would be quite elegant, ids could be changed to classes and
> the css modified accordingly, but I don't see a way to add a <input
> id="element-toggle" type="checkbox" /> which this solution is ultimately
> based on.

There is indeed not rST for an HTML <input> element.
You could use raw HTML.

> Is it where I should write my own directive as described here
> http://docutils.sourceforge.net/docs/howto/rst-directives.html ?

You would not only need a custom directive, but also an extension to the
HTML writer (unless you let the custom directive generate raw HTML). 

Günter