Re: [Docutils-develop] sidebar directive markup (was Re: Boxes)

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

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

> Patrick K. O'Brien wrote:
> > What do you think of Beni's idea to have something like this::
> > 
> >     .. sidebar::
> > 
> >        ======================
> >         Title Text Goes Here
> >        ======================
> > 
> >        -------------------
> >         Optional Subtitle
> >        -------------------
> > 
> >        Regular body elements follow.
> 
> I actually did consider that form originally, and although it's
> possible, it would be tricky to program and potentially confusing to
> readers of the plaintext.  How would the sidebar title adornment
> styles relate to those of the master document?
> 
> Since a sidebar always has a title, no adornment of the title is
> necessary: it can be the directive's argument.  The subtitle could be
> an adorned title, or a directive option, or even extracted from the
> second line of the directive argument::
> 
>     .. sidebar:: Title Text Here
>                  Subtitle Text Here
> 
> That may be too subtle though.
> 
> If we do allow structural elements inside a sidebar, it would
> make sense for the title & subtitle to be adorned also.

I'm prepared for you to make a BDFL pronouncement so I can start
implementing the solution you think best at this point in time. And
I'd just as soon avoid anything that required tricky programming. So
is your original recommendation still the way to proceed?

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