docbook-apps

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

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

    Posted 12-30-2010 02:57
    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 “ pair is decimal numeric
    character references, and “ 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 “ and ” 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>

    </sect1>

    <sect1>

    </sect1>

    <sect1>

    </sect1>


    HHC file:






    Regards
    Tracy

    ----- Original Message -----
    From: "Christopher R. Maden" <crism@maden.org>
    To: <docbook-apps@lists.oasis-open.org>
    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 (“ - left double
    >> quote, ” - 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 “ and ”.
    >
    > ~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: docbook-apps-unsubscribe@lists.oasis-open.org
    > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
    >
    >