Re: feature request for sidebars

[arnold]

Hi Patrice.

Having @cartouche take an optional title and render as <sidebar> in
Docbook would be a perfect solution for me. I don't need the @sidebar
command specifically, just the fucntionality.  So, I really like this
suggestion.

I don't think there are specific constraints to what can go into
a sidebar (I assume you mean within the docbook context).

I remember trying to get sidebars working as macros a long time ago and
it not working very well. I would like it to work in TeX as well as in
everything else since I use texi2pdf a lot.

Thanks!

Arnold

Patrice Dumas <pertusus@free.fr> wrote:

> Hello,
>
> On Sat, Dec 17, 2022 at 01:28:21PM -0700, arnold@skeeve.com wrote:
> > Hi.
> > 
> > I'd like to request a feature.
> > 
> > I would like to have
> > 
> >     @sidebar Sidebar Title Here
> >     ....
> >     @end sidebar
>
> This looks like @cartouche in Texinfo.  The difference is that
> @cartouche never has a title.  Maybe the best would be to add a title to
> @cartouche instead?
>
> > For docbook, this becomes something like
> > 
> >     <sidebar><title>Sidebar Title Here</title>
> >     ....
> >     </sidebar>
>
> I think that it would be better to render @cartouche as <sidebar> in
> DocBook in any case.  Are there specific constraints on what can be
> nested within a <sidebar>?
>
> > I currently use an awk script to generate this for the gawk
> > manual, bug I'd like to have it built-in. :-)
>
> @macro + @ifdocbook + @inlineraw should work without a need for an external
> script?  Thought maybe not in TeX.
>
> -- 
> Pat