Guenter Milde wrote:
> The double colon starts a literal block.
>
>> Why not just:
>
>> .. topic:: myfile.py
>> :class:file
>
>> class MyClass:
>> def something(self):
>> pass
Okay, so the literal block works better ;-)
I'm confused as to why:
.. topic:: myfile.py
::
class MyClass:
def something(self):
pass
...renders to:
<div class="topic">
<p class="topic-title first">myfile.py</p>
<pre class="literal-block">
class MyClass:
def something(self):
pass
</pre>
</div>
...while:
.. topic:: myfile.py
:class: file
::
class MyClass:
def something(self):
pass
...renders to:
<div class="file topic">
<p class="topic-title first">myfile.py</p>
<blockquote>
<pre class="literal-block">
class MyClass:
def something(self):
pass
</pre>
</blockquote>
</div>
Why the additional blockquote?
This looks unsightly both in the Sphinx default templates and when
rendered on PyPI:
http://pypi.python.org/pypi/scatologist
cheers,
Chris
--
Simplistix - Content Management, Batch Processing & Python Consulting
- http://www.simplistix.co.uk
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to sphinx-dev@googlegroups.com
To unsubscribe from this group, send email to
sphinx-dev+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---
