[Rest2web-develop] Having a reST

[<mi...@pc...>]

{emo;html} I've had a productive weekend - although I wrote very little code.

I've managed to convert over several of my website index pages to using rest2web__.

Unlike articles - which are mainly text and images, with a few footnotes etc thrown in - index pages aren't obviously suitable for storing in reST__ format. I was still looking for some way of making them easier to maintain.

I've mastered a few more details of {acro;reST;ReStructured Text} now - including creating macros for generating index tables etc [#]_.

If you look at a page like `python modules`__ - it's not obviously come from a reST document [#]_ ... but it has. Basically all the text is now stored as plain text - with docutils doing the HTML generation.

It is now *much* easier for me to convert the remaining portions of my website over to using rest2web. {sm;:grin:}


.. class:: invisible

.. note::

    Sorry to abuse my blog (and your patience) like this. For the sake of google I'd like to mention http://www.garycefai.co.uk, http://www.nebulae.org.uk, and http://www.buildingtrade.org.uk.


.. [#] Other than a few tell tale clues... like the footnotes style.

.. [#] I'm having to use the ``.. raw:: html`` directive to put multiple elements into a ``div`` block with a specific class.

__ /python/rest2web/
__ http://docutils.sourceforge.net
__ /python/modules.shtml