[publican-list] <abstract> within chapters (and sections)

[Darrin Mison]

Highlight sounds perfect, I'll check it out.

On 10/03/2010, at 12:43 PM, Jeffrey Fearn wrote:

> Darrin Mison wrote:
>> Many books have content at the start of chapters (and some sections) like "Read this chapter for instructions on how to do X".  I would like to be able to mark that up so that it is visually distinct for the reader. I think <abstract> is the appropriate tag for this use-case but it is formatted in publican as standard text  and it always provides the title
>> of *Abstract* at the top. 
> 
> This is DocBook XSL behavior, not publican specific.
> 
>> <abstract> can include the child tag of <title> but it is currently ignored.
>> Any issues with having <abstract> <para> formatted as in a slightly more distinct fashion (slightly bigger or perhaps different font or bold?) and making the use of <title> within abstract explicit (if you don't supply it then it has no title) ?
> >
>> Or is there another tag that fits the bill ?
>> This would also mean that <title>Abstract</title> would have to be inserted into the abstract in the book templates & people would have to update that on their existing books.
> 
> All 700+ of them if you include translations.
> 
> I think:
> 
> 1: Your example implies a poor chapter/section name
> 2: Highlight seems more widely usable [1]
> 
> Cheers, Jeff.
> 
> [1] http://www.docbook.org/tdg/en/html/highlights.html
> 
> -- 
> Jeff Fearn <jfearn at redhat.com>
> Software Engineer
> Engineering Operations
> Red Hat, Inc
> Freedom ... courage ... Commitment ... ACCOUNTABILITY
> 
> _______________________________________________
> publican-list mailing list
> publican-list at redhat.com
> https://www.redhat.com/mailman/listinfo/publican-list
> Wiki: https://fedorahosted.org/publican