How to install hyphenation patterns in FOP?

Asked by Jerzy Jalocha N

In order to use hyphenation with the FOP processor, what files do I have to install, and how do I tell FOP where they are installed?

I think, I have tried all possible combinations, without success.

In the following sample usage scenario:

 * The '' file contains hyphenate="true" and language="en" and language="es" attributes where necessary.
 * The fop-hyph.jar file was downloaded from the '' archive from Sourceforge.

The following instructions do not work. They produce "Couldn't find hyphenation pattern en" and "es" messages.

$ export FOP_HYPHENATION_PATH=/home/work/hyphenation/fop-hyph.jar
$ fop result.pdf

$ export CLASSPATH=$CLASSPATH:/home/work/hyphenation/fop-hyph.jar
$ fop result.pdf

I also tried other paths, such as 'hyphenation/fop-hyph.jar', 'hyphenation' './hyphenation/fop-hyph.jar', etc.

I also tried putting the FOP_HYPHENATION_PATH variable in a /home/work/.foprc file without success.

The documentation also tells me to install the 'fop-hyph.jar' in a "lib directory of the your FOP installation" or in a "build directory of the your FOP installation". But I can't find such directories.

Since the documentation also mentions a 'hyphenation-base' configuration parameter, I tried putting absolute and relative paths to 'fop-hyph.jar' and 'hyphenation' in a '/home/work/hyphenation/fop.xconf' file. But I only got huge error messages.

I also downloaded the '' archive from Sourceforge, and tried to point the 'hyphenation-base' parameter to the 'en.xml' and 'es.xml' files, but FOP complained about missing '*.hyp' files.

I have honestly tried to read and understand the available documentation:

Any help is really appreciated.

Question information

English Edit question
Ubuntu fop Edit question
No assignee Edit question
Solved by:
Jerzy Jalocha N
Last query:
Last reply:
Revision history for this message
Onkar Shinde (onkarshinde) said :

I am curious now. What is version of Ubuntu and fop that you are using?

Revision history for this message
Jerzy Jalocha N (jjalocha) said :

Sorry, Onkar, I forgot to post that information:
 * Xubuntu 9.06 Jaunty Jackalope
 * linux-image-2.6.28-16-generic (ix86)
 * FOP 1:0.95.dfsg-2ubuntu1
 * Both Sun Java and GCJ seem to be installed, so I am not sure which one is running. Here is the output of 'java -version':
java version "1.6.0_16"
Java(TM) SE Runtime Environment (build 1.6.0_16-b01)
Java HotSpot(TM) Client VM (build 14.2-b01, mixed mode, sharing)

Revision history for this message
Jerzy Jalocha N (jjalocha) said :

I finally got help on the FOP mailing list.

The FOP_HYPHENATION_PATH doesn't work in Ubuntu, probably due to some error in the /usr/bin/fop script. (See

But the following scenario does work correctly:


$ export JAVA_CLASSPATH=$JAVA_CLASSPATH:/home/work/hyphenation/fop-hyph.jar
$ fop result.pdf

If you prefer, you could put the patterns in /usr/local/lib/java/fop-hyph.jar, and the export instruction in ~/.bash_profile or ~/.bashrc.

Revision history for this message
Onkar Shinde (onkarshinde) said :

I missed the previous information you provided because I was not subscribed to the question.

The version of fop you are using has the old launcher script. I was referring to the version in karmic which has proper launcher script. It should be easy to install the version from karmic. If you can not install it for some reason then I will attach the script in bug. I will also try to get this fixed in a jaunty-updates.

Revision history for this message
Jerzy Jalocha N (jjalocha) said :

Don't worry, Onkar!
This hyphenation stuff is just a detail, and I am not in hurry with this either.
Thanks for caring!