Re: [boost] [quickbook] Template problems

Subject: Re: [boost] [quickbook] Template problems
From: Nat Goodspeed (nat_at_[hidden])
Date: 2016-04-20 20:14:13

On Wed, Apr 20, 2016 at 5:35 PM, Edward Diener <eldiener_at_[hidden]> wrote:

> I am seeing these template problems with quickbook using the 'develop' branch:
>
> 1) I have a cxxd_templates.qbk file which has this template:
>
> [template power[x y] '''[x]<superscript>[y]</superscript>''']
>
> I include it first in my main .qbk file as:
>
> [include cxxd_templates.qbk]
>
> In another .qbk file, which is also included in my main .qbk file after the cxxd_templates.qbk I have:
>
> "Despite the fact that there are [power 2..n] possible ..." etc.
>
> but this shows up as is:
>
> "Despite the fact that there are [power 2..n] possible ..." etc.
>
> If I just put the template at the top of that other .qbk file instead the expansion actually takes place. Why is this ? Is not the template global to all sections of the doc after it is defined somewhere ?

Are template definitions scoped to the containing file? In a project
to which I'm contributing, global QuickBook template definitions are
in the top-level file, the one that includes all the rest of the
sections.

> 2) The template above when expanded via [power 2..n] shows x with y superscripted rather than 2 with n superscripted. Why is this and how do I get it to work properly ?

My guess would be that you escaped to DocBook too quickly: the [x] and
[y] are in the DocBook section rather than being expanded by
QuickBook.