From 627d51418f363b0d9dba61e391d768d9d254b466 Mon Sep 17 00:00:00 2001
From: "Andreas L. Delmelle" Make sure you have set the language and/or country attributes for an appropriate XSL-FO element (fo:page-sequence, fo:block or fo:character): See Standard Hyphenation Support for a list of supported language and country codes, and Custom Hyphenation Support for instructions on adding support for other languages and countries. See Hyphenation Support for details and instructions on using hyphenation with FOP. Explicitly enable hyphenation for an appropriate XSL-FO element (fo:block, fo:character): The following table summarizes FOP's standard hyphenation support.
-Please note that the "view" links reflect current CVS, and may be different than the contents of released code. See Hyphenation Patterns for a brief explanation of the contents of these files. FOP uses Liang's hyphenation algorithm, well known from TeX. It needs
language specific pattern and other data for operation. Because of licensing issues,
- there are currently some significant holes in FOP's hyphenation support.
- The information in this section is intended to help you work around these
- limitations, if possible, add support for other languages, or enhance FOP's
- support of current languages. Because of licensing issues (and for
+ convenience), all hyphenation patterns for FOP are made available through
+ the Many of the hyphenation files distributed with TeX and its offspring are
licenced under the The most important source of hyphenation pattern files is the
To install custom a custom hyphenation pattern for use with FOP: If you would like to build your own hyphenation pattern files, or modify
existing ones, this section will help you understand how to do so. Even
when creating a pattern file from scratch, it may be beneficial to start
- with an existing file and modify it. See Standard
- Hyphenation Support or the source distribution (src/hyph) for
- examples. Here is a brief explanation of the contents of FOP's hyphenation
- patterns:
-
-
-
- language_COUNTRY code
- Description
- View Patterns (maintenance branch CVS)
-
-
- en
- English
-
-
-
- es
- Spanish
-
-
-
- fi
- Finnish
-
-
-
- hu
- Hungarian
-
-
-
- it
- Italian
-
-
-
- pl
- Polish
-
-
-
- pt
- Portuguese
-
-
-
- ru
- Russian
-
-
{fop-dir}/src/hyph/hyphenation.dtd
.{fop-dir}/hyph/hyphenation.dtd
.
languageCode_countryCode.xml
. The country code is
optional, and should be used only if needed. For example:
@@ -142,18 +88,33 @@ Please note that the "view" links reflect current CVS, and may be different than
on it being two letter strings in a few places. So you can make up your
own codes for custom hyphenation patterns, but they should be two
letter strings too (patches for proper handling extensions are welcome)
-
{fop-dir}/lib
directory, or
+ in a directory of your choice (and append the full path to the JAR to
+ the environment variable FOP_HYPHENATION_PATH
).{fop-dir}/hyph
, and run Ant with build target
+ hyphenation-jar
. This will create a JAR containing the
+ compiled patterns in {fop-dir}/build
that will be added to the
+ classpath on the next run.
+ (When FOP is built from scratch, and there are pattern source file(s)
+ present in {fop-dir}/hyph
, this JAR will automatically
+ be created from the supplied pattern(s)).