Next in thread → Next in month →

Re: [docbook-apps] Docbook xml title containing double quotation marks causes CHM TOC issue

From
Tracy Huang Gmail <>
Date
2010-12-30T02:57:21+00:00
ID
15E06A62191D4DB497C11A8A1DCA46EE@app307c43c3de3
Thread
Re: [docbook-apps] Docbook xml title containing double quotation marks causes CHM TOC issue
Hi Chris,

Thank you for sharing your ideas. I have very limited knowledge to entities 
and encoding, so I did some researches and tried to understand what you 
said, please correct me if my understanding is incorrect.

I tested and found that all the following writing styles produce the same 
result in the hhc file and the html file.
I may assume that they are replacements for one another and all working in a 
portable and standard manner. Difference is &#8220; pair is decimal numeric 
character references, and &#x201c; pair is hexadecimal. And since XML allows 
both decimal and hexadecimal numeric character references, so I would assume 
there is no difference between them that I need to pay special attention to. 
Or is there one preferable over the other?

And &#147; and &#148; are HTML character entity references, as I copied them 
from a list named THML escape chracters. At first, I just wanted to give it 
a try, but it turned out to work. However, I still don't understand why they 
happened to work in an xml file, what their actual meanings are in the xml 
numeric reference, and how Windows CP-1252 encoding interferes with the 
result. I will do more reseraches later. But if anybody could shed me some 
lights on this, I will certainly appreciate it.

XML file:
  <sect1>
    <title>Loading <quote>heavy</quote> window1</title>
  </sect1>

  <sect1>
    <title>Loading &#8220;heavy&#8221; window2</title>
  </sect1>

  <sect1>
    <title>Loading &#x201c;heavy&#x201d; window3</title>
  </sect1>


HHC file:
<param name="Name" value="Loading &#8220;heavy&#8221; window1">

<param name="Name" value="Loading &#8220;heavy&#8221; window2">

<param name="Name" value="Loading &#8220;heavy&#8221; window3">

Regards
Tracy

----- Original Message ----- 
From: "Christopher R. Maden" <>
To: <>
Sent: Wednesday, December 29, 2010 9:46 PM
Subject: Re: [docbook-apps] Docbook xml title containing double quotation 
marks causes CHM TOC issue


> On 12/27/2010 08:32 PM, Tracy Huang Gmail wrote:
>> Thank you for the suggestion! I will install and try Saxon 6 later.
>> And enlightened by another user Sarah Cheng, I have worked around the
>> issue by adding the following Escape Characters (&#147; - left double
>> quote, &#148; - right double quote) in the xml file:
>
> To be clear, characters 147 and 148 are control characters; remember
> that all numeric references are to Unicode.  They happen to be
> double-quotes in the Windows CP-1252 encoding, but that is not their
> meaning in an XML numeric reference.
>
> Instead, try using &#x201c; and &#x201d;.
>
> ~Chris
> -- 
> Chris Maden, text nerd  <URL: http://crism.maden.org/ >
> Axial tilt: the reason for the season.
> GnuPG Fingerprint: C6E4 E2A9 C9F8 71AC 9724 CAA3 19F8 6677 0077 C319
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: 
> For additional commands, e-mail: 
>
>
Next in thread → Next in month →