Contents
/opt/fop/{build,lib}; JAI components include
libmlib_jai.so, jai_codec.jar, jai_core.jar, and
mlibwrapper_jai.jar
The FOP (Formatting Objects Processor) package contains a print formatter driven by XSL formatting objects (XSL-FO). It is a Java application that reads a formatting object tree and renders the resulting pages to a specified output. Output formats currently supported include PDF, PCL, PostScript, SVG, XML (area tree representation), print, AWT, MIF and ASCII text. The primary output target is PDF.
Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.
Download (HTTP): https://archive.apache.org/dist/xmlgraphics/fop/source/fop-2.12-src.tar.gz
Download MD5 sum: 489d8d34cff84217f59d94041a4206ab
Download size: 20 MB
Estimated disk space required: 563 MB (including files downloaded to user directory, add 73 MB for tests)
Estimated build time: 0.3 SBU (add 0.7 SBU for tests) depends on download time
Required Additional Downloads:
Maven build system:
https://archive.apache.org/dist/maven/maven-3/3.10.0/binaries/apache-maven-3.10.0-bin.tar.gz
c0ad4bb59dbd99bcdbde758c9afcc0ee
9.5 MB (additionally, about 90 MB are downloaded to the
building user's directory)
Recommended packages
Objects for Formatting Objects (OFFO) hyphenation
patterns:
https://downloads.sourceforge.net/offo/2.2/offo-hyphenation.zip
bf9c09bf05108ef9661b8f08d91c2336
862 KB
An Internet connection is needed for building this package. The system certificate store may need to be set up with make-ca-1.16.1 before building this package.
Ensure $JAVA_HOME is set correctly
before beginning the build.
Copy the XML hyphenation patterns into the fop source tree by running the following commands:
python3 -m zipfile -e ../offo-hyphenation.zip . && cp offo-hyphenation/hyph/* fop/hyph && rm -rf offo-hyphenation
Starting with fop-2.5, the Maven build system is required. We use the binary provided by apache, that we install in a temporary location:
tar -xf ../apache-maven-3.10.0-bin.tar.gz -C /tmp
Compile fop by running the following commands:
cd fop && LC_ALL=en_US.UTF-8 \ PATH=$PATH:/tmp/apache-maven-3.10.0/bin \ ant package javadocs && mv build/javadocs .
To test the results, issue:
LC_ALL=en_US.UTF-8 \ PATH=$PATH:/tmp/apache-maven-3.10.0/bin \ ant junit
Now, install Fop as the
root user:
install -v -d -m755 -o root -g root /opt/fop-2.12 && cp -vR build conf examples fop* javadocs lib /opt/fop-2.12 && chmod a+x /opt/fop-2.12/fop && ln -v -sfn fop-2.12 /opt/fop
Finally, remove the temporary copy of Apache Maven:
rm -rf /tmp/apache-maven-3.10.0
export LC_ALL=en_US.UTF-8: the compiler fails if using an ASCII locale.
ant target: This reads the file
build.xml and builds the target:
compile compiles the java sources,
jar-main generates jar archives,
jar-hyphenation generates the
hyphenation patterns for FOP, junit
runs the junit tests, and
javadocs builds the documentation. The
all target runs all of the above.
ln -v -sf fop-2.12
/opt/fop: This is optional and creates a
convenience symlink so that $FOP_HOME
doesn't have to be changed each time there's a package version
change.
Using fop to process some large FO's (including the FO derived from the BLFS XML sources), can lead to memory errors. Unless you add a parameter to the java command used in the fop script you may receive messages similar to the one shown below:
Exception in thread "main"
java.lang.OutOfMemoryError: Java heap space
To avoid errors like this, you need to pass an extra parameter to
the java command
used in the fop
script. This can be accomplished by creating a ~/.foprc (which is sourced by the fop script) and adding the
parameter to the FOP_OPTS environment
variable.
The fop script
looks for a FOP_HOME environment
variable to locate the fop class
libraries. You can create this variable using the ~/.foprc file as well. Create a ~/.foprc file using the following commands:
cat > ~/.foprc << "EOF"
FOP_OPTS="-Xmx<RAM_Installed>m"
FOP_HOME="/opt/fop"
EOF
Replace <RAM_Installed> with a
number representing the amount of RAM installed in your computer
(in megabytes). An example would be FOP_OPTS="-Xmx768m".
To include the fop
script in your path, update the system-wide profile with the
following command as the root
user:
cat > /etc/profile.d/fop.sh << "EOF"
# Begin /etc/profile.d/fop.sh
pathappend /opt/fop
# End /etc/profile.d/fop.sh
EOF
Running fop can
be somewhat verbose. The default logging level can be changed
from INFO to any of FINEST, FINER, FINE, CONFIG, INFO, WARNING,
SEVERE, ALL, or OFF. To do this, edit $JAVA_HOME/jre/lib/logging.properties and
change the entries for .level and
java.util.logging.ConsoleHandler.level to the
desired value.
/opt/fop/{build,lib}; JAI components include
libmlib_jai.so, jai_codec.jar, jai_core.jar, and
mlibwrapper_jai.jar