Hojtsy Gabor wrote:
>
> > I looked briefly at files with Czech translations. They are not in fact
> > correct XML files. They should start with correct encoding declaration
> > on the first line of each file:
> >
> > <?xml encoding="windows-1250"?>
> >
> > Jade silently ignores this error, but other XML based tools may have big
> > problems with it.
>
> There is no error. The manual is finally one file for the compiler.
> This is named manual.xml.in and is located in phpdoc/
> This file uses a <?xml version='1.0' encoding='@ENCODING@' ?>
> encoding declaration, and it is enough for all the files.
> Jouni mentioned how to set up the encoding for the cs
> manual. The other xml files are just defined as entities
> (see the autogenerated chapters.ent), so there is no need
> to place <xml> tags in them.... Exactly it would be an error
> to place them there...
External text entities must have encoding declaration, if they are not
in UTF-8 or UTF-16 (see XML spec). Encoding is not inherited from parent
document in XML. Jade does not take much care of it, but if you would
like to process doc with some XML parser or XSLT processor, you will get
into troubles.
--- From XML spec: ---
Although an XML processor is required to read only entities in the UTF-8
and UTF-16 encodings, it is recognized that other encodings are used
around the world, and it may be desired for XML processors to read
entities that use them. Parsed entities which are stored in an encoding
other than UTF-8 or UTF-16 must begin with a text declaration containing
an encoding declaration:
....
Examples of encoding declarations:
<?xml encoding='UTF-8'?>
<?xml encoding='EUC-JP'?>
-----------------------------------------------------------------
Jirka Kosek
e-mail: [EMAIL PROTECTED]
http://www.kosek.cz
