Georg Brandl wrote:
> Apart from that, in the linked HTML file, I had to look twice to get the
> interspersed output,
I did need to improve the style for it. And do a lot of other things to
improve the formatting, presentation, linking, content and overall
utility. Guess how I ended up using Sphinx :-)
> why not just use standard unhighlighted code blocks?
After some experimentation that is what I ended up doing. (As a
beginner to rst it takes a while to get used exactly when indentation is
used, number of colons, what errors/warnings actually mean when you
haven't finished writing your doc, backticks, angle brackets, :words: etc).
One problem I encountered is that labels don't work with code blocks.
For example this works:
.. _mylabel:
A section
=========
But this doesn't work:
.. mylabel:
.. code-block:: python
print 3
Consequently I had to add another level of indent so it looked like this:
.. mylabel:
.. code-block:: python
print 3
That also resulted in more indent on the output html page which was
unfortunate.
Roger
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at
http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---
