| |
|
    
|
|
-
XSLT parser:
The XSL stylesheets use some XPath functions and elements
which might be unknown to some old XSLT Parsers
(e.g. the <xsl:document> - element).
I have tested this software package with these two XSLT parsers:
XSLTproc
and Saxon (ver. 7.1 or later).
Other XSLT parsers might work too, but I can't guarantee
that they will.
-
Unicode and browser:
The XSL stylesheet translates all LaTeX special characters
into the international UTF-8 character set,
which supports a wide range of special characters.
The most recent releases of the most frequently used browsers,
including Firefox/Mozilla (1.x), Netscape (6.x/7.x), and IExplorer,
support this format.
If you are using an older browser (like some versions of Netscape 4.x),
however, you might not be able to see non-standard characters displayed correctly
(e.g. Netscape 4.x display them as question marks).
If you experience difficulties, please upgrade to a newer browser.
-
Special characters in BibTeX:
Make sure that you do not use any special characters
in your BibTeX file (like »&«) without marking them as special
characters in LaTeX.
(e.g. using the »&« in a URL will cause an error by the parser!)
-
Make sure that your BibTeX-file is syntactically correct
before you convert it to XML.
-
Sorting the BibTex entries:
Note that the tool will not (yet) sort your BibTex entries!
If you want to have sorted entries (e.g. by names) in the output HTML files, please
sort the entries in your BibTeX file BEFORE you convert the BibTeX file to XML.
To sort your BibTeX file just use BibTeX tools
or editors with a BibTeX sort option (e.g. Emacs or Xemacs).
-
Colons inside a BibTeX label:
These colons (e.g. »@book{reed:99«) may cause an error with
some parsers (e.g. with Saxon; Xsltproc ignores these colons).
If you encounter any errors during the parsing process
then try to replace these colons with an underscore.
There is a Perl script in the xml2html.zip
package that will do this job for you.
(Note that this is only a temporarily replacement.
It will have no effect to the output HTML files.)
-
BibTeX »crossrefs«:
Make sure to have no crossrefs in your entries.
-
LaTeX commands:
Commands like »/cite«, »/it«, »/sc«,
will be ignored by the parser.
They will be printed literally as they appear in your BibTeX file.
-
BibTeX abbreviations:
Inside the »author« or »editor« field,
BibTeX abbreviations like
»@macro« or »@string« will be ignored by the parser.
(Abbreviations in all other fields are ok.)
|
|
|