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


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

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

Subject: Re: [docbook] Docbook guidance

On Tue, Feb 17, 2004 at 12:07:46PM -0800, Ren? Hach? wrote:

> -Many cross-references and links: although I understand the basic
> concept of linking and cross-referencing with docbook, I am unclear
> on how to implement it. Does anyone know of good tutorials online?

Norman Walsh's 'DocBook: The Definitive Guide', and for later when you
are producing output, Bob Stayton's 'DocBook XSL: The Complete Guide'
are available in print and online:



> -Versioning: I would like to be able to track different versions of
> the document as it evolves as well as the date of those changes. I
> am unclear of what attributes to use for this purpose, if possible.

Have a look at the 'revhistory' element:


> -Ouput Media: the document will be ouputed as a personal website,
> suitable for handheld and printing. I assuming this is not a problem
> for docbook.

No problem.

> -Notes and sidebars: I know docbook has sidebars, notes and example
> elements, all of which I will use extensively. Is it possible
> through attributes to categorize them differently so they get a
> different visual treatment from the stylesheet? If so, what
> attributes (or other means) is appropriate for such a task.

Conventionally people use the 'role' attribute on these elements.  You
then write a custom template for the element (easier than it
sounds---see Bob's book) for each of your roles.

[Others will be able to answer the questions I have not.]



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