Re: [docbook-tc] Very rough proposal for DocBook transclusions

From
Jirka Kosek <>
Date
2010-07-21T17:23:07+00:00
ID
Thread
Re: [docbook-tc] Very rough proposal for DocBook transclusions
Dave Pawson wrote:

> I'm not entirely happy about driving docbook markup by todays tools
> and their capability. I think the attribute version seems 'right'.

As I have already said I have no strong preference on this. Using
element content seemed more convenient for me.

> What purpose does <application><ref .../> serve?

Nothing special, reference is simply enclosed in application element, so
after transclusion is processed you will get

<application>FooWiz</application>

Also, while it is not shown in examples, def element can contain any
markup. So you can also have:

<?xml version="1.0" encoding="UTF-8"?>
<article xmlns="http://docbook.org/ns/docbook">
  <info>
    <title>Transclusions demo</title>
    <definitions>
      <def name="product-version">3.14</def>
      <def name="product-name"><application>FooWiz</application></def>
      <def name="corp-name">ACME Inc.</def>
    </definitions>
  </info>
  <para>The latest version of <ref>product-name</ref>
    from <ref>corp-name</ref> is <ref>product-version</ref>.</para>
</article>

Hope it is more clear now.

				Jirka

-- 
------------------------------------------------------------------
  Jirka Kosek      e-mail:       http://xmlguru.cz
------------------------------------------------------------------
       Professional XML consulting and training services
  DocBook customization, custom XSLT/XSL-FO document processing
------------------------------------------------------------------
 OASIS DocBook TC member, W3C Invited Expert, ISO JTC1/SC34 member
------------------------------------------------------------------