On 2011-01-11, Guenter Milde wrote:
> On 2011-01-09, Vinay Sajip wrote:
>>> > If would be neater if instead of <strong>param_name</strong>, the
>>> > output markup was something like
>>> >
>>> > <span class="positional-param">param_name</span>
>>> >
>>> > and
>>> >
>>> > <span class="keyword-param">param_name</span>
...
> I suggest <emph> or <strong> tags with class="parameter positional" vs.
> class="parameter keyword" so that even without a stylesheet the emphasis
> is kept (graceful degradation) but configuring the layout with CSS is
> easy.
> Using two class arguments ("parameter keyword") instead of a hyphenated
> one ("parameter-keyword") allows setting shared features in a common rule
> and diffentiating with the selectors .parameter.keyword vs.
> .parameter.positional.
Addition: to avoid confusion with keywords of a programming language, I
change my suggestion to <strong class="parameter kwarg">
(i.e. "kwarg" instead of "keyword").
Günter
--
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to sphinx-...@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.
