tags:

views:

22

answers:

2

I am looking into structuring book (fiction) in docbook 5.0. I have got several introductory pages like about the book, about the author, about the publisher (with copyright, isbn info about the printer and the pagesetter), bastard title, title page.

I am unsure, if it is better to structure all this in the info element or try to build several part sections as container for each introductory page.

Are there any examples for this, or are you able to provide an example?

Any hint is appreciated. Thanks a lot!

Frank

A: 

This is all not that important. I would say write the content and move it around in case it needs to go somewhere else (later). It all depends on the (XSLT) you use. The XSL Transformation process is responsible of transforming the content information from the DocBook XML into for example Formating Objects XML, which is (/ can) used to create a PDF.

Verhagen
A: 

Frank,

Short answer: both. The element is primarily a container of meta information about the element that contains it. But what is copyright, isbn, etc? You could argue that it's just meta information for the element (as the Docbook guide does, since it notes that the element is "is confined to meta-information"), but it's also user visible. Remember also that the processing expectations for info read:

Suppressed. Many of the elements in this wrapper may be used in presentation, but they are not generally printed as part of the formatting of the wrapper. The wrapper merely serves to identify where they occur.

So putting it in the elements allow a book publisher to harvest the meta-information for their XML database, while putting it in the body of the document lets you format it properly for print, Web etc.

Now, I notice you're working with a fiction book. You may be better off with the DocBook Publishers schema, rather than the original Docbook. Publisher was designed by the OASIS DocBook Sub Committee for Publishers which was chartered to develop and maintain official variants of DocBook in support of the publishing industry. The DocBook Publishers Schema is based on DocBook 5.0, and delivered in the normative RelaxNG Schema format.

It's a lot easier to work with in that it removes a lot of the technical and software engineering elements from Docbook. It also adds a few elements for poetry, drama and speeches. If you use the Dublin Core metadata, it also adds them as elements for use in blocks.

See: http://docs.oasis-open.org/docbook/specs/publishers-1.0-spec.html

The repository is here: http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/docbook/relaxng/publishers/

I've been developing a schema using Publisher as a base for a particular type of non-fiction book.

uman