Re: [docbook-apps] Suggested Writing Style

["Bob Stayton" <bobs@sagehill.net>]

Hi Mike,
1 and 2 are not the same.  In 2 you added a line break before <footnote>, 
and that linebreak is preserved as a single space in the output.  The line 
break after the <footnote> opening tag is ignored because the content model 
of footnote does not include #PCDATA.  The line break before <footnote> is 
#PCDATA in the para element, and it is preserved.

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net


----- Original Message ----- 
From: "Mike Broschinsky" <mbroschi@utah.gov>
To: <docbook-apps@lists.oasis-open.org>
Sent: Tuesday, August 22, 2006 1:34 PM
Subject: Re: [docbook-apps] Suggested Writing Style


> So, based on Sean's response and Bob's elaboration about elements
> allowing PCDATA, let me ask about another case. Let's say I have a
> paragraph with footnotes...
>
> Should I have (1):
>
> <para>This is text.<footnote><para>This is a
> footnote.</para></footnote>  This is more text.</para>
>
> Or should I have (2):
>
> <para>This is text.
> <footnote>
> <para>This is a footnote.</para>
> </footnote>
> This is more text.</para>
>
> Or what if I have a footnote for the last sentence of a paragraph (3)?
>
> <para>This is the first sentence. This is the last
> sentence.<footnote><para>This is the footnote.</para></footnote></para>
>
> Or this (4):
>
> <para>This is the first sentence. This is the last sentence.
> <footnote>
> <para>This is the footnote.</para>
> </footnote></para>
>
> Or this (5):
> <para>This is the first sentence. This is the last sentence.
> <footnote>
> <para>This is the footnote.</para>
> </footnote>
> </para>
>
> If I read Sean and Bob right, (1) and (2) should be equivalent and
> should produce a nicely formatted paragraph and footnote without
> extraneous spaces? But (4) and (5) may introduce a trailing space?
>
> Mike
>
> ----------------------------
> Mike Broschinsky
> Administrative Code Editor
> Utah State Division of Administrative Rules
> 801-538-3003
> mbroschi@utah.gov
>
>>>> Sean Wheller <sean@inwords.co.za> 08/10/2006 06:30 >>>
> On Thursday 10 August 2006 14:07, Euis Luhuanam wrote:
>> <para>Blah... Blah... Blah sentences.</para>
>
> This way is correct. Any other will induce spaces into the before and
> after of
> the element value.
> -- 
> Ask me about the Monkey.
>
> Sean Wheller
> Technical Author
> sean@inwords.co.za
> +27-84-854-9408
> http://www.inwords.co.za
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>
>
>