Troubleshooting Tools
This page should provide an overview about tools useful for troubleshooting and tracking down problems FOP users may encounter. It is not about FOP itself.
Character encoding
|
Tool |
Location |
Comment |
|
Unicode Description Utilities |
Command line program, use uniname <file>. Requires C compiler for installation. |
|
|
Text encoding conversion: libiconv |
Command line program, use iconv -f <fromcode> -t <tocode> <file>. Use iconv -l to list available encoding names. Usually already installed on Linux. Part of CygWin. |
XML
|
Tool |
Location |
Comment |
|
libxml2 |
Command line program, use xmllint <file>. Usually already installed on Linux. Binaries for Windows are available. Part of CygWin. |
XSLT
It often helps to run a different XSLT processor in order to track down XSLT problems, for various reasons:
The probelm may be caused by a defect in the XML parser or the XSLT processor in use. In particular, the XML parser and the XSLT processor bundled with Java 1.4 and later have shown a number of defects.
The alternate processor might provide a clearer error message or pinpoint the problem location more preciesely.
|
Tool |
Location |
Comment |
|
Saxon |
Free version: |
Requires Java |
|
Xalan (latest release) |
Requires Java. Be careful to use the latest version rather than the one bundled with the JRE |
|
|
libxslt |
Command line program, use xsltproc <stylesheet> <file>. Requires libxml2. Usually already installed on Linux. Binaries for Windows are available. Part of CygWin. |