Add support for restructured text (.rst) code blocks

[podhrmic]

An example below:

Lorem Ipsum
=========================

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum

.. code-block:: cryptol

   R1 : {WIDTH} (fin WIDTH, WIDTH >= 2, WIDTH % 2 == 0) => [WIDTH/2-1] -> Integer
   R1 nhi = `(2^^WIDTH)

   R4 : {WIDTH} (fin WIDTH, WIDTH >= 2, WIDTH % 2 == 0) => [WIDTH/2-1] -> Integer
   R4 nhi = `(2^^(WIDTH+2))

[podhrmic]

Use pandoc module.

[podhrmic]

@yav closing as no longer relevant. .rst is a relatively complex format, so a simple parser similar to what we have for Markdown and Latex wouldn't cut it. A better way is probably to convert .rst code blocks to cryptol separately, and then directly load cryptol files.

[yav]

I think this would be a nice feature to have and extracting Cryptol code blocks from an RST really shouldn't be that hard. Can you say a bit more about what difficulties you envision?

[podhrmic]

Of course. Here are the specs for the code-block directive in rst.

An example:

.. code-block:: cryptol
   :linenos:
   :dedent: 4

       some cryptol code
       
       some other cryptol code

Regular text here. Code block ended on the previous line.

The trick is you have to track the opening token .. code-block:: cryptol and correctly identify the ending newline. So probably some state tracking? Anyway, I agree that getting something that works shouldn't be that hard, but given my Haskell skills it is beyond the time I have available for this feature.

[yav]

@podhrmic I implemented a simple RST pre-processor in PR #1443. Give it a go!