Bug#526092: fop wrapper script doesn't easily support hyphenation jar
Paul Millar
Version: 1:0.95.dfsg-4
Severity: important
Fop includes support for hyphenation using the hyphenation information taken from the TeX project; however,
for licensing issues, the Apache FOP project is unable to redistribute the hyphenation information within
their releases of fop. One must download and install the hyphenation data as an additional task. This
hyphenation support is in the form of a single jar file that must be included in the classpath.
Previous versions of fop deb package contained /usr/bin/fop as some fop-specific script that allowed it's
behaviour to be tailored through parameters held in an external file: /etc/fop.conf. In that file, the
variable FOP_HYPHENATION_PATH may be specified, allowing one to easily alter the behaviour of the
distributed /usr/bin/fop script so it includes hyphenation support.
The most recent version of fop appears to have switched to using java_wrappers. In doing so, support for
/etc/fop.conf appears to have been lost and there seems to be no other mechanism for specifying the
hyphenation jar file.
As a work-around, I have manually edited /usr/bin/fop to include the line:
find_jars /usr/local/share/java/fop-hyph.jar
However, I feel this is undesirable as this is a configuration, so better recorded within /etc.
find_jars /usr/local/share/java/fop-hyph.jar
-- System Information:
Debian Release: squeeze/sid
APT prefers oldstable
APT policy: (500, 'oldstable'), (500, 'unstable'), (500, 'stable'), (1, 'experimental')
Architecture: i386 (i686)
Kernel: Linux 2.6.29-1-686 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash
Versions of packages fop depends on:
ii gij-4.1 [java2-runtime] 4.1.2-19 The GNU Java bytecode interpreter
ii java-gcj-compat [java2-r 1.0.80-1 Java runtime environment using GIJ
ii java-wrappers 0.1.13 wrappers for java executables
ii libavalon-framework-java 4.2.0-4 Common framework for Java server a
ii libbatik-java 1.7-4 xml.apache.org SVG Library
ii libbsf-java 1:2.4.0-2 Bean Scripting Framework to suppor
ii libcommons-io-java 1.4-1 Common useful IO related classes
ii libcommons-logging-java 1.1.1-2 commmon wrapper interface for seve
ii libxalan2-java 2.7.1-2 XSL Transformations (XSLT) process
ii libxerces2-java 2.9.1-2 Validating XML parser for Java wit
ii libxml-commons-external- 1.3.04-2 XML Commons external code - DOM, S
ii libxmlgraphics-commons-j 1.3.1.dfsg-2 reusable components used by Batik
ii libxp6 1:1.0.0.xsf1-2 X Printing Extension (Xprint) clie
ii libxt6 1:1.0.5-3 X11 toolkit intrinsics library
ii libxtst6 2:1.0.3-1 X11 Testing -- Resource extension
ii openjdk-6-jre [java2-run 6b14-1.5~pre1-5 OpenJDK Java runtime, using Hotspo
ii sun-java5-jre [java2-run 1.5.0-18-1 Sun Java(TM) Runtime Environment (
ii sun-java6-jre [java2-run 6-13-1 Sun Java(TM) Runtime Environment (
Versions of packages fop recommends:
ii libsaxon-java 1:6.5.5-5 The Saxon XSLT Processor
Versions of packages fop suggests:
pn fop-doc <none> (no description available)
ii libservlet2.4-java 5.0.30-8 Servlet 2.4 and JSP 2.0 Java class
-- no debconf information
--
To UNSUBSCRIBE, email to debian-bugs-...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listm...@lists.debian.org
Vincent Fourmond
On Wed, Apr 29, 2009 at 9:51 AM, Paul Millar <paul....@desy.de> wrote:
> Previous versions of fop deb package contained /usr/bin/fop as some fop-specific script that allowed it's
> behaviour to be tailored through parameters held in an external file: /etc/fop.conf. In that file, the
> variable FOP_HYPHENATION_PATH may be specified, allowing one to easily alter the behaviour of the
> distributed /usr/bin/fop script so it includes hyphenation support.
>
> The most recent version of fop appears to have switched to using java_wrappers. In doing so, support for
> /etc/fop.conf appears to have been lost and there seems to be no other mechanism for specifying the
> hyphenation jar file.
>
> As a work-around, I have manually edited /usr/bin/fop to include the line:
>
> find_jars /usr/local/share/java/fop-hyph.jar
>
> However, I feel this is undesirable as this is a configuration, so better recorded within /etc.
> find_jars /usr/local/share/java/fop-hyph.jar
Thanks for your report. I'll add that back as soon as I can (say,
tomorrow ?). Where could I find this hypenation jar ?
Cheers,
Vincent
Onkar Shinde
> Thanks for your report. I'll add that back as soon as I can (say,
> tomorrow ?). Where could I find this hypenation jar ?
>
Here - http://sourceforge.net/projects/offo
Following page also talks about similar method to detect path of
hyphenation jar. It also mentions additional methods like using
environment variables or reading path from ~/.foprc. It will be great
if we could accommodate all the methods.
http://offo.sourceforge.net/hyphenation/fop-stable/installation.html
Vincent,
Can you please hold on uploading of this change for say 1-2 days? I
plan to fix 2-3 more bugs in pkg-java svn. One of them (524883) is
fixed in Ubuntu - patch taken from upstream, one is fixed upstream
(451258) and the third is documentation change (523170).
Onkar
Paul Millar
On Wednesday 29 April 2009 10:28:22 Vincent Fourmond wrote:
> On Wed, Apr 29, 2009 at 9:51 AM, Paul Millar <paul....@desy.de> wrote:
> > Previous versions of fop deb package contained /usr/bin/fop as some
> > fop-specific script that allowed it's behaviour to be tailored through
> > parameters held in an external file: /etc/fop.conf [...]
>
> Thanks for your report. I'll add that back as soon as I can (say,
> tomorrow ?).
Sure, no problem.
I have a work-around; so, for me, this isn't urgent.
> Where could I find this hypenation jar ?
There's a separate project "OFFO" on SourceForge that packages the hyphenation
rules as a JAR file:
I've also copied below a section from a README I wrote (for a project I'm
working on). It describes, amongst other things, how to configure fop with
hyphenation support.
HTH,
Paul.
---
Where to get things:
Many distributions package the bare essentials. Some caveats: make
sure the version of FOP is fairly recent: 0.9x is a requirement.
For DocBook, make sure you get DocBookXML support (i.e., the
stylesheets). DocBook is (or "used to") come with SGML support, but
we're using pure XML so the SGML version of DocBook is of no use.
o SF download page for DocBook XSLT (you want "docbook-xsl" package)
http://sourceforge.net/project/showfiles.php?group_id=21935
o FOP download mirror selection (get latest version):
http://www.apache.org/dyn/closer.cgi/xmlgraphics/fop
o Download page for OFFO hyphenation rules. You will want the
offo-hyphenation-fop-stable.zip file:
http://sourceforge.net/project/showfiles.php?group_id=116740
o Download page for the w3m text-mode web browser:
http://sourceforge.net/project/showfiles.php?group_id=39518
Installing the hyphenation rules:
Here's a step-by-step method of installing the fop hyphenation rules
for all users (requires root access).
unzip offo-hyphenation-fop-stable.zip
sudo mkdir -p /usr/local/share/java
sudo cp offo-hyphenation-fop-stable/fop-hyph.jar /usr/local/share/java
cat > /etc/fop.conf << EOF
FOP_HYPHENATION_PATH=/usr/local/share/java/fop-hyph.jar
EOF
A guide to installing the hyphenation rules as a normal user:
unzip offo-hyphenation-fop-stable.zip
mkdir -p ~/local/share/java
cp offo-hyphenation-fop-stable/fop-hyph.jar ~/local/share/java
cat > ~/.foprc << EOF
FOP_HYPHENATION_PATH=$HOME/local/share/java/fop-hyph.jar
EOF
N.B. we assume that $HOME is expanded to your home directory by the
shell; if this doesn't happen, it should happen within the fop
wrapper shell. If it doesn't happen in either place, you're
very unlucky and must substitute the value in ~/.foprc yourself.