From: G. M. <mi...@us...> - 2007-06-01 10:33:54
|
On 30.05.07, Alan G Isaac wrote: > On Wed, 30 May 2007, David Goodger wrote: > > .. code-block:: python > > while indented: > > print "Python code here" > Is a ``code-block`` directive like this destined soon for reST? If I got David right, this is the reST syntax that will be used for inclusion of source code that should be parsed and output with syntax highlight by docutils. > Is that better than an explicit ``literal`` directive? Yes. (it is shorter (and IMO nicer) and backwards compatible to the majority of existing `highlighting extensions`_. > (It doesn't exist yet, right? Not documented anyway.) It does *not* exist in the core docutils but is already used by many `highlighting extensions`_. You can use it in your documents right away and translate it to HTML or LaTeX with the `pygments enhanced docutils front ends`_. Once syntax highlight support becomes a standard docutils feature, the uncha documents should be translable with the standard front ends without need for change. However, there might be the need for a different style-sheet than the one provided at the link above. cheers Guenter .. _highlighting extensions: http://pylit.berlios.de/features/syntax-highlight.html#existing-highlighting-additions-to-docutils .. _pygments enhanced docutils front ends: http://pylit.berlios.de/features/syntax-highlight.html#pygments-enhanced-docutils-front-ends |