OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: RE: [docbook-apps] <phrase> attribute


The docbook standard provides the role attribute as a way
for implementers to add application specific information.
It is typically used to subset an element.  E.g., it is
pretty common to use role on the <emphasis> element to
choose between "normal" and "strong" emphasis.

The standard does not assign any values to role, so in
theory you could ignore it.  However, in practice, you
may want to recognize it in a few places, emphasis being
one example.  I'd suggest looking in two places to find
"commonly used" roles: Bob Stayton's DocBook XSL book and
the DocBook XSL stylesheets, which process the use of role
in a few places.  I'll bet that will cover the most common
uses of role; most other uses are going to be specific to
some small group of users.

Dick Hamilton

> -----Original Message-----
> From: Daniel Carrera [mailto:daniel.carrera@zmsl.com] 
> Sent: Saturday, January 21, 2006 5:36 PM
> To: Craeg Strong
> Cc: docbook-apps@lists.oasis-open.org
> Subject: Re: [docbook-apps] <phrase> attribute
> Hmm... so 'role' can mean anything at all then?
> I am writing an XSLT to turn Docbook into OpenDocument. I 
> guess I have 
> to just ignore the role attribute, right?
> Cheers,
> Daniel.
> Craeg Strong wrote:
> > role is a generic attribute that is available on nearly 
> every docbook 
> > element.
> > It's use is largely application-defined.  Whomever authored 
> that test 
> > file either provided
> > a custom DTD that lists the valid attribute values or they did not.
> > see: http://docbook.org/tdg/en/html/pe-role.html
> > hope this helps,
> -- 
>       /\/`) http://oooauthors.org
>      /\/_/  http://opendocumentfellowship.org
>     /\/_/
>     \/_/    I am not over-weight, I am under-tall.
>     /
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: 
> docbook-apps-help@lists.oasis-open.org

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]