Re: [docbook] ONIX 3 - Docbook 5 Mapping
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
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
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
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.