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 |
http://www.cis.upenn.edu/~wjposer/unidesc.html||Command line program, use uniname <file>. Requires C compiler for installation. |
|
Text encoding conversion: libiconv |
http://www.gnu.org/software/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 |
http://xmlsoft.org/||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: http://sourceforge.net/projects/saxon||Requires Java |
|
Xalan (latest release) |
http://xalan.apache.org/||Requires Java. Be careful to use the latest version rather than the one bundled with the JRE |
|
libxslt |
http://xmlsoft.org/XSLT/||Command line program, use xsltproc <stylesheet> <file>. Requires libxml2. Usually already installed on Linux. Binaries for Windows are available. Part of CygWin. |