Re: [docbook] ONIX 3 - Docbook 5 Mapping

2014-05-17 Thread Thomas Schraitle
Hi Peter,

Am Freitag, 16. Mai 2014, 10:58:11 schrieb Peter Fleck:
 
 May be I'm tackling the issue wrongly and would value advise if so:
 
  1. When we receive a proposal for a book, whether print or eBook, the
 preliminary metadata is entered into a database.
  2. After a review process a decision is made to publish or reject the work.
 3. If the work goes ahead I was hoping to create the Docbook info out of
 the database automatically and a separate ONIX file for
 distribution channels.
  4. The production staff would then take the Docbook file and follow
 through to completion.
 
 That was why I was wonder if there was mapping so the database could
 drive the XML files for both production and marketing.
 Is there a better way of doing it?

If I understand your tool chain correctly, it seems to me of double work: 
creating all metadata from your database, wrap it into DocBook elements and 
create a separate ONIX file.

One possible solution could be: create only the ONIX file. Why?

Well, first of all, I'm pretty sure ONIX offers much more elements in regards 
to meta and publishing information than DocBook. Trying to replicate the ONIX 
semantic in DocBook will make your markup much more cumbersome and 
complicated. 

ONIX's business is meta and publishing information and DocBook's business is 
documentation. I would leave both in their respective domains. 

However, that doesn't mean you can't mix them. If you created a separate 
ONIX file from your tool chain, it can be referenced by xi:include/ inside 
info. You need two things:

1. Customize the DocBook schema and allow ONIX elements inside info. You
   need the original ONIX RELAX NG schema.

2. Customize the DocBook XSL stylesheets, if you want to extract metadata 
   from that domain and add it to the titlepage, for example.

There might be one issue: It *could* happen that an element from DocBook and 
an element from ONIX overlap in their semantics. In that case you have to 
decide in your stylesheets if this is allowed, ignored, or which one is 
prefered over the other.

Not sure if this is what you're searching for.


-- 
Gruß/Regards
  Thomas Schraitle


-
To unsubscribe, e-mail: docbook-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-h...@lists.oasis-open.org



[docbook] ONIX 3 - Docbook 5 Mapping

2014-05-16 Thread Peter Fleck

Hi all,

We are moving our systems over to be as fully compliant as possible to 
ONIX 3.
Before starting the work myself I was wondering if there is a mapping 
between ONIX 3 and Docbook 5?


Many thanks,

Peterskype:peterfleck?call



Re: [docbook] ONIX 3 - Docbook 5 Mapping

2014-05-16 Thread Thomas Schraitle
Hi,

On Fri, 16 May 2014 09:29:56 +0200
Peter Fleck peterfl...@gmail.com wrote:

 [...]
 Before starting the work myself I was wondering if there is a mapping 
 between ONIX 3 and Docbook 5?

I don't know and I'm not sure if it makes sense to rewrite ONIX
elements into DocBook elements. 

Theoretically, you *could* find some mappings, (ab)use the role or
remap attributes. However, I doubt it will be a good solution in
terms of clarity and semantics.

To my knowledge, both can be downloaded as RELAX NG schema. Why not
incorporate ONIX elements into DocBook's info element? 

They both belong to a different namespace, no conflicts would be
created. It shouldn't be that difficult to extend DocBook (although I
haven't tried it).

That way you don't abuse DocBook elements and they stay semantically
the same. In terms of stylesheet customization, you don't have to
change the standard DocBook template rules. That's also a plus I
think: They stay the same, so no surprises. 

The only step you have to take is to implement a different behaviour
for your ONIX elements. But you only need this step, if you really want
to make them appear on a titlepage, for example.


-- 
Gruß/Regards,
Thomas Schraitle

-
To unsubscribe, e-mail: docbook-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-h...@lists.oasis-open.org



Re: [docbook] ONIX 3 - Docbook 5 Mapping

2014-05-16 Thread Peter Fleck

Thanks Thomas,

May be I'm tackling the issue wrongly and would value advise if so:

1. When we receive a proposal for a book, whether print or eBook, the
   preliminary metadata is entered into a database.
2. After a review process a decision is made to publish or reject the work.
3. If the work goes ahead I was hoping to create the Docbook info out
   of the database automatically and a separate ONIX file for
   distribution channels.
4. The production staff would then take the Docbook file and follow
   through to completion.

That was why I was wonder if there was mapping so the database could 
drive the XML files for both production and marketing.

Is there a better way of doing it?

Peter

On 16/05/2014 10:08, Thomas Schraitle wrote:

Hi,

On Fri, 16 May 2014 09:29:56 +0200
Peter Fleck peterfl...@gmail.com wrote:


[...]
Before starting the work myself I was wondering if there is a mapping
between ONIX 3 and Docbook 5?

I don't know and I'm not sure if it makes sense to rewrite ONIX
elements into DocBook elements.

Theoretically, you *could* find some mappings, (ab)use the role or
remap attributes. However, I doubt it will be a good solution in
terms of clarity and semantics.

To my knowledge, both can be downloaded as RELAX NG schema. Why not
incorporate ONIX elements into DocBook's info element?

They both belong to a different namespace, no conflicts would be
created. It shouldn't be that difficult to extend DocBook (although I
haven't tried it).

That way you don't abuse DocBook elements and they stay semantically
the same. In terms of stylesheet customization, you don't have to
change the standard DocBook template rules. That's also a plus I
think: They stay the same, so no surprises.

The only step you have to take is to implement a different behaviour
for your ONIX elements. But you only need this step, if you really want
to make them appear on a titlepage, for example.