Re: [Docutils-develop] Boxes

[<po...@or...>]

David Goodger <go...@py...> writes:

> The DocBook sidebar has a title, but no subtitle.  Off the top of my head, I
> would suggest an element structure like this (for addition to
> spec/docutils.dtd)::
> 
>     <!ELEMENT sidebar (title, subtitle?, (%body.elements;)+)>
>     <!ATTLIST sidebar %basic.atts;>
> 
> The sidebar element would be included in %structure.model as an alternative
> to body elements and topics::
> 
>     <!ENTITY % structure.model
>       " ( ( (%body.elements; | topic | sidebar)+,
>       ...
> 
> A simple directive could be used to implement it, similar to "topic" or
> admonitions::
> 
>     .. sidebar:: Mandatory Title Text Goes Here
>        :subtitle: Is Optional
> 
>        Regular body elements follow.
 
What do you think of Beni's idea to have something like this::

    .. sidebar::

       ======================
        Title Text Goes Here
       ======================

       -------------------
        Optional Subtitle
       -------------------

       Regular body elements follow.

-- 
Patrick K. O'Brien
Orbtech      http://www.orbtech.com/web/pobrien
-----------------------------------------------
"Your source for Python programming expertise."
-----------------------------------------------